カタログ・サービス・ドメイン管理用タスク

Jacl または Jython スクリプト言語を使用して、WebSphere® Application Server 構成内のカタログ・サービス・ドメインを管理できます。

要件

WebSphere Application Server 環境に WebSphere eXtreme Scale クライアントをインストールしている必要があります。

すべての管理用タスクのリスト

カタログ・サービス・ドメインに関連したすべての管理用タスクのリストを取得するには、 wsadmin で以下のコマンドを実行します。
wsadmin>$AdminTask help XSDomainManagement 

コマンド

カタログ・サービス・ドメインの管理用タスクには、以下のコマンドが含まれます。

createXSDomain

createXSDomain コマンドは、新規カタログ・サービス・ドメインを登録します。
表 1. createXSDomain コマンド引数
引数 説明
-name (必須) 作成するカタログ・サービス・ドメインの名前を指定します。
-default カタログ・サービス・ドメインがセルでデフォルトかどうかを指定します。 デフォルト値は true です。(ブール値: true または false に設定)
-properties カタログ・サービス・ドメインのカスタム・プロパティーを指定します。
表 2. defineDomainServers ステップ引数
引数 説明
name_of_endpoint カタログ・サービス・エンドポイントの名前を指定します。
  • 既存のアプリケーション・サーバーの場合: エンドポイントの名前は 、cell_name¥node_name¥server_name の形式でなければなりません。
  • リモート・サーバーの場合: リモート・サーバーのホスト名を指定します。 複数のエンドポイントを同じ名前にすることができますが、 クライアント・ポートの値はそれぞれのエンドポイントで固有でなければなりません。
custom_properties カタログ・サービス・ドメイン・エンドポイントのカスタム・プロパティーを指定します。 カスタム・プロパティーがない場合、 この引数には一組の二重引用符 ("") を使用します。
endpoint_ports
カタログ・サービス・ドメイン・エンドポイントのポート番号を指定します。ポートは 、<client_port>,<listener_port> の順序で指定する必要があります。
クライアント・ポート
カタログ・サービス・ドメイン内のカタログ・サーバー間の通信に使用するポートを指定します。この値は 、WebSphere Application Server プロセスのみで稼働するカタログ・サーバーに必要で、 他で使用されていないどのポートにも設定できます。
リスナー・ポート
クライアントとの通信に使用するポートを指定します。 この値はリモート・エンドポイントに必要で、 カタログ・サービスが開始されたときに使用された値と一致している必要があります。リスナー・ポートは、 カタログ・サービスとの通信のために、クライアントおよびコンテナーによって使用されます。
WebSphere DataPower® XC10 アプライアンスのリモート・エンドポイントの場合: アプライアンスのリモート・エンドポイントに、 値 2809 を使用します。

戻り値:

バッチ・モードの使用例

バッチ・モードの場合、 コマンド項目が正しくフォーマットされていることが必要です。入力する値が適切に処理されるように、 対話モードの使用を検討してください。バッチ・モードを使用する場合、 特定のプロパティー配列を使用して -defineDomainServers ステップ引数を 定義する必要があります。このプロパティー配列のフォーマットは、name_of_endpoint custom_properties endpoint_ports です。 endpoint_ports 値は 、<client_port>,<listener_port> の順序で指定する必要があるポートのリストです。

対話モードの使用例
  • Jacl の使用:
    $AdminTask createXSDomain {-interactive}
  • Jython ストリングの使用:
    AdminTask.createXSDomain ('[-interactive]')

deleteXSDomain

deleteXSDomain コマンドは、カタログ・サービス・ドメインを削除します。

必須パラメーター:
-name
削除するカタログ・サービス・ドメインの名前を指定します。

戻り値:

バッチ・モードの使用例
  • Jacl の使用:
    $AdminTask deleteXSDomain {-name TestDomain }
  • Jython ストリングの使用:
    AdminTask.deleteXSDomain('[-name TestDomain ]')
対話モードの使用例
  • Jacl の使用:
    $AdminTask deleteXSDomain {-interactive}
  • Jython ストリングの使用:
    AdminTask.deleteXSDomain ('[-interactive]')

getDefaultXSDomain

getDefaultXSDomain コマンドは、 セルのデフォルト・カタログ・サービス・ドメインを返します。

必須パラメーター: なし

戻り値: デフォルト・カタログ・サービス・ドメインの名前。

バッチ・モードの使用例
  • Jacl の使用:
    $AdminTask getDefaultXSDomain
  • Jython ストリングの使用:
    AdminTask.getDefaultXSDomain
対話モードの使用例
  • Jacl の使用:
    $AdminTask getDefaultXSDomain {-interactive}
  • Jython ストリングの使用:
    AdminTask.getDefaultXSDomain ('[-interactive]')

listXSDomains

listXSDomains コマンドは、既存のカタログ・サービス・ドメインのリストを返します。

必須パラメーター: なし

戻り値: セル内のすべてのカタログ・サービス・ドメインのリスト。

バッチ・モードの使用例
  • Jacl の使用:
    $AdminTask listXSDomains
  • Jython ストリングの使用:
    AdminTask.listXSDomains
対話モードの使用例
  • Jacl の使用:
    $AdminTask listXSDomains {-interactive}
  • Jython ストリングの使用:
    AdminTask.listXSDomains ('[-interactive]')

modifyXSDomain

modifyXSDomain コマンドは、既存のカタログ・サービス・ドメインを変更します。

バッチ・モードの場合、 コマンド項目が正しくフォーマットされていることが必要です。入力する値が適切に処理されるように、 対話モードの使用を検討してください。バッチ・モードを使用する場合、 特定のプロパティー配列を使用して -modifyEndpoints-addEndpoints、 および -removeEndpoints ステップ引数を 定義する必要があります。このプロパティー配列のフォーマットは、name_of_endpoint host_name custom_properties endpoint_ports です。 endpoint_ports 値は 、<client_port>,<listener_port> の順序で指定する必要があるポートのリストです。

表 3. modifyXSDomain コマンド引数
引数 説明
-name (必須) 編集するカタログ・サービス・ドメインの名前を指定します。
-default true に設定した場合、選択したカタログ・サービス・ドメインがセルのデフォルトであることを指定します。 (ブール値)
-properties カタログ・サービス・ドメインのカスタム・プロパティーを指定します。
表 4. modifyEndpoints ステップ引数
引数 説明
name_of_endpoint カタログ・サービス・エンドポイントの名前を指定します。
  • 既存のアプリケーション・サーバーの場合: エンドポイントの名前は 、cell_name¥node_name¥server_name の形式でなければなりません。
  • リモート・サーバーの場合: リモート・サーバーのホスト名を指定します。 複数のエンドポイントを同じ名前にすることができますが、 リスナー・ポートの値はそれぞれのエンドポイントで固有でなければなりません。アプライアンスを構成する場合、 この値は完全修飾のドメイン名である必要があります。
endpoint_ports
カタログ・サービス・ドメイン・エンドポイントのポート番号を指定します。エンドポイントは 、<client_port>,<listener_port> の順序で指定する必要があります。
クライアント・ポート
カタログ・サービス・ドメイン内のカタログ・サーバー間の通信に使用するポートを指定します。この値は 、WebSphere Application Server プロセスのみで稼働するカタログ・サーバーに必要で、 他で使用されていないどのポートにも設定できます。
リスナー・ポート
クライアントとの通信に使用するポートを指定します。 この値はリモート・エンドポイントに必要で、 カタログ・サービスが開始されたときに使用された値と一致している必要があります。リスナー・ポートは、 カタログ・サービスとの通信のために、クライアントおよびコンテナーによって使用されます。
WebSphere DataPower XC10 アプライアンスのリモート・エンドポイントの場合: アプライアンスのリモート・エンドポイントに、 値 2809 を使用します。
表 5. addEndpoints ステップ引数
引数 説明
name_of_endpoint カタログ・サービス・エンドポイントの名前を指定します。
  • 既存のアプリケーション・サーバーの場合: エンドポイントの名前は 、cell_name¥node_name¥server_name の形式でなければなりません。
  • リモート・サーバーの場合: リモート・サーバーのホスト名を指定します。 複数のエンドポイントを同じ名前にすることができますが、 リスナー・ポートの値はそれぞれのエンドポイントで固有でなければなりません。アプライアンスを構成する場合、 この値は完全修飾のドメイン名である必要があります。
custom_properties カタログ・サービス・ドメイン・エンドポイントのカスタム・プロパティーを指定します。 カスタム・プロパティーがない場合、 この引数には一組の二重引用符 ("") を使用します。
endpoint_ports
カタログ・サービス・ドメイン・エンドポイントのポート番号を指定します。エンドポイントは 、<client_port>,<listener_port> の順序で指定する必要があります。
クライアント・ポート
カタログ・サービス・ドメイン内のカタログ・サーバー間の通信に使用するポートを指定します。この値は 、WebSphere Application Server プロセスのみで稼働するカタログ・サーバーに必要で、 他で使用されていないどのポートにも設定できます。
リスナー・ポート
クライアントとの通信に使用するポートを指定します。 この値はリモート・エンドポイントに必要で、 カタログ・サービスが開始されたときに使用された値と一致している必要があります。リスナー・ポートは、 カタログ・サービスとの通信のために、クライアントおよびコンテナーによって使用されます。
WebSphere DataPower XC10 アプライアンスのリモート・エンドポイントの場合: アプライアンスのリモート・エンドポイントに、 値 2809 を使用します。
表 6. removeEndpoints ステップ引数
引数 説明
name_of_endpoint 削除するカタログ・サービス・エンドポイントの名前を指定します。

戻り値:

バッチ・モードの使用例
  • Jacl の使用:
    $AdminTask modifyXSDomain {-name TestDomain -default true -modifyEndpoints 
    {{xhost1.ibm.com "" ,2809}} -addEndpoints {{xhost2.ibm.com "" ,2809}}} 
    -removeEndpoints {{xhost3.ibm.com}}}
  • Jython ストリングの使用:
    AdminTask.modifyXSDomain('[-name TestDomain  
    -default false -modifyEndpoints [[xhost1.ibm.com "" ,2809]] 
    -addEndpoints [[xhost3.ibm.com "" ,2809]] 
    -removeEndpoints [[xhost2.ibm.com]]]')
対話モードの使用例
  • Jacl の使用:
    $AdminTask modifyXSDomain {-interactive}
  • Jython ストリングの使用:
    AdminTask.modifyXSDomain ('[-interactive]')

testXSDomainConnection

testXSDomainConnection コマンドは、カタログ・サービス・ドメインへの接続をテストします。

必須パラメーター:
-name
接続をテストするカタログ・サービス・ドメインの名前を指定します。
オプション・パラメーター
-timeout
接続されるまで待機する最大時間を秒数で指定します。

戻り値: 接続できた場合、true が返されます。接続できなかった場合は、接続エラー情報が返されます。

バッチ・モードの使用例
  • Jacl の使用:
    $Admintask testXSDomainConnection
  • Jython ストリングの使用:
    AdminTask.testXSDomainConnection
対話モードの使用例
  • Jacl の使用:
    $AdminTask testXSDomainConnection {-interactive}
  • Jython ストリングの使用:
    AdminTask.testXSDomainConnection ('[-interactive]')

testXSServerConnection

testXSServerConnection コマンドは、カタログ・サーバーへの接続をテストします。 このコマンドは、スタンドアロン・サーバーと、カタログ・サービス・ドメインに属するサーバーの両方で機能します。

必須パラメーター:
ホスト (host)
カタログ・サーバーが存在するホストを指定します。
listenerPort
カタログ・サーバーのリスナー・ポートを指定します。
オプション・パラメーター
timeout
カタログ・サーバーに接続されるまで待機する最大時間を秒数で指定します。

戻り値:

バッチ・モードの使用例
  • Jacl の使用:
    $Admintask testXSServerConnection {-host xhost1.ibm.com -listenerPort 2809}
  • Jython ストリングの使用:
    AdminTask.testXSServerConnection('[-host xshost3.ibm.com -listenerPort 2809]')
対話モードの使用例
  • Jacl の使用:
    $AdminTask testXSServerConnection {-interactive}
  • Jython ストリングの使用:
    AdminTask.testXSServerConnection ('[-interactive]')