Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra. # 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](http://docs.oracle.com/cd/E24628_01/doc.121/e25353/overview.htm) et [Overview of Oracle Enterprise Manager Cloud Control 13c](http://docs.oracle.com/cd/E63000_01/EMCON/overview.htm#EMCON109) dans la documentation Oracle. **Topics** + [Exigences pour Management Agent](#Oracle.Options.OEMAgent.PreReqs) + [Prérequis à la communication avec l'hôte OMS](#Oracle.Options.OEMAgent.PreReqs.host) + [Limitations pour Management Agent](#Oracle.Options.OEMAgent.limitations) + [Paramètres de l'option Management Agent](#Oracle.Options.OEMAgent.Options) + [Activation de l’option Management Agent pour votre instance de base de données](#Oracle.Options.OEMAgent.Enable) + [Suppression de l'option Management Agent](#Oracle.Options.OEMAgent.Remove) + [Exécution de tâches de base de données avec l'option Management Agent](#Oracle.Options.OEMAgent.DBTasks) ## Exigences pour Management Agent Pour utiliser Management Agent, vous devez respecter les exigences générales suivantes : + Votre instance de base de données doit exécuter Oracle Database 19c (19.0.0.0). Vous pouvez utiliser l’architecture CDB ou non-CDB. + Vous devez disposer d’une instance Oracle Management Service (OMS) configurée pour se connecter à votre instance de base de données. Notez les exigences OMS suivantes : + Management Agent versions 13.5.0.0.v2 et 13.5.0.0.v3 requièrent OMS version 13.5.0.23 ou 24.1. + Management Agent version 13.5.0.0.v1 requiert OMS version 13.5.0.0 ou 24.1. + Management Agent versions 13.4.0.9.v1 et 13.4.0.9.v2 requièrent OMS version 13.4.0.9 ou ultérieure et le correctif 32198287. + Dans la plupart des cas, vous devez configurer votre VPC de sorte à autoriser les connexions entre OMS et votre instance de base de données. Si vous n'avez pas l'habitude de Amazon Virtual Private Cloud (Amazon VPC), nous vous recommandons d'effectuer les étapes de [Tutoriel : Création d'un VPC à utiliser avec un ) IPv4](CHAP_Tutorials.WebServerDB.CreateVPC.md) avant de poursuivre. + Vous pouvez utiliser Management Agent avec Oracle Enterprise Manager Cloud Control pour 12c et 13c. Vérifiez que vous disposez d'un espace de stockage suffisant pour votre version OEM : + Au moins 8,5 Gio pour OEM 13c version 5 + Au moins 8,5 Gio pour OEM 13c version 4 + Au moins 8,5 Gio pour OEM 13c version 3 + Au moins 5,5 Gio pour OEM 13c version 2 + Au moins 4,5 Gio pour OEM 13c version 1 + Au moins 2,5 Gio pour OEM 12c + Si vous utilisez les versions Management Agent `OEM_AGENT 13.2.0.0.v3` et `13.3.0.0.v2`, et que vous voulez utiliser la connectivité TCPS, suivez les instructions de la section [Configuration de certificats CA tiers pour la communication avec les bases de données cible](https://docs.oracle.com/cd/E73210_01/EMSEC/GUID-8337AD48-1A32-4CD5-84F3-256FAE93D043.htm#EMSEC15996) de la documentation Oracle. De même, mettez à jour le JDK sur votre OMS en suivant les instructions du document Oracle dont l'ID de document Oracle est : 2241358.1. Cette étape garantit qu'OMS prendra en charge toutes les suites de chiffrement prises en charge par la base de données. **Note** La connectivité TCPS entre Management Agent et l'instance de base de données est uniquement prise en charge pour les versions `OEM_AGENT 13.2.0.0.v3`, `13.3.0.0.v2`, `13.4.0.9.v1` et ultérieures de Management Agent. ## 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 : + Pour établir une connexion entre Management Agent et votre hôte OMS, si ce dernier se trouve derrière un pare-feu, ajoutez les adresses IP de vos instances de base de données au pare-feu. Assurez-vous que le pare-feu de l’OMS autorise le trafic réseau suivant : De l’hôte OMS à votre instance de base de données Configurez une règle de pare-feu unidirectionnelle qui autorise le trafic en provenance de l’hôte OMS vers le port de l’écouteur de base de données (par défaut, le port 1521) et le port de l’agent OEM (par défaut, le port 3872). De votre instance de base de données à l’hôte OMS Configurez une règle de pare-feu unidirectionnelle qui autorise le trafic entre l’instance de base de données et le port HTTP OMS (par défaut, le port 4903). + Pour établir une connexion entre votre instance OMS et Management Agent, si votre instance OMS possède un nom d'hôte publiquement résolu, ajoutez l'adresse OMS à un groupe de sécurité. Votre groupe de sécurité doit avoir des règles de trafic entrant qui autorisent l'accès au port de l'instance de base de données et au port de Management Agent. Pour obtenir un exemple de création de règles de sécurité et d'ajout de règles de trafic entrant, consultez [Tutoriel : Création d'un VPC à utiliser avec un ) IPv4](CHAP_Tutorials.WebServerDB.CreateVPC.md). + Pour vous connecter depuis votre OMS à l'agent de gestion, si votre OMS ne possède pas de nom d'hôte publiquement résolu, procédez d'une des manières suivantes : + Si votre OMS est hébergé sur une instance Amazon Elastic Compute Cloud (Amazon EC2) dans un VPC privé, vous pouvez configurer un appairage de VPC pour vous connecter depuis l'OMS à l'agent de gestion. Pour plus d'informations, consultez [Une instance de base de données d’un VPC accessible par une instance EC2 d’un autre VPC](USER_VPC.Scenarios.md#USER_VPC.Scenario3). + Si votre OMS est hébergé sur site, vous pouvez configurer une connexion VPN pour autoriser l'accès entre OMS et l'agent de gestion. Pour plus d'informations, consultez [Une instance de base de données d’un VPC accessible par une application cliente via Internet](USER_VPC.Scenarios.md#USER_VPC.Scenario4) ou [Connexions VPN](https://docs.aws.amazon.com/vpc/latest/userguide/vpn-connections.html). + Pour connecter OEM Management Agent version 13.5.0.0 (v1-v3) à un hôte OMS 24.1, configurez `MINIMUM_TLS_VERSION` pour utiliser le protocole TLS 1.2 `TLSv1.2` dans vos options de configuration. ## Limitations pour Management Agent Voici quelques limitations quant à l'utilisation de Management Agent : + Vous ne pouvez pas fournir d’images personnalisées d’Oracle Management Agent. + Les tâches d'administration telles que l'exécution de tâches et l'application de correctifs de bases de données, qui nécessitent des informations d'identification de l'hôte, ne sont pas prises en charge. + Les métriques de l'hôte et la liste des processus ne reflètent pas nécessairement l'état réel du système. Par conséquent, vous ne devez pas utiliser OEM pour surveiller le système de fichiers racine ou le système de fichiers de point de montage. Pour plus d’informations sur la surveillance du système d’exploitation, consultez [Surveillance des métriques du système d’exploitation à l’aide de la Surveillance améliorée](USER_Monitoring.OS.md). + La découverte automatique n'est pas prise en charge. Vous devez ajouter manuellement les cibles de base de données. + La disponibilité du module OMS dépend de l'édition de votre base de données. Par exemple, le module de diagnostic et de réglage des performances des bases de données n'est disponible que pour Oracle Database Enterprise Edition. + Management Agent consomme des ressources de mémoire et de calcul supplémentaires. Si vous rencontrez des problèmes de performances après avoir activé l'option `OEM_AGENT`, nous vous recommandons d'augmenter la taille de la classe d'instance de base de données Pour plus d’informations, consultez [Classes d'instances de base de données ](Concepts.DBInstanceClass.md) et [Modification d'une instance de base de données Amazon RDS](Overview.DBInstance.Modifying.md). + L'utilisateur exécutant `OEM_AGENT` sur l'hôte Amazon RDS n'a pas accès au journal des alertes par le système d'exploitation. Vous ne pouvez donc pas collecter de métriques pour `DB Alert Log` et `DB Alert Log Error Status` dans OEM. ## Paramètres de l'option Management Agent Amazon RDS prend en charge les paramètres suivants pour l'option Management Agent. | Paramètre d'option | Obligatoire | Valeurs valides | Description | | --- | --- | --- | --- | | **Version** (`AGENT_VERSION`) | Oui | `13.5.0.0.v3` `13.5.0.0.v2` `13.5.0.0.v1` `13.4.0.9.v2` `13.4.0.9.v1` `13.3.0.0.v2` `13.3.0.0.v1` `13.2.0.0.v3` `13.2.0.0.v2` `13.2.0.0.v1` `13.1.0.0.v1` | La version du logiciel Management Agent. La version minimale prise en charge est `13.1.0.0.v1`. Le nom de AWS CLI l'option est`OptionVersion`. Dans les AWS GovCloud (US) régions, les versions 13.1 ne sont pas disponibles. | | **Port** (`AGENT_PORT`) | Oui | Une valeur d'entier | Le port de l'instance de base de données qui é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. Le nom de AWS CLI l'option est`Port`. | | **Groupes de sécurité** | Oui | Groupes de sécurité existants | Un groupe de sécurité qui a accès à **Port**. Votre hôte OMS doit appartenir à ce groupe de sécurité. Le nom de l' AWS CLI option est `VpcSecurityGroupMemberships` ou`DBSecurityGroupMemberships`. | | **OMS\$1HOST** | Oui | Une valeur de chaîne, par exemple *my.example.oms* | Le nom d'hôte accessible au public ou l'adresse IP de l'OMS. Le nom de AWS CLI l'option est`OMS_HOST`. | | **OMS\$1PORT** | Oui | Une valeur d'entier | Le port de chargement HTTPS de l'hôte OMS qui écoute l'agent de gestion. Pour déterminer le port de chargement the HTTPS, connectez-vous à l'hôte OMS et exécutez la commande suivante (sui nécessite le mot de passe `SYSMAN`) : emctl status oms -details Le nom de AWS CLI l'option est`OMS_PORT`. | | **AGENT\$1REGISTRATION\$1PASSWORD** | Oui | Une valeur de chaîne | Le mot de passe que l'agent de gestion utilise pour s'authentifier auprès de l'OMS. Nous vous recommandons de créer un mot de passe permanent dans votre OMS avant d'activer l'option `OEM_AGENT`. Avec un mot de passe permanent, vous pouvez partager un groupe particulier de l'option Management Agent entre plusieurs bases de données Amazon RDS. Le nom de AWS CLI l'option est`AGENT_REGISTRATION_PASSWORD`. | | **ALLOW\$1TLS\$1ONLY** | Non | `true`, `false` (par défaut) | Valeur qui configure l'agent OEM pour ne prendre en charge que le protocole `TLSv1` pendant que l'agent écoute en tant que serveur. Ce paramètre n’est plus pris en charge. Les versions 13.1.0.0.v1 et ultérieures de Management Agent prennent en charge le protocole TLS (Transport Layer Security) par défaut. | | **MINIMUM\$1TLS\$1VERSION** | Non | `TLSv1` (par défaut), `TLSv1.2` | Valeur qui spécifie la version TLS minimale prise en charge par l'agent OEM pendant que l'agent écoute en tant que serveur. Les versions qui ne sont plus prises en charge de l’agent prennent uniquement en charge le paramètre `TLSv1`. Pour connecter 13.5.0.0 (v1-v3) à un hôte OMS 24.1, définissez ce paramètre sur `TLSv1.2`. | | **TLS\$1CIPHER\$1SUITE** | Non | Consultez [Paramètres de l'option Management Agent](#Oracle.Options.OEMAgent.Options). | Valeur qui spécifie la suite de chiffrement TLS utilisée par l'agent OEM pendant que l'agent écoute en tant que serveur. | La table suivante répertorie les suites de chiffrement TLS prises en charge par l'option Management Agent. | Suite de chiffrement | Version d'Agent prise en charge | Conforme au programme FedRAMP | | --- | --- | --- | | TLS\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1SHA | Tous | Non | | TLS\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1 SHA256 | 13.1.0.0.v1 et ultérieures | Non | | TLS\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1SHA | 13.2.0.0.v3 et ultérieures | Non | | TLS\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1 SHA256 | 13.2.0.0.v3 et ultérieures | Non | | TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1SHA | 13.2.0.0.v3 et ultérieures | Oui | | TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1SHA | 13.2.0.0.v3 et ultérieures | Oui | | TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1 SHA256 | 13.2.0.0.v3 et ultérieures | Oui | | TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1 SHA384 | 13.2.0.0.v3 et ultérieures | Oui | | TLS\$1ECDHE\$1ECDSA\$1WITH\$1AES\$1256\$1GCM\$1 SHA384 | 13.4.0.9.v1 et ultérieures | Oui | | TLS\$1ECDHE\$1ECDSA\$1WITH\$1AES\$1256\$1CBC\$1 SHA384 | 13.4.0.9.v1 et ultérieures | Oui | ### 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 : | Type de certificat | Suites de chiffrement compatibles | Suites de chiffrement incompatibles | | --- | --- | --- | | Certificats RSA (rds-ca-2019, 2048-g1, 4096-g1) rds-ca-rsa rds-ca-rsa | TLS\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1SHA TLS\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1 SHA256 TLS\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1SHA TLS\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1 SHA256 TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1SHA TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1SHA TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1 SHA256 TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1 SHA384 | TLS\$1ECDHE\$1ECDSA\$1WITH\$1AES\$1256\$1GCM\$1 SHA384 TLS\$1ECDHE\$1ECDSA\$1WITH\$1AES\$1256\$1CBC\$1 SHA384 | | Certificats ECDSA (384-g1) rds-ca-ecc | TLS\$1ECDHE\$1ECDSA\$1WITH\$1AES\$1256\$1GCM\$1 SHA384 TLS\$1ECDHE\$1ECDSA\$1WITH\$1AES\$1256\$1CBC\$1 SHA384 | TLS\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1SHA TLS\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1 SHA256 TLS\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1SHA TLS\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1 SHA256 TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1SHA TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1SHA TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1 SHA256 TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1 SHA384 | 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 : **Topics** + [Étape 1 : Ajout de l’option Management Agent à votre instance de base de données](#Oracle.Options.OEMAgent.Add) + [Étape 2 : Déverrouillage du compte utilisateur DBSNMP](#Oracle.Options.OEMAgent.DBSNMP) + [Étape 3 : Ajout de vos cibles à la console Management Agent](#Oracle.Options.OEMAgent.Using) ### É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 : 1. Créer un groupe d’options ou copier ou modifier un groupe existant. 1. Ajoutez l'option au groupe d'options. 1. Associez le groupe d'options à l'instance de base de données. Si des erreurs se produisent, vous pouvez consulter les documents [My Oracle Support](https://support.oracle.com/) 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](https://support.oracle.com/epmos/faces/DocContentDisplay?id=2202569.1). #### Console **Pour ajouter l’option Management Agent à votre instance de base de données** 1. Déterminez le groupe d’options que vous voulez utiliser. Vous pouvez créer un groupe d'options ou utiliser un groupe d'options existant. Si vous souhaitez utiliser un groupe d'options existant, passez à l'étape suivante. Sinon, créez un groupe d'options DB personnalisé avec les paramètres suivants : 1. Pour **Moteur**, choisissez l'édition oracle pour votre instance de base de données. 1. Pour **Version majeure du moteur**, choisissez la version de votre instance de base de données. Pour plus d'informations, consultez [Création d’un groupe d’options](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.Create). 1. Ajoutez l'option **OEM\$1AGENT** pour le groupe d'options et configurez les paramètres de l'option. Pour plus d'informations sur l'ajout d'options, consultez [Ajout d’une option à un groupe d’options](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.AddOption). Pour plus d'informations sur chaque paramètre, consultez [Paramètres de l'option Management Agent](#Oracle.Options.OEMAgent.Options). 1. Appliquez le groupe d'options à une instance de base de données nouvelle ou existante: + Pour une nouvelle instance de base de données, vous appliquez le groupe d'options lorsque vous lancez l'instance. Pour plus d’informations, consultez [Création d'une instance de base de données Amazon RDS](USER_CreateDBInstance.md). + Pour une instance de base de données existante, vous appliquez le groupe d'options en modifiant l'instance et en attachant le nouveau groupe d'options. Pour de plus amples informations, veuillez consulter [Modification d'une instance de base de données Amazon RDS](Overview.DBInstance.Modifying.md). #### AWS CLI L'exemple suivant utilise la commande AWS CLI [add-option-to-option-group](https://docs.aws.amazon.com/cli/latest/reference/rds/add-option-to-option-group.html) pour ajouter l'`OEM_AGENT`option à un groupe d'options appelé`myoptiongroup`. Pour Linux, macOS ou Unix : ``` 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 ``` Pour Windows : ``` 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. **Pour déverrouiller le compte utilisateur DBSNMP** 1. Dans SQL\$1Plus ou une autre application Oracle SQL, connectez-vous en tant qu’utilisateur principal à votre instance de base de données. 1. Procédez comme suit, en fonction de l’architecture de la base de données : **Votre base de données est non-CDB.** Utilisez l’instruction SQL suivante : ``` 1. ALTER USER dbsnmp IDENTIFIED BY new_password ACCOUNT UNLOCK; ``` **Votre base de données est une CDB.** Exécutez la procédure stockée suivante pour déverrouiller le compte `DBSNMP` : ``` 1. EXEC rdsadmin.rdsadmin_util.reset_oem_agent_password('new_password'); ``` Si vous recevez un message d’erreur indiquant que la procédure n’existe pas, redémarrez votre instance CDB pour l’installer automatiquement. Pour plus d’informations, consultez [Redémarrage d'une instance de base de données cluster de base de données](USER_RebootInstance.md). ### É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](USER_Endpoint.md). Si votre base de données utilise l’architecture CDB, ajoutez le conteneur `CDB$ROOT` séparément en tant que cible. **Pour ajouter des cibles à la console Management Agent** 1. Dans la console OMS, choisissez **Setup (Configuration)**, **Add Target (Ajouter une cible)**, **Add Targets Manually (Ajouter des cibles manuellement)**. 1. Choisissez **Add Targets Declaratively by Specifying Target Monitoring Properties (Ajouter déclarativement des cibles en spécifiant les propriétés de surveillance cibles)**. 1. Pour **Target Type (Type de cible)**, choisissez **Database Instance (Instance de base de données)**. 1. Pour **Monitoring Agent (Agent de surveillance)**, sélectionnez l'agent ayant le même identifiant que votre identifiant d'instance de base de données RDS. 1. Choisissez **Add Manually (Ajouter manuellement)**. 1. Entrez le point de terminaison de votre instance de base de données Amazon RDS ou sélectionnez-le dans la liste de noms d’hôte. Vérifiez que le nom d'hôte spécifié correspond au point de terminaison de l'instance de base de données Amazon RDS. 1. Spécifiez les propriétés de base de données suivantes : + Pour **Target Name (Nom de la cible)**, entrez un nom. + Pour **Database system name (Nom du système de base de données)**, entrez un nom. + Pour **Monitor username (Nom d'utilisateur de surveillance)**, entrez **dbsnmp**. + Pour **Mot de passe de surveillance**, entrez le mot de passe de [Étape 2 : Déverrouillage du compte utilisateur DBSNMP](#Oracle.Options.OEMAgent.DBSNMP). + Pour **Role (Rôle)**, entrez **normal**. + Pour **Oracle home path (Chemin d'origine Oracle)**, entrez **/oracle**. + Pour **Listener Machine name (Nom de machine d'écouteur)**, l'identifiant de l'agent est déjà affiché. + Pour **Port**, entrez le port de la base de données. La port RDS par défaut est 1521. + Pour **Database name (Nom de la base de données)**, entrez le nom de votre base de données. Si votre base de données est une CDB, ce nom est `RDSCDB`. 1. Choisissez **Test Connection (Connexion test)**. 1. Choisissez **Suivant**. La base de données cible apparaît dans votre liste de ressources surveillées. ## 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 : + Supprimez l'option OEM Agent du groupe d'options auquel elle appartient. Ce changement affecte toutes les instances de bases de données qui utilisent le groupe d'options. Pour plus d'informations, consultez [Suppression d’une option d’un groupe d’options](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.RemoveOption). + Modifiez l'instance de base de données et spécifiez un groupe d'options différent qui n'inclut pas l'option OEM Agent. Ce changement affecte une seule instance de base de données. Vous pouvez spécifier le groupe d’options (vide) par défaut, ou un groupe d’options personnalisées différent. Pour plus d’informations, consultez [Modification d'une instance de base de données Amazon RDS](Overview.DBInstance.Modifying.md). ## 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. **Note** Les tâches sont exécutées de manière asynchrone. **Topics** + [Sécurisation de Management Agent](#Oracle.Options.OEMAgent.DBTasks.SecureAgent) + [Obtenir le statut de l'agent de gestion](#Oracle.Options.OEMAgent.DBTasks.GetAgentStatus) + [Redémarrage du Management Agent](#Oracle.Options.OEMAgent.DBTasks.RestartAgent) + [Liste des cibles surveillées par le Management Agent](#Oracle.Options.OEMAgent.DBTasks.ListTargets) + [Constitution de la liste des threads de collecte surveillés par Management Agent](#Oracle.Options.OEMAgent.DBTasks.ListCollectionThreads) + [Suppression de l'état du Management Agent](#Oracle.Options.OEMAgent.DBTasks.ClearState) + [Chargement de l'OMS par le Management Agent](#Oracle.Options.OEMAgent.DBTasks.ForceUploadOMS) + [Envoi de la commande Ping vers l'OMS](#Oracle.Options.OEMAgent.DBTasks.PingOMS) + [Affichage du statut d'une tâche en cours](#Oracle.Options.OEMAgent.DBTasks.ViewTaskStatus) ### 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](#Oracle.Options.OEMAgent.DBTasks.ViewTaskStatus). ### 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](#Oracle.Options.OEMAgent.DBTasks.ViewTaskStatus). ### 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](#Oracle.Options.OEMAgent.DBTasks.ViewTaskStatus). ### 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](#Oracle.Options.OEMAgent.DBTasks.ViewTaskStatus). ### 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](#Oracle.Options.OEMAgent.DBTasks.ViewTaskStatus). ### 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](#Oracle.Options.OEMAgent.DBTasks.ViewTaskStatus). ### 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](#Oracle.Options.OEMAgent.DBTasks.ViewTaskStatus). ### 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](#Oracle.Options.OEMAgent.DBTasks.ViewTaskStatus). ### 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](Appendix.Oracle.CommonDBATasks.Misc.md#Appendix.Oracle.CommonDBATasks.ReadingFiles).