createMissingSIBEnginePolicy コマンド
createMissingSIBEnginePolicy コマンドを使用して、サービス統合バスのメンバーであるクラスター内のメッセージング・エンジンのコア・グループ・ポリシーを作成します。
コマンドを実行するには、wsadmin スクリプト・クライアントの AdminTask オブジェクトを使用します。
wsadmin スクリプト・クライアントは Qshell から実行されます。.
詳しくは、wsadmin スクリプトを使用した WebSphere スクリプトを実行するための Qshell の構成.
このコマンドが有効なのは 、WebSphere® Application Server バージョン 7.0 以降 のアプリケーション・サーバーで使用される場合のみです。 これより前のバージョンでは使用しないでください。
- Jython で使用可能なサービス統合バス・コマンドのリストと、各コマンドの簡単な説明を見るには、wsadmin プロンプトで以下のコマンドを入力します。
print AdminTask.help('SIBAdminCommands')
- 特定のコマンドの概要ヘルプの場合は、wsadmin プロンプトで以下のコマンドを入力します。
print AdminTask.help('command_name')
AdminConfig.save()
目的
メッセージング・エンジンのコア・グループ・ポリシーを作成するには、このコマンドを使用します。例えば、この作業は、createSIBEngine コマンドを使用してクラスターの新規メッセージング・エンジンを作成した後で行う必要があります。 このコマンドは、クラスターでメッセージング・エンジン・ポリシー・アシスタンスが使用可能になっており、カスタム・ポリシーが指定されている場合のみ使用してください。これを行うには、addSIBusMember コマンドまたは modifySIBusMemberPolicy コマンドを使用します。
ターゲット・オブジェクト
メッセージング・エンジン。
必須パラメーター
- -name messaging_engine_name
- コア・グループ・ポリシーの作成対象となるメッセージング・エンジンの名前。
オプション・パラメーター
- -failover TRUE | FALSE
- メッセージング・エンジンのホスト・サーバーに障害が起こった場合に、クラスター内のメッセージング・エンジンが、クラスターの別のサーバーにフェイルオーバーできるかどうかを指定するパラメーター。このパラメーターには、考えられる値が 2 つあります。
- TRUE
- メッセージング・エンジンはフェイルオーバーできます。
- FALSE
- メッセージング・エンジンはフェイルオーバーできません。
デフォルト値は FALSE です。クラスターでメッセージング・エンジン・ポリシー・アシスタンスが使用可能になっており、カスタム・ポリシーが指定されている場合は、このパラメーターを使用します。これを行うには、addSIBusMember コマンドまたは modifySIBusMemberPolicy コマンドを使用します。
- -failback TRUE | FALSE
- 優先サーバー・リストにあるより優先度の高いサーバーが再度使用可能になった場合に、フェイルオーバーしたクラスター内のメッセージング・エンジンが、そのサーバーにフェイルバックできるかどうかを指定するパラメーター。このパラメーターには、考えられる値が 2 つあります。
- TRUE
- メッセージング・エンジンはフェイルバックできます。このオプションを使用する 場合は、-preferredServerList パラメーターを指定してください。
- FALSE
- メッセージング・エンジンはフェイルバックできません。
デフォルト値は FALSE です。クラスターでメッセージング・エンジン・ポリシー・アシスタンスが使用可能になっており、カスタム・ポリシーが設定されている場合は、このパラメーターを使用します。これを行うには、addSIBusMember コマンドまたは modifySIBusMemberPolicy コマンドを使用します。
- -preferredServersOnly TRUE | FALSE
- クラスター内のメッセージング・エンジンは、優先サーバー・リストにあるサーバー上でのみ実行できるのか、またはクラスター内の任意のサーバー上で実行できるのかを指定するパラメーター。このパラメーターには、考えられる値が 2 つあります。
- TRUE
- メッセージング・エンジンは、優先サーバー・リストにあるサーバー上でのみ実行できます。このオプションを使用する 場合は、-preferredServerList パラメーターを指定してください。
- FALSE
- メッセージング・エンジンは、クラスター内のどのサーバーでも実行できます。
デフォルト値は FALSE です。クラスターでメッセージング・エンジン・ポリシー・アシスタンスが使用可能になっており、カスタム・ポリシーが設定されている場合は、このパラメーターを使用します。これを行うには、addSIBusMember コマンドまたは modifySIBusMemberPolicy コマンドを使用します。
- -preferredServerList {{node server}}
- クラスター内のメッセージング・エンジンを実行するサーバーの優先順のリスト。リストにあるサーバーごとに、サーバーが稼働するノードの名前とサーバーの名前の両方を指定します。このパラメーターにはデフォルト値はありません。クラスターでメッセージング・エンジン・ポリシー・アシスタンスが使用可能になっており、カスタム・ポリシーが設定されている場合は、このパラメーターを使用します。これを行うには、addSIBusMember コマンドまたは modifySIBusMemberPolicy コマンドを使用します。
例
メッセージング・エンジン cluster1.000-bus1 のコア・グループ・ポリシーを作成します。メッセージング・エンジンがフェイルオーバーできてもフェイルバックはできず、さらに server1 および server2 でのみ実行できるように、コア・グループ・ポリシーを構成します。
AdminTask.createMissingSIBEnginePolicy('[-name cluster1.000-bus1
-failover true -failback false -preferredServersOnly true
-preferredServerList [[node1 server1] [node2 server2]]]')