JP1/Performance Management リファレンス
形式
jpcstop サービスキー [lhost=論理ホスト名] [inst=インスタンス名] [kill=immediate]
機能
jpcstopコマンドは,ローカルホストのPerformance Managementプログラムのサービスを停止するコマンドです。リモートホストのPerformance Managementプログラムのサービスは,停止できません。
Performance Managementプログラムのサービスの状態を確認するには,jpcctrl listコマンドを使用してください。jpcstopコマンドを二重実行したり,jpcstartコマンドと同時に実行したりできません。
停止対象サービスにPFM - Managerが含まれ,コマンドを実行するPFM - Managerホストでヘルスチェック機能が有効になっている場合,PFM - Managerのサービスの一部としてヘルスチェックエージェントも停止します。なお,サービスキーにagt0は指定できません。
コマンドを実行できるホスト
- PFM - Manager
- PFM - Agent
- PFM - Base
実行権限
- Windowsの場合
- Administrators権限を持つユーザー(WindowsのUAC機能が有効な場合は管理者コンソールから実行)
- UNIXの場合
- rootユーザー権限を持つユーザー
格納先ディレクトリ
- Windowsの場合
- インストール先フォルダ\tools\
- UNIXの場合
- /opt/jp1pc/tools/
引数
サービスキー
停止するサービスのサービスキー名を指定します。指定できるサービスキーを次に示します。
- all:すべてのPerformance Managementプログラムのサービスを停止します。
- mgr:PFM - Managerサービス(Action Handlerサービスを除く)を停止します。
- act:Action Handlerサービスを停止します。
- stat:Status Serverサービスを停止します。
PFM - Agentのサービスのサービスキーについては,各PFM - Agentマニュアルの,付録に記載されている識別子一覧を参照してください。
lhost=論理ホスト名
コマンドを実行するホスト環境を指定します。コマンドを実行するマシンに論理ホストが構成されている場合,この引数を使用します。1〜32バイトの半角英数字で指定します。空白文字は,指定できません。
指定を省略した場合,物理ホストが仮定されます。ワイルドカード文字は使用できません。
inst=インスタンス名
特定のインスタンスのサービスを停止する場合は,インスタンス名を指定します。このオプションは,インスタンス環境を持つPFM - Agentのサービスにだけ有効となります。それ以外のサービスについては,このオプションは無視されます。1〜32バイトの半角英数字で指定します。
kill=immediate
クラスタ運用時に,起動中のプロセスを強制的に停止させる場合にだけ指定します。サービスキーにallを指定した場合,同一ホスト上で起動中のすべてのプロセスを停止します。all以外のサービスキーを指定した場合,そのサービスに対応するすべてのプロセスを停止します。ただし,instオプションを指定して,インスタンス単位でプロセスを停止させることはできません。
- 注
- このオプションは,クラスタ運用時にプロセスを強制停止させる場合にだけ使用してください。
注意事項
- 引数は,「形式」にある順番で指定してください。
- コマンドを実行して戻り値103が返された場合,Performance Managementプログラムのサービス停止処理の監視が,タイムアウトになったことを示します。しばらくしてからjpcstopコマンドを再実行することで対処してください。頻繁にこの現象が発生する場合は,保守資料を採取したあと,システム管理者に連絡してください。保守資料の採取方法については,マニュアル「JP1/Performance Management システム構築・運用ガイド」の,トラブルへの対処方法について説明している章を参照してください。
- jpcstopコマンドでPFMサービスを停止している間に,Ctrl+Cキーやシグナルでコマンドを中断しても,すでに停止要求を開始しているサービスは,そのまま停止処理を続行します。その際,再度jpcstopコマンドでサービスを停止しようとしても,「KAVE05034-E サービスを停止することができませんでした」のメッセージが表示されることがあります。共通メッセージログでサービスの停止を確認して,再度jpcstopコマンドを実行してください。
- コマンドの実行をCtrl+Cキーやシグナルで中断した場合,特定の戻り値が返りません。そのため,コマンドをCtrl+Cキーやシグナルで中断した場合は戻り値を無視してください。
- ステータス管理機能をサポートしているホストの場合,サービスキーにallまたはstatを指定したとき以外はStatus Serverサービスは停止されません。
- サービスキーにallを指定しているときに-lhostオプションを指定した場合は,Status Serverサービスは停止されません。
- ステータス管理機能が有効の場合に,物理ホストでサービスキーにallまたはstatオプションを指定してコマンドを実行した場合,論理ホスト上でStatus Serverに依存するサービス(ステータス管理機能をサポートするバージョン)が一つ以上起動していたときは,メッセージ「KAVE06022-I Status Serverに依存しているサービスが起動中のためStatus Serverは停止されません」と表示され,戻り値108を返します。
戻り値
0 正常終了した。 1 引数の指定に誤りがある。 2 コマンドの実行権限がない。 3 指定されたサービスは,すでに停止している。 5 指定されたサービスがインストールされていない。 10 コマンドはほかのセッションで実行中である。 100 Performance Managementの環境が不正である。 102 指定された論理ホスト名またはインスタンスは,セットアップされていない。 103 停止処理の監視がタイムアウトになった。 107 Windowsサービスコントロールマネージャーなどのほかのプロセスからサービス起動処理および停止処理が実行されている。 108 Status Serverサービスに依存するサービスが起動しているため,Status Serverを停止できない。 255 予期しないエラーが発生した。
使用例1
すべてのPerformance Managementプログラムのサービスを停止する場合のコマンド実行例を次に示します。
jpcstop all
使用例2
PFM - Agent for Oracleのうち,インスタンスoracleAのサービスだけ停止する場合のコマンド実行例を次に示します。
jpcstop agto inst=oracleA
All Rights Reserved. Copyright (C) 2006, 2008, Hitachi, Ltd.