Enterprise Manager System Monitoring Plug-inインストレーション・ガイド for IBM DB2 Database

リリース12.1.0.2.0

B70764-01(原本部品番号:E25215-03)

Oracle® Enterprise Manager

System Monitoring Plug-inインストレーション・ガイド for IBM DB2 Database

リリース12.1.0.2.0

B70764-01(原本部品番号:E25215-03)

2012年9月

このドキュメントでは、まずOracle System Monitoring Plug-in for IBM DB2 Databaseについて説明し、次に、このプラグインでサポートされるバージョンの詳細、およびインストールの前提条件を示します。さらに、プラグインをダウンロード、インストール、検査および検証するための手順を説明します。

説明

System Monitoring Plug-in for IBM DB2 Databaseは、Oracle Enterprise Manager Cloud Controlを拡張して、IBM DB2 UDB (LUW)データベース・インスタンスを管理できるようにするためのプラグインです。Cloud Control環境にプラグインをデプロイすると、次の管理機能を取得できます。

- DB2 Databaseインスタンスの監視。

- DB2データベース・インスタンスの構成データの収集および構成の変更の追跡。

- 監視ターゲットおよび構成データに設定されたしきい値に基づくアラートおよび違反の表示。

- 収集データに基づいた豊富なレポートの提供。

- リモート・エージェントによる監視のサポート。ローカル・エージェントは、DB2データベースと同じホストで稼働するエージェントです。リモート・エージェントは、DB2データベースが稼働するホストとは異なるホストで稼働するエージェントです。

サポートされるプラットフォーム

プラグインでは、IBM DB2 UDBのインストールが可能なすべてのプラットフォームでIBM DB2 UDB (LUW)の監視をサポートします。

サポートされるバージョン

このプラグインでは、次のバージョンの製品がサポートされます。

- Enterprise Manager 12c Cloud Controlリリース1 (12.1.0.1.0)以上

- シングル・パーティションのIBM DB2 Universal Database (UDB) for Linux, UNIX, and Windows (LUW)バージョン8.2 FixPak 2以上(8.2.x、9.x.x)

前提条件

プラグインを使用する前に、次の前提条件を満たす必要があります。

- 次のソフトウェアをインストールします。

- Enterprise Manager 12c Cloud Controlリリース1 (12.1.0.1.0)以上(Oracle Management ServiceおよびOracle Management Agent)

- IBM DB2 Universal JDBC Type 4ドライバfor IBM DB2 Database (「JDBCドライバの設定」を参照)

- IBM DB2 Universal Database

- IBM DB2で使用されるテーブル・ファンクションにアクセスするための適切なオペレーティング・システム・ユーザーを作成します。ユーザーの作成の詳細は、「適切なオペレーティング・システム・ユーザーの使用と認可レベルおよび権限の割当て」を参照してください。

- データベースの監視メトリックのメトリック収集エラーを回避するために、表STMG_DBSIZE_INFOを作成します。詳細は、「データベースの監視メトリックのメトリック・コレクション・エラーを回避するために必要な構成」を参照してください。

- IBM DB2の診断ログ・ファイル(db2diag.log)を使用してアラートを生成する場合は、次のようにします。

- $ORACLE_HOME/sysman/admin/scripts/emx/ibm_db2_database/にあるDiag_log_file_match_pattern_file.txtファイルに一致パターンを定義します。

- $ORACLE_HOME/plugins/oracle.em.sidb/scripts/emx/ibm_db2_database/にあるDiag_log_file_no_match_pattern_file.txtファイルに無視パターンを定義します。

- 監視するIBM DB2データベースに対応するデータベース・マネージャ(インスタンス)のDIAG_PATH構成パラメータを設定します。

2つのファイルに定義したパターンに基づいて、IBM DB2のSystem Monitoring Plug-inは診断ログ・ファイルを解析し、条件を満たす場合にアラートを生成します。まず、プラグインは、パターンが定義されているかどうかを確認するため、2つのファイルを検証します。パターンが定義されていないと、プラグインは診断ログ・ファイルを解析しません。一致パターンが定義されていないが無視パターンは定義されている場合、プラグインは診断ログ・ファイルのすべてのエントリを解析して、無視パターンと合致するかどうかをチェックします。一致パターンも定義されている場合は、プラグインは、まず一致パターンに合致するエントリのみ解析し、次に合致したエントリに対して、無視パターンが合致するかどうかをチェックします。

また、収集内に同じファンクション名の複数のログ・エントリがある場合、ファンクション名を示すアラートが1つのみ生成されます。このアラートは、診断ログ・ファイルにある共通ファンクション名を含む最後のログ・エントリに基づきます。

注意:
この機能はローカル監視についてのみサポートされています。ローカル監視では、IBM DB2データベースと同じホストで稼働するOracle Management AgentによってDB2データベースが監視されます。

- IBM DB2 DatabaseのSQL文のパフォーマンス、IBM DB2 Databaseのアプリケーション・ロック・パフォーマンスのレポート、およびエージェント監視メトリックで、アプリケーション名とともにSQL文のテキストを表示するには、インスタンス構成パラメータDFT_MON_STMTを有効にします。そうしないと、列にデータが表示されません。

- JDBC URLの一部として、IPアドレスもホスト名も使用できます。ホスト名がネットワークで一貫して解決されることを確認します。nslookupやtracerouteなどの標準TCPツールを使用してホスト名を検証できます。プラグインをデプロイする管理エージェントで次のコマンドを使用して検証します。

- nslookup <hostname>
IPアドレスと完全修飾ホスト名が返されます。

- nslookup <IP>
IPアドレスと完全修飾ホスト名が返されます。

JDBCドライバの設定

JDBCドライバはIBMから入手可能です。JDBCドライバは次のファイルで構成されており、エージェントからこれらのファイルへのアクセスを可能にする必要があります。

- db2jcc.jar

- db2jcc_javax.jar

- db2jcc_license_cu.jar

IBM DB2 Universal Type 4 JDBCドライバにAGENT_BASE_DIRディレクトリを設定するには、次の操作を実行します。

1. 存在しない場合は、ディレクトリ$AGENT_BASE_DIR/plugins/dependencies/oracle.em.sidb/jdbcdriver/を作成します。

2. 3つのJDBCドライバ・ファイルをディレクトリ$AGENT_BASE_DIR/plugins/dependencies/oracle.em.sidb/jdbcdriver/にコピーします。

プラグインをデプロイする管理エージェントの構成

エージェントを構成するには、まず、エージェント・サービスを起動するユーザーがローカル管理者グループに属していることを確認します。また、プラグインをデプロイするすべてのエージェントで優先資格証明を設定する必要があります。これを行うには、次の項の手順に従います。

ユーザーへの高度な権限の割当て

高度な権限を割り当てるには、次のようにします。

1. エージェントをホストするローカルのMicrosoft Windowsノードで、エージェント・サービスを起動するユーザーがローカル管理者グループに属していることを確認します。そうでない場合は、追加します。

2. Windowsの「ローカル セキュリティの設定」ツールを開き、エージェント・サービスを起動するユーザーに次の高度な権限を付与します。

- オペレーティング システムの一部として機能

- プロセスのメモリ クォータの増加

- バッチ ジョブとしてログオン

- プロセス レベル トークンの置き換え

3. エージェント・サービスが稼働している場合は、再起動します。

4. Cloud Controlでホストとエージェントに対する優先資格証明を設定します。詳細は、「優先資格証明の設定と検証」を参照してください。

- 優先資格証明で設定するOSユーザーは、ローカル管理者グループに属している必要があります。

- このOSユーザーは、次の高度な権限を持っている必要があります。

- オペレーティング システムの一部として機能

- プロセスのメモリ クォータの増加

- バッチ ジョブとしてログオン

- プロセス レベル トークンの置き換え

優先資格証明の設定と検証

プラグインをデプロイするすべてのエージェントで優先資格証明を設定するには、次のようにします。

1. Enterprise Manager Cloud Controlで、「設定」メニューから「セキュリティ」、「優先資格証明」の順に選択します。
「優先資格証明」ページが開き、ターゲットの表が表示されます。

2. 表からホストのターゲット・タイプを選択し、管理対象優先資格証明をクリックします。
ホスト優先資格証明ページが表示されます。

3. ホスト優先資格証明ページの「ターゲットの資格証明」セクションで、プラグインをデプロイする管理エージェントが稼働しているホストを選択し、「設定」をクリックします。

4. 「名前付き資格証明の選択」ダイアログ・ボックスで、「新規」として資格証明を選択し、ユーザー名とパスワードを指定して「テストと保存」をクリックします。テストが正常に実行されたら、資格証明は適切に設定されています。

5. プラグインをデプロイする管理エージェントに対してOSコマンド・ジョブを実行します。

- Enterprise Manager Cloud Controlにログインします。

- 「エンタープライズ」メニューから「ジョブ」、「アクティビティ」の順に選択します。

- 「ジョブ・アクティビティ」ページで「ジョブの作成」リストから「OSコマンド」を選択し、「実行」をクリックします。

- 次のページで必要な詳細を入力し、「発行」をクリックしてジョブを実行します。ジョブが正常に実行されたら、資格証明は適切に設定されています。

適切なオペレーティング・システム・ユーザーの使用と認可レベルおよび権限の割当て

System Monitoring Plug-In for IBM DB2は、IBM DB2で使用されるテーブル・ファンクションにアクセスします。同プラグインがこれらのテーブル・ファンクションにアクセスするには、特定のユーザー・グループに割り当てられた、適切なオペレーティング・システム・ユーザーを使用する必要があります。このオペレーティング・システム・ユーザーには、少なくとも最小の権限を割り当てる必要があります。また、正しい認可レベルも割り当てる必要があります。

注意:
IBM DB2ユーザーはオペレーティング・システム・ユーザーである必要があります。IBM DB2では、セキュリティをホスト・オペレーティング・システムに依存しているため、固有のデータベース・ユーザーを使用できません。

オペレーティング・システム・ユーザーをまだ作成していない場合は、IBM DB2を実行しているホスト上にユーザーを1つ作成します。その後、次の手順に従って、そのユーザーを新規または既存のユーザー・グループに割り当てます。

1. IBM DB2コントロール・センターを開きます。

2. ツリー表示から、接続するデータベースまたはデータベース別名を選択します。

3. 管理ユーザーとして接続します。

4. ツリー表示から、「User and Group Objects」を選択します。

5. 右側のペインから、すでに作成されているオペレーティング・システム・ユーザーを選択します。

6. 「Authorities」パネルから、「Connect to Database」を選択します。

7. 適用された変更を確認するために、データベースへの接続を試行します。

注意:
これらの手順は、IBM DB2 SQLを使用してコマンドラインから実行することもできます。

さらに、オペレーティング・システム・ユーザー・グループに認可レベルと権限を割り当てます。IBM DB2でサポートされる認可レベルは、SYSADM、SYSCTRL、SYSMAINT、DBADMおよびLOADです。SYSADM、SSYSCTRLおよびSYSMAINT認可レベルは、GRANT SQL文を使用して付与することはできません。これらの特別な認可レベルは、データベース・マネージャの構成ファイルからのみ設定できます。DBADM権限は、SYSADM認可レベルのユーザーのみが付与できます。

SYSMON認可レベルは、IBM DB2を管理するために必要です。このレベルは、IBM DB2で使用されるテーブル・ファンクション(SYSPROC.SNAPSHOT_DATABASEなど)にアクセスするために必要となります。

次の手順に従って、使用するユーザー・グループにSYSMON認可レベルを設定します。

1. db2=>プロンプトで、次のコマンドを実行します。

db2=> update dbm cfg using sysmon_group USERGROUP
db2 => db2stop
db2 => db2start

2. 変更が反映されたかどうかを確認するために、次のコマンドを実行します。

db2 => get dbm cfg

このコマンドの出力は次のようになります。

Database Manager Configuration
Node type = Enterprise Server Edition with local and remote clients
.....
SYSADM group name     (SYSADM_GROUP)   =
SYSCTRL group name    (SYSCTRL_GROUP)  =
SYSMAINT group name   (SYSMAINT_GROUP) =
SYSMON group name     (SYSMON_GROUP)   = USERGROUP
......

注意:
認可レベルと権限がIBM DB2でどのように実装されるかについては、IBMのWebサイトを参照してください。

プラグインのデプロイ

プラグインをデプロイする手順は、『Oracle Enterprise Manager Cloud Control管理者ガイド』でプラグイン・マネージャに関する章を参照してください。

http://docs.oracle.com/cd/E24628_01/doc.121/e24473/plugin_mngr.htm

IBM DB2でのヘルス・インジケータ(Health Indicator)メトリックとデータベースの監視(Database Monitoring)メトリックの構成

この項では、IBM DB2で実行する必要のある、インストール後の構成手順について説明します。

ヘルス・インジケータ(Health Indicator)メトリックに必要な構成

インスタンスおよびデータベース・オブジェクトのヘルス・インジケータは、データベース・マネージャの構成パラメータHEALTH_MONを使用して有効または無効にできます。これにより、テーブル・ファンクションHEALTH_TBS_HI、HEALTH_DB_HIおよびHEALTH_DBM_HIに値が移入されます。これらのファンクションは、ヘルス・インジケータのしきい値に基づいてトリガーされたアラートを表示するために、プラグインによって使用されます。

注意:
これらの設定を有効にすると、一部のリソース(CPUやメモリーなど)にオーバーヘッドが生じることがあります。したがって、これらの手順はヘルス・インジケータ(Health Indicator)メトリックを表示する必要がある場合にのみ実行してください。

HEALTH_MONをCLP (Command Line Processor)によって有効または無効にするには、次のコマンドを実行します。

db2==> update dbm cfg using HEALTH_MON [on;off]

変更が反映されたかどうかを確認するために、次のコマンドを実行します。

db2==> get dbm cfg

出力は次のようになります。

.....
.....
.....
Monitor health of instance and databases (HEALTH_MON) = ON
.....
..........

詳細は、IBMのWebサイトを参照してください。

データベースの監視(Database Monitoring)メトリックのメトリック・コレクション・エラーを回避するために必要な構成

データベースの監視(Database Monitoring)メトリックのメトリック・コレクション・エラーを回避するには、GET_DBSIZE_INFOパッケージを呼び出して、STMG_DBSIZE_INFO表を作成し、必要なデータを移入する必要があります。

GET_DBSIZE_INFOプロシージャは、データベースのサイズと最大容量を計算します。算出された値は、プロシージャの出力パラメータとして返され、SYSTOOLS.STMG_DBSIZE_INFO表内にキャッシュされます。これらの値がキャッシュされるのは、計算のパフォーマンス・コストが高いためです。

SYSTOOLS.STMG_DBSIZE_INFO表は、このプロシージャの初回実行時に自動的に作成されます。SYSTOOLS.STMG_DBSIZE_INFO表にキャッシュされた値は、snapshot-timestampとrefresh-windowの各値に基づき、古い値でないことを確認されたうえで返されます。

キャッシュされた値が最新でない場合は、新たに算出された値がキャッシュされ、SYSTOOLS.STMG_DBSIZE_INFO表に挿入されて返された後、snapshot-timestamp値が更新されます。GET_DBSIZE_INFOで最後に取得されるパラメータはrefresh-windowです。

refresh-window (コール間の時間間隔)のデフォルト値は30分です。データベースの更新がより頻繁に行われる場合は、より短い時間に設定することもできます。

GET_DBSIZE_INFOの呼出しをCLP (Command Line Processor)によって行う場合は、次のコマンドを実行します。

db2==>CALL GET_DBSIZE_INFO(?, ?, ?, -1)

この例の場合、refresh-windowは30分になります。

詳細は、IBMのWebサイトで次のページを参照してください。

http://publib.boulder.ibm.com/infocenter/db2luw/v9r5/index.jsp?topic=/com.ibm.db2.luw.sql.rtn.doc/doc/r0011863.html

監視対象インスタンスの追加

プラグインが正常にデプロイできたら、次の手順に従って、プラグイン・ターゲットをCloud Controlに追加します。これにより、ターゲットが集中的な監視および管理の対象になります。

1. 「設定」メニューから、「ターゲットの追加」、「ターゲットの手動追加」の順に選択します。

2. 「ターゲットの手動追加」ページで、「ターゲット監視プロパティを指定して非ホスト・ターゲットを追加」を選択し、「ターゲット・タイプ」として「IBM DB2データベース」を選択して「監視エージェント」を選択、「手動追加」をクリックします。

3. プロパティに次の情報を入力します。

- ターゲット名: プラグインの名前。

- JDBC URL: IBM DB2 JDBCドライバの接続URLの名前。
例:

jdbc:db2://<server>:<port>/<database>

JDBC URLの引数はデータソースを表します。パラメータの定義は次のとおりです。

- jdbc:db2: DB2 UDBサーバーへの接続を表します。

- server: データベース・サーバーのドメイン名またはIPアドレス。

- port: データベース・サーバーに割り当てられたTCP/IPサーバー・ポート番号(0〜65535の整数)。

- database: DB2クライアントのDB2データベース・カタログ・エントリを参照する、データベースの別名。
databaseは、DB2 UDB (LUW)のインストール時に定義したデータベース名です。

- JDBCドライバ: DB2 Universal JDBCドライバの名前(オプション)。
例:

com.ibm.db2.jcc.DB2Driver

- データベース・ユーザー名: データベースの有効なユーザー名。
詳細は、「適切なオペレーティング・システム・ユーザーの使用と認可レベルおよび権限の割当て」を参照してください。

- データベース・パスワード: ユーザーのパスワード。

4. 「接続テスト」をクリックして、入力したパラメータが正しいことを確認します。

図1 IBM DB2データベースの追加

注意:
プラグインをデプロイし、環境内で監視する1つ以上のターゲットを構成したら、次はプラグインの監視設定をカスタマイズできます。具体的には、使用する環境の特別な要件に合せて、メトリックの収集間隔やしきい値の設定を変更できます。なお、1つ以上のメトリックについて収集を無効にした場合、それらのメトリックを使用したレポートに影響が及ぶ可能性があります。

プラグインの検査および検証

プラグインがデータの収集を開始するまで数分間待機したら、次の手順を実行して、プラグイン・ターゲットがEnterprise Managerで適切に監視されているかどうかを確認および検証します。

1. 「すべてのターゲット」ページで「IBM DB2データベース」ターゲット・リンクをクリックします。
IBM DB2 Databaseのホームページが表示されます。

図2 IBM DB2 Databaseのホームページ

2. 「ターゲット」メニューから「監視」、「メトリック収集エラー」の順にクリックして、トリック収集エラーが報告されていないことを確認します。

3. 「ターゲット」メニューで「情報パブリッシャ・レポート」をクリックして、「IBM DB2データベース」ターゲット・タイプのレポートを表示し、レポートが表示されていること、およびエラーが報告されていないことを確認します。

4. 「ターゲット」メニューで、「構成」、「最新収集」をクリックし、構成データが表示されていることを確認します。構成データがすぐに表示されない場合は、「最新の構成」ページで「リフレッシュ」をクリックします。

プラグインのアンデプロイ

プラグインをデプロイする手順は、『Oracle Enterprise Manager Cloud Control管理者ガイド』でプラグイン・マネージャに関する章を参照してください。

http://docs.oracle.com/cd/E24628_01/doc.121/e24473/plugin_mngr.htm

プラグインのトラブルシューティング

System Monitoringプラグインの使用中に想定されるトラブルシューティングのシナリオについては、『Oracle Enterprise Manager System Monitoring Plug-inトラブルシューティング・ガイド』を参照してください。

ドキュメントのアクセシビリティについて

Oracleのアクセシビリティについての詳細情報は、Oracle Accessibility ProgramのWebサイトhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=docaccを参照してください。

Oracleサポートへのアクセス

Oracleのお客様は、My Oracle Supportにアクセスして電子サポートを受けることができます。詳細情報はhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=infoか、聴覚に障害のあるお客様はhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=trsを参照してください。

System Monitoring Plug-inインストレーション・ガイド for IBM DB2 Database リリース12.1.0.2.0

B70764-01

Copyright © 2012, Oracle and/or its affiliates.All rights reserved.

このソフトウェアおよび関連ドキュメントの使用と開示は、ライセンス契約の制約条件に従うものとし、知的財産に関する法律により保護されています。ライセンス契約で明示的に許諾されている場合もしくは法律によって認められている場合を除き、形式、手段に関係なく、いかなる部分も使用、複写、複製、翻訳、放送、修正、ライセンス供与、送信、配布、発表、実行、公開または表示することはできません。このソフトウェアのリバース・エンジニアリング、逆アセンブル、逆コンパイルは互換性のために法律によって規定されている場合を除き、禁止されています。

ここに記載された情報は予告なしに変更される場合があります。また、誤りが無いことの保証はいたしかねます。誤りを見つけた場合は、オラクル社までご連絡ください。

このソフトウェアまたは関連ドキュメントを、米国政府機関もしくは米国政府機関に代わってこのソフトウェアまたは関連ドキュメントをライセンスされた者に提供する場合は、次の通知が適用されます。

U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are "commercial computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations.As such, the use, duplication, disclosure, modification, and adaptation shall be subject to the restrictions and license terms set forth in the applicable Government contract, and, to the extent applicable by the terms of the Government contract, the additional rights set forth in FAR 52.227-19, Commercial Computer Software License (December 2007).Oracle USA, Inc., 500 Oracle Parkway, Redwood City, CA 94065.

このソフトウェアもしくはハードウェアは様々な情報管理アプリケーションでの一般的な使用のために開発されたものです。このソフトウェアもしくはハードウェアは、危険が伴うアプリケーション(人的傷害を発生させる可能性があるアプリケーションを含む)への用途を目的として開発されていません。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用する際、安全に使用するために、適切な安全装置、バックアップ、冗長性(redundancy)、その他の対策を講じることは使用者の責任となります。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用したことに起因して損害が発生しても、オラクル社およびその関連会社は一切の責任を負いかねます。

OracleはOracle Corporationおよびその関連企業の登録商標です。その他の名称は、それぞれの所有者の商標または登録商標です。

このソフトウェアおよびドキュメントは、第三者のコンテンツ、製品、サービスへのアクセス、あるいはそれらに関する情報を提供することがあります。オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスに関して一切の責任を負わず、いかなる保証もいたしません。オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても、一切の責任を負いかねます。

Copyright © 2012, Oracle and/or its affiliates. All rights reserved.