リソースタイプを作成する最初の段階では、Agent Builder を起動したときに表示される「作成」画面に必要な情報を入力します。すると、次の画面が表示されます。リソースタイプの作成が完了していなければ、構成画面にはアクセスできません。
構成画面には、次のフィールドがあります。
「起動コマンド」。ベースアプリケーションを起動するために任意の UNIX シェルに渡すことができる完全なコマンド行。これには、起動コマンドを指定する必要があります。このフィールドにコマンドを入力するか、「ブラウズ」ボタンを使用して、アプリケーションを起動するコマンドが記述されているファイルを指定します。
完全なコマンド行には、アプリケーションを起動するのに必要なすべての要素が含まれていなければなりません。たとえば、ホスト名、ポート番号、構成ファイルへのパスなどです。あるいは、プロパティー変数を指定することもできます。この変数については、「プロパティー変数の使用」を参照してください。Korn シェルベースのアプリケーションにコマンド行からホスト名を指定する必要がある場合は、Agent Builder が定義する $hostnames 変数を使用できます。詳細は、「Agent Builder の Korn シェルベース $hostnames 変数の使用」を参照してください。
コマンドは二重引用符 ("") で囲んではなりません。
ベースアプリケーションが複数の独立したプロセスツリーを持ち、各プロセスツリーが Process Monitor Facility (PMF) の制御下で独自のタグによって起動される場合、単一のコマンドは指定できません。代わりに、各プロセスツリーを起動するための個々のコマンドを記述したテキストファイルを作成し、そのファイルへのパスを「起動コマンド」テキストフィールドに指定する必要があります。「Agent Builder の使用にあたって」を参照してください。この節には、このファイルが適切に機能するために必要な特性が示されています。
「停止コマンド」。ベースアプリケーションを停止するために任意の UNIX シェルに渡すことができる完全なコマンド行。このフィールドにコマンドを入力するか、「ブラウズ」ボタンを使用して、アプリケーションを停止するコマンドが記述されているファイルを指定します。あるいは、プロパティー変数を指定することもできます。この変数については、「プロパティー変数の使用」を参照してください。Korn シェルベースのアプリケーションにコマンド行からホスト名を指定する必要がある場合は、Agent Builder が定義する $hostnames 変数を使用できます。詳細は、「Agent Builder の Korn シェルベース $hostnames 変数の使用」を参照してください。
このコマンドは省略可能です。
停止コマンドを指定しない場合、生成されるコードは 、次に示すように、Stop メソッドでシグナルを使用して、アプリケーションを停止します。
Stop メソッドは SIGTERM を送信してアプリケーションを停止しようとします。そして、アプリケーション用のタイムアウト値の 80% だけ待機して、停止しない場合は終了します。
SIGTERM シグナルが失敗した場合、Stop メソッドは SIGKILL を送信して、アプリケーションを停止しようとします。そして、アプリケーション用のタイムアウト値の 15% だけ待機して、停止しない場合は終了します。
SIGKILL が失敗した場合、Stop メソッドは異常終了します。タイムアウト値の残りの 5% はオーバーヘッドとみなされます。
停止コマンドは、アプリケーションが完全に停止するまで戻らないことに注意してください。
「検証コマンド」。定期的に実行され、アプリケーションの状態を検査して、0 (正常) から 100 (致命的な障害) の範囲の終了状態を戻すコマンド。このコマンドは省略可能です。このフィールドにコマンドの完全パスを入力するか、「ブラウズ」を使用して、アプリケーションを検証するコマンドが記述されているファイルを指定します。
通常は、単にベースアプリケーションのクライアントを指定します。検証コマンドを指定しない場合、生成されるコードは、リソースが使用するポートへの接続と切断を試みます。接続と切断に成功すれば、アプリケーションの状態が正常であると判断します。あるいは、プロパティー変数を指定することもできます。この変数については、「プロパティー変数の使用」を参照してください。Korn シェルベースのアプリケーションに検証コマンド行からホスト名を指定する必要がある場合は、Agent Builder が定義する $hostnames 変数を使用できます。詳細は、「Agent Builder の Korn シェルベース $hostnames 変数の使用」を参照してください。
コマンドは二重引用符 ("") で囲んではなりません。
「タイムアウト」各コマンドのタイムアウト値 (秒数)。新しい値を指定するか、Agent Builder が提供するデフォルト値を受け入れます。起動コマンドと停止コマンドのデフォルト値は 300 秒で、検証コマンドのデフォルト値は 30 秒です。