AdminTask オブジェクトの Utility コマンド・グループ

Jython または Jacl スクリプト言語を使用すると、wsadmin ツールでサーバーを管理することができます。ユーティリティー・グループの コマンドおよびパラメーターは、ノードのホスト名の変更、デプロイメント・マネージャーの名前の照会、 およびシステムが単一サーバーか Network Deployment かの判断に 使用できます。

AdminTask オブジェクトの Utility コマンド・グループには、以下のコマンドが含まれます。

changeHostName

changeHostName コマンドは、ノードのホスト名を変更する場合に使用します。

ターゲット・オブジェクト

なし

パラメーターおよび戻り値

-hostName
新規ホスト名。(ストリング、必須)
-nodeName
ホスト名が変更されるノードの名前。(ストリング、必須)

オプション・パラメーター:

-systemName
このノードが稼働する z/OS システムの名前。 このフィールドは、ノードがシステム間で (例えば、システム SYSA からシステム SYSB に) 移動される場合のみ必要です。 このパラメーターに指定する値がよく分からない場合には、 z/OS システムで IPLINFO コマンドを実行して Sysname= フィールドに表示される名前を、このパラメーターの値として使用してください。
注: changeHostName コマンドを対話式に実行すると、 systemName パラメーターが表示されますが、これは、z/OS システムの場合にのみ使用されます。 systemName パラメーターは、server.xml ファイルで was.ConfiguredSystemName プロパティーの値として定義された z/OS システム名を表します。systemName パラメーターが選択されると、このプロパティーは変更されます。
-regenDefaultCert
デフォルトの証明書を再生成する要求。 デフォルトの証明書を再生成する場合、このパラメーターに有効な値は "true" のみです。 その他の値はすべて、デフォルトの証明書を再生成しないことを想定しています。 ストリング引数は、ブール値として処理されます。 ストリング引数が非ヌルで、大/小文字の区別を無視してストリング "true" と等価であれば、戻されるブール値は、値 true を示します。 regenDefaultCert パラメーターは AdminTask.createChainedCertificate と同様に動作し、そのデフォルト値は以下のとおりです。
  • -keyStoreName "NodeDefaultKeyStore"
  • -keyStoreScope "(node):" + nodeName
  • -certificateAlias" "default_" + hostName
  • -certificateCommonName" nodeName
  • -certificateOrganization" "IBM"
  • -certificateOrganizationalUnit" nodeName
  • -certificateCountry "US"
注: AdminTask.createChainedCertificate パラメーターと regenDefaultCert パラメーターのいずれの場合も、デプロイメント・マネージャー・ノードを使用すると、-keyStoreName 値は -keyStoreName "CellDefaultKeyStore" に変わり、-keyStoreScope 値は -keyStoreScope "(cell):" + cellname に変わります。

この切り替えは、証明書パラメーターのデフォルト値に関していろいろ仮定する簡易切り替えです。 デフォルト値が使用されない場合は、代わりに AdminTask.createChainedCertificate または regenDefaultCert を使用する必要があります。

以下の機能の詳細に注意してください。
  • keyStoreName および keyStoreScope は、regenDefaultCert パラメーターでは無効です。
  • changeHostName コマンドを実行する時、certificateCommonName (新規証明の CN) を指定することはできません。新規ホスト名を CN として指定するには、AdminTask.createChainedCertificate を使用する必要があります。

バッチ・モードの使用例:

  • Jacl を使用:

    $AdminTask changeHostName {-hostName host_name -nodeName node_name 
    -systemName system_name}       
  • Jython ストリングを使用:

    AdminTask.changeHostName('-hostName host_name -nodeName node_name 
    -systemName system_name') 
  • Jython リストを使用:

    AdminTask.changeHostName(['-hostName', 'host_name', '-nodeName', 'node_name',
    '-systemName', 'system_name'])

対話モードの使用例:

  • Jacl を使用:

    $AdminTask changeHostName {-interactive}
  • Jython ストリングを使用:

    AdminTask.changeHostName ('[-interactive]')
  • Jython リストを使用:

    AdminTask.changeHostName (['-interactive'])

getDmgrProperties

getDmgrProperties コマンドは、デプロイメント・マネージャーの名前を戻す場合に使用します。

ターゲット・オブジェクト

なし

パラメーターおよび戻り値

  • パラメーター: なし
  • 戻り値: Network Deployment システムのデプロイメント・マネージャーの名前。 システムが単一サーバーの場合、空ストリングを戻します。

バッチ・モードの使用例:

  • Jacl を使用:

    $AdminTask getDmgrProperties {}
  • Jython を使用:

    AdminTask.getDmgrProperties()

isFederated

isFederated コマンドは、システムが単一サーバーであるのかネットワーク・デプロイメントであるのかを調べるために使用します。

ターゲット・オブジェクト

なし

パラメーターおよび戻り値

  • パラメーター: なし
  • 戻り値: ブール値。システムが Network Deployment システムの場合は true。 それ以外の場合、false を戻します。

バッチ・モードの使用例:

  • Jacl を使用:
    $AdminTask isFederated {}
  • Jython ストリングを使用:
    AdminTask.isFederated ()

renameCell

新フィーチャー 新フィーチャー:
renameCell コマンドを使用して、スタンドアロン・アプリケーション・サーバー、デプロイメント・マネージャー、管理エージェント、ジョブ・マネージャー、および統合ノードのプロファイルのセル名を変更します。このコマンドは、wsadmin ローカル・モード、つまり wsadmin -conntype none でのみ実行可能です。newfeat
トラブルの回避 (Avoid trouble) トラブルの回避 (Avoid trouble): 異なるいくつかの WebSphere Application Server バージョンでインストールされたノードが 1 つのセルに含まれる混合セル環境では、 renameCell コマンドを使用しないでください。gotcha

ターゲット・オブジェクト

なし

パラメーターおよび戻り値

-newCellName
新規セル名。(ストリング、必須)
-dmgr_host
デプロイメント・マネージャー・コンピューターのホストまたは IP アドレスの名前。(ストリング、 コマンドが統合ノードで実行される場合は必須)
-dmgr_port
Java Management Extensions (JMX) 接続ポート。(ストリング、 コマンドが統合ノードで実行される場合は必須。指定されない場合、デフォルト値「8879」が使用されます)
-connType
デプロイメント・マネージャーへの接続に使用する JMX コネクター・タイプ。SOAP は、このコマンドのデフォルトの JMX コネクター・タイプです。他の有効なタイプには、JSR160RMI やリモート・メソッド呼び出し (RMI) があります。(ストリング、 コマンドが統合ノードで実行される場合は必須。指定されない場合、デフォルト値「SOAP」が使用されます)
-userName
セキュリティーが有効な場合、認証のためのユーザー名。(ストリング、 コマンドが統合ノードで実行され、セキュリティーが有効の場合は必須)
-password
セキュリティーが有効な場合、認証のためのパスワード。(ストリング、 コマンドが統合ノードで実行され、セキュリティーが有効の場合は必須)

オプション・パラメーター:

-regenCerts
セルのすべてのノードの Secure Sockets Layer (SSL) 証明書を再生成するかどうかを決定します。デフォルト鍵ストアの証明書のみが再生成されます。このパラメーターは、z/OS オペレーティング・システム上のセルには適用されません。証明書を再生成すると、サーバーにアクセスするクライアントが、新しい証明書を取得することでサーバーとのトラストを再確立する可能性があることに留意してください。 デフォルト値は false です。セルのノードの SSL 証明書を再生成するには、true に設定します。(ブール値、オプション)
-updateJaccContextID
Java Authorization Contract for Containers (JACC) プロバイダーによって使用されるアプリケーションのセキュリティー・コンテキスト ID を更新するかどうかを決定します。デフォルト値は false です。セキュリティー・コンテキスト ID を更新するには、true に設定します。(ブール値、オプション)

バッチ・モードの使用例:

  • Jython ストリングを使用:
    AdminTask.renameCell('-newCellName new_cell_name')
  • Jython リストを使用:
    AdminTask.renameCell(['-newCellName', 'new_cell_name'])

対話モードの使用例:

  • Jython ストリングを使用:
    AdminTask.renameCell ('[-interactive]')
  • Jython リストを使用:
    AdminTask.renameCell (['-interactive'])

renameCell を使用するシナリオ例

トラブルの回避 (Avoid trouble) トラブルの回避 (Avoid trouble): renameCell コマンドを使用してノードのセル名を変更する前に、 profile_root/bin ディレクトリーから backupConfig ツールでそのノード構成をバックアップすることをお勧めします。 renameCell コマンドの結果に満足できない場合、および renameCell コマンドの実行が予期せず失敗した場合、 restoreConfig ツールを使用してバックアップ構成をリストアします。gotcha
トラブルの回避 (Avoid trouble) トラブルの回避 (Avoid trouble): renameCell コマンドを実行する前に、profile_root/bin/setupCmdLine スクリプト・ファイルをバックアップしてください。 当該コマンドは、このファイル内のセル名を新しいセル名で更新しますが、このコマンドを実行した結果生じる構成変更をユーザーが破棄することにした場合に、それを元に戻して変更することができません。 そうする場合は、構成変更を破棄した後にファイルをリストアする必要があります。 そうでないと、このプロファイル内のサーバーを開始できなくなります。gotcha
スタンドアロン・アプリケーション・サーバーのセルの名前変更:
  • スタンドアロン・サーバーを停止します。
  • ローカル・モードで wsadmin を使用して、セルを名前変更します。
    AdminTask.renameCell('-newCellName new_cell_name')
デプロイメント・マネージャーとその統合ノードのセルの名前変更:

ネットワーク・デプロイメント・トポロジーのセルを名前変更するには、 デプロイメント・マネージャー・ノード/プロファイルとすべての統合ノード/プロファイルでコマンドが実行されなければなりません。

トラブルの回避 (Avoid trouble) トラブルの回避 (Avoid trouble): セルがマルチセル・トポロジーの一部である場合は、これらのステップの前に、このセルを他のセルからリンク解除して、 ステップの後に再度リンクしてください。gotcha
  • デプロイメント・マネージャー・サーバー、ノード・エージェント・サーバー、およびすべてのアプリケーション・サーバーを含む、セル内のすべてのサーバーを停止します。
  • デプロイメント・マネージャー・ノード/プロファイルのセルの名前を変更します。 ローカル・ノードで wsadmin で下記のコマンドを実行します。 これによって、dmgr マスター・リポジトリーでの SSL 証明書の変更とともに、セル名の変更が行われます。
    AdminTask.renameCell('[-newCellName new_cell_name]')
  • セル内のすべての統合ノード/プロファイルについてセル名変更コマンドを実行します。
  • デプロイメント・マネージャー・サーバーを始動します。
  • 各ノード・エージェントのプロファイルで、およびデプロイメント・マネージャー・ノード以外のすべてのノードについて、 ローカル・モードで wsadmin を開始し、以下に示したコマンドを実行します。
    AdminTask.renameCell('[-newCellName new_cell_name –dmgr_host dmgr_hostname –dmgrPort dmgr_connector_port –connType SOAP –username my_user –password my_password]')
管理エージェント・サーバーのセルの名前変更:
  • 管理エージェント・サーバーを停止します。
  • ローカル・モードで wsadmin を使用して、セルを名前変更します。
    AdminTask.renameCell('-newCellName new_cell_name')
注: 管理エージェント・サーバーに登録されたスタンドアロン・アプリケーション・サーバーのセルを名前変更する場合は、 まず、その管理サーバーでそのスタンドアロン・ノードを登録解除する必要があります。 管理サーバーがスタンドアロン・ノードを引き続き管理するようにする場合は、 セル名変更コマンドの実行後に、ノードを管理サーバーに再び登録することが必要になります。
ジョブ・マネージャー・サーバーのセルの名前変更:
  • ジョブ・マネージャー・サーバーを停止します。
  • ローカル・モードで wsadmin を使用して、セルを名前変更します。
    AdminTask.renameCell('-newCellName new_cell_name')
    トラブルの回避 (Avoid trouble) トラブルの回避 (Avoid trouble): これは、スタンドアロン・ジョブ・マネージャー・プロファイルの場合のみです。 ジョブ・マネージャーとして機能しているデプロイメント・マネージャーには、これを使用しないでください。gotcha
マルチセル・トポロジー内のセルの名前変更:

スター型トポロジーなど、マルチセル・トポロジー内のセルを名前変更するには、名前変更の前に、そのセルを他のセルから切り離す必要があります。 名前変更後、セルを他のセルに再び接続してください。


トピックのタイプを示すアイコン 参照トピック



タイム・スタンプ・アイコン 最終更新: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rxml_atutility
ファイル名:rxml_atutility.html