監視 Script 的輸出的步驟

配置代理程式以從 Script 資料來源接收資料。

1. 在「代理程式起始資料來源」頁面或「資料來源位置」頁面上，選取監視資料種類區域中的指令或 Script 選項。
2. 在資料來源區域中，按一下 Script 的輸出。
3. 按下一步。
4. 在「指令清單」頁面上，按一下新增以顯示「指令資訊」視窗。
   註： 選取啟用使用 SSH 的資料收集勾選框，會針對此屬性群組啟用 SSH。 如果未選取此勾選框，則會在本端執行屬性群組。

   註： 如果存在可以在 Agent Builder 執行所在之作業系統上執行的指令，則會啟用測試選項。 您可以使用測試來測試您定義的指令。
5. 於「指令資訊」的指令資訊區域中，在指令欄位中鍵入指令名稱以及必要的引數，並在分隔字元欄位中鍵入分隔字元。
   註：

   1. 通常會啟動 Windows 中的 Script，而不必在指令行上指定 .bat 或 .cmd 副檔名。 若為遠端執行，必須安裝 Shell 環境，且您必須在 Script 資料來源指令中指定 .bat 或 .cmd，才能執行 Script。 Cygwin 是可用於 Windows 的 Shell 環境範例。 Linux、Red Hat 及 AIX®。 若要驗證是否存在 Shell 環境，則 SSH 或登入遠端主機，並輸入指令：

      PATH=$PATH:. <command>

      如果指令執行，則存在 Shell 環境。
   2. 使用引號括住名稱，以便指令直譯器不會剖析它。 例如，this is a test.bat 引數會變成：

      "this is a test.bat" 引數

   3. 環境變數與配置變數可以用在使用者提供的 Script 中，但是不能成為啟動 Script 的指令行一部分。 下列變數是此規則的例外情況：

      AGENT_BIN_DIR

      代理程式放置二進位檔或 Script 的目錄

      AGENT_ETC_DIR

      代理程式放置配置檔的目錄

      AGENT_LIB_DIR

      代理程式放置共用程式庫或動態鏈結程式庫的目錄

      CANDLEHOME

      Linux 或 UNIX Tivoli® Monitoring 安裝目錄

      CANDLE_HOME

      Windows Tivoli Monitoring 安裝目錄

   4. 如果使用的是 SSH 資料收集選項，則會相對於使用者在遠端系統上的起始目錄，來執行指令行。 如果將 Script 或執行檔上傳至遠端系統，則同時也會將它們複製到在代理程式的環境變數 CDP_SSH_TEMP_DIRECTORY 中指定的位置。 該位置預設為遠端系統上使用者的起始目錄。 在部分系統上，您可能需要利用相對路徑來定義指令行，例如 ./Script.sh。
6. 在作業系統區域中，選取一或多個作業系統。 使用 SSH 從遠端系統收集資料時，「作業系統」是安裝代理程式所在系統的一項內容。 它不是遠端系統的「作業系統」。 建議您在使用 SSH 資料收集功能時，選取所有作業系統勾選框。
7. 選擇性的： 如果執行指令需要一或多個使用者定義檔案，請按一下「指令檔」區域中的新增，以指定您系統中的檔案。
   檔案會複製到 scripts/operating system 下代理程式的專案資料夾中，其中 operating system 是取決於您在「指令資訊」視窗中所選取內容的變數。 這些檔案也會隨代理程式一起包裝和配送。 如果您想要編輯已新增之指令檔的定義，或者變更其內容，請選取該檔案，並按一下編輯。 請參閱編輯指令檔定義。
8. 按一下確定。 「指令清單」頁面即會顯示。
9. 若要測試指令，請使用下列步驟：
   1. 按一下測試，以開啟指令資訊，並顯示「測試指令」視窗。 若要測試遠端系統上的 Script，請從連線名稱清單中選取系統，或者按一下新增，以新增系統的主機名稱。
   2. 使用「測試指令」視窗，以變更指令、預設分隔字元及屬性分隔字元，並檢視這些變更如何影響所傳回的資料。
      1. 在這些欄位中輸入指令及分隔字元（如果尚未輸入）。
         註： 透過在建立屬性時使用「屬性資訊」視窗，或者透過使用 Agent Edito 來修改現有的屬性，您可以指定其他分隔字元。 如需「代理程式編輯器」的相關資訊，請參閱使用「代理程式編輯器」修改代理程式；如需操作資料來源及屬性的相關資訊，請參閱編輯資料來源及屬性內容
      2. 開始測試之前，您可以設定環境變數及配置內容。 如需相關資訊，請參閱屬性群組測試。
      3. 按一下確定，以回到「測試設定」視窗。
      4. 按一下啟動代理程式。 一個視窗會指出代理程式正在啟動。
      5. 若要模擬來自 Tivoli Enterprise Portal 或 SOAP 的代理程式資料要求，請按一下收集資料。 Agent Builder 會執行您的指令。 如果您已指定遠端系統，請提供使用者 ID 與密碼。 即使回覆碼不是 0，Agent Builder 也會使用與代理程式相同的方式，來剖析指令的結果。
      6. 「測試設定」視窗會收集並顯示自代理程式前次啟動以來，代理程式快取中的全部資料。 屬性的起始名稱是 Attribute_1、Attribute_2 等；不過，您可以透過按一下適當的直欄標題，來修改屬性的內容。
      7. 按一下檢查結果，以檢視指令的回覆碼、未剖析的資料，以及傳回的任何錯誤訊息。
      8. 透過按一下停止代理程式，可以停止代理程式。
      9. 按一下確定，以回到「指令資訊」視窗。

         如果您變更指令或分隔字元，則會更新適當的指令，以反映那些變更。

         如果在您建立 Script 資料來源時此視窗已開啟，則屬性已新增至新的 Script 資料來源。

         如果從現有的 Script 資料來源開啟此視窗，則對屬性所做的任何變更都會作用到 Script 資料來源。 而且會新增任何其他的屬性，但是不會移除任何額外屬性。 這些選項只會影響從 Script 輸出剖析的屬性。 不會影響任何衍生屬性。 如果其中任何屬性根據其所參照的屬性而變成無效，則您可以手動更新或移除衍生屬性。 會顯示衍生屬性公式，而不是實際的結果值。

   註： 如果屬性群組存在，若要啟動測試，請完成下列程序

   1. 在「代理程式編輯器」的「資料來源定義」頁面上選取屬性群組。
   2. 從「指令清單」中選取要測試的 Script
   3. 按一下測試，並遵循步驟 9 中的程序
10. 如果您已跳過步驟 (9) 中的指令測試，請使用下列步驟：
    1. 在具有完整指令資訊的「指令清單」頁面上，按下一步。
    2. 在「屬性資訊」頁面上，使用表 1完成屬性名稱及類型資訊。 選取新增其他屬性，以新增進一步屬性。
    3. 在「屬性資訊」頁面上，使用「Script 屬性資訊」標籤，來選擇此屬性的特定資料分隔字元。
       依預設會選取標準分隔字元 ;。 您可以選擇一些其他分隔字元，如字串、多個字元、定位點或空格。 您亦可以針對資料的開頭與結尾，選擇使用不同的字串分隔字元。 最後，您還可以選擇記錄的其餘部分，以將記錄的其餘部分指派給屬性。 如需 Script 剖析及分隔字元的相關資訊，請參閱 Script 剖析及分隔字元。
11. 執行下列其中一個步驟：
    • 如果您正在使用「代理程式」精靈，請按下一步。
    • 按一下完成，以儲存該資料來源並開啟「代理程式編輯器」。
12. 您可以新增屬性並提供資訊給它們。 如需相關資訊，請參閱建立屬性。
    除了適用於所有資料來源的欄位（如用於定義屬性的欄位及選項所述）之外，Script 資料來源的「資料來源定義」頁面還具有下列選項：

    指令清單

    提供對要在資料收集期間啟動之指令及 Script 的存取權。

    新增

    容許使用者新增要由此屬性群組啟動的指令。

    編輯

    容許使用者編輯現有的輸入指令。

    移除

    容許使用者刪除現有的輸入指令。

    測試

    容許使用者存取此屬性群組的測試環境。

    啟用使用 SSH 的資料收集

    選取此勾選框，會針對此屬性群組啟用 SSH。 如果未選取此勾選框，則會在本端執行屬性群組。

    如需 Script 資料來源之 SSH 遠端連線配置的相關資訊，請參閱配置 Secure Shell (SSH) 遠端連線。