jpcconf target setup

形式

jpcconf target setup     -key サービスキー
                         -inst インスタンス名
                         -target 監視対象名
                         [-lhost 論理ホスト名]
                         [-input 定義ファイル名]
                         [-noquery]

jpcconf target setup     -key サービスキー
                         -template 定義ファイル名
                         [-noquery]

ページの先頭へ

機能

jpcconf target setupコマンドは，PFM - RMがインスタンス内で監視する監視対象の作成，および設定を更新するコマンドです。

ページの先頭へ

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

• PFM - Manager（PFM - RMがインストールされたホストだけ実行可能）

• PFM - RM

ページの先頭へ

実行権限

Windowsの場合

Administrators権限を持つユーザー（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合

rootユーザー権限を持つユーザー

ページの先頭へ

格納先ディレクトリ

Windowsの場合

インストール先フォルダ\tools\

UNIXの場合

/opt/jp1pc/tools/

ページの先頭へ

引数

ページの先頭へ

定義ファイルの形式（jpcconf target setupコマンド）

定義ファイルはテキスト形式のファイルです。次に示すセクションおよびラベルで構成されます。ラベルの設定値は，ラベル名の後ろの「=」に続けて指定します。

各セクションおよびラベルは省略できません。また，設定値を記載しない場合，値が指定されていないものと見なされます。不正なセクション名およびラベル名を指定した場合，該当するセクションおよびラベルは無視されます。

[Common Definitions]セクション

定義ファイルの基本情報を指定するセクションです。

Definition File Versionラベル

定義ファイルのバージョンを指定するラベルです。固定で「0001」を指定してください。

[Product Information]セクション

対象とするPFM - RMを指定するセクションです。

Product IDラベル

対象とするPFM - RMのプロダクトIDを指定するラベルです。プロダクトIDについては，各PFM - RMマニュアルの付録の，識別子について説明している個所を参照してください。

[Target Definitions]セクション

監視対象の設定値を指定するセクションです。

Target Hostラベル

監視対象のホスト名を指定するラベルです。

プロダクト固有ラベル

対象とするPFM - RMに固有の監視対象の設定項目を指定するラベルです。指定できるラベルについては，各PFM - RMマニュアルの，インストールとセットアップについて説明している章を参照してください。なお，パスワードなどの設定項目の場合，対話形式での実行時に2回入力を求められることがありますが，ラベルは1回だけ指定してください。

定義ファイルの記述例を次に示します。

[Common Definitions]
Definition File Version=0001
 
[Product Information]
Product ID=7
 
[Target Definitions]
Target Host=hostname
User=Administrator
Password=aaa
　：

ページの先頭へ

注意事項

• jpcconf target setupコマンドを実行する場合は，実行ホスト上のPFM - ManagerまたはPFM - Baseのバージョンが09-00以降である必要があります。

• 論理ホスト環境で動作するPFM - RMの監視対象の設定を実施する場合，待機系ノードでは実行できません。

• 最大監視対象数は，PFM - RMによって異なります。最大監視対象数に達した状態で監視対象を追加しようとすると，KAVE05397-Eメッセージが出力されます。お使いのPFM - RMの最大監視対象数については，各PFM - RMマニュアルを参照してください。

• 定義ファイルにパスワードなどの秘匿情報が含まれる場合，定義ファイルはセキュリティを確保した安全な場所に保存し，使用後は削除してください。また，定義ファイルをホスト間で転送したいときには，SFTP（SSHトンネル経由のFTP）など，盗聴のおそれがない安全な方法を使用することをお勧めします。

• -inputオプションを指定した場合，定義ファイルに必要なラベルがないとき，または必要なラベルの値が不正なときは，コマンドの実行が中断されます。-noqueryオプションを同時に指定して，バッチまたはスクリプトファイルなどで処理を自動化したい場合は，定義ファイルの内容が正しいことをあらかじめ確認してください。また，コマンドが正常終了したかどうかは，出力されるメッセージまたは戻り値で確認してください。

ページの先頭へ

戻り値

ページの先頭へ

使用例

PFM - RM for Platformのインスタンスinst1に，新規に監視対象targetname1を追加する場合のコマンド実行例を次に示します。

jpcconf target setup -key RMPlatform -inst inst1 -target targetname1

ページの先頭へ

非対話形式のコマンドの運用例

-noqueryオプション，-inputオプション，および-templateオプションを使用することで，Performance Managementからの問い合わせを抑止した状態でセットアップを実行できます。運用例を次に示します。

# jpcconf target setup -key RMPlatform -template RMPlatformTemplate.txt

# jpcconf target setup -key RMPlatform -inst inst01 -target target01 -input RMPlatformTarget01.txt -noquery
# jpcconf target setup -key RMPlatform -inst inst01 -target target02 -input RMPlatformTarget02.txt -noquery
# jpcconf target setup -key RMPlatform -inst inst01 -target target03 -input RMPlatformTarget03.txt -noquery

ページの先頭へ