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