Sun Cluster データサービス開発ガイド (Solaris OS 版)

SunPlex Agent Builder を使って GDS ベースのサービスを作成

SunPlex Agent Builder を使って、GDS を使用するサービスを作成できます。SunPlex Agent Builder の詳細については、第 9 章「SunPlex Agent Builder」を参照してください。

スクリプトの作成と構成

SunPlex Agent Builder を起動し、スクリプトを作成する方法
  1. スーパーユーザーになるか、同等の役割になります。

  2. SunPlex Agent Builder を起動します。


    # /usr/cluster/bin/scdsbuilder
    
  3. 「SunPlex Agent Builder Create」画面が表示されます。

    「SunPlex Agent Builder」ダイアログ - Agent Builder Create メイン画面
  4. 「ベンダー名」に値を入力します。

  5. 「アプリケーション名」に値を入力します。


    注 –

    「ベンダー名」と「アプリケーション名」の合計は 9 文字以内でなければなりません。この組み合わせは、スクリプトのパッケージ名として使用されます。


  6. 作業ディレクトリに移動します。

    このパスを入力する代わりに、「ブラウズ」プルダウンメニューを使ってディレクトリを選択することもできます。

  7. データサービスがスケーラブルなのかフェイルオーバーなのかを選択します。

    GDS を作成するときには「ネットワーク認識」がデフォルトですので、これを選択する必要はありません。

  8. 「GDS」を選択します。

  9. (省略可能) 「RT バージョン」フィールドにデフォルト値が表示されるので、これを変更します。


    注 –

    「RT バージョン」フィールドで次の文字を使用することはできません。空白文字、タブ、スラッシュ (/)、逆スラッシュ (\)、アステリスク (*)、疑問符 (?)、コンマ (,)、セミコロン (;)、左角かっこ ([)、右角かっこ (])。


  10. 「Create」をクリックしてください。

    Agent Builder がスクリプトを作成します。サービスの作成結果が「Output Log」ウィンドウに表示されます。

    情報を入力した後の作成画面を示すダイアログボックス

    「Create」がグレイ表示されます。これで、スクリプトの構成を始めることができます。

  11. 「進む」をクリックする。

    「構成」画面が表示されます。

スクリプトを構成する方法

スクリプトの作成が終わったら、新しいサービスを構成する必要があります。

  1. 起動コマンドの場所を指定するか、「ブラウズ」をクリックして起動コマンドの場所を選択します。

    プロパティ変数を指定できます。プロパティ変数については、「プロパティ変数」を参照してください。

  2. (省略可能) 停止コマンドを指定するか、「ブラウズ」をクリックして停止コマンドを選択します。

    プロパティ変数を指定できます。プロパティ変数については、「プロパティ変数」を参照してください。

  3. (省略可能) 検証コマンドを指定するか、「ブラウズ」をクリックして検証コマンドを選択します。

    プロパティ変数を指定できます。プロパティ変数については、「プロパティ変数」を参照してください。

  4. (省略可能) 起動、停止、検証コマンドのタイムアウト値を指定します。

  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 は 3 つの起動スクリプトと、パッケージ作成時の入力内容に基づく構成ファイルを生成します。 構成ファイルには、リソースグループとリソースタイプの名前が指定されます。

作成されるスクリプトは次のとおりです。

これらのスクリプトのインタフェースや動作は、SunPlex Agent Builder によって非 GDS ベースのエージェント用に作成されるユーティリティスクリプトのものと同じです。これらのスクリプトは、Solaris パッケージに含まれており、複数のクラスタで再利用できます。

構成ファイルをカスタマイズすれば、リソースグループの名前など、一般には scrgadm コマンドへの入力として指定されるパラメータを独自に設定できます。スクリプトをカスタマイズしないと、SunPlex Agent Builder が scrgadm のパラメータに対しデフォルト値を 設定します。