3.4.3　インスタンス環境の設定

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

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

• HiRDB運用ディレクトリに関する情報

• HiRDB/パラレルサーバの構成

• HiRDBのシステムマネジャが稼働しないホストに関する情報

• PD_ROT1，PD_ROT2レコードの収集に関する情報

• PI_RDST，PI_RDDSレコード収集時の収集対象RDエリアに関する情報

• PI_FSSTレコード，PI_SSYSレコード，PI_RDFLレコードおよびPI_RDFSレコード収集時のリモート実行に関する情報

• PI_SSYSレコード，PI_RDFLレコードおよびPI_RDFSレコード収集時に関する情報

• PFM-Agent for HiRDBがレコードを収集する上での共通機能オプション情報

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

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

図3‒5　インスタンス設定ファイルjpcagtbdef.iniのフォーマット（UNIXの場合）

注意

• 各情報は「ラベル=値」という形式で指定します。ラベルの前後，および値の前後には，余分な文字（空白文字，引用符など）を記述しないでください。

• 1カラム目が「;」（半角セミコロン）の行はコメント行です。

• PDDIRセクション

  2ユニット以上のHiRDB/パラレルサーバを監視する場合に指定します。

  ユニット名とPDDIRを指定します。次の条件をすべて満たす場合は，該当するユニットにPDDIRを設定してください。

  • PI_FSST，PI_SSYS，PI_RDFL，またはPI_RDFSレコードを収集する場合

  • HiRDBシステム共通定義ファイル（pdsysファイル）のpdunitオペランドに-dオプションの指定がない場合

  この指定がない場合，HiRDBのシステムマネジャが稼働しないホストに存在するユニットの作業表用HiRDBファイルシステム領域の情報や統計情報を収集しません。

  PDDIRセクションに設定するラベルと値を次に示します。

  表3‒6　PDDIRセクションに設定するラベルと値

  ラベル	値
  ユニット識別子	「ユニット識別子」で示されるHiRDBユニットの環境変数PDDIRの値を指定する。

• PDCONFPATHセクション

  2ユニット以上のHiRDB/パラレルサーバを監視する場合に指定します。

  ユニット名とPDCONFPATHを指定します。PI_FSST，PI_SSYS，PI_RDFL，またはPI_RDFSレコードを収集する場合に必要です。

  この指定がない場合，HiRDBのシステムマネジャが稼働しないホストに存在するユニットの作業表用HiRDBファイルシステム領域の情報や統計情報を収集しません。

  PDCONFPATHセクションに設定するラベルと値を次に示します。

  表3‒7　PDCONFPATHセクションに設定するラベルと値

  ラベル	値
  ユニット識別子	「ユニット識別子」で示されるHiRDBユニットの環境変数PDCONFPATHの値を指定する。

• ROT1_Optionsセクション

  PD_ROT1_Optionsセクションには，PD_ROT1収集時に実行する，pddbst -k predコマンドのコマンドオプションを指定します。省略すると，監視期間または基準定義ファイルが指定されていない状態の情報が収集されます。

  表3‒8　PD_ROT1セクションに設定するラベルと値

  ラベル	値
  Option_c	pddbst -k pred コマンドの-cオプションに使用する「基準値定義ファイル」の絶対パス（590バイト以内）を指定する。
  Option_R	pddbst -k pred コマンドの-Rオプションに使用する「監視期間」および「メンテナンス延長期間」を指定する。

• ROT2_Optionsセクション

  PD_ROT2_Optionsセクションには，PD_ROT2収集時に実行する，pddbst -k predコマンドのコマンドオプションを指定します。省略すると，監視期間または基準定義ファイルが指定されていない状態の情報が収集されます。

  表3‒9　PD_ROT2セクションに設定するラベルと値

  ラベル	値
  Option_c	pddbst -k pred コマンドの-cオプションに使用する「基準値定義ファイル」の絶対パス（590バイト以内）を指定する。
  Option_R	pddbst -k pred コマンドの-Rオプションに使用する「監視期間」および「メンテナンス延長期間」を指定する。

• RDST_RDAREAセクション

  RDST_RDAREAセクションには，PI_RDSTレコード収集時にデータ収集したいRDエリア名を，コンマ区切りで指定します。指定したRDエリアに関するパフォーマンスデータが収集されます。

  HiRDBのpddblsコマンドと同様に，RDエリア名はRDエリア名一括指定ができます。

  RDエリア名一括指定については，マニュアル「HiRDB コマンドリファレンス」を参照してください。

  RDエリア名は重複して指定できません。RDエリア名を重複指定した場合，重複排除をしたRDエリアに関するパフォーマンスデータが収集されます。

  例えば，RDST_RDAREAセクションにRDエリア名を指定する場合は次のようになります。

  • HiRDB環境のRDエリアの構成：

    RDMAST，RDDIRT，RDDICT，RDDATA10，RDDATA20，RDDATA30，RDINDX10，RDINDX20，RDINDX30

  • RDST_RDAREAセクションの指定：

    ［RDST_RDAREA］

    RDAREA_NAME=RDMAST,RDDATA10,RDDATA*,*RDDATA*

  • PI_RDSTレコードで収集対象となるRDエリア：

    RDMAST，RDDATA10，RDDATA20，RDDATA30

    注意事項

    • RDエリア名はアポストロフィ(')，引用符(")，エスケープ文字＋引用符(\")などの区切り文字を指定しないでください。

    • RDエリア名の前方および後方に空白文字を含むRDエリアについては，動作が保証されません。

    • RDAREA_NAMEラベルに値を指定していない場合は，すべてのRDエリアに関するパフォーマンスデータが収集されます。

    • RDAREA_NAMEラベルの一部の指定に誤りがある場合は，正しく設定されたRDエリアに関するパフォーマンスデータだけが収集されます。

  表3‒10　RDST_RDAREAセクションに設定するラベルと値

  ラベル	値
  RDAREA_NAME	PI_RDSTレコード収集時にデータを収集したいRDエリア名をコンマ区切りで指定する。設定できるサイズはラベル名（RDAREA_NAME）を含む8,192バイト以内。

• RDDS_RDAREAセクション

  RDDS_RDAREAセクションには，PI_RDDSレコード収集時にデータ収集したいRDエリア名を，コンマ区切りで指定します。指定したRDエリアに関するパフォーマンスデータが収集されます。

  HiRDBのpddblsコマンドと同様に，RDエリア名はRDエリア名一括指定ができます。

  RDエリア名一括指定については，マニュアル「HiRDB コマンドリファレンス」を参照してください。

  RDエリア名は重複して指定できません。RDエリア名を重複指定した場合，重複排除をしたRDエリアに関するパフォーマンスデータが収集されます。

  例えば，RDDS_RDAREAセクションにRDエリア名を指定する場合は次のようになります。

  • HiRDB環境のRDエリアの構成：

    RDMAST，RDDIRT，RDDICT，RDDATA10，RDDATA20，RDDATA30，RDINDX10，RDINDX20，RDINDX30

  • RDDS_RDAREAセクションの指定：

    ［RDDS_RDAREA］

    RDAREA_NAME=RDMAST,RDDATA10,RDDATA*,*RDDATA*

  • PI_RDDSレコードで収集対象となるRDエリア：

    RDMAST，RDDATA10，RDDATA20，RDDATA30

    注意事項

    • RDエリア名はアポストロフィ(')，引用符(")，エスケープ文字＋引用符(\")などの区切り文字を指定しないでください。

    • RDエリア名の前方および後方に空白文字を含むRDエリアについては，動作が保証されません。

    • RDAREA_NAMEラベルに値を指定していない場合は，すべてのRDエリアに関するパフォーマンスデータが収集されます。

    • RDAREA_NAMEラベルの一部の指定に誤りがある場合は，正しく設定されたRDエリアに関するパフォーマンスデータだけが収集されます。

  表3‒11　RDDS_RDAREAセクションに設定するラベルと値

  ラベル	値
  RDAREA_NAME	PI_RDDSレコード収集時にデータを収集したいRDエリア名をコンマ区切りで指定する。設定できるサイズはラベル名（RDAREA_NAME）を含む8,192バイト以内。

• REMOTE_OPERATION_FOR_ACTIVITYセクション

  HiRDB/パラレルサーバで，稼働しているHiRDBユニットのパフォーマンスデータだけを取得するときに，「SETTING=ON」を指定します。デフォルトは指定なしです。

  「SETTING=ON」を指定すると，HiRDBのシステムマネジャが存在するホストからほかのホストに対して，パフォーマンスデータを取得するコマンドがリモート実行されます。パフォーマンスデータの取得がシステムマネジャの稼働が前提となるため，ネットワークとログの容量の負荷を軽減できます。

  指定を省略すると，システムマネジャが停止している場合でも，HiRDB/パラレルサーバを構成する各サーバのパフォーマンスデータが取得されます。システムマネジャが停止していても，ほかのHiRDBサーバのパフォーマンスデータを継続して取得できますが，ネットワークとログの容量の負荷が高くなることがあります。

  このセクションは，インスタンス単位に設定できますが，レコード単位には設定できません。

  レコードの種類によってリモート実行する判断方法が異なります。REMOTE_OPERATION_FOR_ACTIVITYセクションに設定するラベルと値を次の表に示します。

  表3‒12　REMOTE_OPERATION_FOR_ACTIVITYセクションに設定するラベルと値

  ラベル	値
  SETTING	PI_FSSTレコード収集時に，ユニットのステータスがACTIVEであるホストに対してだけリモート実行する場合に「ON」と指定する。 コマンドを実行できない状態（pdls -d svrコマンドの実行結果がKFPS01853-W）のホストには，リモート実行されません。
  	PI_SSYS，PI_RDFLおよびPI_RDFSレコード収集時に，pdls -d stjコマンドの実行結果から，統計情報の取得状況が判明しているユニットが存在するホストに対してだけリモート実行する場合に，「ON」と指定する。

  HiRDBの状態（pdls -d svrコマンドの実行結果）およびREMOTE_OPERATION_FOR_ACTIVITYセクションの設定と，リモート実行されるかどうかの関係を次の表に示します。

  表3‒13　HiRDBの状態およびREMOTE_OPERATION_FOR_ACTIVITYセクションの設定とリモート実行有無の関係

  システムマネジャのホスト	システムマネジャ以外のホスト	REMOTE_OPERATION_FOR_ACTIVITY	リモート実行有無
  コマンド実行可（KFPS01853-Wが出力されない）	ACTIVE	SETTING=ON	○
  		上記以外（指定なしも含む）	○
  	上記以外	SETTING=ON	×
  		上記以外（指定なしも含む）	○
  コマンド実行不可（KFPS01853-Wが出力される）	ACTIVE	SETTING=ON	×
  		上記以外（指定なしも含む）	○
  	上記以外	SETTING=ON	×
  		上記以外（指定なしも含む）	○

  （凡例）

  ○：リモート実行します

  ×：リモート実行しません

  REMOTE_OPERATION_FOR_ACTIVITYセクションの設定内容のメリットおよびデメリットを次の表に示します。

  表3‒14　REMOTE_OPERATION_FOR_ACTIVITYセクションの設定内容のメリットおよびデメリット

  REMOTE_OPERATION_FOR_ACTIVITY	メリット	デメリット
  SETTING=ON	PFM - Agent for HiRDBが実行するリモート実行で，ネットワーク障害などによって不要な負荷が掛からない（ただし，HiRDBサーバのユニット間通信の監視で起こるタイムラグによるステータス誤認識を除く）。	システムマネジャが停止していると，ユニット全体のパフォーマンスデータが収集されない。 また，システムマネジャが稼働していて，システムマネジャ以外のユニットが停止している場合，そのシステムマネジャ以外のユニットに対するパフォーマンスデータは収集されない。
  上記以外（指定なしも含む）	HiRDB/パラレルサーバ内のシステムマネジャが停止していても，ユニット全体のパフォーマンスデータが収集される。	PFM - Agent for HiRDBが実行するリモート実行で，ネットワーク障害などによって不要な負荷が掛かることがある。

• NOT_EXECUTE_PDSTJSYNCセクション

  PFM-Agent for HiRDBは，システムの稼働に関する統計情報（sys統計情報）やデータベース操作に関するHiRDBファイルの統計情報（fil統計情報）を取得するため，pdstjsyncコマンドを実行します。pdstjsyncコマンドには，コマンド実行時点でのsys統計情報の取得を抑止し，指定した時間間隔でだけsys統計情報を取得するオプション（-mオプション）があります。-mオプションを省略すると，指定した時間間隔とは別に，コマンド実行時点のsys統計情報が取得され，異なる時間間隔のsys統計情報が混在することがあります。そのため，PFM-Agent for HiRDBは-mオプション付きの動作で統計情報を取得しています。

  ただし，pdstjsyncコマンドの-mオプションをサポートしていないHiRDBを使用する場合は，上記の統計情報の混在が起こります。この混在を防止するため，pdstjsyncコマンドの実行を抑止する場合に，NOT_EXECUTE_PDSTJSYNCセクションに「SETTING=ON」と指定します。指定すると，PI_SSYSレコード，PI_RDFLレコードおよびPI_RDFSレコード収集時に，pdstjsyncコマンドの実行による異なる時間間隔のsys統計情報の混在を防止できます。

  NOT_EXECUTE_PDSTJSYNCセクションは，-mオプションをサポートしていないHiRDB用の指定であるため，pdstjsyncコマンドの-mオプションをサポートしているHiRDBの場合，NOT_EXECUTE_PDSTJSYNCセクションの指定値は無視されます。

  pdstjsyncコマンドの-mオプションをサポートしていないHiRDBの場合，「SETTING=ON」以外の値を指定すると，エラーメッセージが出力されますが，指定は無視され処理は続行されます。

  このセクションは，インスタンス単位に設定できますが，レコード単位には設定できません。

  NOT_EXECUTE_PDSTJSYNCセクションに設定するラベルと値を次の表に示します。

  表3‒15　NOT_EXECUTE_PDSTJSYNCセクションに設定するラベルと値

  ラベル	値
  SETTING	PI_SSYSレコード，PI_RDFLレコードおよびPI_RDFSレコード収集時に，pdstjsyncコマンドの-mオプションをサポートしていないHiRDBを使用していて，pdstjsyncコマンドを実行したくない場合に，「ON」と指定する。

  NOT_EXECUTE_PDSTJSYNCセクションには，SETTING=ONの指定を推奨します。なお，使用するHiRDBのバージョンとNOT_EXECUTE_PDSTJSYNCセクションの設定によって，pdstjsyncコマンドの実行有無が変わります。その内容を次の表に示します。

  表3‒16　HiRDBのバージョンでのpdstjsyncコマンド実行有無

  推奨順	HiRDBのバージョン	NOT_EXECUTE_PDSTJSYNC	pdstjsyncコマンド実行有無
  1	pdstjsyncコマンドの-mオプションをサポートしているバージョンのHiRDB	SETTING=ON	◎
  		上記以外（指定なしも含む）	◎
  2	pdstjsyncコマンドの-mオプションをサポートしていないバージョンのHiRDB	SETTING=ON	×
  3		上記以外（指定なしも含む）	○※

  （凡例）

  ◎：pdstjsyncコマンドの-mオプションを実行します

  ○：pdstjsyncコマンドを実行します

  ×：pdstjsyncコマンドを実行しません

  注※

  指定に誤りがある場合だけ，エラーメッセージが出力されます。

  pdstjsyncコマンドの-mオプションをサポートしていないHiRDBの場合の，NOT_EXECUTE_PDSTJSYNCセクションの指定内容のメリットおよびデメリットを次の表に示します。

  表3‒17　NOT_EXECUTE_PDSTJSYNCセクションの指定内容のメリットおよびデメリット（pdstjsyncコマンド -mオプション未サポートのHiRDBの場合）

  NOT_EXECUTE_PDSTJSYNC	メリット	デメリット
  SETTING=ON	HiRDBのsys統計情報を出力する時間間隔以外にsys統計情報が出力されない。	収集契機が直近の，HiRDBのsys統計情報およびfil統計情報を収集できない。
  上記以外（指定なしも含む）	収集契機が直近の，HiRDBのsys統計情報およびfil統計情報を収集できる。	HiRDBのsys統計情報を出力する時間間隔以外にもsys統計情報が出力される。

• COMMON_OPTIONセクション

  COMMON_OPTIONセクションには，PFM-Agent for HiRDBがレコードを収集する上での共通機能オプションを指定します。OPTIMIZE_LEVELは，PI_RDSTおよびPI_RDDSレコード収集時のオプションです。CMD_RMODEおよびCMD_RCONFIGは，PI_FSST，PI_SSYS，PI_RDFL，およびPI_RDFSレコード収集時のオプションです。

  表3‒18　COMMON_OPTIONセクションに設定するラベルと値

  ラベル	値	機能
  OPTIMIZE_LEVEL※	0	最適化オプションが無効になる（デフォルト（指定なしも含む））。
  	1	RDエリア数が1,000個以上のHiRDB環境にで，PI_RDST，PI_RDDSレコードの収集時間の短縮を見込むことができるグローバルバッファ名取得処理高速化オプションが有効になる。本機能はRDエリア数にだけ依存し，グローバルバッファ数には依存しない。なお，インスタンス単位の設定となり，レコード単位の設定はできない。
  	上記以外	KAVF15068-Wメッセージを出力し，0を指定した場合と同じになる。
  CMD_RMODE	rsh	rsh，rcpコマンドを使用してリモート実行やファイル転送をする（デフォルト（指定なしも含む））。
  	ssh	ssh，scpコマンドを使用してリモート実行やファイル転送をする。
  	上記以外	KAVF15077-Wメッセージを出力し，rshを指定した場合と同じになる。
  CMD_RCONFIG	SSHクライアント設定ファイル	このオプションは，CMD_RMODEにsshを指定した場合に有効になる。 リモート実行やファイル転送でssh，scpコマンドを使用する場合に，コマンドに指定するSSHクライアント設定ファイルを絶対パス名（255文字以内）で指定する。指定したファイルは，プログラム内で，ssh，scpコマンドの-Fオプションに指定されて動作する。 SSHクライアント設定ファイルは，HiRDB管理者に参照権限があるものとし，監視するすべてのサーバマシンで，同一の絶対パス名で格納すること。 SSHクライアント設定ファイルは，ssh，scpコマンドを実行する場合に，ユーザ設定ファイル（〜/.ssh/config）やシステム全体の設定ファイル（/etc/ssh/ssh_config）とは異なる設定を適用したいときに指定する。 SSHクライアント設定ファイルに，Userを指定する場合は，rootを指定すること。 詳細はOSのマニュアルを参照のこと。

  注※

  OPTIMIZE_LEVELの値には半角数字を指定してください。

ページの先頭へ

(2)　2ユニット以上のHiRDB/パラレルサーバを監視する場合の設定

PFM - Agent for HiRDBのインスタンスで2ユニット以上のHiRDB/パラレルサーバを監視する場合，rsh，rcpやssh，scpを使用します。HiRDBのシステムマネジャが稼働するHiRDBホストとHiRDBのシステムマネジャが稼働しないHiRDBホストとの間で，コマンドのリモート実行やファイル転送をします。

HiRDBのシステムマネジャが稼働するHiRDBホストとHiRDBのシステムマネジャが稼働しないHiRDBホストとの間では，rootおよびHiRDB管理者で相互にログインができるようにしてください。

また，HiRDBのシステムマネジャが稼働するHiRDBホストから稼働しないHiRDBホストへは，rootからHiRDB管理者としてもログインできるようにしてください。

ログインの設定については，次の表を参照してください。

rsh，rcpを使用する場合は，/etc/hosts.equivまたは$HOME/.rhostsを設定してください。

なお，$HOME/.cshrcファイルを作成する場合，登録端末がないときは標準出力または標準エラーファイルにデータを出力しない構造にしてください。

ssh，scpを使用する場合は，監視するすべてのサーバマシンでSSHプロトコルを利用できるように設定する必要があります。ログイン時にパスワードやパスフレーズの入力など，プロンプトに入力をしなくてもログインできるよう設定してください。

また，標準エラー出力に情報が出力されると失敗と判断するため，ssh が標準エラー出力に情報を出力しないよう設定してください（LogLevelにVERBOSE以上を設定するなど）。詳細はOSのマニュアルを参照してください。

この設定をしない場合，PFM - Agent for HiRDBがHiRDBのシステムマネジャ以外のユニットの情報を収集できないおそれがあります。

表3‒19　rootからHiRDB管理者としてログインするために必要な設定

転送元	転送先	必要な設定
MGRのroot	非MGRのroot	プロンプトに入力しなくてもログインできる設定
	非MGRのHiRDB管理者	プロンプトに入力しなくてもログインできる設定
MGRのHiRDB管理者	非MGRのroot	設定不要
	非MGRのHiRDB管理者	プロンプトに入力しなくてもログインできる設定
非MGRのroot	MGRのroot	プロンプトに入力しなくてもログインできる設定
	MGRのHiRDB管理者	設定不要
非MGRのHiRDB管理者	MGRのroot	設定不要
	MGRのHiRDB管理者	プロンプトに入力しなくてもログインできる設定

（凡例）

MGR：HiRDBのシステムマネジャが稼働するHiRDBホスト

非MGR：HiRDBのシステムマネジャが稼働しないHiRDBホスト

ページの先頭へ