本節提供逐步指示,說明在 AIX® 系統上以獨立模式使用 Probekit。
若要以獨立模式來使用 Probekit,目標系統上必須安裝 Agent Controller。Agent Controller 會自動安裝資料收集代理程式和 Probekit 的延伸程式庫。
請遵循下列步驟,以獨立模式使用 Probekit 來執行應用程式:
- 匯入探測或在工作台建置探測。
- 在探測定義中,加入特殊目標規格,請參閱在獨立式 Probekit 的探測中指定目標。
- 將整個探測檔複製到目標機器上的資料夾。
如果使用多個探測,請將 probescript 檔案的內容合併成一個 probescript 檔案。
- 將含有探測檔的資料夾新增至目標機器的類別路徑。
- 將 RAC 程式庫資料夾和 Probekit 外掛程式資料夾新增至目標機器的 LIBPATH 環境變數:
<racInstallDir>/lib
<racInstallDir>/plugins/org.eclipse.hyades.probekit/lib
- 將下列選項字串新增至程式啟動指令行:
-XrunpiAgent:server=standalone,
mode=none,
extensionLibrary=ProbeAgentExtension.so,
ext-pk-BCILibraryName=BCIEngProbe.so,
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> 可以是完整路徑和檔名。
如果您指定 standard error 而非檔名,日誌輸出將會寫到標準錯誤通道中。
如果不指定這個選項,則不會寫入日誌輸出。 |
ext-pk-logLevel=<level> |
指定您要使用的日誌記載層次。關於日誌記載層次及說明,請參閱下表。 |
您可以指定下列日誌記載層次:
層次 |
說明 |
none |
不產生日誌輸出。 |
severe |
僅記載嚴重錯誤,例如無法載入程式庫。 |
warning |
記載警告訊息。這是預設層次。 |
info |
記載狀態訊息,例如「正在起始設定」。 |
config |
記載配置事件和資訊,例如 .probescript 檔案的內容。 |
finest |
產生最多日誌輸出。日誌檔包含 Probekit 代理程式監控的每一個類別的名稱。 |