第 9 章 SunPlex Agent Builder

本章說明 SunPlex Agent Builder 及用於 Agent Builder 的 Cluster Agent 模組。這兩種工具將會自動建立將在 Resource Group Manager (RGM) 的控制下執行的資源類型或資料服務。資源類型是應用程式的包裝程式，可讓該應用程式在叢集環境中在 RGM 的控制之下執行。

本章涵蓋下列主題：

• Agent Builder 簡介

• 使用 Agent Builder 之前

• 使用 Agent Builder

• Agent Builder 建立的目錄結構

• Agent Builder 輸出

• Agent Builder 的 Cluster Agent 模組

Agent Builder 簡介

Agent Builder 將提供一個圖形化使用者介面 (GUI)，以指定有關應用程式的資訊以及要建立的資源類型。Agent Builder 同時支援支援網路的應用程式和不支援網路的應用程式。支援網路的應用程式使用網路與用戶端進行通訊。不支援網路的應用程式為獨立應用程式。

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

基於您指定的資訊，Agent Builder 將產生以下軟體︰

• 一組 C 、Korn shell (ksh) 或通用資料服務 (GDS) 原始碼檔案，用於容錯移轉或可延伸式資源類型 (符合資源類型的方法回呼)。這些檔案同時適用於支援網路 (主從式模型) 的應用程式和不支援網路 (無用戶端) 的應用程式。

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

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

• Solaris 套裝軟體，包含二進位檔 (如果您產生 C 原始碼) 和 RTR 檔案 (如果您產生 C 原始碼或 Korn shell 原始碼)，以及公用程式程序檔。

Agent Builder 也可讓您產生應用程式的資源類型，該資源類型具有程序監視設備 (PMF) 必須個別監視與重新啟動的多個獨立程序樹。

使用 Agent Builder 之前

使用 Agent Builder 之前，您需要瞭解如何建立具有多個獨立程序樹的資源類型。

Agent Builder 可以建立具有多個獨立程序樹的應用程式資源類型。就 PMF 對程序樹進行單獨監視並啟動來說，這些程序樹是獨立的。PMF 使用每個程序樹自己的標記來啟動程序樹。

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

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

確保該檔案不具有執行許可權以使 Agent Builder 可以辨別該檔案。該檔案用於從包含多個指令的簡單可執行程序檔中啟動多個程序樹。如果為該文字檔提供執行許可權，則資源在叢集上不會遇到問題或發生錯誤。然而，所有指令均在一個 PMF 標記下啟動。因此，PMF 無法單獨監視並重新啟動各程序樹。

使用 Agent Builder

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

本章討論下列主題︰

• 分析應用程式

• 安裝與配置 Agent Builder

• Agent Builder 螢幕

• 啟動 Agent Builder

• 導覽 Agent Builder

• 使用 [建立] 畫面

• 使用 [配置] 畫面

• 使用 Agent Builder 基於 Korn Shell 的 $hostnames 變數

• 使用特性變數

• 重複使用使用 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 之前，請確認以下需求︰

• Java 執行階段環境包含在 $PATH 變數中。Agent Builder 附屬於 Java Development Kit 版本 1.3.1 或更高版本。如果在 $PATH 變數中不包含 Java Development Kit，則將會傳回 Agent Builder 指令 (scdsbuilder)，並顯示錯誤訊息。

• 您已安裝了 Developer System Support 軟體群組，Solaris 8 作業系統版本或更高版本。

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

您可以將其他編譯器與 Agent Builder 一起使用，來替代標準 cc 編譯器。若要使用其他編譯器， 請在 $PATH 中建立一個從 cc 到其他編譯器的符號連結，例如 gcc。或者，將 makefile 檔案中的編譯器規格 (目前為 CC=cc) 變更為其他編譯器的完整路徑。例如，在由 Agent Builder 產生的 makefile 檔案中，將 CC=cc 變更為 CC=pathname/gcc。在此類情況下，您無法直接執行 Agent Builder。而是必須使用 make 和 make pkg 指令產生資料服務程式碼和套裝軟體。

Agent Builder 螢幕

Agent Builder 是含有兩個步驟的精靈，每個步驟對應一個螢幕。Agent Builder 提供以下兩個畫面，以指導您完成建立新資源類型的程序︰

1. [建立] 畫面。在此畫面上，您需提供有關要建立的資源類型的基本資訊，例如，其名稱和產生的檔案的工作目錄。該工作目錄是您建立和配置資源類型範本的位置。您還可指定以下資訊︰

   • 要建立的資源之種類 (可延伸式或容錯移轉)

   • 基本應用程式是否為支援網路型 (即，其是否使用網路與用戶端進行通訊)

   • 要產生的程式碼類型 (C、Korn shell [ksh] 或 GDS)

   如需有關 GDS 的資訊，請參閱第 10 章, 一般資料服務。您必須在此畫面上提供所有資訊，然後選取 [建立] 以產生相應的輸出。然後，您可以顯示 [配置] 螢幕。

2. [配置] 畫面。在此畫面上，您必須指定可以傳送至任何 UNIX shell 的完整指令行，以啟動基本應用程式。此外，您可以提供停止與測試應用程式的指令。如果您未指定這兩個指令，則產生的輸出將使用訊號來停止應用程式，並提供預設的探測機制。請參閱使用 [配置] 畫面中對探測指令的說明。[配置] 畫面還可讓您變更以下這三個指令中每一個的逾時值︰start、stop、probe。

啟動 Agent Builder

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

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

透過鍵入以下指令啟動 Agent Builder︰

% /usr/cluster/bin/scdsbuilder

將顯示 [建立] 螢幕。

圖 9–1 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 均會將狀況訊息附加至輸出登錄。如果您反覆變更原始碼並在 Agent Builder 中反覆重新產生輸出，且想要隔離狀態訊息，您可以在每次使用之前儲存並清除記錄檔。

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

使用 [建立] 畫面

建立資源類型的第一步是完成 [建立] 畫面，該畫面會在您啟動 Agent Builder 時顯示。下圖顯示在欄位中鍵入資訊後的 [建立] 畫面。

圖 9–2 鍵入資訊後的 Agent Builder [建立] 畫面

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

• 供應商名稱。用於識別資源類型供應商的名稱。通常，您可以指定供應商的股票代號。然而，任何唯一識別供應商的名稱均有效。僅使用字母數字字元。

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

  ---

  備註 –

  供應商名稱與應用程式名稱共同構成了資源類型的完整名稱。從 Solaris 9 作業系統開始，供應商名稱和應用程式名稱的組合可以超過九個字元。然而，如果您使用舊版本的 Solaris 作業系統，則供應商名稱和應用程式名稱的組合不能超過九個字元。

  ---

• RT 版本。所產生資源類型的版本。[RT 版本] 可辨別屬同一基本資源類型的多個註冊版本或升級版本。

  您不能使用 [RT 版本] 欄位中的以下字元︰

  • 空格鍵

  • Tab 鍵

  • 斜線 (/)

  • 反斜線 (\)

  • 星號 (*)

  • 問號 (?)

  • 逗號 (,)

  • 分號 (;)

  • 左方括號 ([)

  • 右方括號 (])

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

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

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

• 可延伸或防故障備用。指定目標資源類型是否為容錯移轉或可延伸式。

• 網路支援。指定基本應用程式是否為網路支援的應用程式，即是否使用網路與其用戶端進行通訊。選取 [支援網路] 核取方塊以指定為支援網路型，或不選取該核取方塊以指定為不支援網路型。

• C、ksh。指定所產生源代碼的語言。儘管這些選項互斥，但是使用 Agent Builder，您可以建立一個具有 Korn shell 產生的程式碼的資源類型，並重複使用相同資訊以建立 C 產生的程式碼。請參閱重複使用使用 Agent Builder 建立的程式碼。

• GDS。指定此服務為通用資料服務。第 10 章, 一般資料服務包含有關建立與配置通用資料服務的更詳細資訊。

如果 cc 編譯器不包含在 $PATH 變數中，Agent Builder 將以灰色顯示 C 單選按鈕，並允許您選取 ksh 單選按鈕。若要指定其他編譯器，請參閱安裝與配置 Agent Builder結尾處的備註。

指定完所需資訊後，請按一下 [建立]。畫面底部的 [輸出記錄] 區域顯示 Agent Builder 執行的動作。您可以從 [編輯] 功能表中選擇 [儲存輸出日誌]，將資訊儲存至輸出日誌。

完成以上作業後，Agent Builder 將顯示一則成功訊息或警告訊息。

• 如果 Agent Builder 無法完成此步驟，請檢查輸出記錄以取得詳細資訊。

• 如果 Agent Builder 成功完成此步驟，請按一下 [下一步] 以顯示 [配置] 畫面。[配置] 畫面可讓您完成產生資源類型。

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

使用 [配置] 畫面

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

圖 9–3 Agent Builder 的 [配置] 畫面

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

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

  完整指令行必須包含啟動應用程式所必需的所有項目，例如，主機名稱、連接埠號碼以及配置檔案的路徑。您還可以指定特性變數，這在使用特性變數中說明。如果基於 Korn shell 的應用程式要求在指令行上指定一個主機名稱，您可以使用 Agent Builder 定義的變數 $hostnames。請參閱使用 Agent Builder 基於 Korn Shell 的 $hostnames 變數。

  請勿給指令加上雙引號 (””)。

  ---

  備註 –

  如果基本應用程式具有多個獨立的程序樹，其中每一個都在程序監視設備 (PMF) 的控制下以其自己的標記開始，則您無法指定單一指令。然而，您必須建立一個包含獨立指令的文字檔案，以啟動每個程序樹，並在 [start 指令] 文字欄位中為該檔案指定路徑。請參閱使用 Agent Builder 之前。本小節列出該檔案正確工作所需的某些特殊特性。

  ---

• Stop 指令。可傳送至任何 UNIX shell 以停止基本應用程式的完整指令行。您可以在提供的欄位中鍵入指令，或使用 [瀏覽] 尋找包含該指令的檔案，以停止應用程式。您還可以指定特性變數，這在使用特性變數中說明。如果基於 Korn shell 的應用程式要求在指令行上指定一個主機名稱，您可以使用 Agent Builder 定義的變數 $hostnames。請參閱使用 Agent Builder 基於 Korn Shell 的 $hostnames 變數。

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

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

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

  • 如果 SIGKILL 失敗，則 Stop 方法將以失敗結束。剩餘 5% 的逾時值被視為經常性耗用時間。

  ---

  注意 –

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

  ---

• Probe 指令。一個可以定期執行的指令，用於檢查應用程式的運作狀態並傳回一個介於 0 (成功) 與 100 (完全失敗) 之間的結束狀態。此指令是可選擇的。您可以鍵入該指令的完整路徑，或使用 [瀏覽] 尋找包含該指令的檔案，以探測應用程式。

  一般您將指定基本應用程式的簡單用戶端。如果您未指定探測指令，產生的程式碼將會僅連線至資源使用的連接埠以及從此連接埠中斷連線。如果連線和中斷連線成功，產生的程式碼將宣告應用程式運作狀態良好。您還可以指定特性變數，這在使用特性變數中說明。如果基於 Korn shell 的應用程式需要您在 probe 指令行上指定一個主機名稱，您可以使用 Agent Builder 定義的 $hostnames 變數。請參閱使用 Agent Builder 基於 Korn Shell 的 $hostnames 變數。

  請勿給指令加上雙引號 (””)。

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

使用 Agent Builder 基於 Korn Shell 的 $hostnames 變數

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

為了解決此問題，Agent Builder 將提供 $hostnames 變數，以便您可以在指令行上為 start、stop 以及 probe 指令指定該變數。

僅支援變數 $hostnames 與基於 Korn shell 的服務配合使用。不支援變數 $hostnames 與基於 C 的服務和基於 GDS 的服務配合使用。

請完全按照指定實際主機名稱的方式來指定變數$yhostnames，例如：

% /opt/network_aware/echo_server -p port-no -l $hostnames

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

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

使用特性變數

您還可以使用特性變數從 RGM 架構中擷取所選 Sun Cluster 資源類型、資源以及資源群組特性的值。Agent Builder 將掃描特性變數的 start、probe 或 stop 指令字串，並在 Agent Builder 執行指令前使用變數的值取代這些變數。

不支援特性變數與基於 Korn shell 的服務配合使用。

特性變數清單

本小節列出您可以使用的特性變數。Sun Cluster 資源類型、資源以及資源群組特性在附錄 A標準特性中說明。

資源特性變數

• HOSTNAMES

• RS_CHEAP_PROBE_INTERVAL

• RS_MONITOR_START_TIMEOUT

• RS_MONITOR_STOP_TIMEOUT

• RS_NAME

• RS_NUM_RESTARTS

• RS_RESOURCE_DEPENDENCIES

• RS_RESOURCE_DEPENDENCIES_WEAK

• RS_RETRY_COUNT

• RS_RETRY_INTERVAL

• RS_SCALABLE

• RS_START_TIMEOUT

• RS_STOP_TIMEOUT

• RS_THOROUGH_PROBE_INTERVAL

• SCHA_STATUS

資源類型特性變數

• RT_API_VERSION

• RT_BASEDIR

• RT_FAILOVER

• RT_INSTALLED_NODES

• RT_NAME

• RT_RT_VERSION

• RT_SINGLE_INSTANCE

資源群組特性變數

• RG_DESIRED_PRIMARIES

• RG_GLOBAL_RESOURCES_USED

• RG_IMPLICIT_NETWORK_DEPENDENCIES

• RG_MAXIMUM_PRIMARIES

• RG_NAME

• RG_NODELIST

• RG_NUM_RESTARTS

• RG_PATHPREFIX

• RG_PINGPONG_INTERVAL

• RG_RESOURCE_LIST

特性變數語法

在特性名稱之前加上百分號 (%) 表示特性變數，如以下範例所示︰

/opt/network_aware/echo_server -t %RS_STOP_TIMEOUT -n %RG_NODELIST

如果有先前的範例，Agent Builder 可能會解譯這些特性變數，並使用以下值啟動 echo_server 程序檔︰

/opt/network_aware/echo_server -t 300 -n phys-node-1,phys-node-2,phys-node-3

Agent Builder 如何取代特性變數

Agent Builder 會解譯特性變數的類型，如下所示︰

• 由實際值 (例如，300) 取代整數。

• 由字串 TRUE 或 FALSE 取代布林值。

• 由實際字串 (例如，phys-node-1) 取代字串。

• 由清單中所有成員取代字串清單，每個字串由逗號分隔，(例如，phys-node-1,phys-node-2,phys-node-3)。

• 由清單中所有成員取代整數清單，每個整數由逗號分隔 (例如，1,2,3)。

• 列舉類型被其字串形式的值取代。

重複使用使用 Agent Builder 建立的程式碼

Agent Builder 可讓您按以下方法重複使用完成的工作︰

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

• 您可以編輯 Agent Builder 產生的原始碼，然後重新編譯該程式碼以建立一個新的套裝軟體。

如何複製現有的資源類型

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

步驟

1. 使用下列方法之一，將現有的資源類型載入 Agent Builder：

   • 從現有資源類型 (使用 Agent Builder 建立) 的工作目錄中啟動 Agent Builder。請確定工作目錄包含 rtconfig 檔案。Agent Builder 會在 [建立] 和 [配置] 螢幕中載入該資源類型的值。

   • 使用 [檔案] 下拉式功能表中的 [載入資源類型] 選項。

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

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

3. 對現有資源類型做出所需變更。

   您可能會變更為資源類型產生的程式碼類型。例如，如果您初始建立資源類型的 Korn shell 版本，但過後發現需要 C 版本，您可以執行以下作業︰

   • 載入現有 Korn shell 資源類型。

   • 將輸出語言變更為 C。

   • 按一下 [建立] 以使 Agent Builder 建立資源類型的 C 版本。

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

   1. 按一下 [建立] 以建立資源類型。

   2. 按一下 [下一個] 以顯示 [配置] 螢幕。

   3. 按一下 [配置] 以配置資源類型，然後按一下 [取消] 以完成。

編輯產生的來源代碼

若要簡化建立資源類型的程序，Agent Builder 將限制您可以指定的資訊容量，從而限制產生的資源類型的範圍。因此，若要增加更複雜的功能，您需要修改產生的原始碼或 RTR 檔案。附加功能的範例包括增加附加特性的驗證檢查的程式碼，或調準 Agent Builder 無法顯示的參數的程式碼。

原始碼檔案位於 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 的指令行版本遵循與 GUI 相同的基本程序。然而，您需將引數傳送至 scdscreate 和 scdsconfig 指令，而非在 GUI 中鍵入資訊。請參閱 scdscreate(1HA) 和 scdsconfig(1HA) 線上手冊，以取得更多資訊。

遵循這些步驟以使用 Agent Builder 的指令行版本。

步驟

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

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

   您可以指定特性變數。使用特性變數中說明特性變數。

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

4. 使用 pkgadd 指令安裝您透過 scdscreate 建立的套裝軟體。

   • 對於區域環境中的 Solaris 10 作業系統，作為全域區域中的全域管理員，請鍵入以下指令︰

     # pkgadd -G -d . package-name

     假如套裝軟體的內容不影響全域區域的任何區域 (與非全域區域共用)，則您指定的套裝軟體將增加至全域區域。

   • 對於非區域環境中 Solaris 作業系統或 Solaris 10 作業系統的其他任何版本，請鍵入以下指令︰

     # pkgadd -d . package-name

5. (可選擇) 編輯產生的原始碼。

6. 執行啟動程序檔。

Agent Builder 建立的目錄結構

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

在此子目錄下，Agent Builder 將建立並寫入列示在以下表格中的目錄。

% man -M install-directory/SUNWftp/man removeftp

Agent Builder 輸出

來源檔與二進位檔

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

為了支援此模型，Agent Builder 將在 install-directory/rt-名稱/bin 目錄中產生八個可執行的 C 程式或 Korn shell 程序檔。這些程式或 shell 程序檔將作為回呼方法使用。

嚴格來說，實作故障監視器的 rt-name_probe 程式不是回呼程式。RGM 不會直接呼叫 rt-name_probe。相反，RGM 將呼叫 rt-name_monitor_start 和 rt-name_monitor_stop。這些方法可透過呼叫 rt-name_probe 啟動和停止故障監視器。

以下為 Agent Builder 產生的八種方法︰

• 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 目錄中建立可執行檔。

對於 Korn shell 輸出，install-directory/rt-name/bin 目錄與 install-directory/rt-name/src 目錄相同。每個目錄均包含對應於七個回呼方法和 Probe 方法的上述八個可執行程序檔。

Korn shell 輸出包含兩個編譯的公用程式，gettime 和 gethostnames。特定回呼方法需要使用這些方法取得時間和進行探測。

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

Sun 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 指令為此 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 建立的支援檔案

Agent Builder 將支援檔案 (例如，pkginfo、postinstall、postremove 以及 preremove) 置於 install-directory/rt-name/etc 目錄中。該目錄還包含資源類型註冊 (RTR) 檔案。RTR 檔案將宣告可用於目標資源類型的資源與資源類型特性，並在使用叢集註冊資源時初始化特性值。請參閱設定資源特性和資源類型特性，以取得更多資訊。RTR 檔案命名為 vendor-name.resource-type-name，例如 SUNW.ftp。

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

Agent Builder 建立的套裝軟體目錄

install-directory/rt-name/pkg 目錄包含 Solaris 套裝軟體。套裝軟體名稱由供應商名稱和應用程式名稱連結而成，例如，SUNWftp。install-directory/rt-name/src 目錄中的 makefile 檔案支援新套裝軟體的建立。例如，如果您對原始碼檔案做出變更，並重新編譯程式碼，或對套裝軟體公用程式程序檔做出變更，請使用 make pkg 指令以建立新套裝軟體。

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

• 在從任何節點執行 pkgrm 指令之前，請先從叢集的任一節點執行 remove rt-name 程序檔。

• 從叢集的一個節點執行 pkgrm 指令，將處理所有所需的清除作業。然後，從剩下的節點同時執行 pkgrm 指令 (如有必要)。

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

rtconfig 檔案

如果您在工作目錄中產生 C 或 Korn shell 原始碼，則 Agent Builder 將產生名為 rtconfig 的配置檔案。該檔案包含您在 [建立] 和 [配置] 畫面上指定的資訊。如果您從現有資源類型的工作目錄中啟動 Agent Builder，則 Agent Builder 將讀取 rtconfig 檔案。Agent Builder 會將為現有資源類型提供的資訊填入 [建立] 和 [配置] 畫面。如果您透過從 [檔案] 下拉式功能表中選擇 [載入資源類型] 來載入現有資源類型，Agent Builder 將執行相似的工作。如果您要複製現有資源類型， 則此功能將十分有用。請參閱重複使用使用 Agent Builder 建立的程式碼。

Agent Builder 的 Cluster Agent 模組

Agent Builder 的 Cluster Agent 模組是一個 NetBeans^TM 模組。該模組提供一個 GUI，可讓您透過 Sun Java Studio (之前稱為 Sun ONE Studio) 產品為 Sun Cluster 軟體建立資源類型。

Sun Java Studio 文件包含有關如何設置、安裝與使用 Sun Java Studio 產品的資訊。您可以在 http://wwws.sun.com/software/sundev/jde/documentation/index.html 網站上找到此文件。

如何安裝與設置 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 1.4，且它們必須可用於您要在其上運行 Cluster Agent 模組的系統。

步驟

1. 使所有使用者或僅使您自己可以使用 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 模組。

Sun Java Studio 文件包含有關如何設置、安裝與使用 Sun Java Studio 產品的資訊。您可以在 http://wwws.sun.com/software/sundev/jde/documentation/index.html 網站上找到此文件。

步驟

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 產品的獨立視窗中。