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