Oracle Management Agent pour Enterprise Manager Cloud Control

Oracle Enterprise Manager (OEM) Management Agent est un composant logiciel qui surveille les cibles en cours d'exécution sur les hôtes et communique ces informations au Oracle Management Service (OMS) de niveau intermédiaire. Amazon RDS prend en charge Management Agen via l'utilisation due l'option OEM_AGENT.

Pour plus d'informations, consultez les présentations Overview of Oracle Enterprise Manager Cloud Control 12c et Overview of Oracle Enterprise Manager Cloud Control 13c dans la documentation Oracle.

Exigences pour Management Agent

Pour utiliser Management Agent, vous devez respecter les exigences générales suivantes :

Prérequis à la communication avec l'hôte OMS

Vérifiez que votre hôte OMS et votre instance de base de données Amazon RDS peuvent communiquer. Procédez comme suit :

Limitations pour Management Agent

Voici quelques limitations quant à l'utilisation de Management Agent :

Paramètres de l'option Management Agent

Amazon RDS prend en charge les paramètres suivants pour l'option Management Agent.

La table suivante répertorie les suites de chiffrement TLS prises en charge par l'option Management Agent.

Compatibilité des certificats avec les suites de chiffrement

RDS for Oracle prend en charge à la fois les certificats RSA et ECDSA (Elliptic Curve Digital Signature Algorithm). Lorsque vous configurez l’option OEM Agent pour votre instance de base de données, vous devez vous assurer que les suites de chiffrement que vous spécifiez dans le paramètre d’option TLS_CIPHER_SUITE sont compatibles avec le type de certificat utilisé par votre instance de base de données.

Le tableau suivant montre la compatibilité entre les types de certificats et les suites de chiffrement :

Lorsque vous spécifiez une suite de chiffrement dans le paramètre d’option TLS_CIPHER_SUITE, assurez-vous qu’il est compatible avec le type de certificat utilisé par votre instance de base de données. Si vous tentez d’associer un groupe d’options à une option OEM Agent contenant une suite de chiffrement incompatible avec le type de certificat d’une instance de base de données, l’opération échoue avec un message d’erreur indiquant l’incompatibilité.

Activation de l’option Management Agent pour votre instance de base de données

Pour activer l’option Management Agent, procédez comme suit :

Étape 1 : Ajout de l’option Management Agent à votre instance de base de données

Pour ajouter l’option Management Agent à votre instance de base de données, procédez comme suit :

Si des erreurs se produisent, vous pouvez consulter les documents My Oracle Support pour savoir comment résoudre des problèmes spécifiques.

Après avoir ajouté l'option Management Agent, vous n'avez pas besoin de redémarrer votre instance de base de données. Dès que le groupe d'options est actif, l'agent OEM est actif.

Si votre hôte OMS utilise un certificat tiers non approuvé, Amazon RDS renvoie l'erreur suivante :

You successfully installed the OEM_AGENT option. Your OMS host is using an untrusted third party certificate. 
Configure your OMS host with the trusted certificates from your third party.        

S'il vous renvoie une erreur, l'option Management Agent n'est pas activée avant que le problème soit résolu. Pour plus d'informations sur la résolution des problèmes, consultez le document du Support My Oracle 2202569.1.

aws rds add-option-to-option-group \
    --option-group-name "myoptiongroup" \
    --options OptionName=OEM_AGENT,OptionVersion=13.1.0.0.v1,Port=3872,VpcSecurityGroupMemberships=sg-1234567890,OptionSettings=[{Name=OMS_HOST,Value=my.example.oms},{Name=OMS_PORT,Value=4903},{Name=AGENT_REGISTRATION_PASSWORD,Value=password}] \
    --apply-immediately

aws rds add-option-to-option-group ^
    --option-group-name "myoptiongroup" ^
    --options OptionName=OEM_AGENT,OptionVersion=13.1.0.0.v1,Port=3872,VpcSecurityGroupMemberships=sg-1234567890,OptionSettings=[{Name=OMS_HOST,Value=my.example.oms},{Name=OMS_PORT,Value=4903},{Name=AGENT_REGISTRATION_PASSWORD,Value=password}] ^
    --apply-immediately

Étape 2 : Déverrouillage du compte utilisateur DBSNMP

Management Agent utilise le compte utilisateur DBSNMP pour se connecter à la base de données et signaler les problèmes à Oracle Enterprise Manager. Dans une CDB, DBSNMP est un utilisateur ordinaire. Ce compte utilisateur est nécessaire à la fois pour Management Agent et pour OEM Database Express. Par défaut, ce compte est verrouillé. La procédure de déverrouillage de ce compte varie selon que votre base de données utilise une architecture non-CDB ou CDB.

Étape 3 : Ajout de vos cibles à la console Management Agent

Pour ajouter une instance de base de données en tant que cible, assurez-vous de connaître le point de terminaison et le port. Pour plus d’informations sur la recherche du point de terminaison de votre instance de base de données Amazon RDS, consultez Recherche du point de terminaison de votre instance de base de données RDS for Oracle. Si votre base de données utilise l’architecture CDB, ajoutez le conteneur CDB$ROOT séparément en tant que cible.

Suppression de l'option Management Agent

Vous pouvez supprimer l'agent OEM d'une instance de base de données. Lorsque vous avez supprimé l'agent OEM, vous n'avez pas besoin de redémarrer votre instance de base de données.

Pour supprimer l'agent OEM d'une instance de base de données, effectuez l'une des actions suivantes :

Exécution de tâches de base de données avec l'option Management Agent

Vous pouvez utiliser les procédures Amazon RDS for exécuter certaines commandes EMCTL sur Management Agent. Ces procédures vous permettent d'exécuter les tâches indiquées ci-après.

Sécurisation de Management Agent

Pour redémarrer Management Agent, exécutez la procédure Amazon RDS rdsadmin.rdsadmin_oem_agent_tasks.secure_oem_agent. Cette procédure équivaut à exécuter la commande emctl secure agent.

La procédure suivante crée une tâche permettant de sécuriser Management Agent et renvoie l’ID de la tâche :

SELECT rdsadmin.rdsadmin_oem_agent_tasks.secure_oem_agent as TASK_ID from DUAL;

Pour afficher le fichier de résultat pour la tâche et voir le résultat, consultez Affichage du statut d'une tâche en cours.

Obtenir le statut de l'agent de gestion

Pour obtenir le statut de l'agent de gestion, exécutez la procédure Amazon RDS rdsadmin.rdsadmin_oem_agent_tasks.get_status_oem_agent. Cette procédure est équivalente à la commande emctl status agent.

La procédure suivante crée une tâche permettant d'obtenir le statut du Management Agent et renvoie l'ID de la tâche.

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

Pour afficher le fichier de résultat pour la tâche et voir le résultat, consultez Affichage du statut d'une tâche en cours.

Redémarrage du Management Agent

Pour redémarrer le Management Agent, exécutez la procédure Amazon RDS rdsadmin.rdsadmin_oem_agent_tasks.restart_oem_agent. Cette procédure équivaut à exécuter les commandes emctl stop agent et emctl start agent.

La procédure suivante crée une tâche permettant de redémarrer Management Agent et renvoie l'ID de la tâche.

SELECT rdsadmin.rdsadmin_oem_agent_tasks.restart_oem_agent as TASK_ID from DUAL;    

Pour afficher le fichier de résultat pour la tâche et voir le résultat, consultez Affichage du statut d'une tâche en cours.

Liste des cibles surveillées par le Management Agent

Pour répertorier les cibles surveillées par le Management Agent, exécutez la procédure Amazon RDS rdsadmin.rdsadmin_oem_agent_tasks.list_targets_oem_agent. Cette procédure équivaut à exécuter la commande emctl config agent listtargets.

La procédure suivante crée une tâche pour répertorier les cibles surveillées par Management Agent et renvoie l'ID de la tâche.

SELECT rdsadmin.rdsadmin_oem_agent_tasks.list_targets_oem_agent as TASK_ID from DUAL;

Pour afficher le fichier de résultat pour la tâche et voir le résultat, consultez Affichage du statut d'une tâche en cours.

Constitution de la liste des threads de collecte surveillés par Management Agent

Pour répertorier tous les threads de collecte (en cours d'exécution, prêts et planifiés) surveillés par Management Agent, exécutez la procédure Amazon RDS rdsadmin.rdsadmin_oem_agent_tasks.list_clxn_threads_oem_agent. Cette procédure est équivalente à la commande emctl status agent scheduler.

La procédure suivante crée une tâche pour répertorier les threads de collecte et renvoie l'ID de la tâche.

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

Pour afficher le fichier de résultat pour la tâche et voir le résultat, consultez Affichage du statut d'une tâche en cours.

Suppression de l'état du Management Agent

Pour supprimer l'état du Management Agent, exécutez la procédure Amazon RDS rdsadmin.rdsadmin_oem_agent_tasks.clearstate_oem_agent. Cette procédure équivaut à exécuter la commande emctl clearstate agent.

La procédure suivante crée une tâche permettant d'annuler le statut de Management Agent et renvoie l'ID de la tâche.

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

Pour afficher le fichier de résultat pour la tâche et voir le résultat, consultez Affichage du statut d'une tâche en cours.

Chargement de l'OMS par le Management Agent

Pour que le Management Agent charge l'OMS (Oracle Management Server) qui lui est associé, exécutez la procédure Amazon RDS rdsadmin.rdsadmin_oem_agent_tasks.upload_oem_agent. Cette procédure équivaut à exécuter la commande emclt upload agent.

La procédure suivante crée une tâche dans laquelle Management Agent charge son OMS associé et renvoie l'ID de la tâche.

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

Pour afficher le fichier de résultat pour la tâche et voir le résultat, consultez Affichage du statut d'une tâche en cours.

Envoi de la commande Ping vers l'OMS

Pour envoyer la commande Ping à l'OMS du Management Agent, exécutez la procédure Amazon RDS rdsadmin.rdsadmin_oem_agent_tasks.ping_oms_oem_agent. Cette procédure équivaut à exécuter la commande emctl pingOMS.

La procédure suivante crée une tâche permettant de pinger l'OMS de Management Agent et renvoie l'ID de la tâche.

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

Pour afficher le fichier de résultat pour la tâche et voir le résultat, consultez Affichage du statut d'une tâche en cours.

Affichage du statut d'une tâche en cours

Vous pouvez consulter le statut d'une tâche en cours dans un fichier bdump. Les fichiers bdump se trouvent dans le répertoire /rdsdbdata/log/trace. Chaque nom de fichier bdump a le format suivant.

dbtask-task-id.log 

Lorsque vous souhaitez surveiller une tâche, remplacez task-id par l'ID de la tâche que vous souhaitez surveiller.

Pour afficher le contenu des fichiers bdump, exécutez la procédure Amazon RDS rdsadmin.rds_file_util.read_text_file. La requête suivante renvoie le contenu du fichier bdump dbtask-1546988886389-2444.log.

SELECT text FROM table(rdsadmin.rds_file_util.read_text_file('BDUMP','dbtask-1546988886389-2444.log'));

Pour plus d’informations sur la procédure Amazon RDS rdsadmin.rds_file_util.read_text_file, consultez Lecture de fichiers dans un répertoire d’instance de base de données.