2.6.3　インスタンス環境の更新の設定

10-50以前のバージョンではOracle Client 32-bitを前提製品としていましたが，11-00以降のバージョンではOracle Client 64-bitを前提製品としています。

バージョン10-50以前の設定方法では，Oracle Databaseに接続できないため，バージョン11-00以降では，Oracle Client 64-bitを前提として，設定する必要があります。

バージョン11-00以降，インスタンス情報の設定は次の表のように異なるため，設定内容を確認してください。

注意

• PFM - RM for Oracle 10-50以前から11-00以降にバージョンアップする場合，インスタンス情報の設定内容が変更になるため，PFM - RM for Oracleのサービスを起動する前にインスタンス情報を更新してください。

  また，Oracle Client 32-bitは不要になります。Oracle Client 32-bitをPFM - RM for Oracle以外で使用しない場合，アンインストールしても問題ありません。

• Oracle Client 32-bitのORACLE_HOMEを指定して，PFM - RM for Oracleを起動すると，KAVL18020-Eのメッセージが表示されます。

PFM - RM for OracleがOracle Databaseのクライアントライブラリを使用する（PFM - RM for Oracle導入サーバにOracle Database 64bitがインストールされている）場合は，Oracle DatabaseのOracleホームを指定してください。

ユーザーを変更する場合は，次の手順で行ってください。

1. 変更前のユーザーが作成していたオブジェクトを削除する。

2. 変更後のユーザーで，新しくオブジェクトを登録する。

なお，ユーザーを変更しても，パフォーマンスデータは削除されません。

オブジェクトの削除方法については「2.3.2(1)(c)　Oracle Databaseへ登録したオブジェクトを削除する」を，オブジェクトの登録方法については「2.1.4(3)(c)　Oracle Databaseへオブジェクトを登録する」を参照してください。

oracle_passwdにパスワードの有効期限が設定されている場合，有効期限に達するとOracleとの接続エラーが起こり，パフォーマンス情報を収集できません。Oracleとの接続エラーを起こさないようにするために，パスワードの有効期限が切れる前に，次のどちらかを設定してください。

• パスワードの有効期限を解除します。

• パスワードの更新後，jpcconf inst setupコマンドを実行し，oracle_passwdを更新します。

なお，mk_rmus.sqlで作成したOracleのアカウントには，Oracleが提供しているDEFAULTのプロファイルが適用されます。

PFM - RM for Oracleが使用するOracleクライアントのネットワークサービス（tnsnames.oraなど）を設定している必要があります。

また監視対象となるOracleのネットワークサービス定義（listener.oraなど）を設定し，リスナーを起動しておく必要があります。

Oracle RAC構成のOracle Databaseインスタンスを監視するときは，各ノードのOracle Databaseインスタンスを監視するよう設定してください。設定方法については，Oracleのマニュアルを参照してください。

次のフォルダ以外にtnsnames.oraファイルを格納したときは，PFM - RM for OracleがOracle接続エラーとなります。

oracle_homeで指定したフォルダ\network\admin

PFM - RM for OracleではOracleの各セグメント関連の情報を取得するため，Oracleの静的ディクショナリ・ビュー DBA_SEGMENTSを検索します。Oracleに大量のセグメント（数十万件以上のセグメント）が存在する場合，情報収集で非常に時間が掛かるときがあります。そのため，大量のセグメントが存在し，次の表に示す情報の収集が不要な場合，sql_optionを「Y」と設定して運用してください。

各レコードのフィールドの形式が，「float」または「double」型の場合，データは浮動小数点数となるため，指定値によってまるめられる場合があります。

（例）

numeric_10の指定を32767と指定した場合，32760と表示される場合があります。

localtemp_optionに「Y」を指定した場合，ローカル管理一時表領域の空き容量やエクステントに関しての情報を動的パフォーマンスビューのv$sort_segment，またはv$temp_extent_poolを使用して取得します。取得する情報の空き容量は，収集時に使用していた領域のサイズから未使用サイズを算出します。

localtemp_optionに「N」を指定した場合，ローカル管理一時表領域の空き容量やエクステントに関しての情報を動的パフォーマンスビューのv$temp_space_headerを使用して取得します。取得する情報の空き容量は，未割り当てのサイズとなります。一度割り当てられたサイズは，一時表領域の再構築や再作成などをするまで解放されないため，解放されるまで空き容量は増加しません。

v$temp_extent_poolビューを検索した場合，Oracleのインスタンスが休止状態となります。Oracle Databaseの性能に影響することがありますので，十分に検討してから設定してください。詳細については，Oracleのマニュアルを参照してください。

v$temp_extent_poolビューを使用するレコードは次の通りです。

• Data File(PD_PDDF)

• Data File Interval(PI_PIDF)

PFM - RM for Oracleが扱うデータとOSの言語環境，インスタンス情報nls_langとの関係図を以下に示します。

PFM - RM for Oracleでは7ビットアスキーに加え，日本語Windows環境ではSJIS形式，簡体字中国語Windows環境ではGB18030形式のパフォーマンスデータを収集できます。

OSの言語環境および監視対象Oracleのデータベースキャラクタセットによって，nls_langインスタンス情報に設定できる値の組み合わせは次のとおりです。

注※

7ビットアスキーの範囲外のパフォーマンスデータは文字化けが発生します。

上記以外の組み合わせの場合，パフォーマンスデータの文字化けが発生することがあります。

nls_langインスタンス情報に不正な文字コードセットを指定した場合，errcodeが12705のメッセージ「KAVL18302-W」を出力し，Oracleとの接続に失敗します。

また，次の場合にパフォーマンスデータの文字化けが発生します。

1. Oracleのカラム長を超えることによる文字化け

   Oracleにカラム長を超えるデータを格納する場合，最終文字で文字化けが発生することがあります。Oracleで文字化けが発生するデータをPFM - RM for Oracleで収集すると，パフォーマンスデータの最終文字で文字化けが発生します。

2. PFM - RM for Oracleのフィールドサイズを超えることによる文字化け

   PFM - RM for OracleではOracleからレコードのフィールドサイズ分のパフォーマンスデータを取得します。そのためOracleがフィールドサイズを超えるデータを保持している場合，パフォーマンスデータの最終文字で文字化けが発生することがあります。対象となるフィールドは次のとおりです。

   レコード名	フィールド名	フィールドサイズ （単位：byte）
   Parameter Values（PD_PDP）	Value	512
   SQL Text（PD_PDSQ）	Explain Plan	30000
   	SQL Text	30000

undospace_optionに「N」を指定した場合，UNDO表領域の空き容量は，未割り当てのサイズを収集します。UNDO表領域のうち，リテンション期間が過ぎて使用可能になった領域は解放されるまでの間，割り当て済みの領域として扱います。

undospace_optionに「Y」を指定した場合， UNDO表領域の空き容量は，未使用サイズを収集します。UNDO表領域のうち，リテンション期間が過ぎて使用可能になった領域は未使用サイズに含みます。

undospace_optionにより値が変わるフィールドは次のとおりです。

10-50以前のバージョンではOracle Client 32-bitを前提製品としていましたが，11-00以降のバージョンではOracle Client 64-bitを前提製品としています。

バージョン10-50以前の設定方法では，Oracle Databaseに接続できないため，バージョン11-00以降では，Oracle Client 64-bitを前提として，設定する必要があります。

バージョン11-00以降，インスタンス情報の設定は次の表のように異なるため，設定内容を確認してください。

注意

• PFM - RM for Oracle 10-50以前から11-00以降にバージョンアップする場合，インスタンス情報の設定内容が変更になるため，PFM - RM for Oracleのサービスを起動する前にインスタンス情報を更新してください。

  また，Oracle Client 32-bitは不要になります。Oracle Client 32-bitをPFM - RM for Oracle以外で使用しない場合，アンインストールしても問題ありません。

• Oracle Client 32-bitのORACLE_HOMEを指定して，PFM - RM for Oracleを起動すると，KAVL18011-EおよびKAVL18021-Eのメッセージが表示されます。

PFM - RM for OracleがOracle Databaseのクライアントライブラリを使用する（Oracle DatabaseにOracle Client 64bit がインストールされている）場合は，Oracle DatabaseのOracleホームを指定してください。

ユーザーを変更する場合は，次の手順で行ってください。

1. 変更前のユーザーが作成していたオブジェクトを削除する。

2. 変更後のユーザーで，新しくオブジェクトを登録する。

なお，ユーザーを変更しても，パフォーマンスデータは削除されません。

オブジェクトの削除方法については「2.4.2(1)(c)　Oracle Databaseへ登録したオブジェクトを削除する」を，オブジェクトの登録方法については「2.2.4(4)(c)　Oracle Databaseへオブジェクトを登録する」を参照してください。

oracle_passwdにパスワードの有効期限が設定されている場合，有効期限に達するとOracleとの接続エラーが起こり，パフォーマンス情報を収集できません。Oracleとの接続エラーを起こさないようにするために，パスワードの有効期限が切れる前に，次のどちらかを設定してください。

• パスワードの有効期限を解除します。

• パスワードの更新後，jpcconf inst setupコマンドを実行し，oracle_passwdを更新します。

なお，mk_rmus.sqlで作成したOracleのアカウントには，Oracleが提供しているDEFAULTのプロファイルが適用されます。

PFM - RM for Oracleが使用するOracleクライアントのネットワークサービス（tnsnames.oraなど）を設定している必要があります。

また監視対象となるOracleのネットワークサービス定義（listener.oraなど）を設定し，リスナーを起動しておく必要があります。

Oracle RAC構成のOracle Databaseインスタンスを監視するときは，各ノードのOracle Databaseインスタンスを監視するよう設定してください。設定方法については，Oracleのマニュアルを参照してください。

また，tnsnames.oraファイルは次に示すディレクトリに格納してください。

oracle_homeで指定したディレクトリ/network/admin

これ以外のディレクトリに格納する場合，PFM - RM for Oracleの起動ユーザに，OracleのTNS_ADMIN環境変数を設定してから起動してください。TNS_ADMIN環境変数の詳細はOracleのマニュアルを参照してください。

変更前のパス情報は保存されません。手動でファイルなどに履歴として記録しておいてください。トラブルなどによって，変更前のディレクトリからのエージェントログの採取が必要となる場合があります。

PFM - RM for OracleではOracleの各セグメント関連の情報を取得するため，Oracleの静的ディクショナリ・ビュー DBA_SEGMENTSを検索します。Oracleに大量のセグメント（数十万件以上のセグメント）が存在する場合，情報収集で非常に時間が掛かるときがあります。そのため，大量のセグメントが存在し，次の表に示す情報の収集が不要な場合，sql_optionを「Y」と設定して運用してください。

各レコードのフィールドの形式が，「float」または「double」型の場合，データは浮動小数点数となるため，指定値によってまるめられる場合があります。

（例）

numeric_10の指定を32767と指定した場合，32760と表示される場合があります。

localtemp_optionに「Y」を指定した場合，ローカル管理一時表領域の空き容量やエクステントに関しての情報を動的パフォーマンスビューのv$sort_segment，またはv$temp_extent_poolを使用して取得します。取得する情報の空き容量は，収集時に使用していた領域のサイズから未使用サイズを算出します。

localtemp_optionに「N」を指定した場合，ローカル管理一時表領域の空き容量やエクステントに関しての情報を動的パフォーマンスビューのv$temp_space_headerを使用して取得します。取得する情報の空き容量は，未割り当てのサイズとなります。一度割り当てられたサイズは，一時表領域の再構築や再作成などをするまで解放されないため，解放されるまで空き容量は増加しません。

v$temp_extent_poolビューを検索した場合，Oracleのインスタンスが休止状態となります。Oracle Databaseの性能に影響することがありますので，十分に検討してから設定してください。詳細については，Oracleのマニュアルを参照してください。

v$temp_extent_poolビューを使用するレコードは次の通りです。

• Data File(PD_PDDF)

• Data File Interval(PI_PIDF)

PFM - RM for Oracleが扱うデータとPFM - RM for Oracle起動時のLANG環境変数，インスタンス情報nls_langとの関係図を以下に示します。

PFM - RM for Oracleでは7ビットアスキーに加え，日本語環境ではUTF-8，中国語環境ではUTF-8，GB18030形式のパフォーマンスデータを収集できます。

PFM - RM for Oracle起動時のOSのLANG環境変数により，インスタンス情報nls_langに設定できる値は次のとおりです。

注※

7ビットアスキーの範囲外のパフォーマンスデータは文字化けが発生します。

上記以外の組み合わせの場合，パフォーマンスデータの文字化けが発生することがあります。

なお，OSのLANG設定は「2.2.4(1)　LANG環境変数の設定」を参照ください。

nls_langインスタンス情報に不正な文字コードセットを指定した場合，errcodeが12705のメッセージ「KAVL18302-W」を出力し，Oracleとの接続に失敗します。

また，次の場合にパフォーマンスデータの文字化けや文字欠けが発生します。

1. Oracleのカラム長を超えることによる文字化け

   Oracleにカラム長を超えるデータを格納する場合，最終文字で文字化けが発生することがあります。Oracleで文字化けが発生するデータをPFM - RM for Oracleで収集すると，パフォーマンスデータの最終文字で文字化けが発生します。

2. PFM - RM for Oracleのフィールドサイズを超えることによる文字化け

   PFM - RM for OracleではOracleからレコードのフィールドサイズ分のパフォーマンスデータを取得します。そのためOracleがフィールドサイズを超えるデータを保持している場合，パフォーマンスデータの最終文字で文字化けが発生することがあります。対象となるフィールドは次のとおりです。

   レコード名	フィールド名	フィールドサイズ （単位：byte）
   Parameter Values（PD_PDP）	Value	512
   SQL Text（PD_PDSQ）	Explain Plan	30000
   	SQL Text	30000

3. データベースキャラクタセットとnls_langの違いによる文字化けや文字欠け

   nls_langにAMERICAN_AMERICA.AL32UTF8を設定し，監視対象のデータベースキャラクタセットがUTF-8でない場合，Oracleデータベースで2バイト表現されていたデータが3バイトで取り出されることがあります。そのため収集するパフォーマンスデータがPFM - RM for Oracleのフィールドサイズを超える場合，超過部分の文字が欠けることがあります。また，最終文字で文字化けが発生することがあります。対象となるフィールドは次のとおりです。

   レコード名	フィールド名	フィールドサイズ （単位：byte）
   Collection Tablespace 2（PD_PCTS）	Tablespace Name	30
   Collection Instance 2（PD_PCI）	Recovery File Dest	513
   Data File（PD_PDDF）	File Name	513
   	Tablespace Name	30
   Data File Interval（PI_PIDF）	File Name	513
   	Tablespace Name	30
   Database（PD_PDDB）	DB Name	9
   Database Interval（PI_PIDB）	DB Name	9
   Instance（PD_PDI）	Host	64
   Lock Waiters（PD_PDLW）	Holding User	30
   	Waiting User	30
   Minimum Database Interval 2（PI_PMDB）	DB Name	9
   Minimum Data File Interval 2（PI_PMDF）	File Name	513
   Minimum Tablespace Interval 2（PI_PMTS）	Tablespace Name	30
   Open Cursor（PD_PDOC）	Program	48
   	SQL Text	60
   Parameter Values（PD_PDP）	Value	512
   Session Detail（PD_PDS）	Machine	64
   	Module	48
   	OS User	30
   	Program	64
   	Schema Name	30
   	User	30
   Session I/O Interval（PI_PIIO）	User	30
   Session Statistics Summary（PD_PDS2）	Program	48
   	User	30
   SQL Text（PD_PDSQ）	Explain Plan	30000
   	SQL Text	30000
   Tablespace Fragmentation（PD_PDTF）	Tablespace Name	30
   Tablespace Interval（PI_PITS）	Tablespace Name	30
   Tablespace（PD_PDTS）	Tablespace Name	30
   Transaction（PD_PDTR）	User	30
   Transaction Lock（PD_PDTL）	Object Name	30
   	Owner	30
   	User	30

undospace_optionに「N」を指定した場合，UNDO表領域の空き容量は，未割り当てのサイズを収集します。UNDO表領域のうち，リテンション期間が過ぎて使用可能になった領域は解放されるまでの間，割り当て済みの領域として扱います。

undospace_optionに「Y」を指定した場合， UNDO表領域の空き容量は，未使用サイズを収集します。UNDO表領域のうち，リテンション期間が過ぎて使用可能になった領域は未使用サイズに含みます。

undospace_optionにより値が変わるフィールドは次のとおりです。