JP1/Performance Management リファレンス

[目次][索引][前へ][次へ]

jpcconf agent setup

形式

形式1

jpcconf agent setup     -key サービスキー
                        [-noquery]

形式2

jpcconf agent setup     -key サービスキー
                        [-register]

機能

jpcconf agent setupコマンドは，Performance Managementシステムに対して，新しくPFM - AgentまたはPFM - RMを追加するコマンドです。PFM - AgentまたはPFM - RMの情報をPFM - ManagerやPFM - Baseに登録します。PFM - Managerのバージョンが08-50以降の場合， PFM - AgentおよびPFM - RMの情報は自動的にPFM - Managerへ登録されるため，通常はこのコマンドを実行する必要はありません。

PFM - Manager へ新しく登録したPFM - AgentまたはPFM - RMの情報をPFM - Web Consoleに表示させたい場合，新しく登録したPFM - AgentまたはPFM - RMを起動したあと，PFM - Web Consoleにログインした時点で反映されます。ただし，PFM - ManagerよりあとでリリースされたPFM - AgentまたはPFM - RMについては，手動登録が必要になる場合があります。この場合，形式1でjpcconf agent setupコマンドを実行します。PFM - AgentまたはPFM - RMを起動せずに，その情報をPFM - Web Consoleに表示させたい場合は，形式2でjpcconf agent setupコマンドを実行します。

このコマンドは次の場合に実行してください。

形式1
  • PFM - Managerより後でリリースされたPFM - AgentまたはPFM - RMをPFM - Managerに登録する場合※1
  • PFM - BaseにPFM - AgentまたはPFM - RMを登録する場合※2

形式2
PFM - AgentまたはPFM - RMを起動しないで，PFM - AgentまたはPFM - RMの情報をPFM - Managerに登録し，PFM - Web Consoleに表示させる場合

注※1
登録の要否については，PFM - Managerのリリースノートを参照してください。

注※2
NNM連携機能を使用する場合で，NNMがインストールされているホストにPFM - Baseをインストールしたときに必要です。

PFM - Managerに論理ホストの設定がされている場合，設定されている論理ホストおよび物理ホストに対して，新規PFM - AgentまたはPFM - RMの情報が登録されます。

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

形式1
  • PFM - Manager
  • PFM - Agent
  • PFM - Base
  • PFM - RM

形式2
PFM - Manager

実行権限

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

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

格納先ディレクトリ

Windowsの場合
インストール先フォルダ\tools\

UNIXの場合
/opt/jp1pc/tools/

引数

-key サービスキー

追加セットアップを実行したい新規PFM - AgentまたはPFM - RMのサービスキーを指定します。なお，プロダクト名表示機能が有効な場合はプロダクト名でも指定できます。

-register

サービスキーで指定したPFM - AgentまたはPFM - RMをPFM - Web Consoleに表示します。PFM - Managerがクラスタシステムで運用されている場合は，実行系ノードだけで実行できます。

-noquery

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

なお，起動中のPerformance Managementサービスがあった場合は，KAVE05143-Eメッセージが出力され，コマンドの実行が中断されます。ローカルホスト上で起動しているすべてのPerformance Managementサービスを停止して，コマンドを再度実行してください。

注意事項

形式1で実行する場合の注意事項

新規PFM - AgentまたはPFM - RMをインストールしたホストとは別のホストで新規PFM - AgentまたはPFM - RMの追加セットアップを実行する場合，あらかじめ新規PFM - AgentまたはPFM - RMのセットアップファイルを実行ホストのこれらのディレクトリにコピーしてください。WindowsホストとUNIXホスト間でFTPを使用して，コピー（ファイル転送）する場合は，バイナリーモードを使用してください。

形式2で実行する場合の注意事項

戻り値

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

使用例1

PFM - Managerより後でリリースされたPFM - Agent for Oracleのセットアップを実行する場合のコマンド実行例を次に示します。

 
jpcconf agent setup -key Oracle

使用例2

新規に追加したPFM - Agent for Oracleの情報を起動前にPFM - Web Consoleに表示させる場合のコマンド実行例を次に示します。

 
jpcconf agent setup -key Oracle -register

[目次][前へ][次へ]

[他社商品名称に関する表示]

All Rights Reserved. Copyright (C) 2009, 2012, Hitachi, Ltd.
(C)opyright 2000-2009, by Object Refinery Limited and Contributors.