Oracle Solaris Cluster リファレンスマニュアル

印刷ビューの終了

更新: 2015 年 9 月
 
 

scdsconfig (1HA)

名前

scdsconfig - リソースタイプテンプレートの構成

形式

scdsconfig -s start-command [-u start-method-timeout] [-e 
     validate-command] [-y validate-method-timeout] [-t stop-command] 
     [-v stop-method-timeout] [-m probe-command] [-n probe-timeout] 
     [-d working-directory]

説明

scdsconfig コマンドは、scdscreate(1HA) コマンドで作成したリソースタイプテンプレートを構成します。scdsconfig コマンドを使用すると、ネットワーク対応(クライアントサーバーモデル) アプリケーションと非ネットワーク対応(クライアントを持たない) アプリケーションの両方に対して、C、GDS(Generic Data Service)、または Korn シェルベースのテンプレートを作成できます。

scdsconfig コマンドは、アプリケーションを起動、停止、検証、およびプローブするアプリケーション固有のコマンドを構成します。また、scdsconfig コマンドを使用すると、startstopvalidate、および probe コマンドのタイムアウト値も設定できます。scdsconfig コマンドは、ネットワーク対応 (クライアントサーバーモデル) のアプリケーションと非ネットワーク対応 (クライアントレス) のアプリケーションを両方ともサポートします。ユーザーは scdscreate コマンドが実行されたディレクトリから scdsconfig コマンドを実行できます。–d オプションを使用すると、<command>scdscreate</command> を実行したディレクトリを指定できます。scdsconfig コマンドは、生成されたコード内の正しい場所にユーザー指定のパラメータを挿入することにより、リソースタイプテンプレートを構成します。生成されたソースコードの種類が C の場合、このコマンドはさらに、そのソースコードをコンパイルします。scdsconfig コマンドは、出力をインストール可能な Solaris パッケージにします。このコマンドは、scdscreate コマンドによって作成された $vendor-id $resource-type-nameディレクトリ下の pkg サブディレクトリにパッケージを作成します。

オプション

次のオプションがサポートされています。

–d working-directory

scdscreate コマンドが実行されたディレクトリを指定します。

scdscreate コマンドが実行されたディレクトリと異なるディレクトリから scdsconfig を実行する場合に、このオプションを指定します。

–e validate-command

アプリケーションを検証するために呼び出すコマンドの絶対パスを指定します。絶対パスを指定しない場合、アプリケーションは検証されません。アプリケーションの実行が成功した場合、validate-command0 の終了ステータスを返します。0 以外の終了ステータスは、アプリケーションの実行が失敗したことを示します。この場合、過去のアプリケーションの障害履歴に応じて、次の 2 つの結果のいずれかが生じます。

  • このリソースタイプのリソースは、同じノードで再起動されました。

  • このリソースを含むリソースグループは、別の健全なノードにフェイルオーバーされました。

–m probe-command

ネットワーク対応アプリケーションまたは非ネットワーク対応アプリケーションの健全性を定期的にチェックするためのコマンドを指定します。直接シェルに渡すことができる完全なコマンドを指定してください。アプリケーションが正常に実行されている場合、probe-command0 の終了ステータスで戻ります。0 以外の終了ステータスは、アプリケーションの実行が失敗したことを示します。この場合、過去のアプリケーションの障害履歴に応じて、次の 2 つの結果のいずれかが生じます。

  • このリソースタイプのリソースは、同じノードで再起動されました。

  • このリソースを含むリソースグループは、別の健全なノードにフェイルオーバーされました。

–n probe-timeout

プローブコマンドのタイムアウトを秒単位で指定します。障害の検出ミスを防ぐため、タイムアウト値は、システムの過負荷を考慮に入れて指定する必要があります。デフォルト値は 30 秒です。

–s start-command

アプリケーションを起動するコマンドを指定します。start コマンドには、直接シェルに渡すことができる完全なコマンドを指定してください。コマンド行引数を使って、ホスト名、ポート番号など、アプリケーションの起動に必要な各種構成データを指定できます。複数の独立したプロセスツリーを持つリソースタイプを作成する場合は、1 行に 1 個ずつコマンドを記述したテキストファイルを指定し、複数の異なったプロセスツリーを起動します。

–t stop-command

アプリケーションの停止コマンドを指定します。stop コマンドには、直接シェルに渡すことができる完全なコマンドを指定してください。このオプションを省略した場合、アプリケーションは、生成されたコードからのシグナルを発行することによって停止します。停止コマンドには、タイムアウト値の 80% が割り当てられます。この時間内に停止コマンドがアプリケーションを停止できない場合、SIGKILL には、タイムアウト値の 15% が割り当てられます。それでもアプリケーションを停止できない場合、停止メソッドはエラーを返して終了します。

–u start-method-timeout

起動コマンドのタイムアウトを秒単位で指定します。障害の検出ミスを防ぐため、タイムアウト値は、システムの過負荷を考慮に入れて指定する必要があります。デフォルト値は 300 秒です。

–v stop-method-timeout

停止コマンドのタイムアウトを秒単位で指定します。障害の検出ミスを防ぐため、タイムアウト値は、システムの過負荷を考慮に入れて指定する必要があります。デフォルト値は 300 秒です。

–y validate-method-timeout

起動コマンドのタイムアウトを秒単位で指定します。障害の検出ミスを防ぐため、タイムアウト値は、システムの過負荷を考慮に入れて指定する必要があります。デフォルト値は 300 秒です。

終了ステータス

次の終了ステータスコードが返されます。

0

コマンドは正常に完了しました。

0 以外

エラーが発生しました。

ファイル

working-directory /rtconfig

前のセッションの情報が格納されているため、ツールの終了と再起動をスムーズに行うことが可能です。

属性

次の属性については、attributes(5) を参照してください。

属性タイプ
属性値
使用条件
ha-cluster/developer/api
インタフェースの安定性
発展中

関連項目

ksh(1), scdsbuilder(1HA), scdscreate(1HA), attributes(5)