第 9章 SunPlex Agent Builder

本章描述 SunPlex Agent Builder 以及用於 Agent Builder 的 Cluster Agent 模組，它們是自動化資源類型的建立或資料服務的工具，使之可以在資源群組管理員 (RGM) 下執行。 資源類型實際是圍繞應用程式的包裝，以使應用程式在 RGM 控制下的叢集環境中執行。

Agent Builder 將提供一個基於螢幕的介面，以輸入有關應用程式的簡單資訊以及要建立的資源類型種類。 基於所輸入的資訊，Agent Builder 將產生以下軟體：

• 用於故障轉移或可延伸資源類型來源檔集—C shell、Korn shell (ksh) 或 GDS (一般資料服務，對應於資源類型的方法回呼

• 自訂資源類型註冊 (RTR) 檔案 (如果您產生 C shell 來源或 Korn shell 來源)

• 自訂公用程式程序檔與自訂線上援助頁，前者用於啟動、停止以及移除資源類型的實例 (資源)，後者歸檔如何使用其中每個檔案

• Solaris 套件，包含二進位檔 (如果您產生 C 來源)、RTR 檔案 (如果您產生 C shell 來源或 Korn shell 來源) 以及公用程式程序檔

本章中包含以下主題：

• 使用 Agent Builder

• 目錄結構

• 輸出

• 導覽 Agent Builder

• Agent Builder 的 Cluster Agent 模組

使用 Agent Builder

本節描述如何使用 Agent Builder，包含您可以使用 Agent Builder 之前必須完成的作業。 本節還闡述了您在產生資源類型程式碼後可以充分利用 Agent Builder 的方法。

分析應用程式

在使用 Agent Builder 之前，您必須決定應用程式是否符合可使之高度可用或可延伸的條件。 Agent Builder 無法執行這個僅基於應用程式執行時間特性的分析。 分析應用程式的適當性提供有關此主題的更多資訊。

儘管在大多數情況下，Agent Builder 至少會提供一個部分解決方案，但是其不可能總是能夠建立應用程式的完整資源類型。 例如，更複雜的應用程式可能需要 Agent Builder 依預設不會產生的其他程式碼，如對其他屬性加入驗證檢查的程式碼或調諧 Agent Builder 不接觸的參數之程式碼。 在此類情況下，您必須對產生的來源代碼或 RTR 檔案進行變更。 Agent Builder 就恰好是為提供此種靈活性而設計的。

Agent Builder 會將某些點上的註釋置於產生的來源代碼中，您可以從中新增自己的特定資源類型程式碼。 在對來源代碼進行變更後，您可以使用 Agent Builder 產生的 makefile 檔案，以重新編譯來源代碼以及重新產生資源類型套件。

即使您寫入整個資源類型程式碼而未使用任何由 Agent Builder 產生的程式碼，但仍可以利用 Agent Builder 提供的 makefile 檔案與結構，以建立資源類型的 Solaris 套件。

安裝與配置 Agent Builder

Agent Builder 不需要特殊安裝。 Agent Builder 包含在 SUNWscdev 套裝軟體中，此套裝軟體依預設作為標準 Sun Cluster 軟體的一部分安裝 (Sun Cluster 軟體安裝指南 (適用於 Solaris 作業系統)包含更多資訊)。 在使用 Agent Builder 之前，請確認以下資訊：

• 變數 $PATH 中包含 Java，Agent Builder 依靠 Java (Java 開發工具版本 1.3.1 或更高版本)，而如果 Java 不在變數 $PATH 中，則 scdsbuilder 會傳回一條錯誤訊息。

• 您已安裝了 Solaris 8 或更高版本的「開發者系統支援」軟體群組。

• cc 編譯程式包含於變數 $PATH 中，Agent Builder 使用變數 $PATH 中 cc 的第一個事件，以識別透過其產生資源類型的 C 二進制碼的編譯程式。 如果 cc 編譯程式未包含於變數 $PATH 中，Agent Builder 將停用產生 C 程式碼的選項 (請參閱使用 [建立] 畫面。

除了標準 cc 編譯程式，您可以將其他編譯程式與 Agent Builder 搭配使用。 一個方法是在 $PATH 中建立一個從 cc 至其他編譯程式的符號連結 (如 gcc)。 另一個方法是將 makefile 檔案中的編譯程式規格 (目前為 CC=cc) 變更為其他編譯程式的完整路徑。 例如，在 Agent Builder 產生的 makefile 檔案中，將 CC=cc 變更為 CC=pathname/gcc。 在這種情況下，您無法直接執行 Agent Builder，而是必須使用 make 與 make pkg 指令來產生資料服務程式碼與套件。

啟動 Agent Builder

透過輸入以下指令來啟動 Agent Builder：

% /usr/cluster/bin/scdsbuilder

螢幕上會顯示初始 Sun Builder 畫面，如下圖所示。

圖 9–1 初始畫面

如果 GUI 版本不可存取，您可以透過指令行介面存取 Agent Builder (請參閱使用 Agent Builder 的指令行版本)。

Agent Builder 將提供兩個畫面，以指導您完成建立新資源類型的程序：

1. 建立 — 在此畫面上，您將提供有關要建立的資源類型之基本資訊 ，如產生的檔案之名稱與工作目錄 (即在其中建立與配置資源類型範本的目錄)。 您也要識別要建立的資源種類 (可延伸或故障轉移)、基本應用程式是否支援網路 (即是否使用網路與其用戶端通訊) 以及要產生的程式碼類型 (C、ksh 或 GDS)。 如需有關 GDS (一般資料服務) 的資訊，請參閱第 10章, 一般資料服務。 您必須完成此畫面中的資訊，並選取 [建立] 以產生相應的輸出，然後才能顯示 [配置] 畫面。

2. 配置 — 在此畫面上，將要求您提供啟動應用程式的指令。 您可以選擇性地提供停止與探測應用程式的指令。 如果您未指定這些指令，產生的輸出將使用訊號來停止應用程式，並提供預設探測機制 (請參閱使用 [配置] 畫面中 probe 指令的說明)。 此畫面還可讓您變更這三個指令中每一個的逾時值。

如果您從現有資源類型的工作目錄啟動 Agent Builder，Agent Builder 會將 [建立] 畫面與 [配置] 畫面初始化為現有資源類型的值。

如果您對如何使用其中一個 Agent Builder 畫面上的任何按鈕或功能表指令有疑問，請參閱導覽 Agent Builder。

使用 [建立] 畫面

建立資源類型的第一步是填寫 [建立] 畫面，此畫面在您啟動 Agent Builder 時顯示。 下圖將說明您在欄位中輸入資訊之後的 [建立] 畫面。

圖 9–2 [建立] 畫面

[建立] 畫面包含以下欄位、單選按鈕以及核取方塊：

• 供應商名稱 — 識別資源類型供應商的名稱。 您通常要指定供應商的證券代號，但可唯一識別供應商的任何名稱均有效。 僅使用字母數字字元。

• 應用程式名稱 — 資源類型的名稱。 僅使用字母數字字元。

  ---

  註解 –

  供應商名稱與應用程式名稱共同構成了資源類型的完整名稱。 完整名稱不得超出 9 個字元。

  ---

• 工作目錄 — Agent Builder 可在其下建立一個包含為目標資源類型建立的所有檔案之目錄結構的目錄。 您可以在任何一個工作目錄中僅建立一個資源類型。 儘管您可以鍵入其他名稱或使用 [瀏覽] 按鈕來尋找其他目錄，但是 Agent Builder 仍會將此欄位初始化為您從中啟動了 Agent Builder 的目錄之路徑。

  在工作目錄下，Agent Builder 將會建立一個使用資源類型名稱的子目錄。 例如，如果 SUNW 是供應商名稱而 ftp 是應用程式名稱，則 Agent Builder 將命名此子目錄 SUNWftp。

  Agent Builder 會將目標資源類型的所有目錄與檔案都置於此子目錄下 (請參閱目錄結構)。

• 可延伸或故障轉移 — 指定目標資源類型將為故障轉移還是可延伸。

• 支援網路 — 指定基本應用程式是否為支援網路；即基本應用程式是否使用網路與其用戶端進行通訊。 核取此方塊可以指定支援網路；保持為空白可以指定不支援網路。 Korn shell 程式碼需要應用程式為支援網路的應用程式。 因此，如果您核取了 [ksh] 或 [GDS] 按鈕，Agent Builder 將核取此方塊，並使其成為灰階。

• C、ksh — 指定所產生來源代碼的語言。 儘管這些選項彼此相互獨立，但透過 Agent Builder，您可以建立具有 ksh 產生程式碼的資源類型，然後重複使用相同資訊以建立 C 產生程式碼 (請參閱複製現有的資源類型)。

• GDS — 指定此服務為一般資料服務。 請參閱第 10章, 一般資料服務，以取得有關建立與配置一般資料服務的資訊。

如果 cc 編譯程式不在 $PATH 中，Agent Builder 會使 [C] 選項按鈕成為灰階，而核取 [ksh] 按鈕。 若要指定其他編譯程式，請參閱安裝與配置 Agent Builder結尾處的說明。

在您輸入了所需資訊之後，請按一下 [建立] 按鈕。 畫面底部的 [輸出登錄] 說明 Agent Builder 正在執行的動作。 您可以使用 [編輯] 功能表中的 [儲存輸出登錄] 指令，以儲存輸出登錄中的資訊。

完成時，Agent Builder 將會顯示一條成功訊息或無法完成此步驟的警告訊息，而您應檢查輸出登錄以取得詳細資訊。

如果 Agent Builder 成功地完成了此步驟，您可以按一下 [下一步] 按鈕來帶出 [配置] 畫面，此畫面可讓您完成產生資源類型。

儘管產生完整的資源類型需要兩個步驟，但您可以在完成第一個步驟 (建立) 之後結束Agent Builder，而不會遺失您已輸入的資訊或 Agent Builder 已完成的工作 (請參閱重複使用完成的工作)。

使用 [配置] 畫面

如下圖所示，在 Agent Builder 完成資源類型的建立且您選取了 [建立] 畫面上的 [下一步] 按鈕之後，螢幕上將顯示 [配置] 畫面。 您無法在已建立資源類型之前存取 [配置] 畫面。

圖 9–3 [配置] 畫面

[配置] 畫面包含以下欄位：

• Start 指令 — 可傳送至任何 UNIX shell 以啟動基本應用程式的完整指令行。 您必須指定此指令。 您可以在提供的欄位中鍵入該指令或使用 [瀏覽] 按鈕尋找包含該指令的檔案，以啟動應用程式。

  完整指令行必須包含啟動應用程式所必需的所有項目，如主機名稱、通訊埠編號以及配置檔案的路徑等。 如果應用程式需要在指令行上指定的主機名稱，則您可以使用 Agent Builder 定義的變數 $hostnames (請參閱使用 Agent Builder $hostnames 變數)。

  不要對指令加上雙引號 (““)。

  ---

  註解 –

  如果基本應用程式具有多個獨立的程序樹，其中每一個都在 PMF 控制下以其自己的標籤開始，則您無法指定單一指令。 相反，您必須建立一個具有個別指令的文字檔案，以啟動每個程序樹，並在 [Start 指令] 文字欄位中指定該檔案的路徑。 請參閱建立具有多個獨立程序樹的資源類型，其中列出了該檔案正常工作需要的某些特殊特性。

  ---

• Stop 指令 — 可傳送至任何 UNIX shell 以停止基本應用程式的完整指令行。 您可以在提供的欄位中鍵入該指令或使用 [瀏覽] 按鈕尋找包含該指令的檔案，以停止應用程式。 如果應用程式需要在指令行上指定的主機名稱，則您可以使用 Agent Builder 定義的變數 $hostnames (請參閱使用 Agent Builder $hostnames 變數)。

  此指令是可選用的。 如果您不指定 stop 指令，則產生的程式碼將使用訊號 (位於 Stop 方法中) 來停止應用程式，如下所示。

  • Stop 方法傳送 SIGTERM 以停止應用程式，並等待逾時值 80% 的時間以結束應用程式。

  • 如果 SIGTERM 訊號失敗，則 Stop 方法將傳送 SIGKILL 以停止應用程式，並等待逾時值 15% 的時間以結束應用程式。

  • 如果 SIGKILL 訊號失敗，則 Stop 方法將會以失敗狀態結束 (剩下的 5% 的逾時值被視為額外消耗的時間)。

  ---

  小心 –

  確定在應用程式完全停止之前 stop 指令不會傳回。

  ---

• Probe 指令 — 一個指令，可以定期執行，以檢查應用程式的運作狀況並傳回一個 0 (成功) 與 100 (完全故障) 之間的適當退出狀況。 此指令是可選用的。 您可以鍵入該指令的完整路徑或使用 [瀏覽] 按鈕尋找包含該指令的檔案，以探測應用程式。

  一般您將指定基本應用程式的簡單用戶端。 如果您未指定 probe 指令，產生的程式碼會僅連接至資源所使用的通訊埠並僅從該通訊埠斷開連接，如果成功，則會宣告應用程式狀態良好。 您僅可以對支援網路的應用程式使用 probe 指令。 Agent Builder 總是產生 probe 指令，但是對不支援網路的應用程式停用該指令。

  如果應用程式需要您在 probe 指令行上指定主機名稱，則您可以使用 Agent Builder 定義的變數 $hostnames (請參閱使用 Agent Builder $hostnames 變數)。

• 逾時 — (對於每一個指令)—每一個指令的逾時值 (以秒為單位)。 您可以指定一個新值，或接受 Agent Builder 提供的預設值 (對於啟動與停止為 300 秒，對於探測為 30 秒)。

使用 Agent Builder $hostnames 變數

對於許多應用程式，特別是支援網路的應用程式，您必須透過指令行將應用程式偵聽與服務客戶要求的主機名稱傳送至應用程式。 因此，在許多情況下，主機名稱是您必須為目標資源類型 (位於 [配置] 畫面) 的 start、stop 以及 probe 指令指定的參數。 然而，應用程式透過其進行偵聽的主機名稱是叢集特定的主機名稱 — 當在叢集上執行資源時可以決定該主機名稱，而當 Agent Builder 產生資源類型程式碼時無法決定該主機名稱。

為了解決此問題，Agent Builder 將在指令行上提供您可以為 start 指令、stop 指令以及 probe 指令指定的變數 $hostnames。 請將 $hostnames 變數準確地指定為實際主機名稱，例如：

/opt/network_aware/echo_server -p port_no -l $hostnames

當在叢集上執行目標資源類型的資源時，為該資源配置的主機名稱 LogicalHostname 或 SharedAddress (資源的 Network_resources_used 資源屬性中) 將會為變數 $hostnames 的值取代。

如果您配置 Network_resources_used 屬性具有多個主機名稱，則變數 $hostnames 將包含所有主機名稱，名稱之間以逗號分隔。

建立具有多個獨立程序樹的資源類型

Agent Builder 可以為應用程式建立具有多個獨立程序樹的資源類型。 在 PMF 個別監視與啟動這些程序樹來看，它們是獨立的。 PMF 透過每個程序樹自己的標籤來啟動它。

僅當指定的產生來源代碼為 C 時，Agent Builder 才可讓您建立具有多個獨立程序樹的資源類型。您無法使用 Agent Builder 來為 ksh 或 GDS 建立這些資源類型。 若要為 ksh 或 GDS 建立這些資源類型，您必須手動寫入程序碼。

至於具有多個獨立程序樹的基本應用程式，您無法指定一個單一指令行來啟動該應用程式。 相反，您必須建立一個文字檔案，透過指定指令完整路徑的每一行，來啟動其中一個應用程式的程序樹。 該檔案不得包含任何空白行。 您在 [配置] 畫面的 [Start 指令] 文字欄位中指定該文字檔案。

確保此檔案沒有執行權限可讓 Agent Builder 辨別此檔案與包含多個的簡單可執行程序檔，其目的是啟動多個程序樹。 如果該文字檔案給定了執行權限，則資源將會在叢集上啟動且不會出現問題或錯誤，但所有的指令將會在一個 PMF 標籤下啟動，以防止 PMF 個別監視與重新啟動程序樹。

重複使用完成的工作

Agent Builder 可讓您以多種方法利用完成的工作。

• 您可以複製使用 Agent Builder 建立的現有資源類型。

• 您可以編輯 Agent Builder 產生的來源代碼，然後重新編譯該代碼以建立一個新的套件。

複製現有的資源類型

依照此程序複製 Agent Builder 產生的現有資源類型。

1. 將現有資源類型載入 Agent Builder。 您可以透過以下兩種方法其中之一來完成此作業：

   1. 從 (使用 Agent Builder 建立) 現有資源類型的工作目錄 (其包含 rtconfig 檔案) 啟動 Agent Builder，Agent Builder 將在 [建立] 畫面與 [配置] 畫面中載入該資源類型的值。

   2. 使用 [檔案] 功能表中的 [載入資源類型] 指令。

2. 變更 [建立] 畫面上的工作目錄。

   您必須使用 [瀏覽] 按鈕來選取目，鍵入新的目錄名稱是不夠的。 在您選取目錄之後，Agent Builder 將重新啟用 [建立] 按鈕。

3. 進行變更。

   您可以使用此程序來變更為資源類型產生的程式碼之類型。 例如，如果您初始建立 ksh 版本的資源類型，但稍後發現需要 C 版本，您可以載入現有的 ksh 資源類型，變更輸出語言為 C，然後使 Agent Builder 建立 C 版本的資源類型。

4. 建立複製的資源類型。

   選取 [建立] 以建立資源類型。 選取 [下一步] 以帶出 [配置] 畫面。 選取 [配置] 以配置資源類型，然後選取 [取消] 以完成。

編輯產生的來源代碼

若要使建立資源類型的程序保持簡單，Agent Builder 將會限制輸入的數目，此數目會必要地限制所產生資源類型的範圍。 因此，若要新增更複雜的功能 (如其他屬性的驗證檢查) 或調諧 Agent Builder 不接觸的參數，您需要修改產生的來源代碼或 RTR 檔案。

來源檔位於 install_directory /rt_name/src 目錄中。 Agent Builder 將在可新增程式碼的位置內嵌入來源代碼的註釋。 這些註釋的格式為 (對於 C 程式碼)：

/* User added code -- BEGIN vvvvvvvvvvvvvvv */
/* User added code -- END   ^^^^^^^^^^^^^^^ */

除了使用英鎊符號 (#) 來開始註釋行外，這些註釋的 Korn shell 程式碼完全相同。

例如，rt_name.h 宣告不同程式使用的所有公用程式常式。 在宣告清單結尾處是可讓您宣告其他常式 (您可能已將其加入至某程式碼) 的註釋。

Agent Builder 也會在 install_directory/rt_name/src 目錄中產生具有適當目標的 makefile 檔案。 使用 make 指令重新編譯源代碼；使用 make pkg 指令重新產生資源類型套裝軟體。

RTR 檔案位於 install_directory/ rt_name/etc 目錄中。 您可以使用標準文字編輯程式編輯 RTR 檔案 (請參閱設定資源屬性和資源類型屬性以取得有關 RTR 檔案的詳細資訊；請參閱附錄 A, 標準屬性以取得有關屬性的資訊)。

使用 Agent Builder 的指令行版本

Agent Builder 的指令行版本與圖形使用者介面具有相同的兩個步驟程序。 然而，您不是在圖形使用者介面中輸入資訊，而是將參數傳送至 scdscreate(1HA) 與 scdsconfig(1HA)。

依照以下步驟使用 Agent Builder 的指令行版本：

1. 使用 scdscreate 建立 Sun Cluster 資源類型範本，以使應用程式高度可用 (HA) 或可延伸。

2. 使用 scdsconfig 配置您使用 scdscreate 建立的資源類型範本。

3. 將目錄變更為工作目錄中的 pkg 子目錄。

4. 使用 pkgadd(1M) 指令安裝您使用 scdscreate 建立的套裝軟體。

5. 如果需要，請編輯產生的來源代碼。

6. 執行啟動程序檔。

目錄結構

Agent Builder 將建立一個目錄結構以儲存其為目標資源類型產生的所有檔案。 您要指定 (在 [建立] 畫面上) 工作目錄。 您必須為開發的任何其他資源類型指定單獨安裝目錄。 在工作目錄下，Agent Builder 將建立一個子目錄，其名稱由供應商名稱與資源類型名稱 (位於 [建立] 畫面) 串接而成。 例如，如果您指定 SUNW 作為供應商名稱，並建立名為 ftp 的資源類型，則 Agent Builder 將會在工作目錄下建立一個名為 SUNWftp 的目錄。

在此子目錄下，Agent Builder 將建立並植入下表列出的目錄。

輸出

本節說明了 Agent Builder 產生的輸出。

來源檔與二進位檔

管理資源群組並最終管理叢集上資源的資源群組管理員 (RGM) 在回呼模型上工作。 當發生特定事件 (如節點故障) 時，RGM 將為每個在受影響節點上執行的資源呼叫資源類型的方法。 例如，RGM 將呼叫 Stop 方法以停止正在受影響節點上執行的資源，然後呼叫資源的 Start 方法以在其他節點上啟動資源。 (請參閱RGM 模型、回呼方法以及 rt_callbacks(1HA) 線上援助頁，以取得有關此模型的詳細資訊。)

為了支援此模型，Agent Builder 將 (在 install_directory/rt_name/bin 目錄中) 產生 8 個作為回呼方法的可執行程式 (C) 或程序檔 (ksh)。

嚴格地說，實施故障監視器的 rt_name _probe 程式不是回呼程式。 RGM 不會直接呼叫 rt_name _probe，但會呼叫 rt_name_monitor_start 與 rt_name_monitor_stop，其透過呼叫 rt_name_probe 來啟動與停止故障監視器。

Agent Builder 產生的 8 個方法為：

• rt_name_monitor_check

• rt_name_monitor_start

• rt_name_monitor_stop

• rt_name_probe

• rt_name_svc_start

• rt_name_svc_stop

• rt_name_update

• rt_name_validate

請參閱 rt_callbacks(1HA) 線上援助頁，以取得有關這其中每個方法的特定資訊。

在 install_directory/rt_name/src 目錄 (C 輸出) 中，Agent Builder 產生以下檔案：

• 標頭檔案 (rt_name.h)。

• 包含所有方法共用程式碼的來源檔 (rt_name.c)。

• 共用程式碼的物件檔 (rt_name.o)。

• 每個方法的來源檔 (*.c)。

• 每個方法的物件檔 (*.o)。

Agent Builder 將連結 rt_name.o 檔案至每個方法 .o 檔案，以在 install_directory/rt_name/bin 目錄中建立可執行檔。

對於 ksh 輸出，install_directory /rt_name/bin 目錄與 install_directory/rt_name/src 目錄完全相同，各包含八個可執行程序檔，對應於七個回呼方法和 PROBE 方法 。

ksh 輸出包含兩個編譯的公用程式 (gettime 與 gethostnames)，某些回呼方法這些程式來取得時間與進行探測。

您可以編輯源代碼，執行 make 指令重新編譯代碼，完成時可以執行 make pkg 指令來產生一個新的套裝軟體。 為了支援對來源代碼進行變更，Agent Builder 會在可加入程式碼的適當位置嵌入來源代碼的註釋。 請參閱編輯產生的來源代碼。

公用程式程序檔與線上援助頁

一旦您產生了資源類型並在叢集上安裝了資源類型的套件，則您仍必須取得正在叢集上執行的資源類型之實例 (資源)，一般透過使用管理指令或 SunPlex Manager 來完成此作業。 然而，為了方便，Agent Builder 將產生一個用於此目的的自訂公用程式程序檔 (啟動程序檔) 以及用於停止與移除目標資源類型的資源之程序檔。 這三個位於 install_directory /rt_name/util 目錄中的程序檔將執行以下作業：

• 啟動程序檔 — 註冊資源類型、建立必要的資源群組與資源。 該程序檔還將建立網路位址資源 (LogicalHostname 或 SharedAddress)，此資源可讓應用程式透過網路與用戶端進行通訊。

• 停止程序檔 — 停止與停用資源。

• 移除程序檔 — 還原啟動程序檔的工作，即該程序檔將停止與移除資源、資源群組以及系統的目標資源類型。

您僅可以對透過相應啟動程序檔啟動的資源使用移除程序檔，因為這些程序檔使用內部慣例來命名資源與資源群組。

Agent Builder 透過將應用程式名稱附加至程序檔名稱來命名這些程序檔。 例如，如果應用程式名稱為 ftp，則程序檔將稱為 startftp、stopftp 以及 removeftp。

Agent Builder 將提供每一個公用程式程序檔在 install_directory/rt_name/man/man1m 目錄中的線上援助頁。 在啟動這些程序檔之前您應該讀取這些線上援助頁，因為這些線上援助頁將歸檔您需要傳送至程序檔的參數。

若要檢視這些線上援助頁，請搭配使用 -M 選項與 man 指令來指定該線上援助頁目錄的路徑。 例如，如果 SUNW 是供應商名稱，而 ftp 是應用程式名稱，則請使用以下指令來檢視 startftp(1M) 線上援助頁：

man -M install_directory/SUNWftp/man startftp

叢集管理員也可使用線上援助頁公用程式程序檔。 在叢集上安裝 Agent Builder 產生的套件時，公用程式程序檔的線上援助頁將置於 /opt/ rt_name/man 目錄中。 例如，使用以下指令來檢視 startftp(1M) 線上說明手冊：

man -M /opt/SUNWftp/man startftp

支援檔案

Agent Builder 將支援檔案 (如pkginfo、postinstall、postremove 以及 preremove) 置於 install_directory/rt_name/etc 目錄中。 該目錄還包含資源類型註冊 (RTR) 檔案，此檔案宣告可用於目標資源類型的資源與資源類型屬性，並在使用叢集註冊資源時初始化屬性值 (請參閱設定資源屬性和資源類型屬性以取得詳細資訊)。 RTR 檔案的命名為 vendor_name.resource_type_name， 例如 SUNW.ftp。

您可以使用標準文字編輯程式編輯此檔案並進行變更，而無需重新編譯來源代碼。 然而，您必須使用 make pkg 指令重新建立套件。

套件目錄

install_directory/rt_name/pkg 目錄包含 Solaris 套件。 套件的名稱是供應商名稱與應用程式名稱的串接，例如，SUNWftp。 install_directory/rt_name/src 目錄中的 Makefile 支援建立新套件。 例如，如果您變更來源檔並重新編譯程式碼，或變更套件公用程式程序檔，請使用 make pkg 指令來建立新套件。

當您從叢集移除套件時，如果您嘗試同時從多個節點執行指令 pkgrm，則該指令可能會失敗。 您可以透過以下兩種方法之一來解決此問題：

• 在從任何節點執行 pkgrm 之前，從叢集的某一個節點執行 removert_name 程序檔。

• 從叢集的某一個節點執行 pkgrm (其處理所有必要的清除)，如有必要，然後同時從剩餘的節點執行 pkgrm。

如果由於您嘗試同時從多個節點執行 pkgrm 而導致該指令失敗，請再次從一個節點執行此指令，然後再從剩餘的節點執行它。

rtconfig 檔案

如果您在工作目錄中產生 C 來源代碼或 ksh 來源代碼，Agent Builder 將會產生配置檔案 rtconfig，該檔案包含您在 [建立] 畫面與 [配置] 畫面上輸入的資訊。 如果您從現有資源類型的工作目錄啟動 Agent Builder (或使用 [檔案] 功能表中的 [載入資源類型] 指令載入現有的資源類型)，Agent Builder 將讀取 rtconfig 檔案，並使用您為現有資源類型提供的資訊填寫 [建立] 畫面與 [配置] 畫面。 如果您要複製現有資源類型， 則此功能將非常有用 (請參閱複製現有的資源類型)。

導覽 Agent Builder

導覽 Agent Builder 簡單而且直觀。 Agent Builder 是一個兩個步驟的精靈，每個步驟都具有一個對應的畫面 ([建立] 畫面與 [配置] 畫面)。 您可以透過以下方式在每個畫面中輸入資訊：

• 在欄位中鍵入資訊。

• 瀏覽目錄結構並選取檔案或目錄。

• 核取一組互斥單選按鈕的其中一個，例如 [可延伸] 單選按鈕或 [故障轉移] 單選按鈕。

• 核取 [開啟/關閉] 方塊。 例如，核取 [支援網路] 識別基本應用程式為支援網路的應用程式，而保留此方塊為空識別不支援網路的應用程式。

每個畫面底部的按鈕都可讓您完成作業，移至下一個畫面或上一個畫面，或結束 Agent Builder。 Agent Builder 將適當地反白顯示這些按鈕或使這些按鈕成為灰階。

例如，當您填寫了 [建立] 畫面上的欄位並核取了所需的選項後，請按一下畫面底部的 [建立] 按鈕。 由於不存在上一個畫面，並且您在完成此步驟之前無法移至下一步，因此 [上一步] 按鈕與 [下一步] 按鈕將顯示為灰階。

Agent Builder 在畫面底部的輸出登錄區域中顯示進度訊息。 當 Agent Builder 完成時，它會顯示一條成功訊息，或顯示一條警告訊息來查看輸出登錄。 [下一步] 按鈕將反白顯示，或如入該畫面是最後一個畫面，則僅 [取消] 按鈕將反白顯示。

您可以隨時選取 [取消] 以結束 Agent Builder。

[瀏覽] 按鈕

特定的 Agent Builder 欄位可讓您鍵入資訊或按一下 [瀏覽] 按鈕，以瀏覽目錄結構並選取檔案或目錄。

當您按一下 [瀏覽]，螢幕上將會顯示一個與以下畫面相似的畫面：

按兩下資料夾以開啟它。 當您反白顯示檔案時，其名稱會顯示在 [檔案名稱] 方塊中。 當您找到並反白顯示適當的檔案後，請按一下 [選取]。

如果您正在瀏覽目錄，請將其反白顯示並選取 [開啟] 按鈕。 如果沒有子目錄，Agent Builder 將會關閉瀏覽視窗，並將反白顯示的目錄名稱置於適當的欄位中。 如果該目錄具有子目錄，請按一下 [關閉] 按鈕，以關閉瀏覽視窗並返回上一個畫面。 Agent Builder 會將反白顯示的目錄名稱置於適當的欄位中。

畫面右上角的圖示將執行以下作業：

功能表

Agent Builder 提供 [檔案] 功能表與 [編輯] 功能表。

[檔案] 功能表

[檔案] 功能表具有兩個指令：

• 載入資源類型 — 載入現有的資源類型。 Agent Builder 提供一個瀏覽畫面，從該畫面您可以選取現有資源類型的工作目錄。 如果您啟動 Agent Builder 的目錄中存在資源類型，Agent Builder 將會自動載入該資源類型。 [載入資源類型] 指令允許您從任何目錄啟動 Agent Builder，並允許選取現有資源類型作為建立新資源類型的範本 (請參閱複製現有的資源類型)。

• 結束 — 結束 Agent Builder。 您也可以透過按一下 [建立] 畫面或 [配置] 畫面上的 [取消] 來結束。

[編輯] 功能表

[編輯] 功能表具有清除與儲存輸出登錄的指令：

• 清除輸出登錄 — 清除輸出登錄中的資訊。 每當您選取 [建立] 畫面或 [配置] 畫面時，Agent Builder 均會將狀況訊息附加至輸出登錄。 如果您正在進行反覆程序 (該程序可用於對來源代碼進行變更並在 Agent Builder 中重新產生輸出) 並要分離狀況訊息，您可以在每次使用日誌檔前儲存與清除日誌檔。

• 儲存日誌檔 — 將日誌輸出儲存至檔案。 Agent Builder 提供一個可讓您選擇目錄與指定檔案名稱的瀏覽畫面。

Agent Builder 的 Cluster Agent 模組

用於 Agent Builder 的 Cluster Agent 模組是一個 NetBeans^TM 模組。 Cluster Agent 模組可讓 Sun Java Studio (以前為 Sun ONE Studio) 產品的使用者透過整合式開發環境為 Sun Cluster 軟體建立資源類型或資料服務。 Agent Builder 提供一個基於螢幕的介面，用於說明您要建立的資源類型種類。

Sun Java Studio documentation 包含有關如何設定、安裝與使用 Sun Java Studio 產品的資訊。

安裝與設定 Cluster Agent 模組

Cluster Agent 模組在安裝 Sun Cluster 軟體時安裝。 Sun Cluster 安裝工具會將 Cluster Agent 模組檔案 scdsbuilder.jar 置於 /usr/cluster/lib/scdsbuilder 中。 為了將 Cluster Agent 模組與 Sun Java Studio 軟體配合使用，您需要建立一個此檔案的符號連結。

您必須安裝 Sun Cluster 與 Sun Java Studio 產品以及 Java^TM 1.4，且它們必須可用於您要在其上執行 Cluster Agent 模組的系統。

1. 您要使所有使用者均可以使用 Cluster Agent 模組還是僅使您自己可以使用？

   • 若要使所有使用者均可使用 Cluster Agent 模組，請成為超級使用者或假定一個對等的角色，並在全域模組目錄中建立符號連結：

     # cd /opt/s1studio/ee/modules # ln -s /usr/cluster/lib/scdsbuilder/scdsbuilder.jar

     ---

     註解 –

     如果您是在 /opt/s1studio/ee 目錄之外的目錄中安裝了 Sun Java Studio 軟體，請以您使用的路徑來取代此目錄路徑。

     ---

   • 若要僅使自己可使用 Cluster Agent 模組，請在 modules 子目錄中建立符號連結：

     % cd ~your-home-dir/ffjuser40ee/modules % ln -s /usr/cluster/lib/scdsbuilder/scdsbuilder.jar

2. 停止與重新啟動 Sun Java Studio 軟體。

啟動 Cluster Agent 模組

以下步驟描述如何從 Sun Java Studio 軟體啟動 Cluster Agent 模組。

1. 從 Sun Java Studio [檔案] 功能表，選取 [新增]，或按一下工具列上的此圖示：

   螢幕上將顯示 [新增精靈] 畫面。

2. 在 [選取範本] 視窗中，請向下捲動 (如有必要) 並按一下 [其他] 資料夾旁的鍵：

   [其他] 功能表將開啟。

3. 從 [其他] 功能表，選取 [Sun Cluster Agent Builder]，並按一下 [下一步]。

   Sun Java Studio 的 Cluster Agent 模組將會啟動。 第一個 [新增精靈 - Sun Cluster Agent Builder] 畫面將會出現。

使用 Cluster Agent 模組

請以使用 Agent Builder 軟體的相同方式使用 Cluster Agent 模組。 介面完全相同。 例如，下圖說明 Agent Builder 中的 [建立] 畫面與 Cluster Agent 模組中的第一個 [新增精靈 - Sun Cluster Agent Builder] 畫面包含相同的欄位與選取。

圖 9–4 Agent Builder 軟體中的 [建立] 畫面

圖 9–5 Cluster Agent 模組中的 [新增精靈 - Sun Cluster Agent Builder] 畫面

Cluster Agent 模組與Agent Builder 之間的差異

儘管 Cluster Agent 模組與 Agent Builder 之間存在相似性，但也存在微小差異：

• 在 Cluster Agent 模組中，僅當您按一下第二個 [新增精靈 - Sun Cluster Agent Builder] 畫面上的 [完成] 之後，才會建立與配置資源類型。 當您按一下第一個 [新增精靈 - Sun Cluster Agent Builder] 畫面上的 [下一步] 時，資源類型將不會建立。

  在 Agent Builder 中，當您按一下 [建立] 畫面上的 [建立] 時，將會立即建立資源類型，而當您按一下 [配置] 畫面上的 [配置] 時，將會立即配置資源類型。

• 顯示在 Agent Builder 的 [輸出登錄] 視窗中的資訊將會顯示在 Sun Java Studio 產品的獨立輸出視窗中。