在 Microsoft Windows 上以獨立模式使用 Probekit

Windows 平台圖示本節提供逐步指示,說明在 Microsoft® Windows® 系統上以獨立模式使用 Probekit。

若要以獨立模式來使用 Probekit,目標系統上必須安裝 Agent Controller。Agent Controller 會自動安裝資料收集代理程式和 Probekit 的延伸程式庫。

請遵循下列步驟,以獨立模式使用 Probekit 來執行應用程式:

  1. 匯入探測或在工作台建置探測。
  2. 在探測定義中,加入特殊目標規格,請參閱在獨立式 Probekit 的探測中指定目標
  3. 將整個探測檔複製到目標機器上的資料夾。 如果使用多個探測,請將 probescript 檔案的內容合併成一個 probescript 檔案。
  4. 將含有探測檔的資料夾新增至目標機器的類別路徑。
  5. 將 RAC 程式庫資料夾和 Probekit 外掛程式資料夾新增至目標機器的路徑:
    <racInstallDir>\bin
    <racInstallDir>\plugins\org.eclipse.hyades.probekit\lib
  6. 將下列選項字串新增至程式啟動指令行:
    -XrunpiAgent:server=standalone,
    mode=none,
    extensionLibrary=ProbeAgentExtension.dll,
    ext-pk-BCILibraryName=BCIEngProbe.dll,
    ext-pk-probescript=<absolute_path_of_probescript_file>
    其中 <absolute_path_of_probescript_file> 是探測 .probescript 檔的絕對路徑。(例如,<absolute_path_of_probescript_file> = D:\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 代理程式監控的每一個類別的名稱。