2.1.4　PFM - Agent for WebLogic Serverのセットアップ手順

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

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

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

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

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

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

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

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

jpcconf agent setup -key WebLogic

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

jpcwagtsetup

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

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

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

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

注意

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

表2‒3　PFM - Agent for WebLogic Serverのインスタンス情報

項目	説明	設定できる値	デフォルト値
WebLogic Server Installation Directory	WebLogic Serverのインストール先フォルダ。 設定例 C:\bea\weblogic90	1〜512バイトの半角文字列。 ただし，次の文字は指定できない。 「/」，「*」，「?」，「"」，「<」，「>」，「|」	なし
Listen Port Number	WebLogic Serverの非SSLリスンポート番号。	1024〜65535の数値。	7001
User Name※1，※2	WebLogic Serverに接続するためのユーザー名。	1〜512バイトの半角文字列。	なし
Password※1	WebLogic Serverに接続するためのユーザーパスワード。	1〜256バイトの半角文字列。	なし
Store Version※3	使用するStoreバージョン。※4	「1.0」または「2.0」。	2.0
JDK Installation Directory	WebLogic Serverが使用するJDKのイントール先ディレクトリ。	1〜512バイトの半角文字列。ただし，次の文字は指定できない。 「/」，「*」，「?」，「"」，「<」，「>」，「|」	なし
Listen Address	着信接続をリスンするのにWebLogic Serverが使用するIPアドレスまたはDNS名。	1〜512バイトの半角文字列。	localhost

注※1

「User Name」または「Password」に設定した値が正しくない場合，WebLogic Serverへの接続に失敗し，「User Name」に指定したユーザーがロックアウトされる場合があります。ロックアウトの詳細については，WebLogic Serverのドキュメントを参照してください。

注※2

このユーザーにはMonitorセキュリティロールが与えられている必要があります。なお，管理ポートを有効にしている場合は，Adminセキュリティロールが与えられたユーザーを指定しないでください。セキュリティロールの詳細については，WebLogic Serverのドキュメントを参照してください。

注※3

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

注※4

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

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

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

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

   jpcconf inst setup -key WebLogic -inst APSV

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

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

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

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

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

• インスタンス環境のフォルダ構成

  次のフォルダ下にインスタンス環境が構築されます。

  物理ホストの場合：インストール先フォルダ\agts

  論理ホストの場合：環境フォルダ^※\jp1pc\agts

  注※

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

  構築されるインスタンス環境のフォルダ構成を次に示します。

  表2‒4　インスタンス環境のフォルダ構成

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

  注※

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

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

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

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

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

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

• インスタンス環境のWindowsのサービス名

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

  • Agent Collectorサービス：PFM - Agent for WebLogicServer インスタンス名 ［論理ホスト名］

  • Agent Storeサービス：PFM - Agent Store for WebLogicServer インスタンス名 ［論理ホスト名］

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

  また，論理ホストで運用する場合のWindowsのサービス名については，マニュアル「JP1/Performance Management 運用ガイド」の，クラスタシステムでの構築と運用について説明している章を参照してください。