此部分内容提供有关在 iSeries 系统上以独立方式使用 Probekit 的逐步指示信息。
要以独立方式使用 Probekit,必须在目标系统上安装代理控制器。在安装代理控制器时,将自动安装 Probekit 的数据收集代理程序和扩展库。
请完成下列步骤,以便以独立方式使用 Probekit 来运行应用程序:
- 导入探针,或者在工作台中构建探针。
- 在探针定义中,包括在独立 Probekit 的探针中指定目标中描述的特殊目标指定。
- 将所有探针文件复制到目标机器上的一个文件夹中。如果使用多个探针,请将各个
probescript 文件的内容合并到一个 probescript 文件中。
- 将包含探针文件的文件夹添加到目标机器的类路径中。
- 如果尚未将 IBMRAC 库添加到库列表条目中,则通过运行以下命令来添加它:
ADDLIBLE IBMRAC
- 在用于启动程序的命令行中添加以下选项字符串:
-XrunpiAgent:server=standalone,mode=none,
extensionLibrary=IBMRAC/PROBEAGENT,
ext-pk-BCILibraryName=IBMRAC/BCIENGPROB,
ext-pk-probescript=<absolute_path_of_probescript_file>
其中 <absolute_path_of_probescript_file>
是探针的 .probescript 文件的绝对路径(例如
<absolute_path_of_probescript_file> = /home/Project/Probes/myprobe.probescript)。注意,此路径应该指向 .probescript 文件,而不能指向 .probe 文件。
注意:为了方便您阅读,以上选项字符串显示为多行。在命令行上指定该选项字符串时,必须在一行上指定它的所有内容,并且不能嵌入空格。
要让 Probekit 代理程序写日志消息,请在命令行中指定下列选项:
选项 |
描述 |
ext-pk-logFile=<file> |
指定一个文件的名称,Probekit 代理程序将把日志消息写入该文件。
<file> 可以是完整路径和文件名。如果指定了标准错误来代替文件名,就会将日志输出写至标准错误通道。如果未指定此选项,则不会写任何日志输出。 |
ext-pk-logLevel=<level> |
指定要使用的日志记录级别。请参阅下表以了解日志记录级别及其描述。 |
可以指定下列日志记录级别:
级别 |
描述 |
none |
不生成日志输出。 |
severe |
仅记录严重错误(例如无法装入库)。 |
warning |
记录警告消息。这是缺省级别。 |
info |
记录状态消息,例如“正在初始化”。 |
config |
记录配置事件和信息,例如 .probescript 文件的内容。 |
finest |
最大程度地生成日志输出。日志文件将包含 Probekit 代理程序所检测的每个类的名称。 |