3.1.4　PFM - Agent for WebSphere Application Serverのセットアップ手順

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

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

1. PFM - Web Consoleが起動されている場合は，停止する。

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

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

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

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

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

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

jpcconf agent setup -key WAS

ここでは，対話形式の実行例を示していますが，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 WebSphere Application Serverをセットアップするための次のコマンドを実行します。

jpcwagtsetup

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

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

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

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

注意

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

表3‒6　PFM - Agent for WebSphere Application Serverのインスタンス情報

項目	説明	設定できる値	デフォルト値
WebSphere Application Server Installation Directory	WebSphere Application Serverのインストール先ディレクトリ。	1〜512バイトの半角文字列。	なし
WebSphere Application Server Version	WebSphere Application Serverのバージョン。 6：V6.0，V6.1 7：V7.0以降	「6」または「7」。	6
SOAP Connector Port Number	WebSphere Application ServerのSOAPコネクターポート番号。	1024〜65535の数値。	8880
User Name※1，※2	WebSphere Application Serverに接続するためのHTTP基本認証のユーザーID。	1〜512バイトの半角文字列。	なし
Password※2	WebSphere Application Serverに接続するためのHTTP基本認証のパスワード。	1〜256バイトの半角文字列。	なし
TrustStore File Path※3	WebSphere Application ServerのSOAPコネクターポートでSSLを使用している場合に，WebSphere Application Serverに接続するためのトラストストアファイルのファイル名（絶対パス）。	1〜512バイトの半角文字列。	なし
TrustStore Password※3	WebSphere Application ServerのSOAPコネクターポートでSSLを使用している場合に，WebSphere Application Serverに接続するためのトラストストアファイルのパスワード。	1〜256バイトの半角文字列。	なし
Store Version※4	使用するStoreバージョン。※5	「1.0」または「2.0」。	2.0

注※1

このユーザーには，Monitorセキュリティロールが与えられている必要があります。

注※2

HTTP基本認証を使用していない場合は空白（スペース）にしてください。

注※3

SSLを使用していない場合は空白（スペース）にしてください。

注※4

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

注※5

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

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

インスタンス環境の構築手順を次に示します。複数のインスタンス環境を設定する場合は，この手順を繰り返し実施します。

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

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

   jpcconf inst setup -key WAS -inst APSV

   インスタンス名には，WebSphere Application Serverのサーバ名など，監視対象のWebSphere Application Serverのインスタンスを一意に識別できる任意の名称を指定してください。

   jpcconf inst setupコマンドの詳細については，マニュアル「JP1/Performance Management リファレンス」の，コマンドについて説明している章を参照してください。

2. WebSphere Application Serverのインスタンス情報を設定する。

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

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

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

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

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

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

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

  注※

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

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

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

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

  注※

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

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

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

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

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

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