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

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

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

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

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

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

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

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

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

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

2. jpcconf agent setup (jpcagtsetup)コマンドを実行する。

   次のように指定して実行します。

   jpcconf agent setup -key Domino (jpcagtsetup agtl)

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

   注意事項

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

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

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

PFM - Web ConsoleでPFM - Agent for Dominoをセットアップする手順を次に示します。

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

2. jpcwagtsetupコマンドを実行する。

   次のように指定して実行します。

   jpcwagtsetup

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

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

PFM - Agent for Dominoで監視するドミノサーバのインスタンス情報を設定します。インスタンス情報の設定は，PFM - Agentホストで実施します。

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

表3‒4　PFM - Agent for Dominoのインスタンス情報

項目	説明	設定できる値	デフォルト値
Domino Program Directory	監視対象のドミノサーバのプログラムディレクトリを絶対パスで指定する。(UNIX版だけ有効，Windows版は設定不要) 例：/opt/lotus	255バイト以内の半角文字列。	−
notes.ini	監視対象のドミノサーバが使用するnotes.iniファイルの絶対パス（notes.iniまでを含めた名称）を指定する。	255バイト以内の半角文字列。	−
User's mail template	追加用の個人ユーザーメールデータベーステンプレート名を指定する。ここで指定されたテンプレート名を持つデータベースが個人ユーザーメールデータベースとして扱われる。	128バイト以内の半角文字列。 追加しない場合は「none」を指定する。	none
Days for period-excess mail	個人ユーザーメールデータベースで，期間超過メールであると判断する日数を整数で指定する。	0〜65535（単位：日）。	60
Minutes for remaining mail	あるメールが滞留メールであると判断する時間（単位：分）を整数で指定する。	0〜2147483647（単位：分）。	15
Minutes for dead mail	あるメールがデッドメールであると判断する時間（単位：分）を整数で指定する。	0〜2147483647（単位：分）。	15
Use summary to mail count	デッドメール数および滞留メール数の収集に，メールボックスの一覧情報（サマリ情報）を使用するか，メール文書の情報を使用するかを指定する。PI_PIレコードのMail Dead UserCustomフィールドおよびMail Waiting UserCustomフィールドの収集時に使用する。 「Y」を指定した場合，IBM Domino Administratorで「Dominoサーバ」の「メールボックス」に表示される一覧情報を使用して収集する。※1 「N」を指定した場合，メール文書の情報を使用して収集する。※2	YまたはN	N
Store Version※3	使用するStoreバージョンを指定する。Storeバージョンについては「3.4.3　Storeバージョン2.0への移行」を参照のこと。	1.0または2.0	2.0

（凡例）

−：なし

注※1

メールボックスの一覧情報（サマリ情報）を使用すると，メール文書を読み込む必要がなくなり，収集処理時間が短縮されます。

注※2

メール文書の情報を読み込むため，サイズが大きいメールや件数が多い状態になると，レコードの収集に失敗する場合があります。また，収集対象のメールボックスのメール文書数が1,000件を超える場合，収集時の負荷が高くなるため，収集を中止し，Mail Dead UserCustomフィールドおよびMail Waiting UserCustomフィールドの値には0を設定します。

注※3

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

注意

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

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

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

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

   jpcconf inst setup -key Domino -inst Domino01 (jpcinssetup agtl -inst Domino01)

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

2. ドミノのインスタンス情報を設定する。

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

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

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

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

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

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

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

  注※

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

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

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

  ディレクトリ名・ファイル名			説明
  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の場合）
  		STPL	PLレコードタイプのパフォーマンスデータ格納先ディレクトリ（Storeバージョン2.0の場合）

  注※

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

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

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

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

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

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