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

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

インスタンス設定ファイル（インストール先フォルダ\agtb\agent\インスタンス名\jpcagtbdef.ini）に次の構成および情報を設定します。

• 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ファイルは初期化されます。

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

注意

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

• AGTBPATHセクション

  ホスト名とPFMのインストール先フォルダのパス名を指定します。PFMがWindows版でPI_FSST，PI_SSYS，PI_RDFLまたはPI_RDFSレコードを収集する場合に必要です。

  記述がない場合は，該当するホストに存在するユニットの，サーバの作業表用HiRDBファイルシステム領域の情報や統計情報を収集しません。

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

  表2‒5　AGTBPATHセクションに設定するラベルと値

  ラベル	値
  リモートホスト名※1 ※2	「リモートホスト名」で示されたホスト上のPFMのインストール先フォルダのパス。絶対パスで指定すること。

  注※1

  リモートホスト名には，次に示す表のホスト名を指定してください。ただし，監視対象のHiRDBシステムのシステムマネジャが稼働するホストは指定しないでください。

  注※2

  同一ホスト上に複数の監視対象HiRDBユニットがある場合，そのホスト名は1回だけ設定してください。

  表2‒6　HiRDBユニットの系切り替え構成とリモートホスト名の指定方法

  HiRDBユニットの系切り替え構成	リモートホスト名の指定方法
  系切り替えなし	該当するユニット識別子の-uに指定されている，pdsysのpdunitオペランド-xに指定したホスト名を指定する。
  IPアドレス引き継ぎありスタンバイ型系切り替え
  1：1スタンバイレス型系切り替え
  影響分散スタンバイレス型系切り替え
  IPアドレス引き継ぎなしスタンバイ型系切り替え	該当するユニット識別子の-uに指定されている，pdsysのpdunitオペランド -xに指定したホスト名および-cに指定したホスト名を指定する。

• PDDIRセクション

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

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

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

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

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

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

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

• PDCONFPATHセクション

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

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

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

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

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

• ROT1_Optionsセクション

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

  表2‒9　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コマンドのコマンドオプションを指定します。省略すると，監視期間または基準定義ファイルが指定されていない状態の情報が収集されます。

  表2‒10　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エリアに関するパフォーマンスデータだけが収集されます。

  表2‒11　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エリアに関するパフォーマンスデータだけが収集されます。

  表2‒12　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セクションに設定するラベルと値を次の表に示します。

  表2‒13　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セクションの設定と，リモート実行されるかどうかの関係を次の表に示します。

  表2‒14　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セクションの設定内容のメリットおよびデメリットを次の表に示します。

  表2‒15　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セクションに設定するラベルと値を次の表に示します。

  表2‒16　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コマンドの実行有無が変わります。その内容を次の表に示します。

  表2‒17　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セクションの指定内容のメリットおよびデメリットを次の表に示します。

  表2‒18　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がレコードを収集する上での共通機能オプションを指定します。

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

  ラベル	値	機能
  OPTIMIZE_LEVEL※	0	共通機能オプションが無効になる（デフォルト（指定なしも含む））。
  	1	RDエリア数が1,000個以上のHiRDB環境で，PI_RDST，PI_RDDSレコードの収集時間の短縮を見込むことができるグローバルバッファ名取得処理高速化オプションが有効になる。この機能はRDエリア数にだけ依存し，グローバルバッファ数には依存しない。なお，インスタンス単位の設定となり，レコード単位の設定はできない。
  	上記以外	KAVF15068-Wメッセージを出力し，0を指定した場合と同じになる。

  注※

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

ページの先頭へ