jpcspm start
形式
jpcspm start -key サービスキー [-lhost 論理ホスト名] [-inst インスタンス名]
機能
jpcspm startコマンドは,ローカルホストのPerformance Managementプログラムのサービスを起動するコマンドです。リモートホストのPerformance Managementプログラムのサービスは,起動できません。
Performance Managementプログラムのサービスの状態を確認するには,jpctool service listコマンドを使用してください。jpcspm startコマンドを二重実行したり,jpcspm stopコマンドと同時に実行したりできません。
起動対象サービスに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バイトの半角英数字で指定します。
注意事項
-
PFM - ManagerとPFM - Agent,またはPFM - ManagerとPFM - RMが,同一ホストにインストールされている場合,PFM - Agent,PFM - RM,またはAction Handlerサービスを起動するには,PFM - Managerを事前に起動しておく必要があります。PFM - ManagerとPFM - Agent,またはPFM - ManagerとPFM - RMが,別ホストにインストールされている場合は,PFM - Managerが起動されていなくても,PFM - Agent,PFM - RM,またはAction Handlerサービスはスタンドアロンモードで起動できます。ただし,スタンドアロンモードでは実行できる機能に制限があります。制限については,マニュアル「JP1/Performance Management 運用ガイド」の,Performance Managementの起動と停止について説明している章を参照してください。06-70版のPFM - Agentは,スタンドアロンモード起動に対応していません。PFM - Managerと同一ホストにインストールされているかどうかに関係なく,PFM - Managerを事前に起動しておく必要があります。
-
引数は,「形式」にある順番で指定してください。
-
コマンドを実行して戻り値103が返された場合,Performance Managementプログラムのサービス起動処理の監視が,タイムアウトになったことを示します。しばらくしてからjpcspm startコマンドを再実行することで対処してください。頻繁にこの現象が発生する場合は,保守資料を採取したあと,システム管理者に連絡してください。保守資料の採取方法については,マニュアル「JP1/Performance Management 運用ガイド」の,トラブルへの対処方法について説明している章を参照してください。
-
コマンドを実行して戻り値212が返された場合,Master Storeサービス,Agent Storeサービス,またはRemote Monitor Storeサービスのデータベースのインデックス作成に失敗したことを示します。対処方法として,ディスク容量に十分な空き容量があるかどうかを確認してください。ディスクの空き容量の目安については,マニュアル「JP1/Performance Management 設計・構築ガイド」,各PFM - Agentマニュアル,または各PFM - RMマニュアルの付録で,システム見積もりについて説明している個所を参照してください。ディスク容量に問題がないことを確認したあと,再度jpcspm startコマンドを実行してもインデックス作成に失敗する場合は,保守資料を採取したあと,システム管理者に連絡してください。保守資料の採取方法については,マニュアル「JP1/Performance Management 運用ガイド」の,トラブルへの対処方法について説明している章を参照してください。
-
コマンドの実行をCtrl+Cキーやシグナルで中断した場合,特定の戻り値が返りません。そのため,コマンドをCtrl+Cキーやシグナルで中断した場合は戻り値を無視してください。
-
ステータス管理機能が有効で,指定したサービスキーのサービスがステータス管理機能をサポートしているバージョンの場合,Status Serverサービスが起動していなければ,最初にStatus Serverサービスが起動されます。ただしステータス管理機能が無効の場合,Status Serverサービスは起動されません。
-
ステータス管理機能が無効の場合,サービスキーにstatを指定するとKAVE06023-Eメッセージが表示され,コマンドの実行が終了します。
-
クラスタソフトや,サービスコントロールマネージャーからの起動・停止と,このコマンドを同時に実行しないでください。クラスタソフトや,サービスコントロールマネージャーからの起動・停止と,コマンドによる起動が競合し,起動・停止が正しく行えない場合があります。
戻り値
0 |
正常終了した。 |
1 |
引数の指定に誤りがある。 |
2 |
コマンドの実行権限がない。 |
4 |
指定されたサービスはすでに起動している。または,Master StoreサービスもしくはAgent StoreおよびRemote Monitor Storeサービス,またはコマンドがStoreデータベースアクセス中にコマンドを実行した。 |
5 |
指定されたサービスがインストールされていない。 |
10 |
コマンドはほかのセッションで実行中である。 |
100 |
Performance Managementの環境が不正である。 |
101 |
PFM - Managerサービスが起動していない。 |
102 |
指定された論理ホスト名またはインスタンスは,セットアップされていない。 |
103 |
起動処理の監視がタイムアウトになった。 |
107 |
Windowsサービスコントロールマネージャーなどのほかのプロセスからサービス起動処理および停止処理が実行されている。 |
200 |
メモリーが不足している。 |
211 |
ファイルまたはディレクトリにアクセスできない。 |
212 |
インデックスの作成に失敗した。 |
255 |
予期しないエラーが発生した。 |
使用例1
すべてのPerformance Managementプログラムのサービスを起動する場合のコマンド実行例を次に示します。
jpcspm start -key all
使用例2
PFM - Agent for Oracleのうち,インスタンスoracleAのサービスだけ起動する場合のコマンド実行例を次に示します。
jpcspm start -key Oracle -inst oracleA