jpcconf inst unsetup

〈このページの構成〉

形式
機能
コマンドを実行できるホスト
実行権限
格納先ディレクトリ
引数
注意事項
戻り値
使用例

形式

jpcconf inst unsetup     -key サービスキー
                         [-lhost 論理ホスト名]
                         -inst インスタンス名
                         [-noquery]

ページの先頭へ

機能

jpcconf inst unsetupコマンドは，1つのホスト上で複数のサービスのセットを起動できるPFM - AgentまたはPFM - RMのインスタンス環境を削除するコマンドです。

このコマンドを実行すると，インスタンス環境の設定ファイルなどが格納された次のディレクトリを削除します。

Windowsの場合
- インストール先フォルダ\xxxx^※\agent\インスタンス名\
- インストール先フォルダ\xxxx^※\store\インスタンス名\
UNIXの場合
- /opt/jp1pc/xxxx^※/store/インスタンス名/
- /opt/jp1pc/xxxx^※/agent/インスタンス名/

注※: 「xxxx」は，各PFM - AgentまたはPFM - RMのサービスキーを示します。サービスキーについては，マニュアル「JP1/Performance Management 設計・構築ガイド」の付録の，命名規則について説明している個所を参照してください。

ページの先頭へ

コマンドを実行できるホスト

PFM - Agent
PFM - RM

ページの先頭へ

実行権限

Windowsの場合: Administrators権限を持つユーザー
UNIXの場合: rootユーザー権限を持つユーザー

ページの先頭へ

格納先ディレクトリ

Windowsの場合: インストール先フォルダ\tools\
UNIXの場合: /opt/jp1pc/tools/

ページの先頭へ

引数

-key サービスキー

実行環境を削除したいPFM - AgentまたはPFM - RMのサービスのサービスキー名を指定します。プロダクト名表示機能が有効な場合はプロダクト名でも指定できます。指定できるサービスキーは，インスタンス環境を持つPFM - AgentまたはPFM - RMのサービスキーだけです。PFM - AgentまたはPFM - RMのサービスのサービスキーについては，マニュアル「JP1/Performance Management 設計・構築ガイド」の付録の，命名規則について説明している個所を参照してください。

-lhost 論理ホスト名

インスタンス環境を削除する論理ホストのホスト名を指定します。

1〜32バイトの半角英数字で指定します。半角空白文字および"."は指定できません。

論理ホスト名に，"localhost"，IPアドレス，"-"から始まるホスト名は指定できません。

-inst インスタンス名

実行環境を削除するインスタンス名を指定します。1〜32バイトの半角英数字で指定します。

-noquery

このオプションを指定すると，コマンドの実行を中断する問い合わせメッセージが出力されなくなり，ユーザーの応答が不要になります。非対話形式で実行したい場合に指定します。

なお，指定したインスタンス名のサービスが起動中の場合は，KAVE05143-Eメッセージが出力され，コマンドの実行が中断されます。サービスを停止してコマンドを再度実行してください。

ページの先頭へ

注意事項

引数は，「形式」にある順番で指定してください。
指定したインスタンス名のサービスが起動されている場合は，そのサービスを停止してから，インスタンス環境が削除されます。
コマンドの実行をCtrl+Cキーやシグナルで中断した場合，特定の戻り値が返りません。そのため，コマンドをCtrl+Cキーやシグナルで中断した場合は戻り値を無視してください。
アラームテーブルがバインドされているエージェントのインスタンス環境を削除する場合，エージェントのインスタンス環境にバインドされているアラームテーブルを削除前にすべてアンバインドしてください。
このコマンドの実行後は，PFM - Web Consoleのエージェント階層で「User Agents」を選択して表示されるツリーから，不要になったエージェントを必要に応じて削除してください。
jpcconf db defineコマンドでStoreサービスの各種の出力先ディレクトリを変更している場合，変更先のディレクトリは削除されません。jpcconf inst unsetupコマンドの実行後に手動で削除してください。

ページの先頭へ

戻り値

0	正常終了した。
1	引数の指定に誤りがある。
2	コマンドの実行権限がない。
4	指定されたサービスが停止されていない。
5	指定されたサービスがインストールされていない。
10	コマンドはほかのセッションで実行中である。
11	ユーザーによって処理が中止された（問い合わせに対して「N」を返した場合）。
100	Performance Managementの環境が不正である。
101	ポート番号が取得できない。
102	指定されたインスタンスがない。
200	メモリーが不足している。
210	ディスク容量が不足している。
211	ファイルまたはディレクトリにアクセスできない。
222	通信処理でエラーが発生した（IPアドレスが取得できない）。
230	内部コマンドの実行に失敗した。
232	Windowsサービスの削除に失敗した（Windows版だけ）。
255	予期しないエラーが発生した。

ページの先頭へ

使用例

名前がSDCのインスタンスの実行環境を削除する場合のコマンド実行例を次に示します。

jpcconf inst unsetup -key Oracle -inst SDC

ページの先頭へ