Comment faire pour corriger les erreurs courantes lorsque j’utilise l’option OEM_AGENT avec l’Amazon RDS for Oracle ?

Résolution

Remarque : si des erreurs surviennent lorsque vous exécutez des commandes de l’interface de la ligne de commande AWS (AWS CLI), consultez la page Résoudre les erreurs liées à AWS CLI. Vérifiez également que vous utilisez bien la version la plus récente de l’AWS CLI.

Amazon RDS prend en charge l’agent de gestion Oracle Enterprise Manager (OEM) via l’option OEM_AGENT.

Tout d’abord, exécutez les vérifications préalables sur votre instance de base de données, puis consultez la section d’erreur associée. Pour résoudre les problèmes liés à l’utilisation de l’option OEM_AGENT, consultez les journaux des agents OEM après leur exportation vers Amazon CloudWatch. Pour plus d’informations, consultez Publication de journaux Oracle sur Amazon CloudWatch Logs.

Vérifications préalables

Avant de commencer les étapes de résolution, effectuez les vérifications préalables suivantes sur votre instance de base de données :

1. Utilisez l’AWS CLI add-option-to-option-group pour appliquer OEM_AGENT à l’option et à l’instance de base de données.

2. Pour vérifier l’état du groupe d’options, exécutez la commande AWS CLI suivante :

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

3. Vérifiez que l’état du groupe d’options de résultat est in-sync.
   Si l’état du groupe d’options est INVALID, alors l’OEM_AGENT n’est pas installé en raison de problèmes liés à la configuration réseau et à d’autres prérequis. Consultez l’onglet Événements de votre instance de base de données Amazon RDS depuis l’AWS Management Console pour vérifier l’état de l’installation de l’option OEM_AGENT. Vous pouvez également utiliser la commande AWS CLI describe-events. Si les événements indiquent un problème d’installation de l’option OEM_AGENT ou de configuration réseau, assurez-vous que les conditions préalables OEM_AGENT sont bien remplies.

4. Vérifiez la configuration réseau de l’instance de base de données. Le groupe de sécurité de l’instance de base de données doit autoriser OMS_HOST à écouter le port OEM_AGENT (la valeur par défaut est 3872) et le port RDS (la valeur par défaut est 1521).

5. Effectuez un test telnet entre le serveur Oracle Management Service (OMS) et votre instance de base de données sur le port OEM_AGENT et le port de la base de données pour vérifier la connectivité.

6. Vérifiez les configurations de votre réseau. Par exemple, consultez les listes de contrôle d’accès (ACL) au réseau et les tables de routage. Faites-le pour exclure la possibilité de blocage ou d’un refus explicite.

7. Assurez-vous que le pare-feu entre OMS et RDS autorise bien le trafic à la fois sur le port de l’écouteur de base de données et sur le port OEM_AGENT.

Après ces étapes, vérifiez que le chargement OEM_AGENT fonctionne bien. Pour plus d’informations, consultez Faire en sorte que l’agent de gestion charge son OMS.

Corriger les erreurs

L’instance de base de données n’apparaît pas dans l’Auto Discovery des cibles sur la console OEM

Ce problème se produit lorsque le serveur OMS ne peut pas se connecter à l’hôte sous-jacent depuis SSH. Cette connexion est une condition préalable au niveau du système d’exploitation pour qu’Auto Discovery fonctionne correctement. Pour corriger cette erreur, vous devez ajouter manuellement votre instance de base de données Oracle comme cible. Pour plus d’informations, consultez Limites applicables à l’agent de gestion.

Impossible d’installer OEM_AGENT d’Oracle, 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é. Utilisez le serveur OEM pour modifier le mot de passe d’enregistrement de l’agent ou créer un mot de passe.

Impossible d’installer l’OEM_AGENT d’Oracle, car l’instance de base de données ne peut pas atteindre l’hôte OMS

Cette erreur s’affiche lorsque l’OEM_AGENT ne parvient pas à s’installer, car l’hôte/port OMS n’est pas accessible depuis l’hôte RDS. Pour résoudre cette erreur, vérifiez si l’hôte OMS est joignable depuis votre instance de base de données.

Pour valider la connectivité réseau entre le serveur OMS et OEM_AGENT, testez la connexion entre l’instance RDS pour Oracle et le serveur OMS. Procédez ainsi pour tirer parti des listes de contrôle d’accès (ACL) et des packages UTL_TCP.

• Utilisez le package DBMS_NETWORK_ACL_ADMIN qui fournit l’interface permettant d’administrer l’ACL réseau. Pour plus d’informations, consultez Utilisation de DBMS_NETWORK_ACL_ADMIN sur le site Web d’Oracle.
• Utilisez le type d’enregistrement UTL_TCP.CONNECTION. a PL/SQL utilisé pour représenter une connexion TCP/IP. Pour plus d’informations, consultez Utilisation d’UTL_TCP sur le site Web d’Oracle.

Procédez comme suit :

1. Ouvrez la console Amazon Elastic Compute Cloud (Amazon EC2).

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

3. Exécutez la commande telnet suivante depuis l’instance Amazon EC2 vers l’hôte OMS sur le port 4903 :

   telnet OMS_HOST 4903

4. Pour valider la connectivité, exécutez la commande de test telnet suivante dans l’hôte OEM à partir du serveur OMS jusqu’à l’instance de la base de données :

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

5. Pour vérifier si l’hôte RDS peut résoudre le nom d’hôte de l’OMS en une adresse IP, exécutez la commande suivante :

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

6. Exécutez un TCP Traceroute pour vérifier le lieu où le trafic est bloqué.

Vous avez installé l’option OEM_AGENT sur votre instance de base de données. Votre groupe de sécurité n’est peut-être pas configuré correctement

Même si l’installation se termine correctement, il se peut que le groupe de sécurité RDS associé à votre instance de base de données n’ait pas été configuré. Ces configurations permettent la communication entre l’hôte OMS et l’instance de base de données.

Pour corriger cette erreur, vérifiez que le groupe de sécurité de l’agent autorise bien le trafic entrant. Vérifiez aussi que votre hôte OMS appartient bien à un groupe de sécurité qui a accès au port de l’agent. Pour plus d’informations, consultez Enterprise Manager Cloud Control Security Guide sur le site Web d’Oracle.

Impossible d’installer OEM_AGENT d’Oracle, car la version x.x.x.x de votre hôte OMS n’est pas compatible avec la version de l’agent x.x.x.x.

Vous recevez ce message d’erreur en cas de problème de compatibilité entre votre version d’OEM_AGENT et la version de l’hôte OMS. OEM_AGENT s’intègre à l’OMS lorsque les deux composants sont compatibles. Pour corriger cette erreur, choisissez des versions compatibles pour l’hôte OMS et l’agent OEM. Pour plus d’informations, consultez Exigences relatives à l’agent de gestion.

Votre hôte OMS utilise un certificat tiers non fiable

Vous recevez ce message d’erreur lorsque vous installez avec succès l’option OEM_AGENT, mais que votre hôte OMS utilise un certificat tiers qui n’est pas fiable. Pour résoudre cette erreur, configurez votre hôte OMS avec les certifications fiables requises auprès de votre tiers.

Les paramètres d’option requis sont manquants dans votre option OEM_AGENT (Service : AmazonRDS ; code de statut : 400 ; code d’erreur : InvalidParameterValue)

Ce message d’erreur s’affiche lorsque les paramètres requis sont manquants dans votre OEM_AGENT. Vous devez spécifier ce paramètre. Pour plus d’informations sur les paramètres requis pour OEM_AGENT, consultez Paramètres d’option pour l’agent de gestion.

État du signal d’activité : OMS a réagi de manière illégale [ERROR - Failed to Update Target Type Metadata]

Ce message d’erreur s’affiche lorsque l’hôte OMS est remplacé après l’association de l’option OEM_AGENT à Amazon RDS.

Pour corriger cette erreur, procédez comme suit :

1. Effacez le statut de l’agent ou redémarrez l’OEM_AGENT. Pour plus d’informations, consultez Administration de l’agent de gestion.

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

3. Vérifiez l’existence de problèmes de compatibilité avec la version OMS et la version OEM_AGENT. Pour vérifier si le tableau indique la version OEM_AGENT utilisée dans le groupe d’options, exécutez la commande suivante :

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

4. Si le résultat 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 le résultat de la commande. Cette erreur indique que les correctifs et plug-ins latéraux d’OMS requis sont manquants. Assurez-vous qu’OMS est correctement configuré et que tous les correctifs requis sont appliqués.

Si l’agent est bloqué, effectuez les étapes suivantes dans la console OEM pour resynchroniser l’agent :

1. Connectez-vous à la console Cloud Control.
2. Choisissez Configuration, Manage Cloud Control, puis Agents.
3. Choisissez l’agent que vous souhaitez resynchroniser.
4. À partir du menu Agent, choisissez Resynchronisation en cours.
5. Sélectionnez Débloquer l’agent une fois la resynchronisation de l’agent terminée avec succès.
6. Choisissez Continuer. L’opération de resynchronisation est soumise comme tâche.
7. Cliquez sur le lien du nom de la tâche pour vérifier l’état de la tâche de resynchronisation.

Une fois la tâche terminée, vérifiez l’état de l’agent que vous avez resynchronisé et de toutes les cibles surveillées.

Remarque : le serveur DNS doit disposer de fonctionnalités continues pour que la surveillance OEM fonctionne efficacement. L’agent émet des signaux d’activité et transmet des mises à jour de l’état à l’hôte OMS. Si l’agent ne peut pas joindre l’hôte OMS pendant une période prolongée, OMS indique que l’agent et la base de données sont en panne. Assurez-vous que le serveur DNS fonctionne.

Pour que l’agent de gestion Oracle télécharge l’OMS qui lui est associé, exécutez la commande suivante. Lorsque vous exécutez cette commande, il s’agit de la même que lorsque vous exécutez la commande emctl de chargement de l’agent. Pour plus d’informations, consultez EMCTL commands for Management Agent sur le site Web d’Oracle.

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

Pour redémarrer l’agent OEM une fois que l’état de l’agent est effacé, exécutez la commande suivante :

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

Vous pouvez déployer uniquement Oracle Management Agent 13c, publication 4 (13.4.0.0.0) dans Oracle Enterprise Manager Cloud Control 13c, publication 4 (13.4.0.0.0). Le nouveau déploiement des versions précédentes d’Oracle Management Agent (13.2 et 13.3) n’est pas pris en charge après la mise à niveau d’OMS vers 13c, version 4. Pour plus d’informations, consultez Before you begin installing an Enterprise Manager System sur le site Web d’Oracle.

Impossible d’installer l’option OEM_AGENT, car le port de l’agent est en conflit avec le port OMS. Mettre à jour les paramètres d’option et réessayer

Ce message d’erreur s’affiche, car vous n’avez pas configuré correctement OEM_AGENT pour qu’il fonctionne correctement. Vous avez peut-être spécifié le même numéro de port pour le port OMS et le port OEM_AGENT. Pour corriger cette erreur, modifiez le numéro de port OMS ou le numéro de port OEM_AGENT. Vérifiez les paramètres d’option de l’agent de gestion suivants :

• AGENT_PORT. Ce port de 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é ayant accès à ce port.
• OMS_PORT. Ce port HTTPS de l’hôte OMS écoute l’agent de gestion. Pour trouver le port de chargement HTTPS, connectez-vous à l’hôte OMS et exécutez la commande suivante :

  emctl status oms -details

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

Ce message d’erreur s’affiche lorsque le stockage de votre instance de base de données ne dispose pas de suffisamment d’espace de stockage disponible, comme défini dans les conditions préalables OEM_AGENT. Augmentez l’espace de stockage, puis réinstallez l’option OEM_AGENT.

Filesystem / has X.XX% available space

Cette erreur s’affiche en raison d’une limite d’utilisation de l’option OEM_AGENT avec une instance RDS pour Oracle. Les métriques de l’hôte et la liste des processus peuvent ne pas refléter l’état réel du système. Évitez d’utiliser OEM pour surveiller le système de fichiers racine ou le système de fichiers du point de montage. Pour plus d’informations, consultez Limites applicables à l’agent de gestion.

Le système de fichiers racine d’une instance Amazon RDS est géré par le système d’automatisation interne. Ce système d’automatisation surveille le système de fichiers racine à intervalles réguliers pour s’assurer que celui-ci dispose bien d’un espace suffisant. Si un espace de stockage insuffisant est détecté, le système d’automatisation ajoute un espace suffisant au système de fichiers racine. Comme le système d’automatisation gère l’espace dans le système de fichiers racine, vous pouvez ignorer cette erreur.

Informations connexes

Agent de gestion Oracle pour Enterprise Manager Cloud Control