Comment puis-je résoudre les erreurs courantes lors de l'utilisation de l'option OEM_AGENT avec Amazon RDS Oracle ?

Date de la dernière mise à jour : 03/12/2020

J'ai une instance de base de données Amazon Relational Database Service (Amazon RDS) qui exécute Oracle. Je reçois un message d'erreur lorsque j'essaie d'utiliser l'option OEM_AGENT avec mon instance de base de données. Comment puis-je dépanner et résoudre les erreurs courantes lors de l'utilisation de l'option OEM_AGENT ?

Brève description

Amazon RDS prend en charge Oracle Enterprise Manager (OEM) Management Agent grâce à l'option OEM_AGENT. Vous pouvez recevoir l'une des erreurs décrites dans cet article lorsque vous utilisez l'option OEM_AGENT avec votre instance de base de données Oracle Amazon RDS.

Remarque : avant de passer aux étapes de dépannage, exécutez les prévérifications suivantes sur votre instance de base de données :

1. Vérifiez la configuration réseau de votre instance de base de données. Le groupe de sécurité de votre instance de base de données doit permettre à OMS_HOST d'écouter le port OEM_AGENT (3872par défaut) et le port RDS (1521par défaut).

2. Exécutez un test telnet du serveur OMS vers votre instance de base de données sur le port de l'agent OEM et le port de base de données pour vérifier la connectivité.

3. Vérifiez les configurations réseau, y compris les listes de contrôle d'accès (ACL) réseau et les tables de routage. La vérification des configurations exclut la possibilité d'avoir des bloqueurs ou un refus explicite.

4. Assurez-vous que les ports de votre serveur OMS vers l'instance de base de données cible sont ouverts.

    Au terme des vérifications ci-dessus, vérifiez si le téléchargement OEM_AGENT fonctionne. Pour plus d'informations sur les conditions préalables OEM_AGENT, consultez Oracle Management Agent pour Enterprise Manager Cloud Control.

    Suivez les étapes décrites dans cet article, en fonction de l'erreur ou du problème que vous rencontrez.

    Résolution

    Erreur : impossible d'installer Oracle OEM_AGENT, car le mot de passe de l'agent est incorrect ou a expiré

    Assurez-vous que le mot de passe de l'agent est correct et qu'il n'a pas expiré. Sur le serveur OEM, vous pouvez modifier le mot de passe d'enregistrement de l'agent existant ou créer un nouveau mot de passe.

    Erreur : impossible d'installer Oracle OEM_AGENT, car l'instance de base de données ne peut pas atteindre l'hôte OMS.

    Vous recevez ce message d'erreur lorsque l'installation de l'agent OEM_AGENT échoue, car l'hôte/port OMS ne peut pas être atteint à partir de l'hôte RDS. Pour résoudre ce problème, vérifiez si l'hôte OMS peut être atteint à partir de votre instance de base de données.

    1. Lancez une instance Amazon Elastic Compute Cloud (Amazon EC2) avec la même configuration réseau (SG/ACL) que votre instance de base de données.

    2. Exécutez une commande telnet pour l'hôte OMS pour le port 4903 :

    From EC2 instance: telnet OMS_HOST 4903

    3. Valider la connectivité en exécutant un test telnet depuis le serveur OMS vers votre instance de base de données :

    From OMS host: telnet RDS-instance-endpoint 1521 (RDS default port)

    4. Vérifiez si l'hôte RDS est capable de résoudre le nom d'hôte OMS en une adresse IP :

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

    Erreur : vous avez installé l'option OEM_AGENT sur votre instance de base de données. Il est possible que votre groupe de sécurité ne soit pas configuré correctement.

    Même si votre installation se termine correctement, le groupe de sécurité RDS associé à votre instance de base de données peut manquer de configurations pour permettre la communication entre l'hôte OMS et l'instance de base de données.

    Pour résoudre cette erreur, vérifiez que le port de l'agent autorise le trafic entrant et que votre hôte OMS appartient à un groupe de sécurité qui a accès au port de l'agent. Pour plus d'informations, consultez Oracle Management Agent pour Enterprise Manager Cloud Control.

    Erreur : impossible d'installer Oracle OEM_AGENT, car la version 13.3.0.0 de l'hôte OMS n'est pas compatible avec la version 12.1.0.5 de l'agent.

    Vous recevez ce message d'erreur s'il y a un problème de compatibilité entre votre version OEM_AGENT et la version hôte OMS. Actuellement, OEM_AGENT s'intègre à OMS lorsque les deux composants exécutent la même version. Pour résoudre cette erreur, choisissez des versions compatibles pour l'hôte OMS et l'agent OEM.

    Erreur : votre hôte OMS utilise un certificat tiers non approuvé

    Vous avez reçu ce message d'erreur si vous installez correctement l'option OEM_AGENT, mais que votre hôte OMS utilise un certificat tiers qui n'est pas approuvé. Configurez votre hôte OMS avec les certifications d'approbation exigées de votre tiers.

    Erreur : l'option OEM_AGENT manque les paramètres d'option requis (Service : AmazonRDS ; Code d'état : 400 ; Code d'erreur : InvalidParameterValue ;

    Vous recevez ce message d'erreur lorsque OEM_AGENT manque l'un des paramètres requis, et vous devez le mettre à jour. Pour plus d'informations sur les paramètres requis pour OEM_AGENT, voir Paramètres d'option pour l'agent de gestion.

    Pour résoudre cette erreur, vérifiez les paramètres de l'option OEM_AGENT.

    1. Ouvrez la console Amazon RDS.

    2. Dans la page de navigation, choisissez Configuration d'option.

    3. Dans la section Paramètres d'option, recherchez la configuration OMS_HOST. Le panneau Paramètres d'option affiche seulement cinq ressources par défaut. Vous devez donc mettre à jour vos préférences pour afficher tous les paramètres sur une seule page.

    4. Après avoir saisi les paramètres requis, ajoutez l'option OEM_AGENT pour votre groupe d'options.

      Erreur : état du rythme cardiaque : OMS a répondu illégalement [ERREUR – Impossible de mettre à jour la cible]

      Vous recevez cette erreur lorsque l'hôte OMS est remplacé après que l'option OEM_AGENT est attachée à Amazon RDS.

      1. Effacez l'état de l'agent ou redémarrez l'agent OEM_AGENT en suivant les étapes décrites dans Exécution des tâches de base de données avec l'agent de gestion.

      2. Rétablissez votre connexion avec l'hôte OMS.

      3. Vérifiez les problèmes de compatibilité avec la version OMS et la version OEM_AGENT. Exécutez la requête suivante pour vérifier si la table répertorie la version OEM_AGENT utilisée dans le groupe d'options :

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

      4. Si la sortie mgmt_target_type_versions ne contient pas la version OEM_AGENT utilisée dans le groupe d'options, installez la version OEM_AGENT répertoriée dans la sortie de la commande.

      Erreur : l'instance de base de données n'apparaît pas dans les cibles de la console OEM

      Vous recevez ce message d'erreur, car le SSH à l'hôte sous-jacent est restreint sur Amazon RDS. Il s'agit d'une condition préalable au niveau du système d'exploitation pour que la découverte automatique fonctionne correctement.

      Contrairement à la découverte automatique basée sur l'assistant qui est utilisée lors de l'ajout d'une instance de base de données Oracle cible, vous devez ajouter manuellement votre instance de base de données Oracle en tant que cible. Cette opération est requise en raison de restrictions sur l'hôte sous-jacent pour les instances de base de données Oracle.

      Pour plus d'informations sur les limitations des agents, reportez-vous à Oracle Management Agent pour Enterprise Manager Cloud Control.

      Erreur : impossible d'installer l'option OEM_AGENT, car le port de l'agent est en conflit avec le port OMS. Mettez à jour les paramètres de l'option et réessayez

      Vous recevez ce message d'erreur, car vous avez la configuration de OEM_AGENT n'est pas la bonne et ne lui permet pas de fonctionner correctement. Par exemple, vous avez peut-être spécifié le même numéro de port pour le port OMS et le port OEM_AGENT. Pour résoudre ce problème, modifiez le port OMS ou le numéro de port OEM_AGENT.

      Consultez les paramètres d'option de l'agent de gestion suivants :

      • AGENT_PORT – Ce port sur l'instance de base de données écoute l'hôte OMS. La valeur par défaut est 3872. Votre hôte OMS doit appartenir à un groupe de sécurité qui a accès à ce port.
      • OMS_PORT – Ce port HTTPS sur l'hôte OMS écoute l'agent de gestion. Pour trouver le port de téléchargement HTTPS, connectez-vous à l'hôte OMS et exécutez la commande suivante :

      emctl status oms -details

      Erreur : impossible d'installer Oracle OEM_AGENT, car votre instance de base de données ne dispose pas d'un espace de stockage suffisant. Confirmez que le groupe d'options est pris en charge sur votre classe d'instance de base de données et votre configuration. Si c'est le cas, vérifiez tous les paramètres du groupe d'options et réessayez.

      Vous recevez ce message d'erreur lorsque l'espace de stockage alloué pour votre instance de base de données n'a pas suffisant selon les conditions préalables OEM_AGENT. Pour plus d'informations, consultez Conditions préalables pour l'agent de gestion. Augmentez l'espace de stockage, puis réinstallez l'option OEM_AGENT.