本节提供在 Microsoft® Windows® 系统上以独立方式使用 Probekit 的逐步指示信息。
要以独立方式使用 Probekit,必须在目标系统上安装代理控制器。Probekit 的数据收集代理程序和扩展库与代理控制器一起自动安装。
遵循下列步骤,以独立方式使用 Probekit 运行应用程序:
- 在工作台中导入探针或构建探针。
- 在探针定义中,包括指定独立 Probekit 的探针中的目标中描述的特殊目标规范。
- 将所有探针文件复制到目标机器上的某个文件夹中。如果使用多个探针,则将各个 probescript 文件的内容并置到同一个 probescript 文件中。
- 将包含探针文件的文件夹添加到目标机器的类路径中。
- 将 RAC 库文件夹和 Probekit 插件文件夹添加到目标机器的路径:
<racInstallDir>\bin
<racInstallDir>\plugins\com.ibm.rational.pd.probekit\lib
- 将以下选项字符串添加至启动您的程序的命令行:
-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 代理程序检测的每个类名。 |