JP1/Performance Management リファレンス
形式
jpchasetup delete サービスキー -lhost 論理ホスト名
機能
jpchasetup deleteコマンドは,Performance Managementの論理ホスト環境を削除するコマンドです。
このコマンドは,論理ホスト運用に対応したPerformance Managementでだけ実行できます。PFM - Managerは論理ホスト運用に対応しています。PFM - Agentの論理ホスト運用については,各PFM - Agentマニュアルの,クラスタシステムでの運用について説明している章を参照してください。
コマンドを実行できるホスト
- PFM - Manager
- PFM - Agent
実行権限
- Windowsの場合
- Administrators権限を持つユーザー
- UNIXの場合
- rootユーザー権限を持つユーザー
格納先ディレクトリ
- Windowsの場合
- インストール先フォルダ\tools\
- UNIXの場合
- /opt/jp1pc/tools/
引数
サービスキー
論理ホスト環境を削除するPerformance Managementプログラムのサービスのサービスキーを指定します。
指定できるサービスキーを次に示します。
- all:指定した論理ホスト内にセットアップされている,すべてのPerformance Managementプログラムのサービスを削除します。
- mgr:PFM - Managerのサービス(Action Handlerサービスを含む)を削除します。
- PFM - Agentのサービスのサービスキー:PFM - Agentの各サービス(Action Handlerサービスを含む)が削除されます。PFM - Agentのサービスのサービスキーについては,各PFM - Agentマニュアルの,付録に記載されている識別子一覧を参照してください。
Action Handlerサービスのサービスキーactは指定できません。
サービスキーにmgrまたはPFM - Agentサービスのサービスキーを指定すると,そのPerformance Managementプログラムのサービスの論理ホスト環境を削除します。
サービスキーにallを指定すると,指定した論理ホスト内にセットアップされているすべてのPerformance Managementプログラムのサービスについて,論理ホスト環境を削除します。論理ホスト起動に対応していないPerformance Managementプログラムのサービスのサービスキーを指定するとエラーになります。
なお,指定した論理ホストにセットアップされているPerformance Managementプログラムのサービスをすべて削除する場合,Action Handlerサービスも含めた論理ホスト環境が自動的に削除されます。
-lhost 論理ホスト名
削除する論理ホストのホスト名を指定します。
セットアップされていない論理ホスト名を指定するとエラーになります。
なお,現在セットアップされている論理ホスト環境は,jpchasetup list allで確認できます。
注意事項
- 共有ディスク上の論理ホスト環境のファイルが削除されるため,論理ホスト環境を削除するときは,共有ディスクをオンラインに(UNIXの場合はマウント)してからこのコマンドを実行してください。共有ディスクにアクセスできない場合,論理ホスト設定情報およびWindowsサービスだけを削除します。
- このコマンドを実行する前に,そのノード上の物理ホストおよび各論理ホストを含むすべてのPerformance Managementプログラムのサービスを停止してください。
- コマンドの実行をCtrl+Cキーやシグナルで中断した場合,特定の戻り値が返りません。そのため,コマンドをCtrl+Cキーやシグナルで中断した場合は戻り値を無視してください。
- PFM-Managerの論理ホスト環境を削除した場合,物理ホスト環境のPFM-Managerのヘルスチェック機能の有効・無効の設定は,論理ホスト環境の作成前の設定が引き継がれます。
戻り値
0 正常終了した。 0以外 異常終了した。
使用例
論理ホスト名がjp1-ha1のPFM - Managerの論理ホスト環境を削除する場合のコマンドの実行例を次に示します。
jpchasetup delete mgr -lhost jp1-ha1
All Rights Reserved. Copyright (C) 2006, 2008, Hitachi, Ltd.