7 Microsoft SCOMイベント・コネクタのトラブルシューティング
この章では、Microsoft SCOMとの統合に関する問題のトラブルシューティングに役立つ情報を提供します。 特にWebサービス・フロントエンドおよびバックエンド・エージェントでの問題のトラブルシューティングに重点を置いています。
ノート:
特に明記しないかぎり、次の手順はSCOM 2012コネクタおよびSCOM 2007コネクタに適用されます。 SCOM 2007コネクタに固有の手順は、Microsoft SCOM 2007コネクタに使用できます。
この章では、以下のトピックについて説明します。
トラブルシューティングのステップを開始する前に、次の作業が完了していることを確認する必要があります。
-
Microsoft SCOMイベント・コネクタのインストールの指定に従ってSCOMコネクタをインストールします。
-
Oracle SCOMエージェントのインストールと実行の指定に従って、Oracle SCOMエージェントをインストールして起動します。
-
Microsoft SCOM Webサービスのインストールの指定に従って、SCOM Webサービスをインストールし、起動してテストします。
-
コネクタ・インスタンスの作成の指定に従ってコネクタ・インスタンスを作成します。
-
コネクタの構成の指定に従ってコネクタ・インスタンスを構成します。
-
コネクタ・インスタンスにイベントを転送するための1つ以上のルールを設定します。
前述のすべての処理が完了して、コネクタが機能していない場合は、問題の診断のステップを実行します。
問題の診断
- SCOM Webサービスが正常に起動され、SCOM WebサービスのWSDLがインストールされているマシンからアクセスできることを確認します。 そのためには、次のステップを実行します。
- Enterprise ManagerサーバーがインストールされているマシンからSCOM WebサービスのWSDLにアクセスできることを確認します。
- SCOMコネクタが
createEvent
およびupdateEvent
操作に正しいURLを指定していることを確認します。 - 前のステップでエラーが検出されなかった場合、コネクタとSCOM Webサービス間の接続の問題は排除されます。 問題は、SCOM WebサービスまたはOracle SCOMエージェントにあります。 エラーの診断の詳細は、Webサービス操作エラーのトラブルシューティングを参照してください。
Webサービス起動エラーのトラブルシューティング
起動時の障害の原因を特定するには、SCOM Webサービスのインストール・ディレクトリにあるadapters/log
ディレクトリに移動して、framework.log
ファイルをテキスト・エディタで開きます。 Exceptionを検索して、ファイル内のエラーを見つけます。 ファイルがない場合は、JVMの検索または実行に問題があることを示します。 JVMの問題の解決方法は、JVMエラーを参照してください。
次に、考えられるいくつかの例外、根本原因の説明、および解決策の説明を示します。
例7-1 java.net.BindException: Address already in use: bind
このエラーは、ポートの競合のために、Webサービスが起動できなかったことを示します。 2つの原因が考えられます。
-
Webサービスが使用するように構成したポートを、別のアプリケーションが使用しています。 SSLを使用するようにWebサービスが構成されている場合、ポート番号は8443です。 SSLを使用するように構成されていない場合、ポート番号は8080です。
2つの解決策が考えられます。 異なるポートを使用するように他のアプリケーションを変更するか、SCOM Webサービスが別のポートを使用するように変更します。 異なるポートを使用するようにSCOM Webサービスを変更するには、Microsoft SCOMのカスタマイズのデフォルト・ポート番号の変更を参照してください。
-
Webサービスのインスタンスがすでに実行中です。 この場合、変更は必要ありません。 Webサービスのインスタンスは一度に1つのみ実行してください。
例7-2 org.springframework.beans.factory.BeanInitializationException: Could not load properties; nested exception is java.io.FileNotFoundException: … framework.properties (Permission denied)
このエラーは、conf
ディレクトリのframework.properties
ファイルの権限が正しく設定されていないために、Webサービスが起動できなかったことを示します。
この問題を解決するには、SCOM Webサービスが実行されるアカウントまたはグループに読取りおよび実行権限を付与するように、権限を変更します。
その他の起動エラーについては、Oracleサポートに問い合せてください。
JVMエラー
- UNIXシステムでは、環境変数
JAVA_HOME
を、Webサービスが起動されるシェルのJDK 1.6がインストールされているディレクトリに設定する必要があります。 UNIXプラットフォームでWebサービスを正しく起動するには、次の操作を実行します。- 環境変数
JAVA_HOME
をJDK 1.6インストール・ディレクトリに設定します。 - Webサービスのインストール・ディレクトリにある
adapters/bin
サブディレクトリに移動します。 ./service.sh start
コマンドを実行します。
- 環境変数
- Windowsシステムでは、次の操作を実行して、Webサービスの起動時にJDK 1.6が使用されるようにします。
- Webサービスのインストール・ディレクトリにある
adapters\bin
サブディレクトリに移動します。 iWaveAdaptersw.exe
実行可能ファイルを実行します。- 「Java」タブをクリックします。
- 「Use Default」チェック・ボックスの選択が解除されていることを確認します。
- 「Java Virtual Machine」ボックスに、JDK 1.6インストール・ディレクトリの
jvm.dll
ファイルへのパスを指定します。 - 「OK」をクリックします。
- Webサービスのインストール・ディレクトリにある
Webサービス操作エラーのトラブルシューティング
- SCOMコネクタにイベントを転送するルールで、トリガーされたイベントが参照されていることを確認します。
OracleEnterpriseManager.Alert.Creator
管理パックがSCOMサーバーにインポートされていることを確認します。- System Center Operations Managerコンソール・ウィンドウを開き、ログインします。
- Operations Managerコンソールの「Administration」ペインで、「Administration」、「Management Packs」の順に選択します。
- OracleEnterpriseManager Alert Creator管理パックが表示されていることを確認します。
- パックがリストにない場合は、アラート作成管理パックのインストールの指定に従ってインポートします。
- Oracle Enterprise Managerで報告されたエラーを確認します。 そのためには、ログ・ファイルでエラーを確認する必要があります。 ログ・ファイルでエラーを見つけるには、次のステップを実行します。
- エラー情報に基づいて問題を診断します。 トラブルシューティングの一般的なエラー・イベントの詳細は、Oracle Enterprise Managerからのエラーを参照してください。
Oracle Enterprise Managerによるエラー
この項では、一般的なエラー・メッセージのトラブルシューティングに関する原因および解決策の情報を提供します。 受け取ったエラー・メッセージと一致するエラー・メッセージを表7-1で見つけて、考えられる原因にある対応する項を参照し、問題を診断して修正する指示を参照してください。
表7-1 Enterprise Managerのエラー・メッセージ
エラー・メッセージ | 考えられる原因 |
---|---|
|
|
|
|
|
|
|
|
|
または |
|
|
|
|
|
|
Unable to reconnect to server after being disconnected |
|
|
|
|
または |
|
または |
|
|
|
|
|
次の各エラーについて説明します。
無効なWebサービス資格証明
原因
SCOM Webサービスにアクセスするためのユーザー名またはパスワードが正しくありません。
解決策
コネクタに構成されているポート番号が正しいことを確認します。
-
スーパー管理者権限があるアカウントを使用してOracle Enterprise Managerコンソールにログインします。
-
「設定」メニューで、「拡張性」、「管理コネクタ」の順に選択します。
-
「管理コネクタ」ページで、適切なSCOMコネクタの名前をクリックします。
これにより編集モードとなり、コネクタを構成できます。
-
SCOM Webサービスのユーザー名およびSCOM Webサービスのパスワードのフィールドを修正し、「OK」をクリックします。
Enterprise ManagerでSSLが構成されていない
原因
Oracle Enterprise Manager ConnectorフレームワークとSCOM Webサービス間のSSLハンドシェイクが失敗しました。 この障害は、Oracle Enterprise ManagerがSCOM Webサービス用のSSL証明書によって正しく構成されていないために発生します。 SCOM Webサービスで使用されるSSL証明書は、Enterprise Managerキーストアにインポートする必要があります。 証明書がキーストアにないか、SCOM Webサービスによって提供されるSSL証明書と一致しないかのいずれかです。
解決策
SCOM WebサービスからEnterprise ManagerキーストアにSSL証明書をインポートします。 SCOM SSL証明書を使用してOracle Enterprise Managerを設定する方法の詳細は、SSLを使用するためのEnterprise Managerの構成を参照してください。
SCOM Webサービスの停止
原因
SCOM Webサービスが停止しています。
解決策
Webサービスのステータスを調べるために次のステップを実行し、必要な場合はサービスを起動します。
SCOM WebサービスがUNIXシステムにインストールされている場合:
-
SCOM Webサービスがインストールされているシステムで、コマンド・ターミナルを開きます。
-
作業ディレクトリをSCOM Webサービスのインストール・ディレクトリの
adapters/bin
ディレクトリに変更します。 -
次のコマンドを入力します。
./service.sh status
-
コマンドによりサービスが稼働していないことが示された場合、次のコマンドを入力します。
./service.sh start
SCOM WebサービスがWindowsシステムにインストールされている場合:
-
SCOM Webサービスがインストールされているシステムで、コマンド・ターミナルを開きます。
-
作業ディレクトリをSCOM Webサービスのインストール・ディレクトリの
adapters\log
ディレクトリに変更します。 -
テキスト・エディタで
framework.log
ファイルを開きます。 -
ファイルの最後に移動し、文字列iWave Adapter Frameworkを逆方向検索します。 見つかった最後の文字列がiWave Adapter Framework Startedである場合、これはWebサービスが開始されていることを示しています。
-
Webサービスが開始しない場合は、WindowsでのMicrosoft SCOM Webサービスのインストールと実行の指定に従ってWebサービスを開始します。
無効なIPアドレス
原因
URLで指定されているIPアドレスが無効か、ネットワークが停止しています。
解決策
コネクタ用に構成されているホスト名/IPアドレスが正しいことを確認します。
-
スーパー管理者権限があるアカウントを使用してOracle Enterprise Managerコンソールにログインします。
-
「設定」メニューで、「拡張性」、「管理コネクタ」の順に選択します。
-
「管理コネクタ」ページで、適切なSCOMコネクタの名前をクリックします。
これにより編集モードとなり、コネクタを構成できます。
-
createEvent
およびupdateEvent
操作のURLに指定されているホスト名/IPアドレスが正しいことを確認します。 -
ホスト名/IPアドレスが正しくない場合は、正しい値を指定して「OK」をクリックします。
URLにホスト名が指定されている場合は、ホスト名が正しいIPアドレスに解決されていることを確認してください。 ホスト名のIPアドレスを判別するには、ping <hostname>
コマンドを発行します。ここで、<hostname>
は実際のホスト名です。 ホスト名について解決されたIPアドレスのリストが表示されます。 この値が間違っている場合は、間違っている理由をシステム管理者が調査する必要があります。
ホスト名/IPアドレスが正しいと思われる場合は、そのホスト名/IPアドレスを使用して、SCOM Webサービスがインストールされているシステムのpingを試みます。 pingが失敗した場合、システム管理者は接続性がない理由を調べる必要があります。
無効なURLパス
原因
URLに無効なパスが指定されているため、Webサービスがリクエストを受信し、それを拒否しました。
解決策
コネクタが使用しているURLをテストするために、次のステップを実行します。
-
スーパー管理者権限があるアカウントを使用してOracle Enterprise Managerコンソールにログインします。
-
「設定」メニューで、「拡張性」、「管理コネクタ」の順に選択します。
-
「管理コネクタ」ページで、適切なSCOMコネクタの名前をクリックします。
これにより編集モードとなり、コネクタを構成できます。
-
createEvent
操作用に指定されたURLを選択してコピーします。 -
Oracle Enterprise Managerサーバーがインストールされているシステムで、インターネット・ブラウザを開きます。
-
アドレス・ウィンドウに、ステップ6でコピーしたURLを入力します。 URLの最後に?wsdl を追加します。 URLは、次の例のようになります。
http://[Hostname]:8080/services/SCOM/EventService?wsdl
[Hostname]
は、SCOM Webサービスがインストールされている実際のホスト名またはIPアドレスです。
WSDLがロードされていれば、URLが正しいことは確実です。 ロードに失敗した場合は、URLに問題があります。 正しいURLを使用するようにコネクタを構成するには、SCOM Webサービス操作用の正しいURLの使用に指定されているステップを実行します。
無効なポート番号
原因
URLに指定されているポート番号が無効です。
解決策
コネクタに構成されているポート番号が正しいことを確認します。
-
スーパー管理者権限があるアカウントを使用してOracle Enterprise Managerコンソールにログインします。
-
「設定」メニューで、「拡張性」、「管理コネクタ」の順に選択します。
-
「管理コネクタ」ページで、適切なSCOMコネクタの名前をクリックします。
これにより編集モードとなり、コネクタを構成できます。
-
createEvent
、updateEvent
、setup、initializeおよびuninitialize操作のURLに指定されているポート番号が正しいことを確認します。 -
ポート番号が正しくない場合は、正しい値を指定して「OK」をクリックします。
ファイアウォールによるアクセスのブロック
原因
ファイアウォールによって、SCOM Webサービスがインストールされているシステムへのアクセスがブロックされています。
解決策
SCOM Webサービスで使用するポートへのアクセス権をEnterprise Managerに付与するように、IT部門に連絡してください。 SCOM Webサービス操作用の正しいURLの使用に指定されているステップを実行して、SCOM Webサービスで使用されるURLを判別します。 URLに指定されたポート番号は、IT部門がファイアウォールで開くポート番号です。
不明なホスト
原因
URLで指定されたホスト名がシステムによって認識されていません。
解決策
この問題に対処するには次のオプションを使用できます。
-
システム管理者と調整して、システム構成をホスト名が認識されるように変更します。
-
ホスト名のかわりにURLでIPアドレスを指定します。 これを行うには、次のステップを実行します:
-
SCOM WebサービスがインストールされているシステムのIPアドレスを確認します。
-
スーパー管理者のロールがあるユーザー名を入力し、適切なパスワードを入力して「ログイン」をクリックし、Oracle Enterprise Managerコンソールにログインします。
-
Enterprise Managerコンソールで、「設定」、「拡張性」、「管理コネクタ」の順にクリックします。 インストール済コネクタを示す「管理コネクタ」ページが表示されます。
-
Microsoft SCOM Connectorに関連付けられている「構成」アイコンをクリックします。 これにより編集モードとなり、コネクタを構成できます。
-
createEvent
、initialize、setup、uninitializeおよびupdateEvent
操作に指定されているURLのホスト名をIPアドレスに変更します。 -
「OK」をクリックします。
-
無効なXML書式
原因
XSLファイルの書式が正しくないため、コネクタ・フレームワークがリクエストを処理できませんでした。 この問題は、コネクタがカスタマイズされている場合にのみ発生します。
解決策
問題の原因となった可能性のある誤りがないか、XSLテンプレート・ファイルに加えられた変更を調査します。 問題が手動で見つからない場合は、XML検証を実行するユーティリティにXSLをロードします。
SCOMサーバーが動作していない
原因
間違ったホスト名がSCOMに構成されているか、SCOMサーバーが停止しているため、SCOMエージェントがSCOMにアラートを挿入できませんでした。
解決策
次のステップを実行し、問題の根本的な原因を調べて修正します。
-
エラー・メッセージに示されているホスト名やIPアドレスがSCOMサーバーに対して正しいかどうかを確認します。 ホスト名やIPアドレスが正しくない場合は、次のステップを実行して構成を修正します。
-
SCOMエージェントがあるシステムでWindowsエクスプローラを開きます。
-
SCOMエージェントのインストール・ディレクトリの
bin
ディレクトリにナビゲートします。 -
SCOMエージェントの構成ツールを起動する
SCOMAgentConfig.exe
ユーティリティを実行します。 -
「Load」をクリックすると、ディレクトリのナビゲーション・ウィンドウが開きます。
-
SCOMエージェントのインストール・ディレクトリにナビゲートして、
SCOMAgent.cfg
ファイルを開きます。 -
「Management Groups」タブをクリックして「Edit」をクリックすると、Edit Management Groupウィンドウが表示されます。
-
「Server」フィールドのホスト名/IPアドレスを修正して、「Update」をクリックします。
-
「Save」をクリックして、構成ファイルの変更を保存します。
-
「Exit」をクリックしてユーティリティを終了します。
-
IISでSCOMエージェントを停止して再起動します。
-
-
次のOpsMgrサービスが稼働していることを確認します。
-
System Center Data Access
-
System Center Management
-
System Center Management Configuration
-
無効なSCOM API資格証明
原因
SCOM APIにアクセスするために構成された資格証明が無効なため、SCOMエージェントがSCOMサーバーにアラートを送信できませんでした。
解決策
次のステップを実行して、SCOM APIにアクセスするための資格証明を変更します。
-
SCOMエージェントがあるシステムでWindowsエクスプローラを開きます。
-
SCOMエージェントのインストール・ディレクトリのbinディレクトリにナビゲートします。
-
SCOMエージェントの構成ツールを起動するSCOMAgentConfig.exeユーティリティを実行します。
-
「Load」をクリックすると、ディレクトリのナビゲーション・ウィンドウが開きます。
-
SCOMエージェントのインストール・ディレクトリにナビゲートして、SCOMAgent.cfgファイルを開きます。
-
「Management Groups」タブをクリックして「Edit」をクリックすると、Edit Management Groupウィンドウが表示されます。
-
「Domain」、「Username」、「Password」の各フィールドの資格証明情報を修正して、「Update」をクリックします。
-
「Save」をクリックして、構成ファイルの変更を保存します。
-
「Exit」をクリックしてユーティリティを終了します。
-
IISでSCOMエージェントを停止して再起動します。
間違ったSCOM API権限
原因
SCOM APIにアクセスするために構成された資格証明に十分な権限がないため、SCOMエージェントがSCOMサーバーにアラートを送信できませんでした。
解決策
エージェントのアカウントの設定を参照してください。 この項では、SCOM APIにアクセスするアカウントの設定に必要なステップが説明されています。
SCOMエージェントが動作していない
原因
SCOMエージェントが機能しないため、WebサービスがSCOMでアラートを作成できませんでした。
解決策
SCOMエージェントがインストールされたシステムでIISマネージャを開き、エージェントのWebサイトを開始します。
SCOMエージェント構成
原因
Webサービスに無効な構成パラメータがあるため、WebサービスがSCOMエージェントに接続できませんでした。 SCOMエージェントのURLが正しくないか、SCOMエージェントにアクセスするための資格証明が無効です。
解決策
-
SCOMエージェントのURLが正しいことを確認します。 SCOMエージェントのインストールの最後に示されたURLを指定する必要があります。 URLのホスト名がローカルホストで、別のシステムからURLにアクセスしている場合は、ローカルホストをSCOMエージェントのインストール・マシンのホスト名またはIPアドレスに置き換える必要があります。
URLが不明の場合は、次のようにして確認できます。
-
SCOMエージェントをWebサイトとしてインストールした場合、アドレスは次のようになります。
http://<IP>:<port>/Service.asmx
<IP>
はIPアドレス、<port>
は、エージェントのインストール時に指定したポート番号です。 -
SCOMエージェントを仮想ディレクトリとしてインストールした場合、アドレスは次のようになります。
http://<IP>:<port>/<vdir>/Service.asmx
<IP>
はIPアドレス、<port>
は、エージェントがインストールされたWebサービスのポート番号、<vdir>
はエージェントに指定した仮想ディレクトリ名です。
-
-
SCOMエージェントがインストールされたシステムで有効なユーザー名とパスワードを選択します。
-
コマンド・ウィンドウを開き、作業ディレクトリを、SCOM Webサービスのインストール・ディレクトリの
adapters\endpoints\SCOM
に変更します。 -
前述のステップのURLと資格証明を使用して、SCOM Webサービスのインストーラを再実行します。 手順は、使用しているプラットフォームに応じて、UNIXでのMicrosoft SCOM WebサービスのインストールまたはWindowsでのMicrosoft SCOM Webサービスのインストールを参照してください。
-
UNIXでのMicrosoft SCOM WebサービスのインストールまたはWindowsでのMicrosoft SCOM Webサービスのインストールの指定に従って、Webサービスを再起動します。
アラート作成管理パックの欠落
原因
OracleEnterpriseManager.Alert.Creator
管理パックがSCOMにインポートされていないため、WebサービスがSCOMでアラートを作成できませんでした。
解決策
管理パックをSCOMにインポートするために必要なステップは、Microsoft SCOM 2007のアラート作成管理パックのインストールを参照してください。
アラート作成のタイムアウト
原因
WebサービスからSCOMにイベントを挿入できましたが、タイムアウト期間内にアラートが作成されませんでした。 これは、エラーがアラート生成ルールで発生し、SCOMでアンロードされた可能性が高いことを示します。 このエラーが発生すると、System Center Operations Manager Health Serviceにより、エラーに続いて警告がOperations Managerログに生成されます。 エラー・エントリは、次のメッセージで始まります。
A module reported an error 0x80070057 from a callback which was running as part of rule "Create.Default.Alert" running for instance "OracleEnterpriseManager Event Source" with id ...
警告エントリは、次のメッセージで始まります。
Summary: 1 rule(s)/monitor(s) failed and got unloaded, 1 of them reached the failure limit that prevents automatic reload ...
ノート:
この状況は、SCOM Connectorのデフォルトの構成ファイルを使用する場合は発生しません。 この状況が発生するのは、SCOMエージェントのWebサービスに直接アクセスして、「Priority」または「Severity」フィールドに無効な値を渡した場合のみです。
解決策
SCOMサーバーでOps Mgr Health Serviceという名前のWindowsサービスを再起動します。