stopManager コマンド
stopManager コマンドは、WebSphere® Application Server Network Deployment・マネージャー・プロセスの 構成ファイルを読み取ります。
このコマンドは、Java™ Management Extensions (JMX) コマンドをマネージャーに送信し、 マネージャーをシャットダウンするように指示します。 デフォルトでは、stopManager コマンドは、マネージャーがシャットダウン・プロセスを 完了するまで待ってから、コマンド行に制御を戻します。 即時に戻す -nowait オプションや、stopManager コマンドの振る舞いを制御するその他のオプションもあります。 このコマンドを実行する状況について詳しくは、コマンド行ツールの使用を参照してください。
Windows オペレーティング・システムを使用しており、デプロイメント・マネージャーを Windows サービスとして実行している場合は、
stopManager コマンドは、関連した Windows サービスを停止し、
デプロイメント・マネージャーも停止します。
stopServer コマンドは、サーバーのシャットダウンが完了したときに制御を戻しますが、IBM® i プロセスが終了する前に戻すことも可能です。
Java 仮想マシンがメモリー・プールに戻さなければならないメモリーの量によって異なりますが、処理が終了するには数秒から数分かかります。
処理が終わるまで、サーバーを再開しないでください。
処理が完全に終わったかどうかを判別するためには、WRKACTJOB SBS(subsystem) CL コマンドを使用してください。
デフォルトでは、サブシステムは QWAS85 です。
構文
コマンド構文は次のようになります。
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[z/OS]](../images/ngzos.gif)
stopManager [options]
![[IBM i]](../images/iseries.gif)
stopManager [<server>] [options]
パラメーター
stopManager コマンドで使用可能なオプションは、以下のとおりです。
- -nowait
- stopManager コマンドに対して、デプロイメント・マネージャー・プロセスが正常にシャットダウンされるまで待たないように指示します。
- -quiet
- stopManager コマンドが通常モードで印刷する進行情報を抑止します。
- -logfile <fileName>
- トレース情報を書き込むログ・ファイルのロケーションを指定します。デフォルトでは、ログ・ファイルは stopServer.log という名前で、logs ディレクトリーに作成されます。
-profileName
マルチプロファイル・システムで、アプリケーション・サーバー・プロセスのプロファイルを定義します。 -profileName オプションは、単一プロファイル環境で実行する場合は必要ありません。 このオプションのデフォルトは、 デフォルト・プロファイルです。
- -replacelog
- 現行ログに追加する代わりに、ログ・ファイルを置き換えます。
- -trace
- デバッグのために、ファイルにトレース情報を生成します。トレース出力は、profile_root/logs ディレクトリーにある stopmanager.log ファイルに書き込まれます。
- -timeout <seconds>
- タイムアウトが発生しエラーが戻される前の、マネージャーのシャットダウンが完了するまでの待ち時間を指定します。
- -statusport <portNumber>
- デプロイメント・マネージャー状況のコールバック用のポート番号を設定する管理者用オプション・パラメーター。ツールは、このポートを開いて、 デプロイメント・マネージャーから完全に停止する直前の状況のコールバックを待機します。このパラメーターが設定されていない場合、未使用のポートが自動的に割り振られます。
- -conntype <type>
- デプロイメント・マネージャーへの接続に使用する Java Management Extensions (JMX) コネクター・タイプを指定します。 有効なタイプは、SOAP またはリモート・メソッド呼び出し (RMI) です。
- -port <portNumber>
- 明示的に使用するデプロイメント・マネージャー JMX ポートを指定します。 これにより、情報を得るために、構成ファイルを読み取らなくても済みます。
- -username <name>
- デプロイメント・マネージャーでセキュリティーが使用可能な場合、 認証するユーザー名を指定します。 -user オプションと同様の働きをします。
- -user <name>
- デプロイメント・マネージャーでセキュリティーが使用可能な場合、 認証するユーザー名を指定します。 -username オプションと同様の働きをします。
- -password <password>
- セキュリティーがデプロイメント・マネージャーで使用可能である場合、認証にパスワードを指定します。
注: 機密保護機能のある環境で実行中にユーザー ID とパスワードをまだ提供していない場合は、 次のエラー・メッセージが表示されます。
この問題を回避するには、ユーザー ID とパスワードの情報を指定してください。ADMN0022E: Access denied for the stop operation on Server MBean due to insufficient or empty credentials.
- -help
- 使用ステートメントを出力します。
- -?
- 使用ステートメントを出力します。
使用のシナリオ
以下は、正しい構文の例です。
stopManager
stopManager -nowait
stopManager -trace (produces the stopmanager.log file)