Oracle® Enterprise Manager
System Monitoring Plug-inインストレーション・ガイド for VMware ESX Server
リリース5（1.0.3.0.0）からリリース8（1.1.3.2.0）
部品番号: B51850-02
2009年5月
このドキュメントは、System Monitoring Plug-in for VMware ESX Serverのインストレーション・ガイドです。このドキュメントの内容は次のとおりです。
- VMware ESX Serverの簡単な説明
- プラグインでサポートされるVMware ESX ServerバージョンおよびEnterprise Managerバージョン
- プラグインをインストールするための前提条件
- プラグインのダウンロード、インストール、検査および検証の手順
1 説明
System Monitoring Plug-in for VMware ESX Serverは、Oracle Enterprise Manager Grid Controlを拡張して、VMware ESX Serverを管理できるようにするためのプラグインです。このプラグインをGrid Control環境にデプロイすることで、次の管理機能を使用できるようになります。
- VMware ESX Serverの監視。
- VMware ESX Serverの構成データの収集および構成変更の追跡。
- 監視対象メトリックおよび構成データに設定されたしきい値に基づくアラートおよび違反の表示。
- 収集データに基づいた豊富なレポートの提供。
- リモート・エージェントによる監視のサポート。リモート監視の場合、VMware ESX Serverと同じホスト上にエージェントを配置する必要はありません。
2 サポートされるバージョン
このプラグインのリリース8では、次のバージョンの製品がサポートされます。
3 前提条件
プラグインを使用する前に、次の前提条件を満たしていることを確認する必要があります。
- Oracle Enterprise Manager Grid Control 10gリリース3以上の管理サービスおよび管理エージェント。
- VMware ESX Serverは、（エージェントでコールされる）HTTPまたはHTTPSのWebサービスを受け入れるように構成できます。VMware ESX Serverのデフォルトの設定は、HTTPSです。
VMwareの『Developer's Setup Guide - VMware Infrasturcture SDK 2.5』には、本番デプロイにはセキュアなHTTP（デフォルト構成のHTTPS）が推奨され、VI APIへのHTTPアクセスをサポートするようにサーバー構成を変更することは、テストまたは開発用にのみ行い、本番デプロイには推奨されないと記載されています。HTTPSを使用する場合は、各VMware ESX Serverに付属の証明書を格納するためのキーストアを作成する必要があります。
VMware ESXiでは、コンソールへのアクセスは使用できません。このサーバーで、ファイルを取得または更新するには、https://<ESXi_machine>/hostまたはVMware VI Remote CLI（
vifs.pl）を使用する必要があります。いずれの場合も、実際のファイル名を使用してアクセスできないファイルがあります。シンボリック名を使用してアクセスします。たとえば、VMware ESXiでは、rui.crtファイルには、シンボリック名ssl_certを使用してアクセスします。次の手順では、引き続きrui.crtを使用していますが、VMware ESXiでは、かわりに、ssl_certを使用します。この証明書は、各ESX Serverインストールに固有のものです。このため、エージェントが3つのESX Serverを監視していれば、そのエージェントには、3つのESX Serverインストールに対する証明書を格納するキーストア・ファイルへの読取りアクセス権が必要です。エージェントがキーストア・ファイルを介して証明書を使用できるようにするには、次の2つの方法があります。
- 各ESX Serverの証明書に対して個別のキーストア・ファイルを作成します。
- エージェントによって監視するすべてのESX Serverに対するすべての証明書が含まれる単一のキーストア・ファイルを作成します。
キーストア・ファイルは、Java SDKツールのkeytoolを使用して作成します。このツールでは、対話形式の操作により、同じキーストア・ファイルに1つ以上の証明書を追加できます。たとえば、最初の方法を選択する場合は、次のコマンドを使用できます。なお、このコードは、現在のディレクトリにESX Server用のrui.crtという証明書ファイルが存在することを前提としています。
> keytool -import -file rui.crt -alias my_esx_svr -keystore
single_cert.keystore次に、次のコマンドを実行します。
> keytool -list -keystore single_cert.keystore
すると、次のように表示されます（出力の一部を示します）。
Your keystore contains 1 entry my_esx_svr, Aug 17, 2007, trustedCertEntry, Certificate fingerprint (MD5): FF:53:87:A0.................
2つ目の方法を使用する場合は、各rui.crtファイルに、対応するESX Server名を表す名前を付けると区別しやすくなります。
> keytool -import -file svr1_rui.crt -alias my_esx_svr1 -keystore multi_cert.keystore > keytool -import -file svr2_rui.crt -alias my_esx_svr2 -keystore multi_cert.keystore
次に、次のコマンドを実行します。
> keytool -list -keystore multi_cert.keystore
すると、次のように表示されます（出力の一部を示します）。
Your keystore contains 2 entries my_esx_svr1, Aug 17, 2007, trustedCertEntry, Certificate fingerprint (MD5): B3:29:56:0C................. my_esx_svr2, Aug 17, 2007, trustedCertEntry, Certificate fingerprint (MD5): 3F:22:89:B1.................
HTTPを使用する場合は、次のファイルを使用してVMware ESX Serverの構成を変更する必要があります。
/etc/vmware/hostd/config.xml (for versions before 3.5.0) /etc/vmware/hostd/proxy.xml (for version 3.5.0 and above)
詳細は、VMwareの『Developer's Setup Guide - VMware Infrastructure SDK 2.5』の「Modifying ESX Server 3.5 or VirtualCenter 2.5 Configurations」および「Modifying ESX Server 3.0.x and VirtualCenter 2.0.x Configuration」の項を参照してください。
- 各ESX Serverの証明書に対して個別のキーストア・ファイルを作成します。
- プラグインのデプロイ先のすべてのエージェントに対して優先資格証明が設定されていること。適切な権限を割り当てない場合、デプロイは失敗します。
- レスポンス・メトリックがESX Serverのステータスを正しくレポートするためには、エージェントが稼働中のホスト（このプラグインがインストールされている場所）と、ESX Serverが稼働中のホストの間にIPレベル接続が存在する必要があります。
レスポンス・メトリックは
pingコマンドを使用して、ESX Serverのステータスをチェックします。エージェント・ホストからESX Serverホストに対してpingを実行できることを確認します。ESX Serverホストに対してpingを実行できない場合は、2つのホスト間にIP接続が設定されていることをシステム管理者に確認してください。ifconfigコマンドを使用すると、オペレーティング・システムでネットワーク・インタフェースを設定し、構成されているネットワーク・インタフェースに関する情報を表示できます。IP接続は、/etc/sysctl.confファイルのnet.ipv4.icmp_echo_ignore_all設定を使用して、ESX Serverホストで構成することもできます。値を1に設定すると、受信したすべてのpingパケットが削除されます。このため、レスポンス・メトリックが正しく機能するためには値を0に設定する必要があります。
4 プラグインのデプロイ
前提条件を満たしていることを確認した後、次の手順に従ってプラグインをデプロイします。
- VMware ESX Serverプラグインのアーカイブを、ブラウザを起動しているデスクトップまたはコンピュータにダウンロードします。アーカイブは、Oracle Technology Network（OTN）からダウンロードできます。
- スーパー管理者としてEnterprise Manager Grid Controlにログオンします。
- Grid Controlホームページの右上隅にある「設定」リンクをクリックし、次に「設定」ページの左側にある「管理プラグイン」リンクをクリックします。
- 「インポート」をクリックします。
- 「参照」をクリックしてプラグインのアーカイブを選択します。
- 「リスト・アーカイブ」をクリックします。
- プラグインを選択して「OK」をクリックします。
- プラグインのデプロイ先のエージェントすべてに優先資格証明を設定したことを確認します。
- 「管理プラグイン」ページで、VMWare ESX Serverプラグインの「デプロイ」列のアイコンをクリックします。管理プラグインのデプロイ・ウィザードが表示されます。
- 「エージェントの追加」をクリックして、プラグインをデプロイするエージェントを1つ以上選択します。ウィザードが再び表示され、選択したエージェントが表示されます。
- 「次へ」をクリックし、「終了」をクリックします。
優先資格証明が設定されていないというエラー・メッセージが表示された場合、「プリファレンス」ページに移動してエージェント・ターゲット・タイプの優先資格証明を追加します。
- HTTPSのWebサービス・コールを使用する場合は、ターゲット・インスタンスの追加時に指定する場所にキーストア・ファイルをコピーする必要があります（この手順は、これらのエージェントにターゲットを追加する前に実行してください）。
エラーがなければ、次の画面が表示されます。
図 1 デプロイ成功時の画面
5 監視対象インスタンスの追加
プラグインが正常にデプロイできたら、次の手順に従って、プラグイン・ターゲットをGrid Controlに追加します。これにより、ターゲットが集中的な監視および管理の対象になります。
- プラグインをデプロイしたエージェントのホームページで、「追加」ドロップダウン・リストからVMware ESX Serverターゲット・タイプを選択し、「実行」をクリックします。VMware ESX Serverの追加ページが表示されます。
- プロパティに次の情報を入力します。
- 名前: 監視対象のVMware ESX Serverの名前。
- ホスト名: ESX Serverの完全修飾ホスト名（ドメインを含む）。
- ユーザー名: VMware ESX Serverで組込みWebサービスを介したデータ・アクセスをプラグインに許可するための適切な権限を持つユーザーの名前。
- パスワード: 指定された「ユーザー名」に対応するパスワード。
- プロトコル: HTTPまたはHTTPSを指定できます。HTTPSを指定した場合は、「キーストア」パラメータを指定する必要があります（HTTPを設定した場合、「キーストア」パラメータは空白のままにします）。ただし、ESX Serverに関連する問題があるため、ここではHTTPプロトコルを使用することをお薦めします。詳細は、「制限事項」の項を参照してください。
- キーストア: VMware ESX Serverの証明書が含まれるキーストア・ファイルのフルパス名およびファイル名。エージェントには、このキーストア・ファイルへのアクセス権が必要です。
- 名前: 監視対象のVMware ESX Serverの名前。
- 「接続テスト」をクリックして、入力したパラメータが正しいことを確認します。
- 接続テストが成功した場合、手順2の暗号化されたパラメータを再入力して、「OK」をクリックします。Enterprise Managerのリリースが10.2.0.4以上の場合は、このステップは不要です。
- VMを停止、起動および一時停止するEMジョブや、ESX Serverのメンテナンス・モードを設定または解除するEMジョブを実行するには、ジョブに対して資格証明を指定する必要があります。これには、EMの「プリファレンス」セクションで優先資格証明（「エージェント・ホストのユーザー名/パスワード」と「Webサービスのユーザー名/パスワード」の両方）をあらかじめ指定しておく方法と、ジョブが実際に発行されたときに同じ資格証明を指定する方法があります。
図 2 VMware ESX Serverの追加ページ
6 プラグインの検査および検証
プラグインがデータの収集を開始するまで数分間待機したら、次の手順を実行して、プラグイン・ターゲットがEnterprise Managerで適切に監視されているかどうかを確認および検証します。
- エージェントのホームページの「監視ターゲット」表で、VMware ESX Serverターゲット・リンクをクリックします。VMware ESX Serverのホームページが表示されます。
図 3 VMware ESX Serverのホームページ
- 「メトリック」表に、メトリック収集エラーが報告されていないことを確認します。
- 「レポート」プロパティ・ページを選択して、レポートが表示されていることを確認します。
- 「構成」セクションの「構成の表示」リンクをクリックして、構成データが表示されていることを確認します。構成データがすぐに表示されない場合は、「構成の表示」ページで「リフレッシュ」をクリックします。
7 プラグインのアンデプロイ
プラグインをエージェントからアンデプロイするには、次の手順を実行します。
- スーパー管理者としてEnterprise Manager Grid Controlにログインします。
- 「ターゲット」タブを選択して、次に「すべてのターゲット」サブタブを選択します。
- VMware ESX Serverプラグイン・ターゲットを選択して「削除」をクリックします。この手順は、プラグインのすべてのターゲット・インスタンスに対して実行する必要があります。
- プラグインのデプロイ先のエージェントに優先資格証明が設定されていることを確認します。
- 「すべてのターゲット」ページの右上隅にある「設定」リンクをクリックし、次に「設定」ページの左側にある「管理プラグイン」リンクをクリックします。「管理プラグイン」ページが表示されます。
- VMware ESX Serverプラグインの「アンデプロイ」列のアイコンをクリックします。「管理プラグインのアンデプロイ」ページが表示されます。
- VMware ESX Serverプラグインに現在デプロイされているエージェントをすべて選択して「OK」をクリックします。
プラグインをEnterprise Managerから完全に削除するには、システムのすべてのエージェントからアンデプロイする必要があります。
- 「管理プラグイン」ページでVMware ESX Serverプラグインを選択して、「削除」をクリックします。
8 制限事項
- ESX Server VMサマリー・レポートには、特定のESX Serverに作成されたVMの表が含まれます。その表のVM列には、VMの名前がリンクとして表示されます。VMにEMエージェントがインストールされている場合、そのVMのリンクをクリックすると、そのVMの「ホスト」ホームページがホストとして表示されます。そのVMにエージェントがインストールされていない場合も、ホームページは表示されますが、「エラーが発生しました。リポジトリからターゲット<VM name>を検索中にエラーが発生しました。ターゲットが存在しないか、またはターゲットへのアクセス権がない可能性があります。」というエラー・メッセージが表示されます。エージェントがインストールされていないVMはホスト・ターゲット・インスタンスとして監視されないため、これは予測される動作です。
この機能は10.2.0.4で使用可能です。10.2.0.3では、この汎用レポート関連機能に対してEM Grid Controlパッチを適用しないかぎり、リンクは表示されません。また、10.2.0.3では、VMサマリー表の最後に「ドメイン」およびホスト・ホームページURLという名前の列が表示されます。これらの列は、10.2.0.4でもパッチでも表示されません。
- 特定のESX Server上に存在するVMは、名前変更が可能です。データへのキーはVM名であるため、VMが名前変更されると、そのメトリック履歴およびその他のEMリポジトリ・データはアクセス不能になります。
- このプラグインでは、VMware ESX Serverで埋込みWebサービスへのHTTPベースおよびHTTPSベースの両方の接続をサポートしています。ただし、ESX Serverで報告されている問題により、HTTPSのプロトコル設定でEM ESX Serverターゲット・インスタンスを構成すると、最終的に、EMエージェントがメトリックを収集中またはジョブを実行中にESX Serverの
/etc/vmware/log/hostd.logにSSLハンドシェイク・エラーが発生します。この場合、EMエージェントはWebサービスと通信できなくなります。VMware提供のVirtual Infrastructure Clientツールでも、この状況は同じです。ESX Serverの問題の詳細は、http://metalink.oracle.com/で入手可能なノート455661.1を参照してください。ドキュメント455661.1を検索するには、次のようにします。 - VMware ESX Serverターゲット・タイプは、ESX Serverのリモートのエージェントで監視しないでください。EMエージェントをESX Serverで稼働している仮想マシンにインストールし、そのエージェントでそのESX Serverをターゲットとして監視することはできますが、これは行わないでください。これは、VMware ESX Serverプラグインの一部の管理機能が、エージェントの実行と競合するためです。たとえば、エージェントが稼働しているVMを停止するジョブを実行できます。EMジョブを停止するためにVMでエージェントと通信する必要があるため、問題が発生します。ただし、VMの停止時にエージェントが停止し、エージェントとOMSのリレーションシップが未定義の状態になります。
9 ジョブ・エラー・コード
表1に、ジョブ実行中にエラーが発生した場合に表示されるジョブ・エラー・コードの詳細を示します。
表 1 ジョブ・エラー・コードおよび説明
10 ドキュメントのアクセシビリティについて
オラクル社は、障害のあるお客様にもオラクル社の製品、サービスおよびサポート・ドキュメントを簡単にご利用いただけることを目標としています。オラクル社のドキュメントには、ユーザーが障害支援技術を使用して情報を利用できる機能が組み込まれています。HTML形式のドキュメントで用意されており、障害のあるお客様が簡単にアクセスできるようにマークアップされています。標準規格は改善されつつあります。オラクル社はドキュメントをすべてのお客様がご利用できるように、市場をリードする他の技術ベンダーと積極的に連携して技術的な問題に対応しています。オラクル社のアクセシビリティについての詳細情報は、Oracle Accessibility Program のWeb サイトhttp://www.oracle.com/accessibility/を参照してください。
ドキュメント内のサンプル・コードのアクセシビリティについて
スクリーン・リーダーは、ドキュメント内のサンプル・コードを正確に読めない場合があります。コード表記規則では閉じ括弧だけを行に記述する必要があります。しかしJAWSは括弧だけの行を読まない場合があります。
外部Webサイトのドキュメントのアクセシビリティについて
このドキュメントにはオラクル社およびその関連会社が所有または管理しないWebサイトへのリンクが含まれている場合があります。オラクル社およびその関連会社は、それらのWebサイトのアクセシビリティに関しての評価や言及は行っておりません。
聴覚に障害があるお客様のOracleサポート・サービスへのアクセス
Oracleサポート・サービスに連絡するには、電気通信リレー・サービス（TRS）をご利用いただき、Oracleサポート（+1-800-223-1711）までお電話ください。Oracleサポート・サービスの技術者が、Oracleサービス・リクエストのプロセスに従って、技術的な問題を処理し、お客様へのサポートを提供します。TRSの詳細情報はhttp://www.fcc.gov/cgb/consumerfacts/trs.htmlを、電話番号のリストはhttp://www.fcc.gov/cgb/dro/trsphonebk.htmlを参照してください。
11 サポートおよびサービス
次の各項に、各サービスに接続するためのURLを記載します。
Oracleサポート・サービス
オラクル製品サポートの購入方法、およびOracleサポート・サービスへの連絡方法の詳細は、次のURLを参照してください。
http://www.oracle.com/lang/jp/support/index.html
製品マニュアル
製品のマニュアルは、次のURLにあります。
http://www.oracle.com/technology/global/jp/documentation/index.html
研修およびトレーニング
研修に関する情報とスケジュールは、次のURLで入手できます。
http://education.oracle.com/pls/web_prod-plq-dad/db_pages.getpage?page_id=3
その他の情報
オラクル製品やサービスに関するその他の情報については、次のURLから参照してください。
http://www.oracle.com/lang/jp/index.html http://www.oracle.com/technology/global/jp/index.html
Oracle Enterprise Manager System Monitoring Plug-inインストレーション・ガイド for VMware ESX Server, リリース5（1.0.3.0.0）からリリース8（1.1.3.2.0）
部品番号: B51850-02
Oracle Enterprise Manager System Monitoring Plug-in Installation Guide for VMware ESX Server, Release 5 (1.0.3.0.0) to Release 8 (1.1.3.2.0)
原本部品番号: E13339-04
Copyright © 2009, Oracle. 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, use, duplication, disclosure, modification, and adaptation of the Programs, including documentation and technical data, shall be subject to the licensing restrictions set forth in the applicable Oracle license agreement, and, to the extent applicable, the additional rights set forth in FAR 52.227-19, Commercial Computer Software\'d1Restricted Rights (June 1987).Oracle USA, Inc., 500 Oracle Parkway, Redwood City, CA 94065.
The Programs are not intended for use in any nuclear, aviation, mass transit, medical, or other inherently dangerous applications.このプログラムをかかる目的で使用する際、上述のアプリケーションを安全に使用するために、適切な安全装置、バックアップ、冗長性（redundancy）、その他の対策を講じることは使用者の責任となります。万一かかるプログラムの使用に起因して損害が発生いたしましても、オラクル社およびその関連会社は一切責任を負いかねます。
OracleはOracle Corporationおよびその関連企業の登録商標です。その他の名称は、それぞれの所有者の商標または登録商標です。
このプログラムは、第三者のWebサイトへリンクし、第三者のコンテンツ、製品、サービスへアクセスすることがあります。オラクル社およびその関連会社は第三者のWebサイトで提供されるコンテンツについては、一切の責任を負いかねます。当該コンテンツの利用は、お客様の責任になります。第三者の製品またはサービスを購入する場合は、第三者と直接の取引となります。オラクル社およびその関連会社は、第三者の製品およびサービスの品質、契約の履行（製品またはサービスの提供、保証義務を含む）に関しては責任を負いかねます。また、第三者との取引により損失や損害が発生いたしましても、オラクル社およびその関連会社は一切の責任を負いかねます。
