3.1.4　PFM - Agent for Cosminexusのセットアップ手順

(a)　PFM - Agent for Cosminexusのセットアップファイルをコピーする

PFM - Agent for CosminexusをインストールしたホストにあるセットアップファイルをPFM - ManagerおよびPFM - Web Consoleをインストールしたホストにコピーします。手順を次に示します。

1. PFM - Agentのセットアップファイルをバイナリーモードでコピーする。

   ファイルが格納されている場所およびファイルをコピーする場所を次の表に示します。

   表3‒5　コピーするセットアップファイル

   PFM - Agentの セットアップファイル	コピー先
   	PFMプログラム名	OS	コピー先ディレクトリ
   /opt/jp1pc/setup/jpcagtcw.EXE	PFM - Manager	Windows	PFM - Managerのインストール先フォルダ\setup
   /opt/jp1pc/setup/jpcagtcu.Z		UNIX	/opt/jp1pc/setup/
   /opt/jp1pc/setup/jpcagtcw.EXE	PFM - Web Console	Windows	PFM - Web Consoleのインストール先フォルダ\setup
   /opt/jp1pc/setup/jpcagtcu.Z		UNIX	/opt/jp1pcwebcon/setup/

(b)　PFM - Managerホストでセットアップコマンドを実行する

PFM - ManagerでPFM - Agent for Cosminexusをセットアップするための次のコマンドを実行します。

jpcconf agent setup -key Cosminexus

ここでは，対話形式の実行例を示していますが，jpcconf agent setupコマンドは非対話形式でも実行できます。jpcconf agent setupコマンドの詳細については，マニュアル「JP1/Performance Management リファレンス」のコマンドについて説明している章を参照してください。

注意事項

コマンドを実行するローカルホストのPerformance Managementのプログラムおよびサービスが完全に停止していない状態でjpcconf agent setupコマンドを実行した場合，エラーが発生することがあります。その場合は，Performance Managementのプログラムおよびサービスが完全に停止したことを確認したあと，再度jpcconf agent setupコマンドを実行してください。

PFM - ManagerホストにコピーしたPFM - Agentのセットアップファイルは，この作業が終了したあと，削除してもかまいません。

(c)　PFM - Web Consoleホストでセットアップコマンドを実行する

PFM - Web ConsoleでPFM - Agent for Cosminexusをセットアップするための次のコマンドを実行します。

jpcwagtsetup

PFM - Web ConsoleホストにコピーしたPFM - Agentのセットアップファイルは，この作業が終了したあと削除してもかまいません。

(a)　インスタンス情報を設定する

PFM - Agent for Cosminexusで監視するCosminexusのインスタンス情報を設定します。インスタンス情報の設定は，PFM - Agentホストで実施します。

設定するインスタンス情報を次の表に示します。セットアップの操作を始める前に，次の表の情報をあらかじめ確認してください。Cosminexusのインスタンス情報の詳細については，Cosminexusのマニュアルを参照してください。

表3‒6　PFM - Agent for Cosminexusのインスタンス情報

項目	説明	設定できる値	デフォルト値
Cosminexus Application Server Version	uCosminexus Application Serverのバージョン	「7」または「8.50」。 7 08-50より古いとき。 8.50 08-50以降のとき。	7
Cosminexus RMI Registry Port Number	Cosminexusへ接続する際のRMIレジストリのポート番号。	1024〜65535までの整数。	23152
Store Version※1	使用するStoreバージョン。※2	「1.0」または「2.0」。	2.0

注※1

PFM - Agent for Cosminexusと同一ホスト上のPFM - ManagerまたはPFM - Baseが08-10以降で，インスタンス環境を新規に設定する場合に必要です。インスタンス環境を更新するときは指定できません。

注※2

Storeバージョンについては，マニュアル「JP1/Performance Management 設計・構築ガイド」の，インストールとセットアップについて説明している章を参照してください。

注意

• インスタンス環境を設定していない場合，PFM - Agent for Cosminexusのサービスを起動できません。

• jpcconf agent setupコマンドを使用してインスタンス環境を構築する際，誤ったRMIレジストリポート番号を指定した場合でもコマンドは正常に終了します。しかし，その後レコードの収集を開始すると，共通メッセージログに「KAVL10004-E」のメッセージが出力されます。この場合，正しいRMIレジストリポート番号を確認の上，再度jpcconf agent setupコマンドを実行してください。

インスタンス環境を構築するには，jpcconf inst setupコマンドを使用します。インスタンス環境の構築手順を次に示します。

1. サービスキーおよびインスタンス名を指定して，jpcconf inst setupコマンドを実行する。

   例えば，PFM - Agent for Cosminexusのインスタンス名APSVのインスタンス環境を構築する場合，次のように指定してコマンドを実行します。

   jpcconf inst setup -key Cosminexus -inst APSV

   インスタンス名には，J2EEサーバ名など，監視対象のJ2EEサーバを一意に識別できる任意の名称を指定してください。jpcconf inst setupコマンドの詳細については，マニュアル「JP1/Performance Management リファレンス」の，コマンドについて説明している章を参照してください。

2. Cosminexusのインスタンス情報を設定する。

   表3-6に示した項目を，コマンドの指示に従って入力してください。省略はできません。デフォルトで表示されている値を入力する場合は，リターンキーだけを押してください。

すべての入力が終了すると，インスタンス環境が構築されます。構築時に入力したインスタンス情報を変更したい場合は，再度jpcconf inst setupコマンドを実行し，インスタンス環境を更新してください。インスタンス環境の更新については，「3.4.2　インスタンス環境の更新の設定」を参照してください。

構築されるインスタンス環境を次に示します。

• インスタンス環境のディレクトリ構成

  次のディレクトリ下にインスタンス環境が構築されます。

  物理ホストの場合：/opt/jp1pc/agtc

  論理ホストの場合：環境ディレクトリ^※/jp1pc/agtc

  注※

  環境ディレクトリとは，論理ホスト作成時に指定した共有ディスク上のディレクトリです。

  構築されるインスタンス環境のディレクトリ構成を次に示します。

  表3‒7　インスタンス環境のディレクトリ構成

  ディレクトリ名・ファイル名			説明
  agent	インスタンス名	jpcagt.ini	Agent Collectorサービス起動情報ファイル
  		jpcagt.ini.model※	Agent Collectorサービス起動情報ファイルのモデルファイル
  		log	ログファイル格納ディレクトリ
  store	インスタンス名	jpcsto.ini	Agent Storeサービス起動情報ファイル
  		jpcsto.ini.model※	Agent Storeサービス起動情報ファイルのモデルファイル
  		*.DAT	データモデル定義ファイル
  		dump	エクスポート先ディレクトリ
  		backup	バックアップ先ディレクトリ
  		import	標準のデータベースインポート先ディレクトリ（Storeバージョン2.0の場合）
  		log	ログファイル格納ディレクトリ
  		partial	標準のデータベース部分バックアップ先ディレクトリ（Storeバージョン2.0の場合）
  		STPD	PDレコードタイプのパフォーマンスデータ格納先ディレクトリ（Storeバージョン2.0の場合）
  		STPI	PIレコードタイプのパフォーマンスデータ格納先ディレクトリ（Storeバージョン2.0の場合）

  注※

  インスタンス環境を構築した時点の設定値に戻したいときに使用します。

• インスタンス環境のサービスID

  インスタンス環境のサービスIDは次のようになります。

  プロダクトID 機能ID インスタンス番号 インスタンス名 [ホスト名]

  PFM - Agent for Cosminexusの場合，インスタンス名にはjpcconf inst setupコマンドで指定したインスタンス名が表示されます。

  サービスIDについては，マニュアル「JP1/Performance Management 設計・構築ガイド」の，付録に記載されている命名規則を参照してください。