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


ターゲット・オブジェクト
なし
パラメーターおよび戻り値
- -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 を使用するシナリオ例


- スタンドアロン・アプリケーション・サーバーのセルの名前変更:
- スタンドアロン・サーバーを停止します。
- ローカル・モードで wsadmin を使用して、セルを名前変更します。
AdminTask.renameCell('-newCellName new_cell_name')
- デプロイメント・マネージャーとその統合ノードのセルの名前変更:
ネットワーク・デプロイメント・トポロジーのセルを名前変更するには、 デプロイメント・マネージャー・ノード/プロファイルとすべての統合ノード/プロファイルでコマンドが実行されなければなりません。
トラブルの回避 (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): これは、スタンドアロン・ジョブ・マネージャー・プロファイルの場合のみです。 ジョブ・マネージャーとして機能しているデプロイメント・マネージャーには、これを使用しないでください。gotcha
- マルチセル・トポロジー内のセルの名前変更:
スター型トポロジーなど、マルチセル・トポロジー内のセルを名前変更するには、名前変更の前に、そのセルを他のセルから切り離す必要があります。 名前変更後、セルを他のセルに再び接続してください。