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

第 10 章汎用データサービス

この章では、汎用データサービス (GDS) の概要を述べてから、GDS を使用するサービスの作成方法について説明します。このサービスの作成には、Sun Cluster Agent Builder、または Sun Cluster 管理コマンドを使用します。

この章の内容は次のとおりです。

GDS の概念

GDS とは、簡単なネットワーク対応や非ネットワーク対応のアプリケーションを高可用性にしたり、スケーラブルにしたりするための機構です。そのためには、これらのアプリケーションを Sun Cluster Resource Group Management (RGM) フレームワークに組み込みます。この機構では、アプリケーションの可用性やスケーラビリティーを高めるために一般的に行う必要がある、データサービスのコーディングは必要ありません。

GDS ベースのデータサービスを非大域ゾーンで実行するように構成できるのは、関連するアプリケーションも非大域ゾーンで実行するように構成する場合です。

GDS は、あらかじめコンパイルされた単一のデータサービスです。コールバックメソッド (rt_callbacks) の実装やリソースタイプ登録ファイル (rt_reg) など、コンパイル済みのデータサービスやそのコンポーネントを変更することはできません。

この節の内容は、次のとおりです。

コンパイル済みリソースタイプ
GDS を使用することの利点と欠点
GDS を使用するサービスの作成方法
GDS によるイベントのロギング
必須の GDS プロパティー
任意の GDS プロパティー

コンパイル済みリソースタイプ

汎用データサービスのリソースタイプ SUNW.gds は、SUNWscgds パッケージに含まれています。このパッケージは、クラスタのインストール時に scinstall ユーティリティーでインストールされます。scinstall(1M) のマニュアルページを参照してください。SUNWscgds パッケージには次のファイルが格納されています。

# pkgchk -v SUNWscgds

/opt/SUNWscgds
/opt/SUNWscgds/bin
/opt/SUNWscgds/bin/gds_monitor_check
/opt/SUNWscgds/bin/gds_monitor_start
/opt/SUNWscgds/bin/gds_monitor_stop
/opt/SUNWscgds/bin/gds_probe
/opt/SUNWscgds/bin/gds_svc_start
/opt/SUNWscgds/bin/gds_svc_stop
/opt/SUNWscgds/bin/gds_update
/opt/SUNWscgds/bin/gds_validate
/opt/SUNWscgds/etc
/opt/SUNWscgds/etc/SUNW.gds

GDS を使用することの利点と欠点

GDS を使用すると、Agent Builder のソースコード (scdscreate(1HA) のマニュアルページを参照) や Sun Cluster 管理コマンドを使用するのに比べ、次の利点があります。

GDS は使い易いデータサービスです。
GDS とそのメソッドはコンパイル済みであるため、変更できません。
Agent Builder を使って、アプリケーション用のスクリプトを生成できます。これらのスクリプトは、複数のクラスタで再利用できる Solaris パッケージになっています。

GDS を使用すると多くの利点もありますが、GDS 機構の使用が適さない場合もあります。

コンパイル済みリソースタイプを使用する場合よりも高度な制御が必要な場合。たとえば拡張プロパティーを追加する場合や、デフォルト値を変更する場合など
特別な機能を追加するためにソースコードを変更する必要がある場合

GDS を使用するサービスの作成方法

GDS を使用するサービスの作成方法は 2 通りあります。

Agent Builder
Sun Cluster 管理コマンド

GDS と Agent Builder

Agent Builder を使用し、生成するソースコードのタイプとして GDS を選択します。特定のアプリケーションのリソースを設定するスクリプト群を生成するためにユーザーの入力が必要です。

GDS と Sun Cluster 管理コマンド

この方法では、SUNWscgds に含まれているコンパイル済みデータサービスコードを使用します。ただし、クラスタ管理者は、Sun Cluster 管理コマンドを使ってリソースの作成と構成を行う必要があります。詳細は、clresource(1CL) のマニュアルページを参照してください。

GDS ベースのサービスを作成する方法の選択

Sun Cluster のコマンドを発行するためには相当量の入力作業が必要になります。たとえば、「Sun Cluster 管理コマンドを使って GDS ベースの高可用性サービスを作成する方法」や「Sun Cluster 管理コマンドを使って GDS ベースのスケーラブルサービスを作成する方法」を参照してください。

GDS と Agent Builder を使用する方法では、この処理が簡単になります。この方法では、生成されるスクリプトがユーザーに代わって scrgadm と scswitch コマンドを出力するからです。

GDS によるイベントのロギング

GDS を使用すると、GDS から渡される関連情報を、GDS が起動するスクリプトにロギングできます。この情報には、起動、検証、確認、停止の各メソッドの状態やプロパティー変数が含まれます。この情報を使ってスクリプトの問題やエラーを診断したり、この情報をほかの目的に適用することができます。

GDS でロギングすべきメッセージのレベル (つまり、タイプ) の指定には、Log_level プロパティーを使用します (詳細は「Log_level プロパティー」を参照)。NONE、INFO、ERR を指定できます。

GDS ログファイル

次の 2 つの GDS ログファイルは、ディレクトリ /var/cluster/logs/DS/ resource-group-name/resource-name に配置されています。

start_stop_log.txt には、リソース起動メソッドや停止メソッドによって生成されるメッセージが含まれています。
probe_log.txt には、リソースモニターによって生成されるメッセージが含まれています。

start_stop_log.txt に含まれる情報のタイプを、次の例に示します。

06/12/2006 12:38:05 phys-node-1 START-INFO> Start succeeded. [/home/brianx/sc/start_cmd]
06/12/2006 12:42:11 phys-node-1 STOP-INFO> Successfully stopped the application

probe_log.txt に含まれる情報のタイプを、次の例に示します。

06/12/2006 12:38:15 phys-node-1 PROBE-INFO> The GDS monitor (gds_probe) has been started
06/12/2006 12:39:15 phys-node-1 PROBE-INFO> The probe result is 0
06/12/2006 12:40:15 phys-node-1 PROBE-INFO> The probe result is 0
06/12/2006 12:41:15 phys-node-1 PROBE-INFO> The probe result is 0

必須の GDS プロパティー

アプリケーションがネットワーク対応の場合は、Start_command 拡張プロパティーと Port_list プロパティーの両方を指定する必要があります。アプリケーションがネットワーク非対応の場合は、Start_command 拡張プロパティーだけを指定します。

`Start_command` プロパティー

Start_command 拡張プロパティーで指定する起動コマンドによって、アプリケーションが起動されます。このコマンドは、引数を備えた UNIX コマンドでなければなりません。コマンドは、アプリケーションを起動するシェルに直接渡すことができます。

`Port_list` プロパティー

Port_list プロパティーは、アプリケーションが待機するポートのリストを指定します。Port_list プロパティーは、Agent Builder によって生成される起動スクリプトか、clresource コマンド (Sun Cluster 管理コマンドを使用する場合) に指定されていなければなりません。

任意の GDS プロパティー

任意の GDS プロパティーには、「システム定義プロパティー」と「拡張プロパティー」の両方が含まれます。システム定義プロパティーは、Sun Cluster により提供されるプロパティーの標準セットです。RTR ファイルで定義されているプロパティーは、拡張プロパティーと呼ばれます。

任意の GDS プロパティーには次のものがあります。

Child_mon_level 拡張プロパティー (管理コマンドでのみ使用)
Failover_enabled 拡張プロパティー
Log_level 拡張プロパティー
Network_resources_used プロパティー
Probe_command 拡張プロパティー
Probe_timeout 拡張プロパティー
Start_timeout プロパティー
Stop_command 拡張プロパティー
Stop_signal 拡張プロパティー
Stop_timeout プロパティー
Validate_command 拡張プロパティー
Validate_timeout プロパティー

`Child_mon_level` プロパティー

注 –

Sun Cluster 管理コマンドを使用する場合は、Child_mon_level プロパティーを使用できます。Agent Builder を使用する場合、このプロパティーは使用できません。

このプロパティーは、プロセスモニター機能 (PMF) を通じて監視されるプロセスを制御します。このプロパティーは、フォークされた子プロセスをどのようなレベルで監視するかを表します。このプロパティーは、pmfadm コマンドの -C 引数と同等の働きをします。詳細は、pmfadm(1M) のマニュアルページを参照してください。

このプロパティーを省略するか、このプロパティーにデフォルト値の -1 を指定することは、pmfadm コマンドで --C オプションを省略するのと同じ効果があります。つまり、すべての子プロセスとその子孫プロセスが監視されます。

`Failover_enabled` プロパティー

この拡張プロパティーは、リソースのフェイルオーバー動作を制御します。この拡張プロパティーに TRUE を設定すると、アプリケーションは、再起動回数が Retry_interval 秒間に Retry_count を超えるとフェイルオーバーされます。

このプロパティーに FALSE を設定すると、再起動回数が Retry_interval 秒間に Retry_count を超えてもアプリケーションの再起動や、別のノードまたはゾーンへのフェイルオーバーは行われません。

このプロパティーを使用すると、アプリケーションリソースによるリソースグループのフェイルオーバーを防ぐことができます。このプロパティーのデフォルト値は TRUE です。

注 –

Failover_mode のほうがフェイルオーバー動作をよりよく制御できるので、将来的には Failover_enabled 拡張プロパティーの代わりに Failover_mode プロパティーを使用します。詳細は、r_properties(5) のマニュアルページで、Failover_mode の LOG_ONLY および RESTART_ONLY の値の説明を参照してください。

`Log_level` プロパティー

このプロパティーは、GDS によって記録される診断メッセージのレベル (つまり、タイプ) を指定します。このプロパティーには、NONE、INFO、または ERR を指定できます。NONE を指定すると、診断メッセージはロギングされません。INFO を指定すると、情報メッセージだけがロギングされます。ERR を指定すると、エラーメッセージだけがロギングされます。デフォルトでは、診断メッセージはロギングされません (NONE)。

`Network_resources_used` プロパティー

このプロパティーは、リソースによって使用される論理ホスト名と共有アドレスネットワークリソースのリストを指定します。このプロパティーのデフォルト値は null です。アプリケーションを 1 つ以上の特定のアドレスにバインドする必要がある場合は、このプロパティーを指定してください。このプロパティーを省略するか Null を指定すると、アプリケーションはすべてのアドレスで待機します。

GDS リソースを作成する前には、LogicalHostname または SharedAddress リソースがすでに構成されている必要があります。LogicalHostname または SharedAddress リソースの構成方法については、『Sun Cluster データサービスの計画と管理 (Solaris OS 版)』を参照してください。

値を指定する場合は、1 つまたは複数のリソース名を指定します。個々のリソース名には、1 つ以上の LogicalHostnameリソースか 1 つ以上の SharedAddress リソースを含めることができます。詳細は、r_properties(5) のマニュアルページを参照してください。

`Probe_command` プロパティー

このプロパティーは、特定のアプリケーションの状態を周期的にチェックする検証コマンドを指定します。このコマンドは、引数を備えた UNIX コマンドでなければなりません。コマンドは、アプリケーションを検証するシェルに直接渡されます。アプリケーションが正常に実行されていれば、検証コマンドは終了ステータスとして 0 を返します。

検証コマンドの終了ステータスは、アプリケーションの障害の重大度を判断するために使用されます。終了状態 (検証状態) は、0 (正常) から 100 (全面的な障害) までの整数である必要があります。検証ステータスは、特殊な値として 201 をとることがあります。この場合、アプリケーションは、Failover_enabled が FALSE に設定されている場合を除き、直ちにフェイルオーバーされます。GDS 検証アルゴリズムは、この検証ステータスを使って、アプリケーションをローカルに再起動するか、フェイルオーバーするかを決定します。詳細は、scds_fm_action(3HA) のマニュアルページを参照してください。終了ステータスが 201 の場合には、アプリケーションは直ちにフェイルオーバーされます。

検証コマンドを省略すると、GDS はそれ自身の簡単な検証を行います。この検証は、Network_resources_used プロパティーや scds_get_netaddr_list() 関数の出力から得られる一連の IP アドレスに対してアプリケーションに接続します。詳細は、scds_get_netaddr_list(3HA) のマニュアルページを参照してください。接続に成功すると、接続が直ちに切断されます。接続と切断が両方とも成功すれば、アプリケーションは正常に動作しているものとみなされます。

注 –

GDS で提供される検証は、全機能を備えたアプリケーション固有の検証の単純な代替物ではありません。

`Probe_timeout` プロパティー

このプロパティーは、検証コマンドのタイムアウト値を指定します。詳細は、「Probe_command プロパティー」を参照してください。Probe_timeout のデフォルトは 30 秒です。

`Start_timeout` プロパティー

このプロパティーは、起動コマンドの起動タイムアウトを指定します。詳細は、「Start_command プロパティー」を参照してください。Start_timeout のデフォルトは 300 秒です。

`Stop_command` プロパティー

このプロパティーは、アプリケーションを停止し、アプリケーションが完全に停止したあとでのみ戻る必要があるコマンドを指定します。このコマンドは、アプリケーションを停止するシェルに直接渡すことができる完全な UNIX コマンドでなければなりません。

Stop_command 拡張プロパティーが指定されていると、GDS 停止メソッドは、停止タイムアウトの 80% を指定して停止コマンドを起動します。さらに、GDS 停止メソッドは、停止コマンドの起動結果がどうであれ、停止タイムアウトの 15% を指定して SIGKILL を送信します。タイムアウトの残り 5% は、処理のオーバーヘッドのために使用されます。

停止コマンドが省略されていると、GDS は、Stop_signal に指定されたシグナルを使ってアプリケーションを停止しようとします。

`Stop_signal` プロパティー

このプロパティーは、PMF を通じてアプリケーションを停止するためのシグナルを識別する値を指定します。指定可能な整数値のリストについては、signal(3HEAD) のマニュアルページを参照してください。デフォルト値は 15 です (SIGTERM )。

`Stop_timeout` プロパティー

このプロパティーは、停止コマンドのタイムアウトを指定します。詳細は、「Stop_command プロパティー」を参照してください。Stop_timeout のデフォルトは 300 秒です。

`Validate_command` プロパティー

このプロパティーは、アプリケーションを検証するために呼び出されるコマンドへの絶対パスを指定します。絶対パスを指定しない場合、アプリケーションは検証されません。

`Validate_timeout` プロパティー

このプロパティーは、検証コマンドのタイムアウトを指定します。詳細は、「Validate_command プロパティー」を参照してください。Validate_timeout のデフォルトは 300 秒です。

Agent Builder を使って、GDS を使用するサービスを作成

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

GDS ベースのスクリプトの作成と構成

Agent Builder を起動し、スクリプトを作成する

スーパーユーザーになるか、RBAC 承認 solaris.cluster.modify を提供する役割になります。

Agent Builder を起動します。
# /usr/cluster/bin/scdsbuilder

「Agent Builder Create」画面が表示されます。

ベンダー名を入力します。

アプリケーション名を入力します。

注 –
Solaris 9 OS 以降では、ベンダー名とアプリケーション名の両方を合わせて 10 文字以上を指定できます。この組み合わせは、スクリプトのパッケージ名として使用されます。

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

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

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

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

「GDS」を選択します。

(省略可能) 表示されているデフォルト値から RT バージョンを変更します。

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

「作成」をクリックしてください。

Agent Builder により、スクリプトが作成されます。結果が「出力ログ」領域に表示されます。

「作成」ボタンがグレー表示されていることに注意してください。これで、スクリプトの構成を始めることができます。

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

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

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

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

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

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

(省略可能) 停止コマンドの場所を入力するか、「ブラウズ」をクリックして停止コマンドの場所を指定します。

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

(省略可能) 確認コマンドの場所を入力するか、「ブラウズ」をクリックして確認コマンドの場所を指定します。

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

(省略可能) 検証コマンドの場所を入力するか、「ブラウズ」をクリックして検証コマンドの場所を指定します。

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

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

「構成」をクリックします。

Agent Builder によりスクリプトが構成されます。

注 –
Agent Builder は、ベンダー名とアプリケーション名を連結してパッケージ名を作成します。

スクリプトのパッケージが作成され、次のディレクトリに置かれます。
```
working-dir/vendor-name-application/pkg
```
たとえば、/export/wdir/NETapp/pkg のようになります。

クラスタの各ノード上で、スーパーユーザーになるか、RBAC 承認 solaris.cluster.modify を提供する役割になります。

クラスタの各ノード上で、完成したパッケージをインストールします。
# 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
```
注 –
マニュアルページとスクリプト名は、以前に「Create」画面で入力したアプリケーション名の前にスクリプト名を付けたものに対応します (たとえば、startapp のようになります)。

クラスタのいずれかのノードでリソースを構成し、アプリケーションを起動します。

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

4 つのスクリプトは次のとおりです。

起動スクリプト: リソースを構成し、RGM の制御下にあるアプリケーションを起動します。
停止スクリプト: アプリケーションを停止し、リソースやリソースグループを停止します。
削除スクリプト: 起動スクリプトによって作成されたリソースやリソースグループを削除します。

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

構成ファイルをカスタマイズすれば、(通常は scrgadm および scswitch コマンドへの引数として指定される) リソースグループやそのほかの引数の独自の名前を指定できます。スクリプトをカスタマイズしないと、Agent Builder がこれらの引数に対しデフォルト値を設定します。

Sun Cluster 管理コマンドを使って、GDS を使用するサービスを作成

この節では、GDS に引数をどのように入力するかについて説明します。既存の Sun Cluster 管理コマンド、たとえば clresourcetype、clresourcegroup、clresource などを使って、GDS の保守と管理を行います。

スクリプトが適切な機能を提供している場合は、この節で述べる低位レベルの管理コマンドを使用する必要はありません。ただし、GDS ベースのリソースをより細かく制御する必要がある場合は、低位レベルの管理コマンドを使用できます。これらのコマンドはスクリプトによって実行されます。

Sun Cluster 管理コマンドを使って GDS ベースの高可用性サービスを作成する方法

スーパーユーザーになるか、RBAC 承認 solaris.cluster.modify を提供する役割になります。

リソースタイプ SUNW.gds を登録します。
# clresourcetype register SUNW.gds

LogicalHostname リソースとフェイルオーバーサービス自体を含むリソースグループを作成します。
# clresourcegroup create haapp_rg

LogicalHostname リソースのリソースを作成します。
# clreslogicalhostname create -g haapp_rg hhead

フェイルオーバーサービス自体のリソースを作成します。

# clresource create -g haapp_rg -t SUNW.gds
        -p Validate_command="/export/app/bin/configtest" \
        -p Scalable=false -p Start_timeout=120 \
        -p Stop_timeout=120 -p Probe_timeout=120 \
        -p Port_list="2222/tcp" \
        -p Start_command="/export/ha/appctl/start" \
        -p Stop_command="/export/ha/appctl/stop" \
        -p Probe_command="/export/app/bin/probe" \
        -p Child_mon_level=0 -p Network_resources_used=hhead \
        -p Failover_enabled=TRUE -p Stop_signal=9 haapp_rs

リソースグループ haapp_rg を、管理された状態でオンラインにします。
# clresourcegroup online -M haapp_rg

Sun Cluster 管理コマンドを使って GDS ベースのスケーラブルサービスを作成する方法

スーパーユーザーになるか、RBAC 承認 solaris.cluster.modify を提供する役割になります。

リソースタイプ SUNW.gds を登録します。
# clresourcetype register SUNW.gds

SharedAddress リソースのリソースグループを作成します。
# clresourcegroup create sa_rg

SharedAddress リソース hhead をリソースグループ sa_rg 内に作成します。
# clressharedaddress create -g sa_rg hhead

スケーラブルサービスのリソースグループを作成します。
# clresourcegroup create -S -p RG_dependencies=sa_reg app_rg

スケーラブルサービスのリソースを作成します。

# clresource create -g app_rg -t SUNW.gds
        -p Validate_command="/export/app/bin/configtest" \
        -p Scalable=TRUE -p Start_timeout=120 \
        -p Stop_timeout=120 -p Probe_timeout=120 \
        -p Port_list="2222/tcp" \
        -p Start_command="/export/app/bin/start" \
        -p Stop_command="/export/app/bin/stop" \
        -p Probe_command="/export/app/bin/probe" \
        -p Child_mon_level=0 -p Network_resource_used=hhead \
        -p Failover_enabled=TRUE -p Stop_signal=9 app_rs

ネットワークリソースを含むリソースグループをオンラインにします。
# clresourcegroup online sa_reg

リソースグループ app_rg を、管理された状態でオンラインにします。
# clresourcegroup online -M app_reg

Agent Builder のコマンド行インタフェース

Agent Builder には、GUI が提供するのと同じ機能を提供するコマンド行インタフェースが組み込まれています。コマンド行インタフェースは scdscreate と scdsconfig コマンドからなります。詳細は、scdscreate(1HA) と scdsconfig(1HA) のマニュアルページを参照してください。

コマンド行バージョンの Agent Builder を使って、GDS を使用するサービスを作成する

この節では、「Agent Builder を使って、GDS を使用するサービスを作成」と同じ手順を、コマンド行インタフェースを使ってどのように実行するかについて説明します。

スーパーユーザーになるか、RBAC 承認 solaris.cluster.modify を提供する役割になります。

サービスを作成します。
- フェイルオーバーサービスの場合:
  # scdscreate -g -V NET -T app -d /export/wdir
- スケーラブルサービスの場合:
  # scdscreate -g -s -V NET -T app -d /export/wdir
注 –
-d 引数は任意です。この引数を指定しないと、現在のディレクトリが作業ディレクトリになります。

サービスを構成します。
# scdsconfig -s "/export/app/bin/start" \ -e "/export/app/bin/configtest" \ -t "/export/app/bin/stop" \ -m "/export/app/bin/probe" -d /export/wdir
プロパティー変数を指定できます。プロパティー変数については、「プロパティー変数の使用」を参照してください。

注 –
起動コマンド (scdsconfig -s) のみ必須です。ほかのオプションと引数はすべて任意です。

クラスタの各ノード上で、完成したパッケージをインストールします。
# 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
```
注 –
マニュアルページとスクリプト名は、以前に「Create」画面で入力したアプリケーション名の前にスクリプト名を付けたものに対応します (たとえば、startapp のようになります)。

クラスタのいずれかのノードでリソースを構成し、アプリケーションを起動します。

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

startapp スクリプトの引数は、リソースのタイプがフェイルオーバーかスケーラブルかで異なります。

注 –

# 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]

第 10 章 汎用データサービス

GDS の概念

コンパイル済みリソースタイプ

GDS を使用することの利点と欠点

GDS を使用するサービスの作成方法

GDS と Agent Builder

GDS と Sun Cluster 管理コマンド

GDS ベースのサービスを作成する方法の選択

GDS によるイベントのロギング

GDS ログファイル

必須の GDS プロパティー

Start_command プロパティー

Port_list プロパティー

任意の GDS プロパティー

Child_mon_level プロパティー

Failover_enabled プロパティー

Log_level プロパティー

Network_resources_used プロパティー

Probe_command プロパティー

Probe_timeout プロパティー

Start_timeout プロパティー

Stop_command プロパティー

Stop_signal プロパティー

Stop_timeout プロパティー

Validate_command プロパティー

Validate_timeout プロパティー

Agent Builder を使って、GDS を使用するサービスを作成

GDS ベースのスクリプトの作成と構成

Agent Builder を起動し、スクリプトを作成する

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

Agent Builder からの出力

Sun Cluster 管理コマンドを使って、GDS を使用するサービスを作成

Sun Cluster 管理コマンドを使って GDS ベースの高可用性サービスを作成する方法

Sun Cluster 管理コマンドを使って GDS ベースのスケーラブルサービスを作成する方法

Agent Builder のコマンド行インタフェース

コマンド行バージョンの Agent Builder を使って、GDS を使用するサービスを作成する

第 10 章汎用データサービス

`Start_command` プロパティー

`Port_list` プロパティー

`Child_mon_level` プロパティー

`Failover_enabled` プロパティー

`Log_level` プロパティー

`Network_resources_used` プロパティー

`Probe_command` プロパティー

`Probe_timeout` プロパティー

`Start_timeout` プロパティー

`Stop_command` プロパティー

`Stop_signal` プロパティー

`Stop_timeout` プロパティー

`Validate_command` プロパティー

`Validate_timeout` プロパティー