2.6.3 インスタンス環境の更新の設定
インスタンス環境を更新したい場合は,インスタンス名を確認し,インスタンス情報を更新します。インスタンス情報の設定は,PFM - RMホストで実施します。
更新する情報はあらかじめ確認してください。Oracleのインスタンス情報の詳細については,Oracleのマニュアルを参照してください。
インスタンス情報を更新する手順を次に示します。
- <この項の構成>
- (1) Windowsの場合
- (2) UNIXの場合
(1) Windowsの場合
Windowsの場合のインスタンス情報を次の表に示します。
表2-29 PFM - RM for Oracleのインスタンス情報(Windowsの場合)
項目 | 説明 | 設定できる値 | デフォルト値 |
---|
oracle_sid | この値は更新できる。 監視対象となるOracleシステム識別子(環境変数ORACLE_SIDと同じ値)。 | 255バイト以内の半角文字列。 ただし,次の文字は指定できない。
| 前回の設定値 |
oracle_home※1. | この値は更新できる。 PFM - RM for Oracleが使用するOracleクライアントのOracleホームのフォルダ(環境変数ORACLE_HOMEと同じ値)。※2 | 255バイト以内の半角文字列。 ただし,次の文字は指定できない。
| 前回の設定値 |
oracle_version | この値は更新できる。 PFM - RM for Oracleが使用するOracleクライアントのバージョン番号。 | - Oracle 10gの場合:10
- Oracle 11gの場合:11
| 前回の設定値 |
oracle_user※3 | この値は更新できる。 Oracleを監視するアカウント(指定できるアカウント,および必要な権限については,「2.1.4(2) PFM - RM for Oracleで使用するOracleのアカウントの作成」を参照のこと)。 | 255バイト以内の半角文字列。 ただし,次の文字は指定できない。
| 前回の設定値 |
oracle_passwd※3,※4 | この値は更新できる。 oracle_userで指定したアカウントのパスワードを指定する。 | 255バイト以内の半角文字列。 ただし,次の文字は指定できない。
| 前回の設定値 |
net_service_name※1,※5 | この値は更新できる。 監視対象のデータベースのネットサービス名。監視対象のデータベースのネットサービス名については,Oracleのマニュアルを参照のこと。 | 255バイト以内の半角文字列。ただし,次の文字は指定できない。
| 前回の設定値 |
retry_time | この値は更新できる。 Oracle接続時に認証エラーが出力された場合に,再接続を試みる秒数。 | 0~600(単位:秒)。 | 前回の設定値 |
log_path | この値は更新できる。 エージェントログの出力先フォルダ名を絶対パスで指定する。 | 245バイト以内の半角文字列。 ただし,次の文字は指定できない。
- タブ
- 次の記号
「/」「:」「,」「;」「*」「?」「"」「<」「>」「|」
- 注意
- デフォルト以外のフォルダを設定する場合,インストール先フォルダ配下となるパスは指定できない。
- ほかのインスタンス出力先として指定している値は指定できない。
| 前回の設定値 |
log_size | この値は更新できる。 エージェントログの1ファイルの最大サイズを指定する。 | 1~32(単位:キロバイト)。 ただし,推奨は16以上。 | 前回の設定値 |
timeout | この値は更新できる。 クエリー時のOracleアクセスのタイムアウト時間を指定する。 | 0,10~3,600(単位:秒)。 0を指定した場合はタイムアウト監視を行わない。1~9を指定した場合は,実行時,10に変更する。 | 前回の設定値 |
sql_option※6 | この値は更新できる。 「Y」を指定した場合,PI_PIDB,PD_PDTSレコードで,次の項目※6の情報収集を行わず,0またはnumeric_10で指定した値を設定する。 | {Y|N} | 前回の設定値 |
numeric_10 | この値は更新できる。 sql_optionが「Y」の場合,情報収集しない項目に設定する値を指定する。sql_optionが「N」の場合,設定を無視する。 | 0~99999。 ただし,設定するフィールドのデータ型の最大値(shortの場合32767,ushortの場合65535)を超える値を指定した場合,データ型の最大値が設定される。※7 | 前回の設定値 |
startup_always | この値は更新できる。 PFM - RM for Oracle起動時に監視対象のOracleが起動処理中であった場合などに,PFM - RM for OracleがOracle接続エラーで停止することがある。 「Y」を指定した場合,接続エラーが発生しても起動処理を継続する。「N」を指定した場合,この動作を有効にしない。 | {Y|N} | 前回の設定値 |
localtemp_option※8 | この値は更新できる。PD_PDDB,PI_PIDB,PD_PDDF,PI_PIDF,PD_PDTF,PD_PDTS,PD_PCTSレコードのローカル管理一時表領域の空き容量の情報の表示を切り替えるオプション。 「Y」を指定した場合,使用されていないサイズを表示する。「N」を指定した場合,未割り当てのサイズを表示する。 | {Y|N} | 前回の設定値 |
- 注※1
- 監視対象プログラムを監視する場合,Oracle Client 32-bitのインストールと環境設定が必要です。また,jpcconf inst setupコマンドを実行する際,各項目について次のように設定してください。
- 「oracle_home」
Oracle Client 32-bitのOracleホームを設定してください。
- 「net_service_name」
Oracle Client 32-bitで設定したネットサービス名を指定してください。
- Oracle Client 32-bitで設定するネットサービス名には,監視するOracleインスタンスに接続するネットサービス名を指定してください。
- Oracle Client 32-bitのインストールと環境構築が完了していない状態で,インスタンス情報の「oracle_home」に,Oracle Client 32-bitがインストールされていないOracle DatabaseまたはOracle Client 64-bitのORACLE_HOMEを指定して,PFM - Agent for Oracleを起動すると,KAVL18020-Eのメッセージが表示されます。
- 注※2
- PFM - RM for OracleがOracle Databaseのクライアントライブラリを使用する(Oracle DatabaseにOracle Client 32bit がインストールされている)場合は,Oracle DatabaseのOracleホームを指定してください。
- 注※3
- ユーザーを変更する場合は,次の手順で行ってください。
- 変更前のユーザーが作成していたオブジェクトを削除する。
- 変更後のユーザーで,新しくオブジェクトを登録する。
- なお,ユーザーを変更しても,パフォーマンスデータは削除されません。
- オブジェクトの削除方法については「2.3.2(1)(c) Oracle Databaseへ登録したオブジェクトを削除する」を,オブジェクトの登録方法については「2.1.4(3)(c) Oracle Databaseへオブジェクトを登録する」を参照してください。
- 注※4
- oracle_passwdにパスワードの有効期限が設定されている場合,有効期限に達するとOracleとの接続エラーが起こり,パフォーマンス情報を収集できません。Oracleとの接続エラーを起こさないようにするために,パスワードの有効期限が切れる前に,次のどちらかを設定してください。
- パスワードの有効期限を解除します。
- パスワードの更新後,jpcconf inst setupコマンドを実行し,oracle_passwdを更新します。
- なお,mk_rmus.sqlで作成したOracleのアカウントには,Oracleが提供しているDEFAULTのプロファイルが適用されます。
- 注※5
- 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
- 注※6
- PFM - RM for OracleではOracleの各セグメント関連の情報を取得するため,Oracleの静的ディクショナリー・ビュー DBA_SEGMENTSの検索をします。Oracleに大量のセグメント(数十万件以上のセグメント)が存在する場合,情報収集で非常に時間が掛かるときがあります。そのため,大量のセグメントが存在し,次の表に示す情報の収集が不要な場合,sql_optionを「Y」と設定して運用してください。
表2-30 レコード名とnumeric_10で指定した値(インスタンス情報の更新の設定)
レコード名 | PFM - View名 | numeric_10で指定した値 |
---|
PD_PDTS | Segments | 有効 |
Extents | 有効 |
PI_PIDB | DB Files % | 有効 |
Log Files % | 有効 |
NextAlloc Fails | 有効 |
Tablespaces | 有効 |
Rollback Segments | 有効 |
Rollback Segments Trans | 有効 |
Blocks | 有効 |
Segments | 有効 |
Extents | 有効 |
Free Mbytes | 有効 |
Overextended | 有効 |
High Max Extent | 有効 |
Datafiles | 有効 |
Mbytes | 有効 |
Free Extents | 有効 |
Free% | 有効 |
Free Change | 有効 |
Write% | 有効 |
Write/sec | 有効 |
Redo Files | 有効 |
Links | 有効 |
Links Logged On | 有効 |
Links In Tran | 有効 |
Links Open Cursors | 有効 |
Used Change | 有効 |
Used Mbytes | 有効 |
Rollback Segments Hit% | 有効 |
Sort Segments | 有効 |
Sorting Users | 有効 |
Physical Blocks Read | デルタ項目のため,常に0設定。 |
Physical Blocks Written | デルタ項目のため,常に0設定。 |
Physical Reads | デルタ項目のため,常に0設定。 |
Physical Writes | デルタ項目のため,常に0設定。 |
- 注※7
- 各レコードのフィールドの形式が,「float」または「double」型の場合,データは浮動小数点数となるため,指定値によってまるめられる場合があります。
- (例)
- numeric_10の指定を32767と指定した場合,32760と表示される場合があります。
- 注※8
- localtemp_optionに「Y」を指定した場合,ローカル管理一時表領域の空き容量やエクステントに関しての情報を動的パフォーマンスビューのv$temp_extent_poolを使用して取得します。取得する情報の空き容量は,収集時に使用していた領域のサイズから未使用サイズを算出します。
- localtemp_optionに「N」を指定した場合,ローカル管理一時表領域の空き容量やエクステントに関しての情報を動的パフォーマンスビューのv$temp_space_headerを使用して取得します。取得する情報の空き容量は,未割り当てのサイズとなります。一度割り当てられたサイズは,一時表領域の再構築や再作成などをするまで解放されないため,解放されるまで空き容量は増加しません。
- v$temp_extent_poolビューを検索した場合,Oracleのインスタンスが休止状態となります。Oracle Databaseの性能に影響することがありますので,十分に検討してから設定してください。詳細については,Oracleのマニュアルを参照してください。
インスタンス名を確認するには,jpcconf inst listコマンドを使用します。また,インスタンス環境を更新するには,jpcconf inst setupコマンドを使用します。
インスタンス環境を更新する手順を次に示します。複数のインスタンス環境を更新する場合は,次の手順を繰り返し実施します。
- インスタンス名を確認する。
PFM - RM for Oracleを示すサービスキーを指定して,jpcconf inst listコマンドを実行します。
jpcconf inst list -key RMOracle
設定されているインスタンス名がSDCの場合,SDCと表示されます。
- 更新したいインスタンス環境のPFM - RM for Oracleのサービスが起動されている場合は,停止する。
サービスの停止方法については,マニュアル「JP1/Performance Management 運用ガイド」の,Performance Managementの起動と停止について説明している章を参照してください。
jpcconf inst setupコマンド実行時に,更新したいインスタンス環境のサービスが起動されている場合は,確認メッセージが表示され,サービスを停止できます。サービスを停止した場合は,更新処理が続行されます。サービスを停止しなかった場合は,更新処理が中断されます。
- PFM - RM for Oracleを示すサービスキーおよびインスタンス名を指定して,jpcconf inst setupコマンドを実行する。
インスタンス名がSDCのインスタンス環境を更新する場合,次のように指定してコマンドを実行します。
jpcconf inst setup -key RMOracle -inst SDC
- Oracleのインスタンス情報を更新する。
表2-29に示した項目を,コマンドの指示に従って入力します。現在設定されている値が表示されます(ただし,oracle_passwdの値は表示されません)。表示された値を変更しない場合は,リターンキーだけを押してください。すべての入力が終了すると,インスタンス環境が更新されます。
- 更新したインスタンス環境のサービスを再起動する。
サービスの起動方法については,マニュアル「JP1/Performance Management 運用ガイド」の,Performance Managementの起動と停止について説明している章を参照してください。
コマンドについては,マニュアル「JP1/Performance Management リファレンス」の,コマンドについて説明している章を参照してください。
(2) UNIXの場合
UNIXの場合のインスタンス情報を次の表に示します。
表2-31 PFM - RM for Oracleのインスタンス情報(UNIXの場合)
項目 | 説明 | 設定できる値 | デフォルト値 |
---|
oracle_sid | この値は更新できる。 監視対象となるOracleシステム識別子(環境変数ORACLE_SIDと同じ値)。 | 255バイト以内の半角文字列。 ただし,次の文字は指定できない。
| 前回の設定値 |
oracle_home※1 | この値は更新できる。 PFM - RM for Oracleが使用するOracleクライアントのOracleホームのディレクトリ(環境変数ORACLE_HOMEと同じ値)。※2 | 255バイト以内の半角文字列。 ただし,次の文字は指定できない。
| 前回の設定値 |
oracle_version | この値は更新できる。 PFM - RM for Oracleが使用するOracleクライアントのバージョン番号。 | - Oracle 10gの場合:10
- Oracle 11gの場合:11
| 前回の設定値 |
oracle_user※3 | この値は更新できる。 Oracleを監視するアカウント(指定できるアカウント,および必要な権限については,「2.2.4(3) PFM - RM for Oracleで使用するOracleのアカウントの作成」を参照のこと)。 | 255バイト以内の半角文字列。 ただし,次の文字は指定できない。
| 前回の設定値 |
oracle_passwd※3,※4 | この値は更新できる。 oracle_userで指定したアカウントのパスワードを指定する。 | 255バイト以内の半角文字列。 ただし,次の文字は指定できない。
| 前回の設定値 |
net_service_name※1,※5 | この値は更新できる。 監視対象のデータベースのネットサービス名。監視対象のデータベースのネットサービス名については,Oracleのマニュアルを参照のこと。 | 255バイト以内の半角文字列。ただし,次の文字は指定できない。
| 前回の設定値 |
log_path※6 | この値は更新できる。 エージェントログの出力先ディレクトリ名を絶対パスで指定する。 | 245バイト以内の半角文字列。 ただし,次の文字は指定できない。
- タブ
- 次の記号
「/」「:」「,」「;」「*」「?」「"」「<」「>」「|」
- 注意
- デフォルト以外のフォルダを設定する場合,インストール先フォルダ配下となるパスは指定できない。
- ほかのインスタンス出力先として指定している値は指定できない。
| 前回の設定値 |
log_size | この値は更新できる。 エージェントログの1ファイルの最大サイズを指定する。 | 1~32(単位:キロバイト)。 ただし,推奨は16以上。 | 前回の設定値 |
timeout | この値は更新できる。 クエリー時のOracleアクセスのタイムアウト時間を指定する。 | 0,10~3,600(単位:秒)。 0を指定した場合はタイムアウト監視を行わない。1~9を指定した場合は,実行時,10に変更する。 | 前回の設定値 |
sql_option※7 | この値は更新できる。 「Y」を指定した場合,PI_PIDB,PD_PDTSレコードで,次の項目※7の情報収集を行わず,0またはnumeric_10で指定した値を設定する。 | {Y|N} | 前回の設定値 |
numeric_10 | この値は更新できる。 sql_optionが「Y」の場合,情報収集しない項目に設定する値を指定する。sql_optionが「N」の場合,設定を無視する。 | 0~99999。 ただし,設定するフィールドのデータ型の最大値(shortの場合32767,ushortの場合65535)を超える値を指定した場合,データ型の最大値が設定される。※8 | 前回の設定値 |
startup_always | この値は更新できる。 PFM - RM for Oracle起動時に監視対象のOracleが起動処理中であった場合などに,PFM - RM for OracleがOracle接続エラーで停止することがある。 「Y」を指定した場合,接続エラーが発生しても起動処理を継続する。「N」を指定した場合,この動作を有効にしない。 | {Y|N} | 前回の設定値 |
localtemp_option※9 | この値は更新できる。PD_PDDB,PI_PIDB,PD_PDDF,PI_PIDF,PD_PDTF,PD_PDTS,PD_PCTSレコードのローカル管理一時表領域の空き容量の情報の表示を切り替えるオプション。 「Y」を指定した場合,使用されていないサイズを表示する。「N」を指定した場合,未割り当てのサイズを表示する。 | {Y|N} | 前回の設定値 |
- 注※1
- 監視対象プログラムを監視する場合,Oracle Client 32-bitのインストールと環境設定が必要です。また,jpcconf inst setupコマンドを実行する際,各項目について次のように設定してください。
- 「oracle_home」
Oracle Client 32-bitのOracleホームを設定してください。
- 「net_service_name」
Oracle Client 32-bitで設定したネットサービス名を指定してください。
- Oracle Client 32-bitで設定するネットサービス名には,監視するOracleインスタンスに接続するネットサービス名を指定してください。
- Oracle Client 32-bitのインストールと環境構築が完了していない状態で,インスタンス情報の「oracle_home」に,Oracle Client 32-bitがインストールされていないOracle DatabaseまたはOracle Client 64-bitのORACLE_HOMEを指定して,PFM - Agent for Oracleを起動すると,KAVL18011-EおよびKAVL18021-Eのメッセージが表示されます。
- 注※2
- PFM - RM for OracleがOracle Databaseのクライアントライブラリを使用する(Oracle DatabaseにOracle Client 32bit がインストールされている)場合は,Oracle DatabaseのOracleホームを指定してください。
- 注※3
- ユーザーを変更する場合は,次の手順で行ってください。
- 変更前のユーザーが作成していたオブジェクトを削除する。
- 変更後のユーザーで,新しくオブジェクトを登録する。
- なお,ユーザーを変更しても,パフォーマンスデータは削除されません。
- オブジェクトの削除方法については「2.4.2(1)(c) Oracle Databaseへ登録したオブジェクトを削除する」を,オブジェクトの登録方法については「2.2.4(4)(c) Oracle Databaseへオブジェクトを登録する」を参照してください。
- 注※4
- oracle_passwdにパスワードの有効期限が設定されている場合,有効期限に達するとOracleとの接続エラーが起こり,パフォーマンス情報を収集できません。Oracleとの接続エラーを起こさないようにするために,パスワードの有効期限が切れる前に,次のどちらかを設定してください。
- パスワードの有効期限を解除します。
- パスワードの更新後,jpcconf inst setupコマンドを実行し,oracle_passwdを更新します。
- なお,mk_rmus.sqlで作成したOracleのアカウントには,Oracleが提供しているDEFAULTのプロファイルが適用されます。
- 注※5
- 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
- 注※6
- 変更前のパス情報は保存されません。手動でファイルなどに履歴として記録しておいてください。トラブルなどによって,変更前のディレクトリからのエージェントログの採取が必要となる場合があります。
- 注※7
- PFM - RM for OracleではOracleの各セグメント関連の情報を取得するため,Oracleの静的ディクショナリー・ビュー DBA_SEGMENTSの検索をします。Oracleに大量のセグメント(数十万件以上のセグメント)が存在する場合,情報収集で非常に時間が掛かるときがあります。そのため,大量のセグメントが存在し,次の表に示す情報の収集が不要な場合,sql_optionを「Y」と設定して運用してください。
表2-32 レコード名とnumeric_10で指定した値(インスタンス情報の更新の設定)
レコード名 | PFM - View名 | numeric_10で指定した値 |
---|
PD_PDTS | Segments | 有効 |
Extents | 有効 |
PI_PIDB | DB Files % | 有効 |
Log Files % | 有効 |
NextAlloc Fails | 有効 |
Tablespaces | 有効 |
Rollback Segments | 有効 |
Rollback Segments Trans | 有効 |
Blocks | 有効 |
Segments | 有効 |
Extents | 有効 |
Free Mbytes | 有効 |
Overextended | 有効 |
High Max Extent | 有効 |
Datafiles | 有効 |
Mbytes | 有効 |
Free Extents | 有効 |
Free% | 有効 |
Free Change | 有効 |
Write% | 有効 |
Write/sec | 有効 |
Redo Files | 有効 |
Links | 有効 |
Links Logged On | 有効 |
Links In Tran | 有効 |
Links Open Cursors | 有効 |
Used Change | 有効 |
Used Mbytes | 有効 |
Rollback Segments Hit% | 有効 |
Sort Segments | 有効 |
Sorting Users | 有効 |
Physical Blocks Read | デルタ項目のため,常に0設定。 |
Physical Blocks Written | デルタ項目のため,常に0設定。 |
Physical Reads | デルタ項目のため,常に0設定。 |
Physical Writes | デルタ項目のため,常に0設定。 |
- 注※8
- 各レコードのフィールドの形式が,「float」または「double」型の場合,データは浮動小数点数となるため,指定値によってまるめられる場合があります。
- (例)
- numeric_10の指定を32767と指定した場合,32760と表示される場合があります。
- 注※9
- localtemp_optionに「Y」を指定した場合,ローカル管理一時表領域の空き容量やエクステントに関しての情報を動的パフォーマンスビューのv$temp_extent_poolを使用して取得します。取得する情報の空き容量は,収集時に使用していた領域のサイズから未使用サイズを算出します。
- localtemp_optionに「N」を指定した場合,ローカル管理一時表領域の空き容量やエクステントに関しての情報を動的パフォーマンスビューのv$temp_space_headerを使用して取得します。取得する情報の空き容量は,未割り当てのサイズとなります。一度割り当てられたサイズは,一時表領域の再構築や再作成などをするまで解放されないため,解放されるまで空き容量は増加しません。
- v$temp_extent_poolビューを検索した場合,Oracleのインスタンスが休止状態となります。Oracle Databaseの性能に影響することがありますので,十分に検討してから設定してください。詳細については,Oracleのマニュアルを参照してください。
インスタンス名を確認するには,jpcconf inst listコマンドを使用します。また,インスタンス環境を更新するには,jpcconf inst setupコマンドを使用します。
インスタンス環境を更新する手順を次に示します。複数のインスタンス環境を更新する場合は,次の手順を繰り返し実施します。
- インスタンス名を確認する。
PFM - RM for Oracleを示すサービスキーを指定して,jpcconf inst listコマンドを実行します。
jpcconf inst list -key RMOracle
設定されているインスタンス名がSDCの場合,SDCと表示されます。
- 更新したいインスタンス環境のPFM - RM for Oracleのサービスが起動されている場合は,停止する。
サービスの停止方法については,マニュアル「JP1/Performance Management 運用ガイド」の,Performance Managementの起動と停止について説明している章を参照してください。
jpcconf inst setupコマンド実行時に,更新したいインスタンス環境のサービスが起動されている場合は,確認メッセージが表示され,サービスを停止できます。サービスを停止した場合は,更新処理が続行されます。サービスを停止しなかった場合は,更新処理が中断されます。
- PFM - RM for Oracleを示すサービスキーおよびインスタンス名を指定して,jpcconf inst setupコマンドを実行する。
インスタンス名がSDCのインスタンス環境を更新する場合,次のように指定してコマンドを実行します。
jpcconf inst setup -key RMOracle -inst SDC
- PFM - RM for Oracleのインスタンス情報を更新する。
表2-12に示した項目を,コマンドの指示に従って入力します。現在設定されている値が表示されます(ただし,oracle_passwdの値は表示されません)。表示された値を変更しない場合は,リターンキーだけを押してください。すべての入力が終了すると,インスタンス環境が更新されます。
- 更新したインスタンス環境のサービスを再起動する。
サービスの起動方法については,マニュアル「JP1/Performance Management 運用ガイド」の,Performance Managementの起動と停止について説明している章を参照してください。
コマンドについては,マニュアル「JP1/Performance Management リファレンス」の,コマンドについて説明している章を参照してください。