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

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

[図データ]は使用する環境によって必要になるセットアップ項目,またはデフォルトの設定を変更する場合のオプションのセットアップ項目を示します。

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

(1) LANG環境変数の設定

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

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

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

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

OS言語種別LANG環境変数の値
AIX日本語Shift-JISコード
  • Ja_JP
  • Ja_JP.IBM-932
EUCコード
  • ja_JP
  • ja_JP.IBM-eucJP
英語(日本語なし)
  • C
Linux日本語UTF-8コード
  • ja_JP.UTF-8
  • ja_JP.utf8
Shift-JISコード-(該当なし)
EUCコード-(該当なし)
英語(日本語なし)
  • C

(2) LD_LIBRARY_PATH環境変数の設定(Linuxの場合)

PFM - Agent for DB2が08-50以降の場合は,PFM - Agent for DB2を起動する前に,LD_LIBRARY_PATH環境変数にDB2ライブラリの場所を次のように指定する必要があります。

LD_LIBRARY_PATH=DB2のインストールパス/lib32

LD_LIBRARY_PATH環境変数に,ほかのパスを含める場合には,必ず上記の値を先頭に指定してください。

DB2ライブラリの場所は,DB2インスタンスユーザーでログインし,DB2DIR環境変数に設定されている値に"/lib32"を付けたパスです。

注意
・複数のDB2がインストールされている場合
同一ホスト内にインストール場所の異なる複数のDB2が存在し,それぞれをPFM - Agent for DB2で監視するときには,PFM - Agent for DB2インスタンスごとに,次の操作を実施してください。
  1. LD_LIBRARY_PATH環境変数に監視対象のDB2のインストールパス/lib32を設定する
  2. 次のコマンドで,PFM - Agent for DB2サービスを起動する

jpcspm start -key DB2 -inst PFM - Agent for DB2のインスタンス名(jpcstart agtr inst=PFM - Agent for DB2のインスタンス名)

同一のターミナルやシェルから,複数のPFM - Agent for DB2サービスを起動する場合には,上記の手順をPFM - Agent for DB2インスタンスごとに繰り返してください。
なお,次のPFM - Agent for DB2のインスタンス名を指定しない形式でのサービスの起動はできません。
  • jpcspm start all (jpcstart all)
  • jpcspm start -key DB2 (jpcstart agtr)
・自動再起動機能または定期再起動機能を使用する場合
Status ServerサービスのLD_LIBRARY_PATH環境変数に,DB2のライブラリの場所を設定してください。
同一ホスト内にインストール場所の異なる複数のDB2が存在する環境では,自動再起動機能および定期再起動機能は使用できません。

(3) PFM - Agent for DB2の登録

PFM - ManagerおよびPFM - Web Consoleを使ってPFM - Agentを一元管理するために,PFM - ManagerおよびPFM - Web ConsoleにPFM - Agent for DB2を登録する必要があります。

PFM - Managerのバージョンが08-50-05以降およびPFM - Web Consoleのバージョンが08-50-02以降の場合,PFM - Agentの登録は自動で行われるため,ここで説明する手順は不要です。ただし,PFM - Managerのリリースノートに記載されていないデータモデルバージョンのPFM - Agentは,手動で登録する必要があります。

なお,PFM - Agent for DB2のデータモデルのバージョンについては,「付録I バージョン互換」を参照してください。

PFM - Agentの登録の流れを次に示します。

図2-4 PFM - Agentの登録の流れ

[図データ]

注意
  • PFM - Agentの登録は,インスタンス環境を設定する前に実施してください。
  • すでにPFM - Agent for DB2の情報が登録されているPerformance Managementシステムに,新たに同じバージョンのPFM - Agent for DB2を追加した場合,PFM - Agentの登録は必要ありません。
  • バージョンが異なるPFM - Agent for DB2を,異なるホストにインストールする場合,古いバージョン,新しいバージョンの順でセットアップしてください。
  • PFM - Managerと同じホストにPFM - Agentをインストールした場合,jpcconf agent setup (jpcagtsetup)コマンドが自動的に実行されます。共通メッセージログに「KAVE05908-I エージェント追加セットアップは正常に終了しました」と出力されるので,結果を確認してください。コマンドが正しく実行されていない場合は,コマンドを実行し直してください。コマンドの実行方法については,マニュアル「JP1/Performance Management リファレンス」のコマンドの章を参照してください。
  • PFM - Agent for DB2の情報を登録する作業では,PFM - Web Consoleの[レポート階層]タブに「DB2_Universal_Database」,[アラーム階層]タブに「DB2 Universal Database」という名前のフォルダが作成されます。[レポート階層]タブで,すでに独自に「DB2_Universal_Database」という名前のフォルダまたはレポートを作成していた場合には,名前を変更してから作業を始めてください。

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

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

  1. PFM - Web Consoleが起動されている場合は,停止する。
  2. PFM - Agentのセットアップファイルをバイナリーモードでコピーする。
    ファイルが格納されている場所およびファイルをコピーする場所を次の表に示します。

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

    PFM - Agentの
    セットアップファイル
    コピー先
    PFMプログラム名OSコピー先ディレクトリ
    /opt/jp1pc/setup/jpcagtrw.EXEPFM - ManagerWindowsインストール先フォルダ¥setup¥
    /opt/jp1pc/setup/jpcagtru.ZUNIX/opt/jp1pc/setup/
    /opt/jp1pc/setup/jpcagtrw.EXEPFM - Web ConsoleWindowsインストール先フォルダ¥setup¥
    /opt/jp1pc/setup/jpcagtru.ZUNIX/opt/jp1pc/setup/

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

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

jpcconf agent setup -key DB2 (jpcagtsetup agtr)

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

jpcwagtsetup

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

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

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

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

表2-4 PFM - Agent for DB2のインスタンス情報

項目説明設定できる値デフォルト値
db2_instanceDB2のインスタンス名。8バイト以内の半角英数字。
ただし,次の文字は指定できない。
  • 空白文字
  • 次の記号
    「!」「"」「%」「&」「'」「(」「)」「+」「,」「-」「.」「/」「:」「;」「<」「=」「>」「?」「[」「¥」「]」「'」「{」「|」「}」「~」
db2_nodeDB2のノード名。
db2_nameDB2のデータベース名。
db2_userDB2のデータベースに接続できるユーザー名。次のどれかの権限を持つこと。
  • SYSADM
  • SYSCTRL
  • SYSMAINT
db2_passworddb2_userで指定したユーザーのパスワード。64バイト以内の半角英数字。
ただし,次の文字は指定できない。
  • 空白文字
  • 次の記号
    「!」「"」「%」「&」「'」「(」「)」「+」「,」「-」「.」「/」「:」「;」「<」「=」「>」「?」「[」「¥」「]」「'」「{」「|」「}」「~」
attach_retryDB2インスタンス接続リトライ回数。0~99(単位:回数)0
attach_waittimeDB2インスタンス接続リトライ間隔。0~600(単位:秒)0
db2_activateDB2を活動化状態にするかどうかを指定する。yまたはnn
db2_dir1DB2のインストールパスを指定する。※2255バイト以内のディレクトリパス/opt/IBM/db2/V9.1
Store Version※3使用するStoreバージョンを指定する。
Storeバージョンについては「2.4.3 Storeバージョン2.0への移行」を参照のこと。
1.0または2.02.0
(凡例)
-:なし

注※1
AIXの場合だけ必要な項目です。
注※2
db2_dirに指定する値は,DB2がインストールされている場所(インストールパス)です。通常はDB2インスタンスユーザーでログインし,DB2DIR環境変数に設定されている値です。
同一ホスト内にインストール場所の異なる複数のDB2が存在し,それぞれをPFM - Agent for DB2で監視する場合は,db2_dirの値を監視対象のそれぞれのDB2のインストールパスに合わせてください。
注※3
Store Versionは新規にインスタンス環境を設定するときだけ指定できる項目です。インスタンス環境を更新するときは指定できません。
注意
  • db2_instance,およびdb2_nodeが不明な場合,DB2の"Control Center"を起動して,"Instances"ディレクトリ下の"Name"をdb2_instanceに,"Node name"をdb2_nodeに設定してください。"Control Center"についての詳細は,DB2のマニュアルを参照してください。

なお,DB2の"Control Center"を使用できない場合,DB2のコマンドを使って次の表の方法を実施し,必要な値を確認します。DB2のコマンドの詳細は,DB2のマニュアルをしてください。

表2-5 DB2を使ったPFM - Agent for DB2のインスタンス項目値の確認方法

インスタンス項目設定する値の確認方法
db2_instance次のコマンドを実行して出力された値を確認します。

DB2のインストールディレクトリ/bin/db2ilistコマンド


このコマンドは,どのユーザーでも実行できます。
db2_node次のどちらかの値を確認します。
  • 監視対象のDB2インスタンスユーザー(db2_instanceの値)でログインし,DB2のlist node directoryコマンドを実行した時に出力される"Node name"の値を確認します。
    ただし,ノードの情報をカタログしていない場合,値は出力されません。
  • PFM - Agent for DB2のインスタンスの項目db2_instanceと同じ値を確認します。

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

  1. サービスキーおよびインスタンス名を指定して,jpcconf inst setup (jpcinssetup)コマンドを実行する。
    PFM - Agent for DB2のインスタンス名db2instのインスタンス環境を構築する場合,次のように指定してコマンドを実行します。

    jpcconf inst setup -key DB2 -inst db2inst (jpcinssetup agtr -inst db2inst)

    jpcconf inst setup (jpcinssetup)コマンドの詳細については,マニュアル「JP1/Performance Management リファレンス」の,コマンドについて説明している章を参照してください。
  2. DB2のインスタンス情報を設定する。
    表2-4に示した項目を,コマンドの指示に従って入力してください。各項目とも省略はできません。デフォルトで表示されている値を,項目の入力とする場合はリターンキーだけを押してください。

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

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

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

表2-6 インスタンス環境のディレクトリ構成

ディレクトリ名・ファイル名説明
agentインスタンス名jpcagt.iniAgent Collectorサービス起動情報ファイル
jpcagt.ini.modelAgent Collectorサービス起動情報ファイルのモデルファイル
logログファイル格納ディレクトリ
storeインスタンス名jpcsto.iniAgent Storeサービス起動情報ファイル
jpcsto.ini.modelAgent Storeサービス起動情報ファイルのモデルファイル
*.DATデータモデル定義ファイル
dumpエクスポート先ディレクトリ
backupバックアップ先ディレクトリ
importインポート先ディレクトリ(Storeバージョン2.0の場合)
logログファイル格納ディレクトリ
partial部分バックアップ先ディレクトリ(Storeバージョン2.0の場合)
STPDPDレコードタイプのパフォーマンスデータ格納ディレクトリ(Storeバージョン2.0の場合)
STPIPIレコードタイプのパフォーマンスデータ格納ディレクトリ(Storeバージョン2.0の場合)
注※
インスタンス環境を構築した時点の設定値に戻したいときに使用します。

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

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

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

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

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

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

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

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

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

注※
Storeバージョン2.0使用時だけ設定できます。
注意
論理ホストで運用する場合のデフォルトの保存先については,「/opt/jp1pc」を「環境ディレクトリ/jp1pc」に読み替えてください。

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

(8) PFM - Agent for DB2の接続先PFM - Managerの設定

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

注意
  • 同一ホスト上に,複数のPFM - Agentがインストールされている場合でも,接続先に指定できるPFM - Managerは,一つだけです。PFM - Agentごとに異なるPFM - Managerを接続先に設定することはできません。
  • PFM - AgentとPFM - Managerが同じホストにインストールされている場合,PFM - Agentの接続先PFM - ManagerはローカルホストのPFM - Managerとなります。この場合,接続先のPFM - ManagerをほかのPFM - Managerに変更できません。
  • セットアップを実施する前に,ローカルホストでPerformance Managementのプログラムのサービスが起動されている場合は,すべて停止してください。サービスの停止方法については,マニュアル「JP1/Performance Management 運用ガイド」の,Performance Managementの起動と停止について説明している章を参照してください。

手順を次に示します。

  1. Performance Managementのプログラムおよびサービスを停止する。
    jpcconf mgrhost define (jpcnshostname)コマンド実行時に,Performance Managementのプログラムおよびサービスが起動されている場合は,停止を問い合わせるメッセージが表示されます。
  2. 接続先の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 リファレンス」のコマンドについて説明している章を参照してください。

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

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

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