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

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

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

建立與配置基於 GDS 的程序檔

Procedure如何啟動 Agent Builder 與建立程序檔

步驟
  1. 成為超級使用者,或者假定一個對等身份。

  2. 啟動 Agent Builder。


    # /usr/cluster/bin/scdsbuilder
    
  3. Agent Builder [建立] 畫面出現。

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

  5. 鍵入應用程式名稱。


    備註 –

    從 Solaris 9 作業系統開始,供應商名稱和應用程式名稱的組合可以超出九個字元。然而,如果您使用舊版本的 Solaris Operating System,則供應商名稱和應用程式名稱的組合不能超出九個字元。此組合用做程序檔的套裝軟體名稱。


  6. 移至工作目錄。

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

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

    您不需要選取 [支援網路],因為建立 GDS 時設定為該預設。

  8. 選取 GDS。

  9. (可選擇) 從所示預設值變更 RT 版本。


    備註 –

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


  10. 按一下 [建立]。

    Agent Builder 便會建立程序檔。結果將顯示在 [輸出記錄] 區域。

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

    請注意,[建立] 按鈕顯示為灰色。現在便可配置程序檔。

  11. 按一下 [下一步]。

    [配置] 畫面出現。

    顯示 [配置] 畫面的對話方塊

Procedure如何配置程序檔

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

步驟
  1. 鍵入啟動指令的位置,或按一下 [瀏覽] 以尋找啟動指令。

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

  2. (可選擇) 鍵入停止指令的位置,或按一下 [瀏覽] 以尋找停止指令。

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

  3. (可選擇) 鍵入探測指令的位置,或按一下 [瀏覽] 以尋找探測指令。

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

  4. (可選擇) 指定啟動、停止、探測指令的新逾時值。

  5. 按一下 [配置]。

    Agent Builder 將配置程序檔。


    備註 –

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


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

    working-dir/vendor-name-application/pkg
    

    例如 /export/wdir/NETapp/pkg

  6. 在叢集的每個節點上,成為超級使用者或假定為等效角色。

  7. 在叢集的每個節點上,安裝完整的套裝軟體。

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


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

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

      以下檔案由 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
    • 對於非區域環境中任何其他版本的 Solaris 作業系統或 Solaris 10 作業系統,請鍵入以下指令︰


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

      透過 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) 之後。


  8. 在叢集的一個節點上,配置資源並啟動應用程式。


    # /opt/NETapp/util/startapp -h logicalhostname -p port-and-protocol-list
    

    依據資源類型的不同,startapp 程序檔的引數也會不同:故障轉移或可延伸。


    備註 –

    若要確定您需要鍵入的指令行,請檢查自訂線上手冊,或執行不帶任何引數的 startapp 程序檔,以顯示用法敘述。

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


    # man -M /opt/NETapp/man 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]

Agent Builder 輸出

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

程序檔如下所示︰

這些程序檔具有與公用程式程序檔 (由基於非 GDS 資料服務的 Agent Builder 產生) 相同的介面和運作方式。這些程序檔會置於您可在多個叢集上重複使用的 Solaris 套裝軟體中。

您可以自訂配置檔案,提供自己的資源群組名稱或通常作為 scrgadm 指令的引數的其他引數。如果您不自訂程序檔,Agent Builder 將提供 scrgadm 引數的預設值。