Amazon RDS for Oracle で OEM_AGENT オプションを使用するときによくあるエラーをトラブルシューティングする方法を教えてください。

解決策

**注:**AWS コマンドラインインターフェイス (AWS CLI) コマンドの実行中にエラーが発生した場合は、「AWS CLI エラーのトラブルシューティング」を参照してください。また、AWS CLI の最新バージョンを使用していることを確認してください。

Amazon RDS は OEM_AGENT オプションを通じて Oracle エンタープライズマネージャー (OEM) 管理エージェントをサポートしています。

まず、DB インスタンスで事前チェックを実行してから、関連するエラーセクションを参照してください。OEM_AGENT オプションを使用する際の問題をトラブルシューティングするには、これらのログを Amazon CloudWatch にエクスポートした後に OEM エージェントのログを確認してください。詳細については、「Oracle ログを Amazon CloudWatch ログに公開する」を参照してください。

事前チェック

解決ステップを開始する前に、DB インスタンスで以下の事前チェックを完了してください。

1. add-option-to-option-group AWS CLI を使用して、OEM_AGENT をオプションと DB インスタンスに適用します。

2. オプショングループのステータスを確認するには、次の AWS CLI コマンドを実行します。

   aws rds describe-db-instances --db-instance-identifier <db-instance-name> --query 'DBInstances[*].[Engine,DBInstanceStatus,OptionGroupMemberships]'

3. 出力オプショングループのステータスが in-sync であることを確認します。
   オプショングループのステータスが INVALID の場合、ネットワーク構成の設定やその他の前提条件に問題があるため、OEM_AGENT はインストールされていません。AWS マネジメントコンソールから Amazon RDS DB インスタンスの [イベント] タブを確認して、OEM_AGENT オプションのインストールステータスを確認します。AWS CLI コマンドの describe-events を使用することもできます。イベントで OEM_AGENT オプションのインストールまたはネットワーク設定に問題があることがわかった場合は、OEM_AGENT の前提条件が満たされていることを確認してください。

4. DB インスタンスのネットワーク設定を確認します。DB インスタンスのセキュリティグループは、OMS_HOST が OEM_AGENT ポート (デフォルトは 3872) と RDS ポート (デフォルトは 1521) をリッスンできるようにする必要があります。

5. Oracle 管理サービス (OMS) サーバーから OEM_AGENT ポートとデータベースポートの DB インスタンスへの Telnet テストを実行して、接続を確認します。

6. ネットワーク設定を確認するたとえば、ネットワークアクセスコントロールリスト (ACL) とルートテーブルを確認します。これを行うと、ブロッカーや明示的な拒否の可能性が排除されます。

7. OMS と RDS の間のファイアウォールが、DB リスナーポートと OEM_AGENT ポートの両方でトラフィックを許可していることを確認します。

これらの手順を完了したら、OEM_AGENT のアップロードが機能することを確認します。詳細については、「管理エージェントに OMS をアップロードさせる」を参照してください。

エラー発生時のトラブルシューティング

**DB インスタンスが OEM コンソールのターゲットの自動検出に表示されない **

この問題は、OMS サーバーが SSH から基盤となるホストに接続できない場合に発生します。この接続は、自動検出が正しく機能するための OS レベルの前提条件です。このエラーを解決するには、Oracle DB インスタンスをターゲットとして手動で追加する必要があります。詳細については、「管理エージェントの制限事項」を参照してください。

エージェントのパスワードが正しくないか、有効期限が切れているため、Oracle OEM_AGENTをインストールできない

エージェントパスワードが正しく、有効期限が切れていないことを確認してください。OEM サーバーを使用して、エージェント登録パスワードを変更するか、新しいパスワードを作成します。

DB インスタンスが OMS ホストにアクセスできないため、Oracle OEM_AGENT をインストールできない

このエラーは、RDS ホストから OMS ホスト/ポートにアクセスできないために OEM_AGENT のインストールに失敗した場合に発生します。このエラーをトラブルシューティングするには、DB インスタンスから OMS ホストにアクセスできるかどうかを確認します。

OMS サーバーと OEM\ _AGENT の間のネットワーク接続を検証するには、RDS for Oracle インスタンスから OMS サーバーへの接続をテストします。これにより、アクセスコントロールリスト (ACL) と UTL_TCP パッケージを活用できます。

• ネットワーク ACL を管理するためのインターフェイスを提供する DBMS_NETWORK_ACL_ADMIN パッケージを使用してください。詳細については、オラクルのウェブサイトの「DBMS_NETWORK_ACL_ADMIN の使用」を参照してください。
• TCP/IP 接続を表すために使用される PL/SQL レコードタイプである UTL_TCP.CONNECTION を使用してください。詳細については、オラクルのウェブサイトの「UTL_TCP の使用」を参照してください。

次の手順を実行します。

1. Amazon Elastic Compute Cloud (Amazon EC2) コンソールを開きます。

2. DB インスタンスと同じネットワーク設定 (SG/ACL) で Amazon EC2 インスタンスを起動します。

3. Amazon EC2 インスタンスからポート 4903 の OMS ホストに次の telnet コマンドを実行します。

   telnet OMS_HOST 4903

4. 接続を検証するには、OEM ホストで OMS サーバーから DB インスタンスに次の telnet テストコマンドを実行します。

   telnet RDS-instance-endpoint 1521 (RDS default port)

5. RDS ホストが OMS ホスト名を IP アドレスに変換できるかどうかを確認するには、次のコマンドを実行します。

   SQL> SELECT UTL_INADDR.get_host_address('OMS_Host_Name') FROM dual;

6. TCP Traceroute を実行して、トラフィックがブロックされている場所を確認します。

DB インスタンスに OEM_AGENT オプションをインストールしました。セキュリティグループが正しく設定されていない可能性がある

インストールが正しく完了したとしても、DB インスタンスに関連付けられた RDS セキュリティグループには設定がない可能性があります。これらの設定により、OMS ホストと DB インスタンス間の通信が可能になります。

このエラーを解決するには、エージェントのセキュリティグループがインバウンドトラフィックを許可していることを確認します。また、OMS ホストがエージェントポートにアクセスできるセキュリティグループに属していることも確認してください。詳細は、Oracle の Web サイトの「Enterprise Manager Cloud Control Security Guide」を参照してください。

お使いの OMS ホストバージョン x.x.x.x がエージェントバージョン x.x.x.x と互換性がないため、Oracle OEM_AGENT をインストールできません。

このエラーは、OEM_AGENT バージョンと OMS ホストバージョンとの間に互換性の問題がある場合に表示されます。OEM_AGENT は、両方のコンポーネントに互換性がある場合に OMS と統合されます。このエラーを解決するには、OMS ホストと OEM エージェントの両方に互換性のあるバージョンを選択してください。詳細については、「管理エージェントの要件」を参照してください。

OMS ホストが信頼できないサードパーティの証明書を使用している

このエラーは、OEM_AGENT オプションを正常にインストールしたが、OMS ホストが信頼できないサードパーティの証明書を使用している場合に表示されます。このエラーを解決するには、OMS ホストにサードパーティからの必要な信頼証明書を設定します。

OEM\ _AGENT オプションに必要なオプション設定がない (サービス: AmazonRDS; Status Code: 400; エラーコード: InvalidParameterValue)

このエラーは、OEM_AGENT に必要な設定がない場合に発生します。この設定を指定する必要があります。OEM_AGENT に必要な設定の詳細については、「管理エージェントのオプション設定」を参照してください。

**ハートビートステータス: OMS が不正に応答しました\ [エラー - ターゲットタイプメタデータの更新に失敗しました] **

このエラーは、OEM_AGENT オプションが Amazon RDS にアタッチされた後に OMS ホストが交換されたときに表示されます。

このエラーを解決するには、次の手順を実行してください:

1. エージェントのステータスをクリアするか、OEM_AGENT を再起動してください。詳細については、「管理エージェントの管理」を参照してください。

2. OMS ホストとの接続を再確立します。

3. OMS バージョンと OEM_AGENT バージョンとの互換性の問題を確認してください。テーブルにオプショングループで使用されている ** OEM_AGENT** のバージョンが表示されているかどうかを確認するには、次のコマンドを実行します。

   select type_meta_ver from sysman.mgmt_target_type_versions where target_type = 'oracle_emd';

4. mgmt_target_type_versions 出力にオプショングループで使用されている OEM_AGENT バージョンが含まれていない場合は、コマンド出力にリストされている OEM_AGENT バージョンをインストールします。このエラーは、必要な OMS サイドパッチとプラグインが見つからないことを示しています。OMS が正しく設定され、必要なパッチがすべて適用されていることを確認してください。

エージェントがブロックされている場合は、OEM コンソールで次の手順を実行してエージェントを再同期します。

1. クラウドコントロールコンソールにログインします。
2. [設定] を選択し、[クラウドコントロールの管理] を選択して、[エージェント] を選択します。
3. 再同期するエージェントを選択します。
4. [エージェント] メニューから [再同期...] を選択します。
5. [エージェントの再同期が正常に完了したら、エージェントのブロックを解除する] を選択します。
6. [続行] を選択します。再同期操作はジョブとして送信されます。
7. ジョブ名のリンクを選択して、再同期ジョブのステータスを確認します。

ジョブが完了したら、再同期したエージェントとすべての監視対象ターゲットのステータスを確認します。

**注:**OEM モニタリングが効果的に機能するためには、DNS サーバーに継続的な機能が必要です。エージェントはハートビートを送信し、ステータス更新を OMS ホストにプッシュします。エージェントから OMS ホストに長期間アクセスできない場合、OMS はエージェントとデータベースがダウンしていることを示します。DNS サーバーが機能していることを確認します。

関連する OMS を Oracle 管理エージェントにアップロードさせるには、次のコマンドを実行します。このコマンドを実行すると、emctl upload agent コマンドを実行したときと同じになります。詳細については、Oracle の Webサイトの「管理エージェントの EMCTL コマンド」を参照してください。

SELECT rdsadmin.rdsadmin_oem_agent_tasks.upload_oem_agent() as TASK_ID from DUAL;

エージェント状態がクリアされた後に OEM エージェントを再起動するには、次のコマンドを実行します。

SELECT rdsadmin.rdsadmin_oem_agent_tasks.restart_oem_agent() as TASK_ID from DUAL;

Oracle Enterprise Manager Cloud Control 13c リリース 4 (13.4.0.0.0) にデプロイできるのは Oracle Management Agent 13c リリース 4 (13.4.0.0.0) だけです。OMS が 13cリリース 4 にアップグレードされた後は、以前のバージョンの Oracle 管理エージェント (13.2 および 13.3) の新規デプロイはサポートされません。詳細は、Oracle Webサイトの「Enterprise Managerシステムのインストールを始める前に」を参照してください。

エージェントポートが OMS ポートと競合しているため、OEM_AGENT オプションをインストールできない。オプション設定を更新してやり直してください

このエラーが表示されるのは、OEM_AGENT が正しく動作するための構成が間違っているためです。OMS ポートと OEM_AGENT ポートの両方に同じポート番号を指定した可能性があります。このエラーを解決するには、OMS ポートまたは OEM_AGENT ポート番号を変更してください。以下の管理エージェントオプション設定を確認してください。

• **AGENT_PORT。**DB インスタンスのこのポートは OMS ホストを受信します。デフォルトは 3872 です。OMS ホストは、このポートにアクセスできるセキュリティグループに属している必要があります。
• **OMS_PORT。**OMS ホスト上のこの HTTPS ポートは、管理エージェントを受信します。HTTPS アップロードポートを見つけるには、OMS ホストに接続して次のコマンドを実行します。

  emctl status oms -details

DB インスタンスに十分なストレージがないため、Oracle OEM\ _AGENT をインストールできない。DB インスタンスクラスと設定でオプショングループがサポートされていることを確認します。サポートされている場合は、すべてのオプショングループ設定を確認してから再試行してください

このエラーは、DB インスタンスのストレージに OEM_AGENT の前提条件で定義されている十分なストレージがない場合に表示されます。ストレージ容量を増やしてから、OEM_AGENT オプションを再インストールしてください。

ファイルシステムに X.XX% の空き領域がある

このエラーが表示されるのは、RDS for Oracle インスタンスの OEM_AGENT オプションの使用制限が原因です。ホストメトリックとプロセスリストは、実際のシステム状態を反映していない場合があります。OEM を使用してルートファイルシステムまたはマウントポイントファイルシステムを監視することは避けてください。詳細については、「管理エージェントの制限事項」を参照してください。

Amazon RDS インスタンスのルートファイルシステムは、内部自動化システムによって管理されます。この自動化システムは、ルートファイルシステムを定期的に監視して、ファイルシステムに十分な容量があることを確認します。ストレージが不足していることが検出された場合、自動化システムはルートファイルシステムに十分なスペースを追加します。ルートファイルシステムの領域はオートメーションシステムが管理するので、このエラーは無視してかまいません。

関連情報

Oracle Management Agent for Enterprise Manager Cloud Control