JP1/Performance Management リファレンス
形式
jpcinsunsetup サービスキー [-lhost 論理ホスト名] -inst インスタンス名
機能
jpcinsunsetupコマンドは,一つのホスト上で複数のサービスのセットを起動できるPFM - Agentのインスタンス環境を削除するコマンドです。
このコマンドを実行すると,インスタンス環境の設定ファイルなどが格納された次のディレクトリを削除します。
- Windowsの場合
- インストール先フォルダ\xxxx※\agent\インスタンス名\
- インストール先フォルダ\xxxx※\store\インスタンス名\
- UNIXの場合
- /opt/jp1pc/xxxx※/store/インスタンス名/
- /opt/jp1pc/xxxx※/agent/インスタンス名/
- 注※
- 「xxxx」は,各PFM - Agentのサービスキーを示します。サービスキーについては,各PFM - Agentマニュアルの,付録に記載されている識別子一覧を参照してください。
コマンドを実行できるホスト
PFM - Agent
実行権限
- Windowsの場合
- Administrators権限を持つユーザー
- UNIXの場合
- rootユーザー権限を持つユーザー
格納先ディレクトリ
- Windowsの場合
- インストール先フォルダ\tools\
- UNIXの場合
- /opt/jp1pc/tools/
引数
サービスキー
実行環境を削除したいPFM - Agentのサービスのサービスキー名を指定します。指定できるサービスキーは,インスタンス環境を持つPFM - Agentのサービスキーだけです。PFM - Agentのサービスのサービスキーについては,各PFM - Agentマニュアルの,付録に記載されている識別子一覧を参照してください。
-lhost 論理ホスト名
インスタンス環境を削除する論理ホストのホスト名を指定します。
1〜32バイトの半角英数字で指定します。半角空白文字および"."は指定できません。
論理ホスト名に,"localhost",IPアドレス,"-"から始まるホスト名は指定できません。
-inst インスタンス名
実行環境を削除するインスタンス名を指定します。1〜32バイトの半角英数字で指定します。
注意事項
- 引数は,「形式」にある順番で指定してください。
- 指定したインスタンス名のサービスが起動されている場合は,そのサービスを停止してから,インスタンス環境が削除されます。
- コマンドの実行をCtrl+Cキーやシグナルで中断した場合,特定の戻り値が返りません。そのため,コマンドをCtrl+Cキーやシグナルで中断した場合は戻り値を無視してください。
戻り値
0 正常終了した。 1 引数の指定に誤りがある。 2 コマンドの実行権限がない。 4 指定されたサービスが停止されていない。 5 指定されたサービスがインストールされていない。 10 コマンドはほかのセッションで実行中である。 11 ユーザーによって処理が中止された(問い合わせに対して「N」を返した場合)。 100 Performance Managementの環境が不正である。 101 ポート番号が取得できない。 102 指定されたインスタンスが存在しない。 200 メモリーが不足している。 210 ディスク容量が不足している。 211 ファイルまたはディレクトリにアクセスできない。 222 通信処理でエラーが発生した(IPアドレスが取得できない)。 230 内部コマンドの実行に失敗した。 232 Windowsサービスの削除に失敗した(Windows版だけ)。 255 予期しないエラーが発生した。
使用例
名前がSDCのインスタンスの実行環境を削除する場合のコマンド実行例を次に示します。
jpcinsunsetup agto -inst SDC
All Rights Reserved. Copyright (C) 2006, 2008, Hitachi, Ltd.