2.1.4 PFM - Agent for Dominoのセットアップ手順
ここでは,PFM - Agent for Dominoを運用するための,セットアップについて説明します。
は使用する環境によって必要になるセットアップ項目,またはデフォルトの設定を変更する場合のオプションのセットアップ項目を示します。
- 〈この項の構成〉
(1) PFM - Agent for Dominoの登録
PFM - ManagerおよびPFM - Web Consoleを使ってPFM - Agentを一元管理するために,PFM - ManagerおよびPFM - Web ConsoleにPFM - Agent for Dominoを登録する必要があります。
PFM - Managerのバージョンが08-50以降の場合,PFM - Agentの登録は自動で行われるため,ここで説明する手順は不要です。ただし,PFM - Managerのリリースノートに記載されていないデータモデルバージョンのPFM - Agentは手動で登録する必要があります。なお,PFM - Agent for Dominoのデータモデルのバージョンについては,「付録I バージョン互換」を参照してください。
PFM - Agent for Dominoの登録の流れを次の図に示します。
|
- 注意事項
-
-
PFM - Agentの登録は,インスタンス環境を設定する前に実施してください。
-
すでにPFM - Agent for Dominoの情報が登録されているPerformance Managementシステムに,新たに同じバージョンのPFM - Agent for Dominoを追加した場合,PFM - Agentの登録は必要ありません。
-
バージョンが異なるPFM - Agent for Dominoを,異なるホストにインストールする場合,古いバージョン,新しいバージョンの順でセットアップしてください。
-
PFM - Managerと同じホストにPFM - Agentをインストールした場合,jpcconf agent setup (jpcagtsetup)コマンドが自動的に実行されます。共通メッセージログに「KAVE05908-I エージェント追加セットアップは正常に終了しました」と出力されるので,結果を確認してください。コマンドが正しく実行されていない場合は,コマンドを実行し直してください。コマンドの実行方法については,マニュアル「JP1/Performance Management リファレンス」のコマンドの章を参照してください。
-
PFM - Agent for Dominoの情報を登録する作業では,PFM - Web Consoleの[レポート階層]画面および[アラーム階層]画面に「Domino」という名前のフォルダが作成されます。[レポート階層]画面で,すでに独自に「Domino」という名前のフォルダまたはファイルを作成していた場合には,名前を変更してから作業を始めてください。
-
(a) PFM - Agent for Dominoのセットアップファイルをコピーする
PFM - Agent for DominoをインストールしたホストにあるセットアップファイルをPFM - ManagerおよびPFM - Web Consoleをインストールしたホストにコピーします。手順を次に示します。
-
PFM - Web Consoleが起動されている場合は,停止する。
-
PFM - Agentのセットアップファイルをバイナリーモードでコピーする。
ファイルが格納されている場所およびファイルをコピーする場所を次の表に示します。
表2‒2 コピーするセットアップファイル PFM - Agentの
セットアップファイル
コピー先
PFMプログラム名
OS
コピー先フォルダ
インストール先フォルダ\setup\jpcagtlw.EXE
PFM - Manager
Windows
PFM - Managerのインストール先フォルダ\setup\
インストール先フォルダ\setup\jpcagtlu.Z
UNIX
/opt/jp1pc/setup/
インストール先フォルダ\setup\jpcagtlw.EXE
PFM - Web Console
Windows
PFM - Web Consoleのインストール先フォルダ\setup\
インストール先フォルダ\setup\jpcagtlu.Z
UNIX
/opt/jp1pcwebcon/setup/
(b) PFM - Managerホストでセットアップコマンドを実行する
PFM - ManagerでPFM - Agent for Dominoをセットアップするためのコマンドを実行します。手順を次に示します。
-
PFM - Managerが起動されている場合は,停止する。
-
jpcconf agent setup (jpcagtsetup)コマンドを実行する。
次のように指定して実行します。
jpcconf agent setup -key Domino (jpcagtsetup agt1)
ここでは,対話形式の実行例を示していますが,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のセットアップファイルは,この作業が終了したあと,削除してもかまいません。
(2) インスタンス環境の設定
インスタンス環境の設定では,次の項目を実施します。複数のインスタンス環境を設定する場合は,この手順を繰り返し実施します。
-
インスタンス情報の設定
次に手順について説明します。
(a) インスタンス情報を設定する
PFM - Agent for Dominoで監視するドミノサーバのインスタンス情報を設定します。インスタンス情報の設定は,PFM - Agentホストで実施します。
設定するインスタンス情報を次の表に示します。セットアップの操作を始める前に,次の表の情報をあらかじめ確認してください。ドミノサーバのインスタンス情報の詳細については,ドミノサーバのマニュアルを参照してください。
項目 |
説明 |
設定できる値 |
デフォルト値 |
---|---|---|---|
監視対象のドミノサーバのプログラムディレクトリを絶対パスで指定する。(UNIX版だけ有効,Windows版は設定不要) |
255バイト以内の半角文字列。 |
− |
|
監視対象のドミノサーバが使用するnotes.iniファイルの絶対パス(notes.iniまでを含めた名称)を指定する。 |
255バイト以内の半角文字列。 |
− |
|
追加用の個人ユーザーメールデータベーステンプレート名を指定する。ここで指定されたテンプレート名を持つデータベースが個人ユーザーメールデータベースとして扱われる。 |
128バイト以内の半角文字列。 追加しない場合は「none」を指定する。 |
none |
|
個人ユーザーメールデータベースで,期間超過メールであると判断する日数を整数で指定する。 |
0〜65535(単位:日)。 |
60 |
|
あるメールが滞留メールであると判断する時間(単位:分)を整数で指定する。 |
0〜2147483647(単位:分)。 |
15 |
|
あるメールがデッドメールであると判断する時間(単位:分)を整数で指定する。 |
0〜2147483647(単位:分)。 |
15 |
|
デッドメール数および滞留メール数の収集に,メールボックスの一覧情報(サマリ情報)を使用するか,メール文書の情報を使用するかを指定する。PI_PIレコードのMail Dead UserCustomフィールドおよびMail Waiting UserCustomフィールドの収集時に使用する。 「Y」を指定した場合,IBM Domino Administratorで「Dominoサーバ」の「メールボックス」に表示される一覧情報を使用して収集する。※1 「N」を指定した場合,メール文書の情報を使用して収集する。※2 |
YまたはN |
N |
|
使用するStoreバージョンを指定する。Storeバージョンについては「2.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)コマンドを使用します。インスタンス環境の構築手順を次に示します。
-
サービスキーおよびインスタンス名を指定して,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に示した項目を,コマンドの指示に従って入力してください。各項目は省略できません。デフォルトで表示されている値を,項目の入力とする場合はリターンキーだけを押してください。
すべての入力が終了すると,インスタンス環境が構築されます。構築時に入力した内容を変更したい場合は,再度jpcconf inst setup (jpcinssetup)コマンドを実行し,インスタンス環境を更新してください。インスタンス環境の更新については,「2.4.2 インスタンス環境の更新の設定」を参照してください。
構築されるインスタンス環境を次に示します。
-
インスタンス環境のフォルダ構成
次のフォルダ下にインスタンス環境が構築されます。
物理ホストの場合:インストール先フォルダ\agtl
論理ホストの場合:環境フォルダ※\jp1pc\agtl
- 注※
-
環境フォルダとは,論理ホスト作成時に指定した共有ディスク上のフォルダです。
構築されるインスタンス環境のフォルダ構成を次に示します。
- 注※
-
インスタンス環境を構築した時点の設定値に戻したいときに使用します。
-
インスタンス環境のサービスID
インスタンス環境の場合のサービスIDは次のようになります。
プロダクトID 機能ID インスタンス番号 インスタンス名 [ホスト名]
PFM - Agent for Dominoの場合,インスタンス名にはjpcconf inst setup (jpcinssetup)コマンドで指定したインスタンス名が表示されます。
サービスIDについては,マニュアル「JP1/Performance Management 設計・構築ガイド」の,付録に記載されている命名規則を参照してください。
-
インスタンス環境のWindowsのサービス名
インスタンス環境のWindowsのサービス名は次のようになります。
-
Agent Collectorサービス:PFM - Agent for Domino インスタンス名 [論理ホスト名]
-
Agent Storeサービス:PFM - Agent Store for Domino インスタンス名 [論理ホスト名]
Windowsのサービス名については,マニュアル「JP1/Performance Management 設計・構築ガイド」の,付録に記載されている命名規則を参照してください。また,論理ホストで運用する場合のWindowsのサービス名については,マニュアル「JP1/Performance Management 運用ガイド」の,クラスタシステムでの構築と運用について説明している章を参照してください。
-
(3) ネットワークの設定![[図データ]](GRAPHICS/ZU020600.GIF)
Performance Managementを使用するネットワーク構成に応じて,変更する場合に必要な設定です。
ネットワークの設定には次の2つの項目があります。
-
IPアドレスを設定する
Performance Managementを複数のLANに接続されたネットワークで使用するときに設定します。複数のIPアドレスを設定するには,jpchostsファイルにホスト名とIPアドレスを定義します。設定したjpchostsファイルはPerformance Managementシステム全体で統一させてください。
詳細についてはマニュアル「JP1/Performance Management 設計・構築ガイド」の,インストールとセットアップについて説明している章を参照してください。
-
ポート番号を設定する
Performance Managementが使用するポート番号を設定できます。運用での混乱を避けるため,ポート番号とサービス名は,Performance Managementシステム全体で統一させてください。
ポート番号の設定の詳細についてはマニュアル「JP1/Performance Management 設計・構築ガイド」の,インストールとセットアップについて説明している章を参照してください。
(4) ログのファイルサイズ変更![[図データ]](GRAPHICS/ZU020600.GIF)
Performance Managementの稼働状況を,Performance Management独自のログファイルに出力します。このログファイルを「共通メッセージログ」と呼びます。共通メッセージログは,デフォルトで2,048キロバイトのファイルが2ファイル使用されます。このファイルサイズを変更したい場合に,必要な設定です。
詳細については,マニュアル「JP1/Performance Management 設計・構築ガイド」の,インストールとセットアップについて説明している章を参照してください。
(5) パフォーマンスデータの格納先の変更![[図データ]](GRAPHICS/ZU020600.GIF)
PFM - Agent for Dominoで管理されるパフォーマンスデータを格納するデータベースの保存先,バックアップ先,エクスポート先,またはインポート先のフォルダを変更したい場合に,必要な設定です。
-
保存先:インストール先フォルダ\agtl\store\インスタンス名\
-
バックアップ先:インストール先フォルダ\agtl\store\インスタンス名\backup\
-
部分バックアップ先※:インストール先フォルダ\agtl\store\インスタンス名\partial\
-
エクスポート先:インストール先フォルダ\agtl\store\インスタンス名\dump\
-
インポート先※:インストール先フォルダ\agtl\store\インスタンス名\import\
- 注
-
論理ホストで運用する場合のデフォルトの保存先については,「インストール先フォルダ」を「環境フォルダ\jp1pc」に読み替えてください。
- 注※
-
Storeバージョン2.0使用時だけ設定できます。
詳細については,「2.4.1 パフォーマンスデータの格納先の変更」を参照してください。
(6) PFM - Agent for Dominoの接続先PFM - Managerの設定
PFM - Agentがインストールされているホストで,そのPFM - Agentを管理するPFM - Managerを設定します。接続先のPFM - Managerを設定するには,jpcconf mgrhost define (jpcnshostname)コマンドを使用します。
- 注意事項
-
-
同一ホスト上に,複数のPFM - Agentがインストールされている場合でも,接続先に指定できるPFM - Managerは,1つだけです。PFM - Agentごとに異なるPFM - Managerを接続先に設定することはできません。
-
PFM - AgentとPFM - Managerが同じホストにインストールされている場合,接続先PFM - ManagerはローカルホストのPFM - Managerとなります。この場合,接続先のPFM - ManagerをほかのPFM - Managerに変更できません。
-
手順を次に示します。
-
Performance Managementのプログラムおよびサービスを停止する
セットアップを実施する前に,ローカルホストでPerformance Managementのプログラムおよびサービスが起動されている場合は,すべて停止してください。サービスの停止方法については,マニュアル「JP1/Performance Management 運用ガイド」の,Performance Managementの起動と停止について説明している章を参照してください。
jpcconf mgrhost defineコマンド (jpcnshostname)実行時に,Performance Managementのプログラムおよびサービスが起動されている場合は,停止を問い合わせるメッセージが表示されます。
-
接続先のPFM - Managerホストのホスト名を指定して,jpcconf mgrhost define (jpcnshostname)コマンドを実行する
例えば,接続先のPFM - Managerがホストhost01上にある場合,次のように指定します。
jpcconf mgrhost define -host host01 (jpcnshostname -s host01)
ここでは,対話形式の実行例を示していますが,jpcconf mgrhost defineコマンドは非対話形式でも実行できます。jpcconf mgrhost defineコマンドの詳細については,マニュアル「JP1/Performance Management リファレンス」のコマンドについて説明している章を参照してください。
(7) 動作ログ出力の設定![[図データ]](GRAPHICS/ZU020600.GIF)
アラーム発生時に動作ログを出力したい場合に必要な設定です。動作ログとは,システム負荷などのしきい値オーバーに関するアラーム機能と連動して出力される履歴情報です。
設定方法については,「付録J 動作ログの出力」を参照してください。