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