Sun Cluster 資料服務開發者指南 (適用於 Solaris 作業系統)

使用 SunPlex Agent Builder 建立使用 GDS 的服務

您可以使用 SunPlex Agent Builder 來建立使用 GDS 的服務。在第 9 章, SunPlex Agent Builder中將會更詳細地說明 SunPlex Agent Builder。

建立與配置程序檔

如何啟動 SunPlex Agent Builder 與建立程序檔
  1. 成為超級使用者,或者假定一個對等身份。

  2. 啟動 SunPlex Agent Builder。


    # /usr/cluster/bin/scdsbuilder
    
  3. 將顯示 SunPlex Agent Builder [建立] 螢幕。

    標題為 SunPlex Agent Builder 的對話方塊,顯示主 Agent Builder [建立] 螢幕
  4. 鍵入供應商名稱。

  5. 鍵入應用程式名稱。


    注意 –

    供應商名稱與應用程式名稱的組合不得超過九個字元。它作為程序檔的套裝軟體名稱。


  6. 移至工作目錄。

    您可以使用 [瀏覽] 下拉式功能表來選取目錄,而不必鍵入路徑。

  7. 選取資料服務是否可延伸或故障轉移。

    不需要選取 [網路支援],因為在建立 GDS 時它是預設值。

  8. 選取 GDS。

  9. (選擇性的) 變更顯示的 RT 版本預設值。


    注意 –

    在 [RT 版本] 欄位中不能使用下列字元︰空白、定位字元、斜線 (/)、反斜線 (\)、星號 (*)、問號 (?)、逗號 (,)、分號 (;)、左方括號 ([) 或右方括號 (])。


  10. 按一下 [完成]。

    Agent Builder 便會建立程序檔。在 [輸出日誌] 視窗中,將顯示服務的建立結果。

    在輸入資訊後顯示 [建立] 螢幕的對話方塊

    [建立] 將以灰色顯示。現在便可配置程序檔。

  11. 按一下 [下一步]。

    將顯示 [配置] 螢幕。

如何配置程序檔

建立程序檔後,需要配置新的服務。

  1. 鍵入 start 指令的位置,或按一下 [瀏覽] 尋找 start 指令。

    您可以指定特性變數。特性變數中描述了特性變數。

  2. (選擇性的) 鍵入 stop 指令,或按一下 [瀏覽] 尋找 stop 指令。

    您可以指定特性變數。特性變數中描述了特性變數。

  3. (選擇性的) 鍵入 probe 指令,或按一下 [瀏覽] 尋找 probe 指令。

    您可以指定特性變數。特性變數中描述了特性變數。

  4. (選擇性的) 指定 start、stop 和 probe 指令的逾時值。

  5. 按一下 [配置]。

    Agent Builder 開始配置程序檔。


    注意 –

    Agent Builder 鏈結供應商名稱與應用程式名稱以建立套裝軟體名稱。


    將建立程序檔的套裝軟體,並將其放置在以下目錄中:


    working-dir/vendor_nameapplication/pkg
    

    例如 /export/wdir/NETapp/pkg

  6. 以超級使用者身份,在叢集所有節點上安裝完成的套裝軟體。


    # cd /export/wdir/NETapp/pkg
    # pkgadd -d . NETapp
    

  7. 透過 pkgadd 安裝以下檔案:


    /opt/NETapp
    /opt/NETapp/README.app
    /opt/NETapp/man
    /opt/NETapp/man/man1m
    /opt/NETapp/man/man1m/removeapp.1m
    /opt/NETapp/man/man1m/startapp.1m
    /opt/NETapp/man/man1m/stopapp.1m
    /opt/NETapp/man/man1m/app_config.1m
    /opt/NETapp/util
    /opt/NETapp/util/removeapp
    /opt/NETapp/util/startapp
    /opt/NETapp/util/stopapp
    /opt/NETapp/util/app_config


    注意 –

    線上說明手冊及程序檔名稱與先前輸入的應用程式名稱 (以程序檔名稱開頭,如 startapp) 對應。


    若要檢視線上援助頁,您需要指定到援助頁的路徑。例如,若要檢視 startapp(1M) 線上說明手冊,請鍵入:


    # man -M /opt/NETapp/man startapp
    
  8. 在叢集的一個節點上,配置資源並啟動應用程式。


    # /opt/NETapp/util/startapp -h logicalhostname -p port_and_protocol_list
    

    依據資源類型的不同,startapp 程序檔的引數也會不同:故障轉移或可延伸。檢查自訂的線上說明手冊,或運行沒有引數的 startapp 程序檔,以顯示用法描述。


    # /opt/NETapp/util/startapp
     The resource name of LogicalHostname or SharedAddress must be
     specified. For failover services:
     Usage: startapp -h logicalhostname
              -p port_and_protocol_list
              [-n ipmpgroup_adapter_list]
     For scalable services:
     Usage: startapp -h shared_address_name
              -p port_and_protocol_list
              [-l load_balancing_policy]
              [-n ipmpgroup/adapter_list]
              [-w load_balancing_weights]

SunPlex Agent Builder 的輸出

SunPlex Agent Builder 基於建立套裝軟體時您提供的輸入,產生三個程序檔和一個配置檔。配置檔會指定資源群組與資源類型的名稱。

程序檔為:

這些程序檔的介面及運作方式,與 SunPlex Agent Builder 為非 GDS 型代理程式產生的公用程式程序檔相同。這些程序檔被置於可在多個叢集中重複使用的 Solaris 套裝軟體中。

您可以自訂配置檔,以自行提供資源群組名稱或通常輸入至 scrgadm 指令的參數。如果您不自訂程序檔,SunPlex Agent Builder 將為 scrgadm 參數提供預設值。