

# Oracle Enterprise Manager
<a name="Oracle.Options.OEM"></a>

Amazon RDS es compatible con Oracle Enterprise Manager (OEM). OEM es la línea de productos de Oracle para la administración integrada de tecnología de la información empresarial. 

Amazon RDS solo admite OEM en Oracle Database 19c (CDB o no CDB). En la tabla siguiente se describen las opciones de OEM admitidas.


****  

| Opción | ID de la opción | Versiones OEM compatibles | 
| --- | --- | --- | 
|  [OEM Database Express](Appendix.Oracle.Options.OEM_DBControl.md)  |  `OEM`  |  OEM Database Express 19c  | 
|  [OEM Management Agent](Oracle.Options.OEMAgent.md)  |  `OEM_AGENT`  |  OEM Cloud Control for 13c  | 

**nota**  
Puede utilizar OEM Database u OEM Management Agent, pero no ambos.

# Oracle Enterprise Manager Database Express
<a name="Appendix.Oracle.Options.OEM_DBControl"></a>

Amazon RDS es compatible con Oracle Enterprise Manager Database Express (EM Express) mediante la opción OEM. Amazon RDS admite EM Express para Oracle Database 19c tanto con la arquitectura de CDB como con una arquitectura que no sea de CDB.

EM Express es una herramienta web de administración de bases de datos que está incluida en su base de datos y que solo está disponible cuando está abierta. Es compatible con las funciones clave de administración del rendimiento y de administración básica de bases de datos. Para obtener más información, consulte [Introduction to Oracle Enterprise Manager Database Express](https://docs.oracle.com/en/database/oracle/oracle-database/19/admqs/getting-started-with-database-administration.html#GUID-BA75AD46-D22E-4914-A31E-C395CD6A2BBA) en la documentación de Oracle Database.

**nota**  
No se admite EM Express para la clase de instancia de base de datos db.t3.small. Para obtener más información sobre las clases de instancias de bases de datos, consulte [Clases de instancias de base de datos de RDS para Oracle](Oracle.Concepts.InstanceClasses.md).

## Configuración de la opción OEM
<a name="Appendix.Oracle.Options.OEM_DBControl.Options"></a>

Amazon RDS admite los siguientes valores para las opciones de OEM. 


****  

| Ajuste de la opción | Valores válidos | Descripción | 
| --- | --- | --- | 
| **Puerto** | Un valor entero |  El puerto en la instancia de base de datos de RDS para Oracle que escucha para EM Express. El valor predeterminado es 5500.  | 
| **Grupos de seguridad de** | — |  Un grupo de seguridad que tiene acceso a **Port**.   | 

## Paso 1: añadir la opción OEM
<a name="Appendix.Oracle.Options.OEM_DBControl.Add"></a>

El proceso general para añadir la opción OEM a una instancia de base de datos es el siguiente: 

1. Cree un grupo de opciones nuevo o copie o modifique un grupo de opciones existente.

1. Añada la opción al grupo de opciones.

1. Asocie el grupo de opciones con la instancia de base de datos.

Cuando se agrega la opción OEM, se produce una breve interrupción mientras la instancia de base de datos se reinicia automáticamente. 

**Para añadir la opción OEM a una instancia de base de datos**

1. Determine el grupo de opciones que desea utilizar. Puede crear un grupo de opciones o utilizar uno existente. Si desea utilizar un grupo de opciones existente, vaya al siguiente paso. De lo contrario, cree un grupo de opciones de base de datos personalizado con las siguientes opciones: 

   1. En **Engine**, elija la edición de Oracle que corresponda a la instancia de base de datos. 

   1. En **Major engine version (Versión principal del motor)**, elija la versión de su instancia de base de datos. 

   Para obtener más información, consulte [Creación de un grupo de opciones](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.Create). 

1. Añada la opción OEM al grupo de opciones y ajuste la configuración de opciones. Para obtener más información acerca de la adición de opciones, consulte [Agregar una opción a un grupo de opciones](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.AddOption). Para obtener más información acerca de cada opción, consulte [Configuración de la opción OEM](#Appendix.Oracle.Options.OEM_DBControl.Options). 
**nota**  
Si agrega la opción OEM a un grupo de opciones existente que ya se ha adjuntado a una o varias instancias de base de datos, se producirá una breve interrupción mientras reinician todas las instancias de base de datos. 

1. Aplique el grupo de opciones a una instancia de base de datos nueva o existente:
   + Si se trata de una instancia de base de datos nueva, aplique el grupo de opciones al lanzar la instancia. Para obtener más información, consulte [Creación de una instancia de base de datos de Amazon RDS](USER_CreateDBInstance.md). 
   + Para una instancia de base de datos existente, el grupo de opciones se aplica modificando la instancia y asociando el grupo de opciones nuevo. Cuando se agrega la opción OEM, se produce una breve interrupción mientras la instancia de base de datos se reinicia automáticamente. Para obtener más información, consulte [Modificación de una instancia de base de datos de Amazon RDS](Overview.DBInstance.Modifying.md). 

**nota**  
También puede utilizar la AWS CLI para agregar la opción OEM. Para ver ejemplos, consulte [Agregar una opción a un grupo de opciones](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.AddOption).

## Paso 2 (solo CDB): desbloquear la cuenta de usuario de DBSNMP
<a name="Appendix.Oracle.Options.OEM_DBControl.DBSNMP"></a>

Si su instancia de base de datos utiliza la arquitectura de CDB, debe iniciar sesión en EM Express como `DBSNMP`. En una CDB, `DBSNMP` es un usuario común. De forma predeterminada, esta cuenta está bloqueada. Si la instancia de base de datos no utiliza la arquitectura de CDB, omita este paso.

**Desbloqueo de la cuenta de usuario de DBSNMP en una instancia de CDB**

1. En SQL\$1Plus u otra aplicación de Oracle SQL, inicie sesión como usuario maestro en su instancia de base de datos.

1. Ejecute el siguiente procedimiento almacenado para desbloquear la cuenta de `DBSNMP`:

   ```
   1. EXEC rdsadmin.rdsadmin_util.reset_oem_agent_password('new_password');
   ```

   Si recibe un error que indica que el procedimiento no existe, reinicie la instancia de CDB para instalarla automáticamente. Para obtener más información, consulte [Reinicio de una instancia de base de datos ](USER_RebootInstance.md).

## Paso 3: acceder a EM Express a través del navegador
<a name="Appendix.Oracle.Options.OEM_DBControl.Using"></a>

Cuando se accede a EM Express desde un navegador web, aparece una ventana de inicio de sesión que solicita un nombre de usuario y una contraseña.

**Acceso a EM Express a través del navegador**

1. Identifique el punto de conexión y el puerto de EM Express de su instancia de base de datos de Amazon RDS. Para obtener información acerca de cómo encontrar el punto de enlace de su instancia de base de datos de Amazon RDS, consulte [Búsqueda del punto de conexión de la instancia de base de datos de RDS para Oracle](USER_Endpoint.md).

1. Introduzca una URL en la barra de localización del navegador con el siguiente formato. 

   ```
   https://endpoint.rds.amazonaws.com:port/em
   ```

   Por ejemplo, si el punto de conexión de la instancia de base de datos de Amazon RDS es `mydb.a1bcde234fgh.us-east-1.rds.amazonaws.com` y el puerto de EM Express es `1158`, use la siguiente URL para acceder a EM Express.

   ```
   1. https://mydb.f9rbfa893tft.us-east-1.rds.amazonaws.com:1158/em
   ```

1. Cuando se le pida la información de inicio de sesión, lleve a cabo alguna de las siguientes acciones, dependiendo de la arquitectura de la base de datos:  
**La base de datos no es de CDB.**  
Escriba el nombre de usuario maestro y la contraseña maestra para la instancia de base de datos.  
**La base de datos es de CDB.**  
Introduzca `DBSNMP` como usuario y la contraseña de `DBSNMP`. Deje vacío el campo `Container`.

## Modificación de la configuración de OEM Database
<a name="Appendix.Oracle.Options.OEM_DBControl.ModifySettings"></a>

Después de activar OEM Database, puede modificar la configuración de grupos de seguridad de la opción. 

No se puede modificar el número de puerto de OEM después de asociar el grupo de opciones una instancia de base de datos. Para cambiar el número de puerto de OEM de una instancia de base de datos, haga lo siguiente: 

1. Cree un nuevo grupo de opciones.

1. Añada la opción OEM con el nuevo número de puerto al grupo de opciones. 

1. Elimine el grupo de opciones existente de la instancia de base de datos.

1. Añada el grupo de opciones nuevo a la instancia de base de datos.

Para obtener más información acerca de cómo modificar la configuración de las opciones, consulte [Modificación de una configuración de opciones](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.ModifyOption). Para obtener más información acerca de cada opción, consulte [Configuración de la opción OEM](#Appendix.Oracle.Options.OEM_DBControl.Options). 

## Ejecución de tareas OEM Database Express
<a name="Appendix.Oracle.Options.OEM_DBControl.DBTasks"></a>

Puede utilizar los procedimientos de Amazon RDS para ejecutar determinadas tareas de OEM Database Express. Al ejecutar estos procedimientos, puede hacer las tareas que se enumeran a continuación.

**nota**  
Las tareas de OEM Database Express se ejecutan de forma asíncrona.

**Topics**
+ [Cambio del front-end del sitio web para OEM Database Express a Adobe Flash](#Appendix.Oracle.Options.OEM_DBControl.DBTasks.FrontEndToFlash)
+ [Cambio del front-end del sitio web para OEM Database Express a Oracle JET](#Appendix.Oracle.Options.OEM_DBControl.DBTasks.FrontEndToOracleJET)

### Cambio del front-end del sitio web para OEM Database Express a Adobe Flash
<a name="Appendix.Oracle.Options.OEM_DBControl.DBTasks.FrontEndToFlash"></a>

**nota**  
Esta tarea solo está disponible para Oracle Database 19c no CDB.

A partir de Oracle Database 19c, Oracle ha dado de baja la antigua interfaz de usuario de OEM Database Express, que se basaba en Adobe Flash. En su lugar, OEM Database Express utiliza ahora una interfaz creada con Oracle JET. Si tiene dificultades con la nueva interfaz, puede volver a la interfaz basada en Flash obsoleta. Las dificultades que puede tener con la nueva interfaz incluyen quedarse atascado en una pantalla `Loading` después de iniciar sesión en OEM Database Express. También puede perder ciertas características que estaban presentes en la versión basada en Flash de OEM Database Express.

Para cambiar el front-end del sitio web de OEM Database Express a Adobe Flash, ejecute el procedimiento de Amazon RDS `rdsadmin.rdsadmin_oem_tasks.em_express_frontend_to_flash`. Este procedimiento es equivalente al comando `execemx emx` de SQL.

Las prácticas recomendadas de seguridad desalientan el uso de Adobe Flash. Aunque puede volver a OEM Database Express basado en Flash, se recomienda el uso de los sitios web de OEM Database Express basados en JET si es posible. Si vuelve a utilizar Adobe Flash y desea volver a Oracle JET, utilice el procedimiento `rdsadmin.rdsadmin_oem_tasks.em_express_frontend_to_jet`. Después de una actualización de la base de datos Oracle, una versión más reciente de Oracle JET podría resolver problemas relacionados con JET en OEM Database Express. Para obtener más información sobre cómo cambiar a Oracle JET, consulte [Cambio del front-end del sitio web para OEM Database Express a Oracle JET](#Appendix.Oracle.Options.OEM_DBControl.DBTasks.FrontEndToOracleJET).

**nota**  
La ejecución de esta tarea desde la instancia de base de datos de origen para una réplica de lectura también hace que la réplica de lectura cambie sus front-ends del sitio web de OEM Database Express a Adobe Flash.

La siguiente invocación del procedimiento crea una tarea para cambiar el sitio web de OEM Database Express a Adobe Flash y devuelve el ID de la tarea.

```
SELECT rdsadmin.rdsadmin_oem_tasks.em_express_frontend_to_flash() as TASK_ID from DUAL;
```

Para ver el resultado, visualice el archivo de salida de la tarea.

```
SELECT text FROM table(rdsadmin.rds_file_util.read_text_file('BDUMP','dbtask-task-id.log'));
```

Reemplace *`task-id`* con el ID de tarea devuelto por el procedimiento. Si necesita más información sobre el procedimiento `rdsadmin.rds_file_util.read_text_file` de Amazon RDS, consulte [Lectura de archivos de un directorio de instancia de base de datos](Appendix.Oracle.CommonDBATasks.Misc.md#Appendix.Oracle.CommonDBATasks.ReadingFiles) 

También puede ver el contenido del archivo de salida de la tarea en la Consola de administración de AWS buscando las entradas de registro en las sección **Logs & events (Registros y eventos)** de la `task-id`.

### Cambio del front-end del sitio web para OEM Database Express a Oracle JET
<a name="Appendix.Oracle.Options.OEM_DBControl.DBTasks.FrontEndToOracleJET"></a>

**nota**  
Esta tarea solo está disponible para Oracle Database 19c no CDB.

Para cambiar el front-end del sitio web de OEM Database Express a Oracle JET, ejecute el procedimiento de Amazon RDS `rdsadmin.rdsadmin_oem_tasks.em_express_frontend_to_jet`. Este procedimiento es equivalente al comando `execemx omx` de SQL.

De forma predeterminada, los sitios web de OEM Database Express para instancias de base de datos Oracle que ejecutan 19c o versiones posteriores utilizan Oracle JET. Si ha utilizado el procedimiento `rdsadmin.rdsadmin_oem_tasks.em_express_frontend_to_flash` para cambiar el front-end del sitio web de OEM Database Express a Adobe Flash, puede cambiar de nuevo a Oracle JET. Para hacer esto, utilice el procedimiento `rdsadmin.rdsadmin_oem_tasks.em_express_frontend_to_jet`. Para obtener más información sobre cómo cambiar a Adobe Flash, consulte [Cambio del front-end del sitio web para OEM Database Express a Adobe Flash](#Appendix.Oracle.Options.OEM_DBControl.DBTasks.FrontEndToFlash).

**nota**  
La ejecución de esta tarea desde la instancia de base de datos de origen para una réplica de lectura también hace que la réplica de lectura cambie sus front-ends del sitio web de OEM Database Express a Oracle JET.

La siguiente invocación del procedimiento crea una tarea para cambiar el sitio web de OEM Database Express a Oracle JET y devuelve el ID de la tarea.

```
SELECT rdsadmin.rdsadmin_oem_tasks.em_express_frontend_to_jet() as TASK_ID from DUAL;
```

Para ver el resultado, visualice el archivo de salida de la tarea.

```
SELECT text FROM table(rdsadmin.rds_file_util.read_text_file('BDUMP','dbtask-task-id.log'));
```

Reemplace *`task-id`* con el ID de tarea devuelto por el procedimiento. Si necesita más información sobre el procedimiento `rdsadmin.rds_file_util.read_text_file` de Amazon RDS, consulte [Lectura de archivos de un directorio de instancia de base de datos](Appendix.Oracle.CommonDBATasks.Misc.md#Appendix.Oracle.CommonDBATasks.ReadingFiles) 

También puede ver el contenido del archivo de salida de la tarea en la Consola de administración de AWS buscando las entradas de registro en las sección **Logs & events (Registros y eventos)** de la `task-id`.

## Eliminación de la opción OEM Database
<a name="Appendix.Oracle.Options.OEM_DBControl.Remove"></a>

Puede eliminar la opción OEM de una instancia de base de datos. Cuando se elimina las opción OEM, se produce una breve interrupción mientras la instancia se reinicia automáticamente. Por lo tanto, después de eliminar la opción OEM, no es necesario reiniciar la instancia de base de datos.

Para eliminar la opción OEM de una instancia de base de datos, realice una de las siguientes operaciones:
+ Elimine la opción OEM del grupo de opciones al que pertenece. Este cambio afecta a todas las instancias de base de datos que utilizan el grupo de opciones. Para obtener más información, consulte [Quitar una opción de un grupo de opciones](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.RemoveOption). 
+ Modifique la instancia de base de datos y especifique otro grupo de opciones que no incluya la opción OEM. Este cambio afecta a una única instancia de base de datos. Puede especificar el grupo de opciones predeterminado (vacío) u otro grupo de opciones personalizado. Para obtener más información, consulte [Modificación de una instancia de base de datos de Amazon RDS](Overview.DBInstance.Modifying.md). 

# Oracle Management Agent para Enterprise Manager Cloud Control
<a name="Oracle.Options.OEMAgent"></a>

Oracle Enterprise Manager (OEM) Management Agent es un componente de software que monitoriza destinos que se ejecutan en hosts y comunica esa información al nivel intermedio de Oracle Management Service (OMS). Amazon RDS es compatible con Management Agent mediante el uso de la opción `OEM_AGENT`. 

Para obtener más información, consulte [Overview of Oracle Enterprise Manager Cloud Control 12c](http://docs.oracle.com/cd/E24628_01/doc.121/e25353/overview.htm) y [Overview of Oracle Enterprise Manager Cloud Control 13c](http://docs.oracle.com/cd/E63000_01/EMCON/overview.htm#EMCON109) en la documentación de Oracle.

**Topics**
+ [Requisitos de Management Agent](#Oracle.Options.OEMAgent.PreReqs)
+ [Requisitos previos de comunicación del host de OMS](#Oracle.Options.OEMAgent.PreReqs.host)
+ [Limitaciones de Management Agent](#Oracle.Options.OEMAgent.limitations)
+ [Configuración de opción de Management Agent](#Oracle.Options.OEMAgent.Options)
+ [Habilitación de la opción del agente de gestión a la instancia de base de datos](#Oracle.Options.OEMAgent.Enable)
+ [Eliminar la opción de Management Agent](#Oracle.Options.OEMAgent.Remove)
+ [Realización de tareas de base de datos con Management Agent](#Oracle.Options.OEMAgent.DBTasks)

## Requisitos de Management Agent
<a name="Oracle.Options.OEMAgent.PreReqs"></a>

A continuación, se indican los requisitos generales para utilizar Management Agent: 
+ Su instancia de base de datos debe ejecutar Oracle Database 19c (19.0.0.0). Puede utilizar la arquitectura de CDB o no CDB.
+ Debe utilizar un Oracle Management Service (OMS) configurado para conectarse a su instancia de base de datos. Tenga en cuenta los siguientes requisitos de OMS:
  + Las versiones 13.5.0.0.v2 y 13.5.0.0.v3 del agente de gestión requieren la versión 13.5.0.23 o 24.1 de OMS.
  + La versión 13.5.0.0.v1 del agente de gestión requiere la versión 13.5.0.0 o 24.1 de OMS.
  + Las versiones 13.4.0.9.v1 y 13.4.0.9.v2 del agente de gestiones requieren la versión 13.4.0.9 o posterior de OMS y el parche 32198287.
+ En la mayoría de los casos, debe configurar la VPC para permitir conexiones desde OMS a su instancia de base de datos. Si no está familiarizado con Amazon Virtual Private Cloud (Amazon VPC), le recomendamos que antes de seguir realice los pasos que aparecen en [Tutorial: Creación de una VPC para utilizarla con una instancia de base de datos (solo IPv4)](CHAP_Tutorials.WebServerDB.CreateVPC.md). 
+ Puede utilizar Management Agent con Oracle Enterprise Manager Cloud Control para 12c y 13c. Asegúrese de que dispone de suficiente espacio de almacenamiento para su versión de OEM:
  + Al menos 8,5 GiB para OEM 13c versión 5
  + Al menos 8,5 GiB para OEM 13c versión 4
  + Al menos 8,5 GiB para OEM 13c versión 3
  + Al menos 5,5 GiB para OEM 13c versión 2
  + Al menos 4,5 GiB para OEM 13c versión 1
  + Al menos 2,5 GiB para OEM 12c
+ Si utiliza las versiones `OEM_AGENT 13.2.0.0.v3` y `13.3.0.0.v2` de Management Agent y desea utilizar la conectividad de TCPS, siga las instrucciones de [Configuración de certificados de entidades de certificación externas para la comunicación con las bases de datos de destino](https://docs.oracle.com/cd/E73210_01/EMSEC/GUID-8337AD48-1A32-4CD5-84F3-256FAE93D043.htm#EMSEC15996) que figura en la documentación de Oracle. Además, actualice el JDK en su OMS siguiendo las instrucciones en el documento de Oracle con el Doc ID 2241358.1 de Oracle. Este paso garantiza que OMS sea compatible con todos los conjuntos de cifrado compatibles con la base de datos.
**nota**  
La conectividad TCPS entre Management Agent y la instancia de base de datos solo es compatible para las versiones `OEM_AGENT 13.2.0.0.v3`, `13.3.0.0.v2`, `13.4.0.9.v1` y posteriores de Management Agent.

## Requisitos previos de comunicación del host de OMS
<a name="Oracle.Options.OEMAgent.PreReqs.host"></a>

Asegúrese de que su host de OMS y su instancia de base de datos de Amazon RDS puedan comunicarse. Haga lo siguiente: 
+ Para conectarse desde Management Agent al host de OMS cuando este se encuentre detrás de un firewall, agregue las direcciones IP de las instancias de base de datos al firewall. Asegúrese de que el firewall del OMS permita el siguiente tráfico de red:  
Desde el host de OMS a la instancia de base de datos  
Configure una regla de firewall unidireccional que permita el tráfico del host de OMS al puerto del oyente de base de datos (valor predeterminado 1521) y el puerto de OEM Agent (valor predeterminado 3872).  
Desde la instancia de base de datos al host de OMS  
Configure una regla de firewall unidireccional que permita el tráfico desde la instancia de base de datos al puerto HTTP de OMS (el valor predeterminado es 4903).
+ Para conectarse desde OMS a Management Agent, si OMS tiene un nombre de host que se pueda resolver públicamente, debe agregar la dirección de OMS a un grupo de seguridad. El grupo de seguridad debe tener reglas de entrada que permitan el acceso al puerto del agente de escucha de base de datos y al puerto de Management Agent. Para ver un ejemplo de cómo crear una regla de seguridad y agregar reglas de entrada, consulte [Tutorial: Creación de una VPC para utilizarla con una instancia de base de datos (solo IPv4)](CHAP_Tutorials.WebServerDB.CreateVPC.md). 
+ Para conectarse desde OMS a Management Agent, si OMS no tiene un nombre de host que se pueda resolver públicamente, utilice uno de los siguientes: 
  + Si OMS se hospeda en una instancia de Amazon Elastic Compute Cloud (Amazon EC2) en una VPC privada, puede configurar la interconexión de VPC para conectarse desde OMS a Management Agent. Para obtener más información, consulte [Acceso a una instancia de base de datos en una VPC desde una instancia EC2 de otra VPC](USER_VPC.Scenarios.md#USER_VPC.Scenario3). 
  + Si OMS se hospeda localmente, puede configurar una conexión de VPN para permitir el acceso desde OMS a Management Agent. Para obtener más información, consulte [Acceso a una instancia de base de datos en una VPC desde una aplicación cliente a través de internet](USER_VPC.Scenarios.md#USER_VPC.Scenario4) o [Conexiones de VPN](https://docs.aws.amazon.com/vpc/latest/userguide/vpn-connections.html). 
+ Para conectar la versión 13.5.0.0 (v1-v3) del agente de gestión de OEM a un host de OMS 24.1, configure `MINIMUM_TLS_VERSION` para usar el protocolo de TLS 1.2 `TLSv1.2` en las opciones de configuración.

## Limitaciones de Management Agent
<a name="Oracle.Options.OEMAgent.limitations"></a>

A continuación se indican algunas limitaciones al utilizar Management Agent: 
+ No puede proporcionar imágenes personalizadas de Oracle Management Agent.
+ No se admiten las tareas administrativas, como la ejecución de tareas y la aplicación de parches a la base de datos, que requieren credenciales de host. 
+ No se garantiza que las métricas de host y la lista de procesos reflejen el estado real del sistema. Por lo tanto, no debe utilizar OEM para monitorear el sistema de archivos raíz o el sistema de archivos de punto de montaje. Para obtener más información acerca de cómo monitorear el sistema operativo, consulte [Supervisión de las métricas del sistema operativo con Supervisión mejorada](USER_Monitoring.OS.md).
+ La detección automática es incompatible. Los destinos de base de datos deben agregarse manualmente. 
+ La disponibilidad del módulo OMS depende de la edición de su base de datos. Por ejemplo, el módulo de ajuste y diagnóstico de desempeño de la base de datos solo está disponible para Oracle Database Enterprise Edition. 
+ Management Agent consume memoria adicional y recursos informáticos. Si tiene problemas de rendimiento después de habilitar la opción `OEM_AGENT`, recomendamos que realice una ampliación a una clase de instancia de base de datos más grande. Para obtener más información, consulte [Clases de instancia de base de datos de ](Concepts.DBInstanceClass.md) y [Modificación de una instancia de base de datos de Amazon RDS](Overview.DBInstance.Modifying.md). 
+ El usuario que ejecuta `OEM_AGENT` en el host de Amazon RDS no tiene acceso de sistema operativo al registro de alertas. Por lo tanto, no puede recopilar métricas para `DB Alert Log` y `DB Alert Log Error Status` en OEM.

## Configuración de opción de Management Agent
<a name="Oracle.Options.OEMAgent.Options"></a>

Amazon RDS admite la siguiente configuración para la opción de Management Agent.


| Ajuste de la opción | Obligatorio | Valores válidos | Descripción | 
| --- | --- | --- | --- | 
|  **Version** (`AGENT_VERSION`)  |  Sí  |  `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 versión del software Management Agent. La versión mínima compatible es `13.1.0.0.v1`. El nombre de la opción de la AWS CLI es `OptionVersion`.  En las regiones AWS GovCloud (US), las versiones 13.1 no están disponibles.   | 
|  **Port** (`AGENT_PORT`)  |  Sí  |  Un valor entero  |  El puerto en la instancia de base de datos que escucha el host de OMS. El valor predeterminado es 3872. El host de OMS debe pertenecer a un grupo de seguridad que tenga acceso a este puerto.  El nombre de la opción de la AWS CLI es `Port`.  | 
|  **Grupos de seguridad de**  |  Sí  |  Grupos de seguridad existentes  |  Un grupo de seguridad que tiene acceso a **Port**. El host de OMS debe pertenecer a este grupo de seguridad.  El nombre de la opción de la AWS CLI es `VpcSecurityGroupMemberships` o `DBSecurityGroupMemberships`.  | 
|  **OMS\$1HOST**  |  Sí  |  Un valor de cadena, por ejemplo *my.example.oms*   |  El nombre de host accesible públicamente o la dirección IP de OMS.  El nombre de la opción de la AWS CLI es `OMS_HOST`.  | 
|  **OMS\$1PORT**  |  Sí  |  Un valor entero  |  El puerto de carga HTTPS en el host de OMS que escucha el Management Agent.  Para determinar el puerto de carga HTTPS, conéctese al host de OMS y ejecute el siguiente comando (que requiere la contraseña de `SYSMAN`): emctl status oms -details  El nombre de la opción de la AWS CLI es `OMS_PORT`.  | 
|  **AGENT\$1REGISTRATION\$1PASSWORD**  |  Sí  |  Un valor de cadena  |  La contraseña que Management Agent utiliza para autenticarse en OMS. Recomendamos que cree una contraseña persistente en OMS antes de habilitar la opción `OEM_AGENT`. Con una contraseña persistente puede compartir un grupo de opción de Management Agent individual entre múltiples bases de datos de Amazon RDS.  El nombre de la opción de la AWS CLI es `AGENT_REGISTRATION_PASSWORD`.  | 
|  **ALLOW\$1TLS\$1ONLY**  |  No  |  `true`, `false` (predeterminado)  |  Un valor que configura el agente de OEM para que solo admita el protocolo `TLSv1` mientras el agente escucha como un servidor. Este ajuste ya no es compatible. Las versiones 13.1.0.0.v1 y superiores de Management Agent admiten seguridad de la capa de transporte (TLS) de forma predeterminada.   | 
|  **MINIMUM\$1TLS\$1VERSION**  |  No  |  `TLSv1` (predeterminado), `TLSv1.2`  |  Un valor que especifica la versión mínima de TLS admitida por el agente de OEM mientras el agente escucha como un servidor. Las versiones que ya no son compatibles del agente solo admiten la configuración `TLSv1`. Para conectar la versión 13.5.0.0 (v1-v3) a un host de OMS 24.1, configúrelo en `TLSv1.2`.  | 
|  **TLS\$1CIPHER\$1SUITE**  |  No  |  Consulte [Configuración de opción de Management Agent](#Oracle.Options.OEMAgent.Options).  |  Un valor que especifica el conjunto de cifrado TLS utilizado por el agente de OEM mientras el agente escucha como un servidor.   | 

La siguiente tabla muestra los conjuntos de cifrado TLS que admite la opción Management Agent.


| Conjunto de cifrado | Versión del agente admitida | Conforme con FedRAMP | 
| --- | --- | --- | 
| TLS\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1SHA | Todos | No | 
| TLS\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1SHA256 | 13.1.0.0.v1 y versiones posteriores | No | 
| TLS\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1SHA | 13.2.0.0.v3 y versiones posteriores | No | 
| TLS\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1SHA256 | 13.2.0.0.v3 y versiones posteriores | No | 
| TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1SHA | 13.2.0.0.v3 y versiones posteriores | Sí | 
| TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1SHA | 13.2.0.0.v3 y versiones posteriores | Sí | 
| TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1SHA256 | 13.2.0.0.v3 y versiones posteriores | Sí | 
| TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1SHA384 | 13.2.0.0.v3 y versiones posteriores | Sí | 
| TLS\$1ECDHE\$1ECDSA\$1WITH\$1AES\$1256\$1GCM\$1SHA384 | 13.4.0.9.v1 y versiones posteriores | Sí | 
| TLS\$1ECDHE\$1ECDSA\$1WITH\$1AES\$1256\$1CBC\$1SHA384 | 13.4.0.9.v1 y versiones posteriores | Sí | 

### Compatibilidad de certificados con conjuntos de cifrado
<a name="Oracle.Options.OEMAgent.CertificateCompatibility"></a>

RDS para Oracle admite certificados RSA y de algoritmo de firma digital de curva elíptica (ECDSA). Al configurar la opción de OEM Agent para la instancia de base de datos, debe asegurarse de que los conjuntos de cifrado que especifique en la configuración de la opción `TLS_CIPHER_SUITE` sean compatibles con el tipo de certificado utilizado por la instancia de base de datos.

En la siguiente tabla, se muestra la compatibilidad entre los tipos de certificados y los conjuntos de cifrado:


| Tipo de certificado | Conjuntos de cifrado compatibles | Conjuntos de cifrado incompatibles | 
| --- | --- | --- | 
| Certificados RSA (rds-ca-2019, rds-ca-rsa2048-g1, rds-ca-rsa4096-g1) |  TLS\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1SHA TLS\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1SHA256 TLS\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1SHA TLS\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1SHA256 TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1SHA TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1SHA TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1SHA256 TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1SHA384  |  TLS\$1ECDHE\$1ECDSA\$1WITH\$1AES\$1256\$1GCM\$1SHA384 TLS\$1ECDHE\$1ECDSA\$1WITH\$1AES\$1256\$1CBC\$1SHA384  | 
| Certificados de ECDSA (rds-ca-ecc384-g1) |  TLS\$1ECDHE\$1ECDSA\$1WITH\$1AES\$1256\$1GCM\$1SHA384 TLS\$1ECDHE\$1ECDSA\$1WITH\$1AES\$1256\$1CBC\$1SHA384  |  TLS\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1SHA TLS\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1SHA256 TLS\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1SHA TLS\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1SHA256 TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1SHA TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1SHA TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1SHA256 TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1SHA384  | 

Al especificar un conjunto de cifrado en la configuración de la opción `TLS_CIPHER_SUITE`, asegúrese de que sea compatible con el tipo de certificado utilizado por la instancia de base de datos. Si intenta asociar un grupo de opciones a una opción de OEM Agent que contenga un conjunto de cifrado incompatible con el tipo de certificado de una instancia de base de datos, la operación producirá un error y aparecerá un mensaje de error que indica la incompatibilidad.

## Habilitación de la opción del agente de gestión a la instancia de base de datos
<a name="Oracle.Options.OEMAgent.Enable"></a>

Para habilitar la opción del agente de gestión, utilice los pasos siguientes:

**Topics**
+ [Paso 1: agregar la opción de agente de gestión a la instancia de base de datos](#Oracle.Options.OEMAgent.Add)
+ [Paso 2: desbloquear la cuenta de usuario de DBSNMP](#Oracle.Options.OEMAgent.DBSNMP)
+ [Paso 3: añadir los destinos a la consola de Management Agent](#Oracle.Options.OEMAgent.Using)

### Paso 1: agregar la opción de agente de gestión a la instancia de base de datos
<a name="Oracle.Options.OEMAgent.Add"></a>

Para añadir la opción Management Agent a una instancia de base de datos, haga lo siguiente:

1. Cree un grupo de opciones nuevo o copie o modifique un grupo de opciones existente.

1. Añada la opción al grupo de opciones.

1. Asocie el grupo de opciones a la instancia de base de datos.

Si se produce algún error, consulte los documentos de [My Oracle Support](https://support.oracle.com/) para obtener información sobre cómo solucionar determinados problemas.

Después de agregar la opción de Management Agent, no es necesario reiniciar la instancia de base de datos. En cuanto esté activo el grupo de opciones, OEM Agent también lo estará. 

Si el host OMS usa un certificado de terceros que no es de confianza, Amazon RDS devolverá el error siguiente.

```
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.
```

Si se devuelve este error, la opción de Management Agent no se habilitará hasta que se haya solucionado el problema. Para obtener información acerca de cómo corregir el problema, consulte el documento de soporte de My Oracle [2202569.1](https://support.oracle.com/epmos/faces/DocContentDisplay?id=2202569.1).

#### Consola
<a name="Oracle.Options.OEMAgent.Add.Console"></a>

**Adición de la opción Management Agent a una instancia de base de datos**

1. Determine el grupo de opciones que desea utilizar. Puede crear un grupo de opciones o utilizar uno existente. Si desea utilizar un grupo de opciones existente, vaya al siguiente paso. De lo contrario, cree un grupo de opciones de base de datos personalizado con las siguientes opciones: 

   1. En **Engine**, elija la edición de Oracle que corresponda a la instancia de base de datos. 

   1. En **Major engine version (Versión principal del motor)**, elija la versión de su instancia de base de datos. 

   Para obtener más información, consulte [Creación de un grupo de opciones](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.Create). 

1. Agregue la opción **OEM\$1AGENT** al grupo de opciones y establezca la configuración de opción. Para obtener más información acerca de la adición de opciones, consulte [Agregar una opción a un grupo de opciones](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.AddOption). Para obtener más información acerca de cada opción, consulte [Configuración de opción de Management Agent](#Oracle.Options.OEMAgent.Options). 

1. Aplique el grupo de opciones a una instancia de base de datos nueva o existente: 
   + Si se trata de una instancia de base de datos nueva, el grupo de opciones se aplica cuando se lanza la instancia. Para obtener más información, consulte [Creación de una instancia de base de datos de Amazon RDS](USER_CreateDBInstance.md). 
   + Para una instancia de base de datos existente, el grupo de opciones se aplica modificando la instancia y asociando el grupo de opciones nuevo. Para obtener más información, consulte [Modificación de una instancia de base de datos de Amazon RDS](Overview.DBInstance.Modifying.md). 

#### AWS CLI
<a name="Oracle.Options.OEMAgent.Add.CLI"></a>

En el ejemplo siguiente se usa el comando de la AWS CLI [add-option-to-option-group](https://docs.aws.amazon.com/cli/latest/reference/rds/add-option-to-option-group.html) para añadir la opción `OEM_AGENT` a un grupo de opciones llamado `myoptiongroup`. 

Para Linux, macOS o 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
```

Para 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
```

### Paso 2: desbloquear la cuenta de usuario de DBSNMP
<a name="Oracle.Options.OEMAgent.DBSNMP"></a>

Management Agent utiliza la cuenta de usuario de `DBSNMP` para conectarse a la base de datos y notificar los problemas a Oracle Enterprise Manager. En una CDB, `DBSNMP` es un usuario común. Esta cuenta de usuario es necesaria tanto para Management Agent como para OEM Database Express. De forma predeterminada, esta cuenta está bloqueada. El procedimiento para desbloquear esta cuenta varía en función de si la base de datos utiliza una arquitectura de CDB o no de CDB.

**Para desbloquear la cuenta de usuario de DBSNMP**

1. En SQL\$1Plus u otra aplicación de Oracle SQL, inicie sesión como usuario maestro en su instancia de base de datos.

1. Lleve a cabo una de las siguientes acciones, dependiendo de la arquitectura de base de datos:  
**La base de datos no es de CDB.**  
Ejecute la siguiente instrucción de SQL:  

   ```
   1. ALTER USER dbsnmp IDENTIFIED BY new_password ACCOUNT UNLOCK;
   ```  
**La base de datos es de CDB.**  
Ejecute el siguiente procedimiento almacenado para desbloquear la cuenta de `DBSNMP`:  

   ```
   1. EXEC rdsadmin.rdsadmin_util.reset_oem_agent_password('new_password');
   ```
Si recibe un error que indica que el procedimiento no existe, reinicie la instancia de CDB para instalarla automáticamente. Para obtener más información, consulte [Reinicio de una instancia de base de datos ](USER_RebootInstance.md).

### Paso 3: añadir los destinos a la consola de Management Agent
<a name="Oracle.Options.OEMAgent.Using"></a>

Para añadir una instancia de base de datos como destino, debe conocer el punto de conexión y el puerto. Para obtener información acerca de cómo encontrar el punto de enlace de su instancia de base de datos de Amazon RDS, consulte [Búsqueda del punto de conexión de la instancia de base de datos de RDS para Oracle](USER_Endpoint.md). Si su base de datos utiliza la arquitectura de CDB, añada el contenedor `CDB$ROOT` por separado como destino.

**Adición de destinos a la consola de Management Agent**

1. En consola de OMS, elija **Setup**, **Add Target** y, a continuación, **Add Targets Manually**. 

1. Elija **Add Targets Declaratively by Specifying Target Monitoring Properties**.

1. En **Target Type**, elija **Target Type**.

1. En **Monitoring Agent (Monitorización del agente)**, elija el agente con el mismo identificador que su identificador de instancia de base de datos de RDS. 

1. Elija **Add Manually**.

1. Introduzca el punto de conexión de la instancia de base de datos de Amazon RDS o selecciónelo en la lista de nombres de host. Asegúrese de que el nombre de host especificado coincide con el punto de enlace de la instancia de base de datos de Amazon RDS.

1. Especifique las siguientes propiedades para la base de datos:
   + En **Target name (Nombre de destino)**, escriba un nombre. 
   + En **Database system name (Nombre de sistema de base de datos)**, escriba un nombre.
   + En **Monitor username (Nombre de usuario de monitor)**, escriba **dbsnmp**. 
   + En **Monitor password**, escriba la contraseña de [Paso 2: desbloquear la cuenta de usuario de DBSNMP](#Oracle.Options.OEMAgent.DBSNMP). 
   + En **Role (Rol)**, escriba **normal**. 
   + En **Oracle home path (Ruta de inicio de Oracle)**, escriba **/oracle**. 
   + En **Listener Machine name**, el identificador del agente ya aparece. 
   + En **Port (Puerto)**, escriba el puerto de base de datos. El puerto predeterminado de RDS es 1521. 
   + En **Database name (Nombre de base de datos)**, escriba el nombre de la base de datos. Si la base de datos es de CDB, este nombre es `RDSCDB`. 

1. Elija **Test Connection**. 

1. Elija **Next (Siguiente)**. La base de datos de destino aparece en su lista de recursos monitorizados. 

## Eliminar la opción de Management Agent
<a name="Oracle.Options.OEMAgent.Remove"></a>

Puede eliminar OEM Agent de una instancia de base de datos. Después de eliminar OEM Agent, no es necesario reiniciar la instancia de base de datos. 

Para eliminar OEM Agent de una instancia de base de datos, realice una de las siguientes operaciones: 
+ Elimine la opción de OEM Agent del grupo de opciones al que pertenece. Este cambio afecta a todas las instancias de base de datos que utilizan el grupo de opciones. Para obtener más información, consulte [Quitar una opción de un grupo de opciones](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.RemoveOption). 
+ Modifique la instancia de base de datos y especifique otro grupo de opciones que no incluya la opción de OEM Agent. Este cambio afecta a una única instancia de base de datos. Puede especificar el grupo de opciones predeterminado (vacío) u otro grupo de opciones personalizado. Para obtener más información, consulte [Modificación de una instancia de base de datos de Amazon RDS](Overview.DBInstance.Modifying.md). 

## Realización de tareas de base de datos con Management Agent
<a name="Oracle.Options.OEMAgent.DBTasks"></a>

Puede utilizar procedimientos de Amazon RDS para ejecutar determinados comandos de EMCTL en Management Agent. Al ejecutar estos procedimientos, puede hacer las tareas que se enumeran a continuación.

**nota**  
Las tareas se ejecutan de forma asíncrona.

**Topics**
+ [Protección del agente de gestión](#Oracle.Options.OEMAgent.DBTasks.SecureAgent)
+ [Obtención del estado del agente de administración](#Oracle.Options.OEMAgent.DBTasks.GetAgentStatus)
+ [Reinicio del Management Agent](#Oracle.Options.OEMAgent.DBTasks.RestartAgent)
+ [Descripción de los objetivos monitoreados por el Management Agent](#Oracle.Options.OEMAgent.DBTasks.ListTargets)
+ [Descripción de los subprocesos de recopilación monitoreados por Management Agent](#Oracle.Options.OEMAgent.DBTasks.ListCollectionThreads)
+ [Borrado del estado de Management Agent](#Oracle.Options.OEMAgent.DBTasks.ClearState)
+ [Hacer que Management Agent cargue su OMS](#Oracle.Options.OEMAgent.DBTasks.ForceUploadOMS)
+ [Hacer ping al OMS](#Oracle.Options.OEMAgent.DBTasks.PingOMS)
+ [Visualización del estado de una tarea en curso](#Oracle.Options.OEMAgent.DBTasks.ViewTaskStatus)

### Protección del agente de gestión
<a name="Oracle.Options.OEMAgent.DBTasks.SecureAgent"></a>

Para proteger el agente de gestión, ejecute el procedimiento `rdsadmin.rdsadmin_oem_agent_tasks.secure_oem_agent` de Amazon RDS. Este procedimiento es equivalente a ejecutar el comando `emctl secure agent`.

El siguiente procedimiento crea una tarea para proteger el agente de gestión y devuelve el ID de la tarea:

```
SELECT rdsadmin.rdsadmin_oem_agent_tasks.secure_oem_agent as TASK_ID from DUAL;
```

Para mostrar el archivo de salida de la tarea y ver el resultado, consulte [Visualización del estado de una tarea en curso](#Oracle.Options.OEMAgent.DBTasks.ViewTaskStatus).

### Obtención del estado del agente de administración
<a name="Oracle.Options.OEMAgent.DBTasks.GetAgentStatus"></a>

Para obtener el estado del agente de administración, ejecute el procedimiento de Amazon RDS `rdsadmin.rdsadmin_oem_agent_tasks.get_status_oem_agent`. Este procedimiento es equivalente al comando `emctl status agent`.

El siguiente procedimiento crea una tarea para obtener el estado del agente de gestión y devuelve el ID de la tarea.

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

Para mostrar el archivo de salida de la tarea y ver el resultado, consulte [Visualización del estado de una tarea en curso](#Oracle.Options.OEMAgent.DBTasks.ViewTaskStatus).

### Reinicio del Management Agent
<a name="Oracle.Options.OEMAgent.DBTasks.RestartAgent"></a>

Para reiniciar el Management Agent, ejecute el procedimiento de Amazon RDS `rdsadmin.rdsadmin_oem_agent_tasks.restart_oem_agent`. Este procedimiento es equivalente a ejecutar los comandos `emctl stop agent` y `emctl start agent`.

El siguiente procedimiento crea una tarea para reiniciar Management Agent y devuelve el ID de la tarea.

```
SELECT rdsadmin.rdsadmin_oem_agent_tasks.restart_oem_agent as TASK_ID from DUAL;    
```

Para mostrar el archivo de salida de la tarea y ver el resultado, consulte [Visualización del estado de una tarea en curso](#Oracle.Options.OEMAgent.DBTasks.ViewTaskStatus).

### Descripción de los objetivos monitoreados por el Management Agent
<a name="Oracle.Options.OEMAgent.DBTasks.ListTargets"></a>

Para enumerar los objetivos monitorizados por el Management Agent, ejecute el procedimiento de Amazon RDS `rdsadmin.rdsadmin_oem_agent_tasks.list_targets_oem_agent`. Este procedimiento es equivalente a ejecutar el comando `emctl config agent listtargets`.

El siguiente procedimiento crea una tarea para mostrar los destinos monitoreados por Management Agent y devuelve el ID de la tarea.

```
SELECT rdsadmin.rdsadmin_oem_agent_tasks.list_targets_oem_agent as TASK_ID from DUAL;
```

Para mostrar el archivo de salida de la tarea y ver el resultado, consulte [Visualización del estado de una tarea en curso](#Oracle.Options.OEMAgent.DBTasks.ViewTaskStatus).

### Descripción de los subprocesos de recopilación monitoreados por Management Agent
<a name="Oracle.Options.OEMAgent.DBTasks.ListCollectionThreads"></a>

Para mostrar todos los subprocesos de recopilación en ejecución, listos y programados monitoreados por Management Agent, ejecute el procedimiento de Amazon RDS `rdsadmin.rdsadmin_oem_agent_tasks.list_clxn_threads_oem_agent`. Este procedimiento es equivalente al comando `emctl status agent scheduler`.

El siguiente procedimiento crea una tarea para enumerar los subprocesos de recopilación y devuelve el ID de la tarea.

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

Para mostrar el archivo de salida de la tarea y ver el resultado, consulte [Visualización del estado de una tarea en curso](#Oracle.Options.OEMAgent.DBTasks.ViewTaskStatus).

### Borrado del estado de Management Agent
<a name="Oracle.Options.OEMAgent.DBTasks.ClearState"></a>

Para borrar el estado de Management Agent, ejecute el procedimiento de Amazon RDS `rdsadmin.rdsadmin_oem_agent_tasks.clearstate_oem_agent`. Este procedimiento es equivalente a ejecutar el comando `emctl clearstate agent`.

El siguiente procedimiento crea una tarea que borra el estado de Management Agent y devuelve el ID de la tarea.

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

Para mostrar el archivo de salida de la tarea y ver el resultado, consulte [Visualización del estado de una tarea en curso](#Oracle.Options.OEMAgent.DBTasks.ViewTaskStatus).

### Hacer que Management Agent cargue su OMS
<a name="Oracle.Options.OEMAgent.DBTasks.ForceUploadOMS"></a>

Para que Management Agent cargue el Oracle Management Server (OMS) asociado al mismo, ejecute el procedimiento de Amazon RDS `rdsadmin.rdsadmin_oem_agent_tasks.upload_oem_agent`. Este procedimiento es equivalente a ejecutar el comando `emclt upload agent`.

El procedimiento siguiente crea una tarea que hace que Management Agent cargue su OMS asociado y devuelva el ID de la tarea.

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

Para mostrar el archivo de salida de la tarea y ver el resultado, consulte [Visualización del estado de una tarea en curso](#Oracle.Options.OEMAgent.DBTasks.ViewTaskStatus).

### Hacer ping al OMS
<a name="Oracle.Options.OEMAgent.DBTasks.PingOMS"></a>

Para hacer ping al OMS del Management Agent, ejecute el procedimiento de Amazon RDS `rdsadmin.rdsadmin_oem_agent_tasks.ping_oms_oem_agent`. Este procedimiento es equivalente a ejecutar el comando `emctl pingOMS`.

El siguiente procedimiento crea una tarea que realiza ping al OMS de Management Agent y devuelve el ID de la tarea.

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

Para mostrar el archivo de salida de la tarea y ver el resultado, consulte [Visualización del estado de una tarea en curso](#Oracle.Options.OEMAgent.DBTasks.ViewTaskStatus).

### Visualización del estado de una tarea en curso
<a name="Oracle.Options.OEMAgent.DBTasks.ViewTaskStatus"></a>

Puede ver el estado de una tarea continua en un archivo bdump. Los archivos bdump están ubicados en el directorio `/rdsdbdata/log/trace`. El nombre del archivo bdump está en el siguiente formato.

```
dbtask-task-id.log 
```

Si desea monitorizar una tarea, reemplace `task-id` por el ID de la tarea que desea monitorizar.

Para ver el contenido de los archivos bdump, ejecute el procedimiento de Amazon RDS `rdsadmin.rds_file_util.read_text_file`. Por ejemplo, la siguiente consulta devuelve el contenido del archivo bdump `dbtask-1546988886389-2444.log`. 

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

Si necesita más información sobre el procedimiento `rdsadmin.rds_file_util.read_text_file` de Amazon RDS, consulte [Lectura de archivos de un directorio de instancia de base de datos](Appendix.Oracle.CommonDBATasks.Misc.md#Appendix.Oracle.CommonDBATasks.ReadingFiles).