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

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

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

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

(1) LANG環境変数の設定

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

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

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

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

OS言語種別LANG環境変数の値
HP-UX(PA-RISC)
HP-UX(IPF)
Solaris
日本語Shift-JISコード
  • ja_JP.SJIS
  • japanese
EUCコード
  • ja_JP.eucJP
  • japanese.euc
英語(日本語なし)
  • C
日本語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
Linux日本語Shift-JISコード
EUCコード
UTF-8コード
  • ja_JP.UTF-8
  • ja_JP.utf8
英語(日本語なし)
  • C

(2) PFM - Agent for HiRDBの登録

PFM - ManagerおよびPFM - Web Consoleを使ってPFM - Agentを一元管理するために,PFM - ManagerおよびPFM - Web ConsoleにPFM - Agent for HiRDBを登録する手順を説明します。

PFM - Managerのバージョンが08-50以降の場合,PFM - Agentの登録は自動で行われるため,ここで説明する手順は不要です。ただし,PFM - Managerのリリースノートに記載されていないデータモデルバージョンのPFM - Agentは手動で登録する必要があります。なお,PFM - Agent for HiRDBのデータモデルのバージョンについては,「付録I バージョン互換」を参照してください。

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

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

[図データ]

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

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

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

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

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

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

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

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

jpcagtsetup agtb

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

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

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

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

jpcwagtsetup

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

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

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

インスタンス環境の設定は,システムマネジャが稼働するホストで実施してください。なお,システムマネジャが稼働していないホストではインスタンス環境の設定は実施しないでください。

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

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

項目説明設定できる値デフォルト値
PDDIR監視対象のHiRDBシステムのシステムマネジャを含むHiRDBユニットのHiRDB運用ディレクトリのパス(環境変数PDDIRの値)。200バイト以内のパス名なし
PDCONFPATH監視対象のHiRDBシステムのシステムマネジャを含むHiRDBユニットの環境変数PDCONFPATHの値。
「PDDIRの値/conf」が設定されます。
512バイト以内のパス名
HiRDB_userDBA権限を持つHiRDB認可識別子。大文字と小文字を区別する場合は全体を"(引用符)で囲んでください。囲まなければすべて大文字として扱われます。10バイト以内の文字列
HiRDB_passwordHiRDB_userに対応するパスワード。大文字と小文字を区別する場合は全体を"(引用符)で囲んでください。囲まなければすべて大文字として扱われます。32バイト以内の文字列
LANGインスタンスが動作するときに使用する文字コードの値。PFMで指定できるLANG値の中からHiRDBシステムで使用しているLANG値を指定します。256バイト以内の文字列
HiRDB_adminHiRDB管理者。8バイト以内の文字列
Store VersionStoreバージョン。{1.0|2.0}2.0
注※
PFM - Agent for HiRDBと同一ホスト上のPFM - ManagerまたはPFM - Baseが08-10以降で,初めてインスタンス環境を設定する場合に必要です。

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

  1. サービスキーおよびインスタンス名を指定して,jpcinssetupコマンドを実行する。
    例えば,PFM - Agent for HiRDBのインスタンス名HRD1のインスタンス環境を構築する場合,次のように指定してコマンドを実行します。

    jpcinssetup agtb -inst HRD1

    agtb:HiRDBエージェントを示します。
    jpcinssetupコマンドの詳細については,マニュアル「JP1/Performance Management リファレンス」の,コマンドについて説明している章を参照してください。
  2. HiRDBのインスタンス情報を設定する。
    表3-4に示した項目を,コマンドの指示に従って入力してください。各項目とも省略できません。

すべての入力が終了すると,インスタンス環境が構築されます。構築時に入力したアカウント名,パスワード,リスナー名,エージェントログ出力先,またはエージェントログファイルサイズを変更したい場合は,再度jpcinssetupコマンドを実行し,インスタンス環境を更新してください。インスタンス環境の更新については,「3.4.3 インスタンス環境の更新」を参照してください。

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

(4) インスタンス設定ファイルを作成する

インスタンス設定ファイル(/opt/jp1pc/agtb/agent/インスタンス名/jpcagtbdef.ini)に次の構成および情報を設定します。

なお,インスタンスを作成すると,jpcagtbdef.iniファイルは初期化されます。

インスタンス設定ファイルのフォーマットを次の図に示します。

図3-4 インスタンス設定ファイルjpcagtbdef.iniのフォーマット(UNIXの場合)

[図データ]

注意
  • jpcagtbdef.iniファイルの中で「=」の左右に指定する文字列の両端には,余分な文字(空白文字,引用符など)を挿入しないでください。

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

Performance Managementを使用するネットワーク構成に応じて,変更する場合にだけ必要な設定です。

ネットワークの設定では次の二つの項目を設定できます。

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

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

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

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

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

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

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

(8) PFM - Agent for HiRDBの接続先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 システム構築・運用ガイド」の,サービスの起動と停止について説明している章を参照してください。
    jpcnshostnameコマンド実行時に,Performance Managementのプログラムおよびサービスが起動されている場合は,停止を問い合わせるメッセージが表示されます。
  2. 接続先のPFM - Managerホストのホスト名を指定して,jpcnshostnameコマンドを実行する
    例えば,接続先のPFM - Managerがホストhost01上にある場合,次のように指定します。

    jpcnshostname -s host01