在 Microsoft Windows 上以独立方式使用 Probekit

“Windows 平台”图标 本节提供在 Microsoft® Windows® 系统上以独立方式使用 Probekit 的逐步指示信息。

要以独立方式使用 Probekit,必须在目标系统上安装代理控制器。Probekit 的数据收集代理程序和扩展库与代理控制器一起自动安装。

遵循下列步骤,以独立方式使用 Probekit 运行应用程序:

  1. 在工作台中导入探针或构建探针。
  2. 在探针定义中,包括指定独立 Probekit 的探针中的目标中描述的特殊目标规范。
  3. 将所有探针文件复制到目标机器上的某个文件夹中。如果使用多个探针,则将各个 probescript 文件的内容并置到同一个 probescript 文件中。
  4. 将包含探针文件的文件夹添加到目标机器的类路径中。
  5. 将 RAC 库文件夹和 Probekit 插件文件夹添加到目标机器的路径:
    <racInstallDir>\bin
    <racInstallDir>\plugins\com.ibm.rational.pd.probekit\lib
  6. 将以下选项字符串添加至启动您的程序的命令行:
    -XrunpiAgent:server=standalone,
    mode=none,
    extensionLibrary=ProbeAgentExtension.dll,
    ext-pk-BCILibraryName=BCIEngProbe.dll,
    ext-pk-probescript=<myProbe>.probescript
    其中 <myProbe> 是探针的 .probescript 文件的名称。
    注: 以上选项字符串分多行显示,以便于阅读。当在命令行中包含该选项字符串时,它必须都在同一行上且没有嵌入的空格。
    要让 Probekit 代理程序写日志消息,请向命令行添加以下选项:
    选项 描述
    ext-pk-logFile=<file> 指定要 Probekit 代理程序写入日志消息的文件名。<file> 可以是完整路径和文件名。如果指定了 stderr 而不是文件名,日志输出将写入标准错误通道。如果未指定此选项,则不写日志输出。
    ext-pk-logLevel=<level> 指定要使用的记录级别。有关记录级别及其描述,请参阅下表。
    可以指定下列记录级别:
    级别 描述
    不生成日志输出。
    严重 只记录严重错误,例如,无法装入库。
    警告 记录警告消息。此级别是缺省级别。
    信息 记录状态消息,例如,“正在初始化”。
    配置 记录配置事件和信息,例如,.probescript 文件的内容。
    最详细 生成最大的日志输出。日志文件将包含 Probekit 代理程序检测的每个类名。
反馈
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.