JP1/Performance Management - Agent Option for Domino

[目次][用語][索引][前へ][次へ]

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

ここでは，PFM - Agent for Dominoを運用するための，セットアップについて説明します。

＜この項の構成＞
(1)　LANG環境変数の設定
(2)　PFM - Agent for Dominoの登録
(3)　インスタンス環境の設定
(4)　ネットワークの設定
(5)　ログのファイルサイズ変更
(6)　パフォーマンスデータの格納先の変更
(7)　PFM - Agent for Dominoの接続先PFM - Managerの設定
(8)　動作ログ出力の設定

(1)　LANG環境変数の設定

PFM - Agent for Dominoで使用できるLANG環境変数を次の表に示します。

なお，これらのLANG環境変数を設定する前に，設定する言語環境が正しくインストール・構築されていることを確認しておいてください。正しくインストール・構築されていない場合，文字化けが発生したり，定義データが不当に書き換わってしまったりすることがあります。

注意
共通メッセージログの言語は，サービス起動時やコマンド実行時に設定されているLANG環境変数によって決まります。そのため，日本語や英語など，複数の言語コードの文字列が混在することがあります。

表3-2　PFM - Agent for Dominoで使用できるLANG環境変数

OS 言語種別 LANG環境変数の値
Solaris 日本語 Shift-JISコード
  • ja_JP.PCK
EUCコード
  • ja
  • japanese
英語（日本語なし）
  • C
AIX 日本語 Shift-JISコード
  • Ja_JP
  • Ja_JP.IBM-932
EUCコード
  • ja_JP
  • ja_JP.IBM-eucJP
英語（日本語なし）
  • C

(2)　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の登録の流れを次の図に示します。

図3-3　PFM - Agentの登録の流れ

[図データ]

注意
  • PFM - Agentの登録は，インスタンス環境を設定する前に実施してください。
  • すでにPFM - Agent for Dominoの情報が登録されているPerformance Managementシステムに，新たに同じバージョンのPFM - Agent for Dominoを追加した場合，PFM - Agentの登録は必要ありません。
  • バージョンが異なるPFM - Agent for Dominoを，異なるホストにインストールする場合，古いバージョン，新しいバージョンの順でセットアップしてください。
  • PFM - Managerと同じホストにPFM - Agentをインストールした場合，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をインストールしたホストにコピーします。手順を次に示します。

  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. jpcagtsetupコマンドを実行する。
    次のように指定して実行します。
jpcagtsetup agtl
注意
コマンドを実行するローカルホストのPerformance Managementのプログラムおよびサービスが完全に停止していない状態でjpcagtsetupコマンドを実行した場合，エラーが発生することがあります。その場合は，Performance Managementのプログラムおよびサービスが完全に停止したことを確認したあと，再度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のセットアップファイルは，この作業が終了したあと削除してもかまいません。

(3)　インスタンス環境の設定

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

それぞれの手順について説明します。

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

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

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

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

項目 説明 設定できる値 デフォルト値
Instance ドミノサーバを一意に識別する名前を指定する。通常はドミノサーバ名を指定すること。
ただし，スラッシュなどファイル名として指定できない記号は使用できないため，ドミノサーバ名に記号を含んでいる場合は記号を除いた名前を指定すること。		 32バイト以内の半角文字列。
空白文字
タブ
次の記号
「/」「:」「,」「;」「*」「?」「"」「<」「>」「|」		 セットアップ時に使用したインスタンス名
Domino Program Directory 監視対象のドミノサーバのプログラムディレクトリをフルパス名で指定する。
例：/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
Store Version※ 使用するStoreバージョンを指定する。Storeバージョンについては「3.4.3　Storeバージョン2.0への移行」を参照のこと。 1.0または2.0 2.0

（凡例）
−：なし

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

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

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

  1. サービスキーおよびインスタンス名を指定して，jpcinssetupコマンドを実行する。
    例えば，PFM - Agent for Dominoのインスタンス名Domino01のインスタンス環境を構築する場合，次のように指定してコマンドを実行します。
    jpcinssetup agtl -inst Domino01
    jpcinssetupコマンドの詳細については，マニュアル「JP1/Performance Management リファレンス」の，コマンドについて説明している章を参照してください。

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

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

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

(4)　ネットワークの設定[図データ]

Performance Managementを使用するネットワーク構成に応じて行う設定です。

ネットワークの設定には次の二つの項目があります。

(5)　ログのファイルサイズ変更[図データ]

Performance Managementの稼働状況を，Performance Management独自のログファイルに出力します。このログファイルを「共通メッセージログ」と呼びます。共通メッセージログは，デフォルトで2,048キロバイトのファイルが2ファイル使用されます。このファイルサイズを変更したい場合にだけ，必要な設定です。

詳細については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，インストールとセットアップについて説明している章を参照してください。

(6)　パフォーマンスデータの格納先の変更[図データ]

PFM - Agent for Dominoで管理されるパフォーマンスデータを格納するデータベースの保存先，バックアップ，エクスポート先，またはインポート先のディレクトリを変更したい場合にだけ，必要な設定です。

パフォーマンスデータは，デフォルトで，次の場所に保存されます。

注
論理ホストで運用する場合のデフォルトの保存先については，「/opt/jp1pc」を「環境ディレクトリ/jp1pc」に読み替えてください。

注※
Storeバージョン2.0使用時だけ設定できます。

詳細については，「3.4.1　パフォーマンスデータの格納先の変更」を参照してください。

(7)　PFM - Agent for Dominoの接続先PFM - Managerの設定

PFM - Agentがインストールされているホストで，そのPFM - Agentを管理するPFM - Managerを設定します。接続先のPFM - Managerを設定するには，jpcnshostnameコマンドを使用します。

注意
  • 同一ホスト上に，複数のPFM - Agentがインストールされている場合でも，接続先に指定できるPFM - Managerは，一つだけです。PFM - Agentごとに異なるPFM - Managerを接続先に設定することはできません。
  • PFM - AgentとPFM - Managerが同じホストにインストールされている場合，接続先PFM - ManagerはローカルホストのPFM - Managerとなります。この場合，接続先のPFM - ManagerをほかのPFM - Managerに変更できません。

手順を次に示します。

  1. Performance Managementのプログラムおよびサービスを停止する。
    セットアップを実施する前に，ローカルホストでPerformance Managementのプログラムおよびサービスが起動されている場合は，すべて停止してください。サービスの停止方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，Performance Managementの起動と停止について説明している章を参照してください。
    jpcnshostnameコマンド実行時に，Performance Managementのプログラムおよびサービスが起動されている場合は，停止を問い合わせるメッセージが表示されます。

  2. 接続先のPFM - Managerホストのホスト名を指定して，jpcnshostnameコマンドを実行する。
    例えば，接続先のPFM - Managerがホストhost01上にある場合，次のように指定します。
    jpcnshostname -s host01

(8)　動作ログ出力の設定[図データ]

アラーム発生時に動作ログを出力したい場合に必要な設定です。動作ログとは，システム負荷などのしきい値オーバーに関するアラーム機能と連動して出力される履歴情報です。

設定方法については，「付録J　動作ログの出力」を参照してください。

[目次][前へ][次へ]

[他社商品名称に関する表示]

Copyright (C) 2006,2008, Hitachi, Ltd.
Copyright (C) 2006,2008, Hitachi Software Engineering Co., Ltd.