Tareas de administración de las instancias de Management Agent

Visión general de la consola de Management Agent

La consola de Management Agent es la interfaz de usuario del servicio OCI Management Agent que le permite ver y administrar Management Agent y Management Gateways.

Puede realizar operaciones básicas y avanzadas en función de sus necesidades. La página de visión general proporciona información importante y enlaces a los recursos configurados en el servicio Management Agent. Console también proporciona acceso a Management Agent (agentes) y Management Gateways (gateways) configurados, así como paneles de control para visualizar datos relevantes en gráficos.

Para abrir la consola de Management Agent:

Conéctese a OCI y abra el menú de navegación desde la consola de OCI.
En Observación y gestión, haga clic en Agente de gestión.
Vaya al menú de la izquierda y seleccione un compartimento en la lista desplegable Compartimento.
Aparece la consola de Management Agent.

La consola de Management Agent tiene un menú a la izquierda con las siguientes opciones:

Visión general

En la página Visión general se muestra información útil sobre el servicio Management Agent y las instancias de Management Agent y Management Gateways instaladas.

La página Visión general proporciona información de resumen sobre los agentes de gestión y los gateways de gestión de su entorno. Incluye los siguientes gráficos:

Agentes: número de instancias de Management Agent instaladas.
Disponibilidad del agente: estado de disponibilidad de Management Agent. Estos son los estados disponibles:
- Activo: el servicio Management Agent se comunica con la instancia de Management Agent.
- Silencioso: el servicio Management Agent no se comunica con Management Agent. La comunicación con el agente se ha establecido después de la instalación del agente, pero algo ha ocurrido y puede haber un problema de comunicación entre el servicio Management Agent y el agente.
- No disponible: el proceso de instalación de Management Agent se está ejecutando y el servicio Management Agent aún no ha establecido la comunicación con el agente.
Nota

A partir del 9 de mayo de 2022, los agentes de gestión que permanecen en estado de disponibilidad SILENT durante más de 90 días no se mostrarán en la consola. Puede utilizar la CLI de OCI para revisar dichos agentes en lifeCycleState y suprimirlos según sea necesario. Los agentes de gestión que permanezcan en estado de disponibilidad SILENT durante más de 180 días se suprimirán automáticamente.
Alarmas: los agentes de gestión y los gateways proporcionan detalles de alarma del servicio OCI Monitoring. Para obtener más información sobre la configuración de alarmas y notificaciones, consulte:
Sistemas operativos de agente: versiones del sistema operativo de los agentes de gestión instalados.
Versiones de agente: versiones de Management Agent.
Complementos de servicio del agente: plugins de servicio desplegados por Management Agent.
Datos enviados por agentes: cantidad de datos que los agentes de gestión envían a los plugins de servicio.
Gateways: número de gateways de gestión instalados.
Disponibilidad de gateway: estado de disponibilidad de gateways de gestión.
Datos enviados por gateways: cantidad de datos que los gateways de gestión envían a los plugins de servicio.

Puede hacer clic en cada uno de los gráficos para ver más detalles.

La siguiente captura de pantalla es un ejemplo de la página Visión general de Management Agent.

Página Visión general que muestra información sobre los agentes de gestión instalados.

Paneles de Control

Puede utilizar paneles de control para visualizar, explorar y analizar datos en gráficos fáciles de interpretar. Para obtener más información, consulte Trabajar con paneles de control.

Agentes

En la página Agentes se muestran todas las agentes de gestión (agentes) y los gateways de gestión (gateways) instalados en un compartimento seleccionado.

La página Agentes incluye las siguientes opciones:

Agentes y gateways

Para seleccionar un compartimento:

Vaya al panel izquierdo. En Ámbito, seleccione el compartimento deseado en la lista desplegable Compartimento.
- Si se selecciona un compartimento raíz, la casilla de control Incluir subcompartimentos está disponible.
  Utilice la casilla de control para mostrar todos los agentes accesibles en subcompartimentos.
  
  El número máximo por defecto de agentes y gateways que se muestra es de 1.000. Para personalizar la selección, vaya al panel izquierdo y utilice Filtros.
  
  Requisito de política: asegúrese de tener el permiso inspect management-agents en el compartimento raíz del arrendamiento para poder mostrar todos los subcompartimentos del compartimento raíz. Por ejemplo: ALLOW GROUP <group_name> TO INSPECT management-agents IN TENANCY
- Si se selecciona un compartimento no raíz, la casilla de control Incluir subcompartimentos está desactivada.

La página Agentes y Gateways muestra una tabla con todos los agentes de gestión y gateways de gestión instalados.

La tabla está formada por las columnas siguientes:

Nombre: muestra el nombre del agente de gestión o gateway.
Host: muestra el nombre de host en el que está instalado Management Agent o Gateway.
Disponibilidad: muestra el estado de Management Agent o Gateway.
Sistema operativo: muestra el sistema operativo del host en el que está instalado el agente de gestión o el gateway.
Versión: muestra la versión del gateway o el agente de gestión instalado.
Plugins: muestra el nombre del plugin de servicio desplegado por Management Agent.
Creado: muestra la fecha en la que se instaló el agente de gestión o el gateway.
: muestra más acciones disponibles para un agente de gestión o gateway específico.

La siguiente captura de pantalla es un ejemplo de la lista Agentes y gateways.

Página Agentes y gateways que muestra todos los agentes de gestión y gateways de gestión instalados.

Puede hacer clic en un agente o gateway específico para abrir la página de detalles y acceder rápidamente y obtener más información.

Nota

Asegúrese de tener el permiso READ management-agents para poder ver los detalles del agente o gateway.

Detalles de agentes

La página Detalles de agentes muestra información sobre el agente seleccionado.

Utilice Desplegar plugins para desplegar un plugin en el agente seleccionado.
Utilice Activar logs de agente para activar el servicio Logging Analytics para recopilar archivos log del agente de gestión para el agente seleccionado. Para obtener más información, consulte Activar logs de agente.
Utilice Gestionar DataSources para ver o editar las propiedades y dimensiones del tipo de origen de datos configurado con el agente seleccionado. Para obtener más información, consulte Gestión de DataSources.
Utilice Más acciones para Agregar etiquetas o Suprimir un agente.
El separador Información de agente muestra información detallada del agente. Muestra el nombre de host, el nombre del compartimento, la versión del agente, el sistema operativo, los plugins de servicio desplegados en él, las solicitudes de trabajo, las bases de datos y mucho más.
- Complementos de servicio: utilice el enlace Complementos de servicio para mostrar todos los plugins de servicio desplegados en este agente de gestión específico. Para obtener más información, consulte Despliegue de plugins de servicio.
- DataSources: utilice el enlace DataSources para mostrar todos los orígenes de datos configurados en este agente de gestión específico. Para obtener más información, consulte Gestión de DataSources.

Página de detalles del agente que muestra información sobre un agente de gestión instalado.

Detalles de gateway

La página Detalles de gateway muestra información detallada sobre un gateway.

El separador Información de gateway muestra información detallada del gateway. Muestra el nombre de host, el nombre de compartimento, la versión de gateway, el sistema operativo, los agentes asociados, etc.

Agentes asociados: utilice el enlace Agentes asociados para mostrar todos los agentes de gestión configurados para utilizar este gateway de gestión específico. El panel Agentes asociados muestra la información de ID, host, disponibilidad y sistemas operativos de los agentes de gestión.

Página de detalles de gateway que muestra información sobre un gateway de gestión instalado.

Agentes con DataSource

La página Agentes con DataSource muestra una tabla que muestra todos los agentes con orígenes de datos configurados.

La tabla está formada por las columnas siguientes:

Nombre: nombre del agente.
Tipo DataSource: tipo del origen de datos. Por ejemplo: Prometeo.
DataSource: nombre del origen de datos.
Disponibilidad: disponibilidad del agente.
Creado: registro de hora cuando se creó el agente.

Puede hacer clic en un agente específico para abrir la página de detalles y acceder rápidamente y obtener más información.

Descargas y claves

En la página Descargas y claves se muestra información sobre el archivo de descarga de Management Agent y las claves de instalación de este creadas.

Consta del panel Descarga de software de agente en la parte superior y del panel Claves de instalación de agente en la parte inferior.

Descarga de software de agente

El panel Descarga de software tiene una tabla que consta de las siguientes columnas:

Descargar: muestra el nombre del archivo de descarga del agente de gestión.
Tipo de paquete: muestra el tipo de paquete: ZIP o RPM.
Versión: muestra la versión del agente de gestión instalada.
Tamaño (MB): muestra el tamaño del agente de gestión.
Total de control SHA-256: muestra la información para confirmar la integridad del archivo.

La siguiente captura de pantalla es un ejemplo del panel Software Download (Descarga de software).

Panel de descarga de software

Claves de instalación de agente

El panel Claves de instalación de agente tiene un botón Crear clave para crear una clave de instalación de agente. También muestra una tabla que consta de las siguientes columnas:

Nombre de clave: muestra el nombre de la clave de instalación de Management Agent.
Compartimento: muestra el nombre del compartimento donde se creó la clave de instalación de Management Agent.
Creado por: muestra información sobre el usuario que ha creado la clave de instalación de Management Agent.
Creado: muestra la fecha de creación de la clave de instalación de Management Agent.
Días restantes: muestra el número de días restantes hasta que caduca la clave de instalación de Management Agent.
Instalaciones de agentes restantes: muestra el número de instalaciones restantes para cada clave de instalación de Management Agent.
Menú de elemento de acción: muestra más acciones disponibles para una clave de instalación de agente, como Copiar clave al portapapeles, Descargar clave en archivo y Suprimir clave.

Despliegue de plugins de servicio

Los agentes de gestión le permiten desplegar plugins de servicio para diferentes servicios de Oracle Cloud Infrastructure (OCI).

Los plugins de servicio se pueden desplegar en agentes de gestión, lo que permite realizar tareas para esos servicios. Cualquier agente de gestión determinado puede tener varios plugins de servicio.

plugins de servicio disponibles

Están disponibles los siguientes plugins de servicio:

Servicio de gestión de bases de datos y estadísticas de operaciones.
Java Management Service.
Seguimiento de uso de Java.
Análisis de registro.
Servicio de host de Operations Insights.
Supervisión de pila.

Para obtener más información sobre los servicios de OCI, consulte Servicios de Oracle Cloud Infrastructure (OCI).

Nota

Si hay alguna actualización de plugin de servicio de OCI disponible, se actualizará automáticamente.

Despliegue de un Plugin de Servicio

Puede desplegar un plugin de servicio mediante cualquiera de los siguientes métodos:

Despliegue de un plugin de servicio mediante la página Agentes

Utilice este método cuando el agente de gestión ya esté instalado como se describe en Install Management Agents.

Para desplegar un plugin mediante la página Agentes, realice lo siguiente:

En el menú de la izquierda, haga clic en Agentes para abrir la página Agentes.
En la lista Agentes, haga clic en el agente deseado donde desea desplegar el plugin.

Aparecerá la página de detalles del agente.
Haga clic en Desplegar plugins.

Aparecerá la ventana Desplegar plugins.
Seleccione el plugin y haga clic en Actualizar.

El plugin seleccionado se desplegará en el agente deseado.

Despliegue de un plugin de servicio durante la instalación del agente de gestión

Utilice este método cuando se realice un despliegue de plugin durante el proceso de instalación de Management Agent.

Siga las instrucciones para descargar el software del agente y crear una clave de instalación del agente, como se describe en Descarga del software del agente y Creación de la clave de instalación.
Descargue el archivo de claves de instalación del agente.

Vaya a la página Claves de instalación de agente y, en el menú de acción, seleccione la opción Descargar clave en archivo.

La opción Descargar clave en archivo permite descargar una plantilla de archivo de respuesta. Para obtener detalles, consulte Descarga de la clave de instalación.
Edite la plantilla del archivo de respuesta mediante un editor de texto y cree un archivo de respuesta personalizado.

Siga las instrucciones para crear un archivo de respuesta mediante la opción de descarga de una plantilla de archivo de respuesta, como se describe en Opción 1: Descargar una plantilla de archivo de respuesta para crear un archivo de respuesta.

La plantilla de archivo de respuesta contiene parámetros de agente, incluido el parámetro de plugin de servicio, que es necesario para desplegar un plugin.

Para desplegar un plugin de servicio como parte del proceso de instalación de Management Agent, personalice el parámetro Service.plugin.<plugin_name>.download.

Por ejemplo, si desea desplegar el plugin DataSafe durante la instalación del agente, el valor del parámetro será: Service.plugin.datasafe.download=true

Para obtener más información sobre los parámetros de agente soportados en el archivo de respuesta, consulte Revisión de los parámetros del agente.
Instale el agente de gestión como se describe en Install Management Agent para completar la instalación.

Tareas posteriores al despliegue

Después de desplegar un plugin de servicio, puede hacer lo siguiente:

Comprobar estado del plugin de servicio

En la página Detalles de agente, vaya a Información de agente y haga clic en el enlace Plugin de servicio.
El panel Plugins de servicio se muestra con la siguiente información: nombre, estado y mensaje.

Si el agente de gestión tiene más de un plugin de servicio desplegado, se muestra información de todos los plugins de servicio.

Si el despliegue se realiza correctamente, puede ver Running en Estado.

Si el despliegue tiene problemas, puede ver Failed en Estado con una descripción del error en Mensaje.

Comprobar estado de solicitud de trabajo

Cuando se despliega un plugin de servicio, se genera una solicitud de trabajo para realizar un seguimiento del proceso de despliegue.

Para comprobar el estado de la solicitud de trabajo, realice lo siguiente:

En la página Detalles de agente, vaya a Información de agente y haga clic en el enlace Solicitud de trabajo.
El panel Solicitudes de trabajo se muestra con la siguiente información: ID, Tipo de operación, Nombre de plugin, Estado y Hora de aceptación.

Muestra todas las solicitudes de trabajo de los últimos 30 días.

Si el despliegue se realiza correctamente, la solicitud de trabajo muestra Succeeded en Estado.

Si el despliegue tiene problemas, la solicitud de trabajo muestra Failed en Estado. Puede utilizar la información de ID para la resolución de problemas.

Activar logs del agente

La opción Activar logs de agente permite activar la recopilación continua de los logs de agente en el servicio Logging Analytics.

Esta función incorpora el agente seleccionado con Logging Analytics y permite la carga automática de los archivos log del agente en Logging Analytics. Para obtener información sobre el servicio OCI de Log Analytics, consulte Logging Analytics.

Requisitos

El estado del agente seleccionado es Activo.
El arrendamiento debe estar incorporado al servicio Logging Analytics.
El plugin de Logging Analytics se debe desplegar en el agente seleccionado.

Activar logs del agente

Para activar logs, haga lo siguiente:

En la página de lista Agents, haga clic en el agente que desee.

Aparecerá la página de detalles del agente.
Haga clic en Activar logs de agente.

Se muestra la ventana Activar logs: Agente para el agente seleccionado.
Seleccione un compartimento de grupo de logs en la lista desplegable.
Seleccione un grupo de logs en la lista desplegable.
Si desea crear un nuevo grupo de logs, haga clic en Crear grupo de logs.

En la ventana Crear grupo de logs, introduzca el nombre de grupo de logs y una descripción. Después, haga clic en Crear.
Haga clic en Activar.

Solución de Problemas:

Para cada agente, hay una entidad (recurso) correspondiente que se crea en Logging Analytics. Si no se encuentra ninguna entidad coincidente para el agente seleccionado, no se puede activar el registro. Para activar logs en este caso, vuelva a intentarlo más tarde o agregue manualmente el agente como una entidad en Logging Analytics. Para obtener información, consulte Creación de una entidad para representar el recurso de emisión de logs en Logging Analytics.

Verificar asociación de origen de logs de agente

Una vez activados los logs, la asociación se puede ver en Logging Analytics.

Vaya a Observación y gestión y vaya a Logging Analytics.
En la página Logging Analytics, vaya a Administración.
En el menú izquierdo, seleccione Orígenes.

En el panel central, seleccione Logs de Oracle Management Agent y verifique que el agente se muestre en la lista Entidades asociadas.

Los logs solo se activan con el grupo de logs seleccionado en la página Detalles de agente.

Para configurar la política de depuración de los datos de log, consulte Depurar datos de log de Logging Analytics.

Desactivación de logs del agente

La desactivación de logs de agente para la carga continua de logs del agente seleccionado en Logging Analytics.

Para desactivar logs, haga lo siguiente:

Haga clic en Desactivar logs de agente.
Se muestra la ventana de desactivación de logs del agente para el agente seleccionado.
Haga clic en Desactivar.

Gestionar DataSources

Gestionar DataSources permite ver o editar las propiedades y dimensiones de los orígenes de datos configurados con el agente seleccionado, como el origen de datos de Prometheus.

Requisitos previos de Prometheus DataSource:

Management Agent se ha desplegado con la versión 231231.0001 o superior de Management Agent.
Para el exportador de Prometheus, el agente de gestión debe estar en la misma máquina virtual (VM) o en una máquina virtual con acceso al punto final del exportador de nodos. Este agente de gestión está configurado para extraer métricas del exportador de nodos de Prometheus en ejecución.

Para gestionar orígenes de datos, realice lo siguiente:

En la página de lista Agents, haga clic en el agente que desee.

Aparecerá la página de detalles del agente.
Haga clic en Gestionar DataSources.
La ventana DataSources muestra una tabla con las siguientes columnas:
- Nombre: nombre del origen de datos.
- Tipo: tipo del origen de datos. Por ejemplo: Prometeo.
- Estado: estado del origen de datos.
- Hora de creación: registro de hora en el que se creó el origen de datos.
- : muestra más acciones disponibles para un origen de datos específico.
Si hace clic en un nombre de origen de datos específico, se muestra la ventana Ver DataSource.
Utilice Ver DataSource para mostrar toda la información sobre un origen de datos.

Por ejemplo: puede ver los datos de métricas del exportador de Prometheus.
Utilice Agregar DataSource para agregar un origen de datos.
- Seleccione el tipo DataSource de la lista desplegable. Por ejemplo: Prometeo.
- Utilice Nombre para introducir el nuevo nombre de origen de datos.
- Seleccione Compartimento de métrica en la lista desplegable.
- Introduzca un espacio de nombre de métrica.
- Introduzca una URL que Prometheus Exporter utiliza para publicar sus métricas.
- Utilice las dimensiones de métricas personalizadas para agregar una dimensión de métrica.
- Si es necesario, utilice Propiedades opcionales.
Suprimir DataSource: utilice el menú de acción para suprimir un origen de datos.
Editar DataSource: utilice el menú de acción para editar las propiedades de un origen de datos.
Por ejemplo, puede modificar la URL del exportador de Prometheus, que publica los datos de métrica en el servicio OCI Monitoring.

Nota

Para el exportador de Prometheus, debe crear políticas. Para obtener más información, consulte Configuración de un agente de gestión para recopilar métricas mediante el exportador de nodos de Prometheus.

Control de instancias de Management Agent

Una de las tareas de administración es controlar el estado de los agentes de gestión. Puede iniciar, parar y verificar el estado de las instancias de Management Agent.

Inicio de agentes

Para iniciar el servicio de agente, realice los siguientes pasos:

En Linux:

Conéctese como usuario con permisos sudo.
Ejecute el siguiente comando:

Para Oracle Linux 6: sudo /sbin/initctl start mgmt_agent

Para Oracle Linux 7: sudo systemctl start mgmt_agent

En Windows:

Conéctese como usuario Administrator y abra una ventana de símbolo del sistema.
Ejecute el siguiente comando: net start mgmt_agent

En Solaris:

Inicie sesión como usuario con permisos sudo para ejecutar comandos como usuario root.
Ejecute el siguiente comando:

sudo /etc/init.d/mgmt_agent start

Parada de los agentes

Para parar el servicio de agente, realice los siguientes pasos:

En Linux:

Conéctese como usuario con permisos sudo.
Ejecute el siguiente comando:

Para Oracle Linux 6: sudo /sbin/initctl stop mgmt_agent

Para Oracle Linux 7: sudo systemctl stop mgmt_agent

En Windows:

Conéctese como usuario Administrator y abra una ventana de símbolo del sistema.
Ejecute el siguiente comando: net stop mgmt_agent

En Solaris:

Conéctese como usuario que tenga el privilegio sudo para ejecutar comandos como usuario root.
Ejecute el siguiente comando:

sudo /etc/init.d/mgmt_agent stop

Verificación de agentes

Para verificar el estado del agente, haga lo siguiente:

En Linux:

Conéctese como usuario con permisos sudo.
Ejecute el siguiente comando:

Para Oracle Linux 6: sudo /sbin/initctl status mgmt_agent

Para Oracle Linux 7: sudo systemctl status mgmt_agent

Para obtener más información, consulte el archivo log: /opt/oracle/mgmt_agent/agent_inst/log/mgmt_agent.log.

En Windows:

Conéctese como usuario Administrator y abra una ventana de símbolo del sistema.
Ejecute el siguiente comando: sc query mgmt_agent

Para obtener más información, consulte el archivo log: C:\Oracle\mgmt_agent\agent_inst\log\mgmt_agent.log.

En Solaris:

Conéctese como usuario que tenga el privilegio sudo para ejecutar comandos como usuario root.
Ejecute el siguiente comando: sudo /etc/init.d/mgmt_agent status

Para obtener más información, consulte el archivo log: /opt/oracle/mgmt_agent/agent_inst/log/mgmt_agent.log.

Gestión de claves de instalación

Creación de la clave de instalación

Debe crear una clave de instalación antes de realizar la instalación de Management Agent.

Se emite una clave de instalación en el dominio de identidad y valida la autenticidad de la instalación. Asegúrese de haberla creado antes de iniciar el proceso de instalación de Management Agent.

Para crear una clave:

En la página inicial de Management Agent, haga clic en Descargas y claves en el menú de la izquierda para ver el panel Claves de instalación.

El panel Claves de instalación se muestra en la parte inferior de la página.
En el panel Claves de instalación, haga clic en Crear clave para crear una clave.
Introduzca los detalles necesarios en la ventana Crear clave.
1. En el campo Nombre de clave, especifique un nombre para identificar la clave.
2. En el campo Compartimento, seleccione el compartimento en la lista desplegable. Este es el compartimento en el que se creará el recurso del agente.
3. En el campo Máximo de instalaciones, especifique un número que indique el número máximo de instalaciones que se pueden asociar a la clave. El valor por defecto es 1000.
4. En el campo Válido durante, especifique un número que indique el período para el que es válida la clave. El valor por defecto es 1 semana.
5. La casilla de control Ilimitado es opcional.
  
  Si se selecciona, la clave se puede utilizar para un número ilimitado de instalaciones de agente y gateway, y la clave nunca caduca.
  
  Riesgos de uso de claves ilimitadas: Oracle recomienda mantener el tiempo de vida de una clave de instalación en un tiempo mínimo necesario y un número limitado de agentes. Asegúrese de mantener la clave descargada en una ubicación segura para proteger la confidencialidad. Si la clave de instalación ilimitada está comprometida, un atacante puede instalar agentes peligrosos en su arrendamiento. Una auditoría regular de los agentes de su arrendamiento puede ayudar a mitigar cualquier riesgo potencial asociado a claves de instalación ilimitadas. Cuando ya no se necesite una clave de instalación ilimitada, asegúrese de suprimirla mediante Management Agents Console o CLI.
Se crea una nueva clave.

El panel Claves de instalación ofrece diferentes opciones disponibles para gestionar las claves. Durante un paso posterior, la opción Descargar clave en archivo es útil para descargar un archivo que se puede utilizar como plantilla de archivo de respuesta, como se describe en Configuración de un archivo de respuesta.

Para obtener más información sobre la gestión de claves de instalación, consulte Gestión de claves de instalación.

Nota

Si está instalando una instancia de Management Gateway, puede utilizar la misma clave de instalación para instalar Management Gateway y Management Agent. Para obtener información sobre Management Gateway, consulte Management Gateway.

Copia de la clave de instalación

Puede copiar una clave de instalación en el portapapeles desde el panel Claves de instalación.

En la página inicial de Management Agent, haga clic en Descargas y claves en el menú de la izquierda para ver el panel Claves de instalación.
Se muestra el panel Claves de instalación.
En la lista de claves de instalación, seleccione la clave que desea copiar en el portapapeles.
En el lado derecho de la clave seleccionada, haga clic en el menú de acción y seleccione Copiar clave al portapapeles.

La clave se copia en el portapapeles.

La opción Copiar clave al portapapeles es útil para copiar y pegar el valor de la clave al crear el archivo de respuesta durante el proceso de configuración del agente. Para obtener más detalles, consulte Creación de un archivo de respuesta.

Descarga de la clave de instalación

Puede descargar una clave de instalación desde el panel Claves de instalación.

En la página inicial de Management Agent, haga clic en Descargas y claves en el menú de la izquierda para ver el panel Claves de instalación.
Se muestra el panel Claves de instalación, con todas las claves existentes.
En la lista de claves de instalación, seleccione la clave que desea descargar.
En el lado derecho de la clave seleccionada, haga clic en el menú de acción y seleccione Descargar clave en archivo.

Se descarga un archivo.

La opción Descargar clave en archivo es útil para descargar un archivo con los parámetros del agente que se pueden utilizar como archivo de respuesta durante el proceso de instalación del agente. Para obtener más detalles, consulte Creación de un archivo de respuesta.

Supresión de la clave de instalación

Puede suprimir una clave de instalación del panel Claves de instalación.

En la página inicial de Management Agent, haga clic en Descargas y claves en el menú de la izquierda para abrir el panel Claves de instalación.

Se muestra el panel Claves de instalación, con todas las claves existentes.
En la lista de claves de instalación, seleccione la clave que desea suprimir.
En la parte derecha de la clave seleccionada, haga clic en el menú de acción y seleccione Suprimir clave.
Haga clic en Suprimir clave.
Pulse Suprimir para confirmar la operación.

La opción Suprimir clave es útil cuando sospecha que un usuario no autorizado ha obtenido el valor de una clave de instalación de agente.

Cambio de versión de las instancias de Management Agent

Hay dos métodos disponibles para actualizar las instancias de Management Agent:

Cambio de versión automático

El servicio Management Agent soporta el cambio de versión automático.

La activación de la función de actualización automática se realiza en el nivel de arrendamiento: los usuarios pueden activar la actualización automática para todos los agentes de gestión que residan en su arrendamiento actual.

Requisitos:

Permiso: se necesita el permiso MGMT_AGENT_UPDATE en el compartimento raíz del arrendamiento para activar la función de actualización automática. Utilice la siguiente sintaxis de política:
```
ALLOW GROUP <group_name> TO USE management-agents IN TENANCY
```
Para obtener información sobre las políticas del agente de gestión, consulte Detalles del agente de gestión.
Versión mínima de Management Agent: 210918.1427 o superior.

Estado por defecto de cambio de versión automático: Desactivar.

Temas

Activación del cambio de versión automático

Puede activar el cambio de versión automático mediante la consola de Management Agent.

En la página inicial de Management Agent, haga clic en Descargas y claves en el menú de la izquierda.

El panel Cambio de versión automático de agente se muestra en la parte superior de la página.
En el panel Cambio de versión automático de agente, haga clic en Activar cambio de versión automático.

Aparece la ventana Activar cambio de versión automático.
En la ventana Activar cambio de versión automático, haga clic en Aceptar para activar el cambio de versión automático para todos los agentes de gestión del arrendamiento actual.

Desactivación del cambio de versión automático

Puede desactivar el cambio de versión automático mediante la consola de Management Agent.

En la página inicial de Management Agent, haga clic en Descargas y claves en el menú de la izquierda.

El panel Cambio de versión automático de agente se muestra en la parte superior de la página.
En el panel Cambio de versión automático de agente, haga clic en Desactivar cambio de versión automático.

Aparece la ventana Desactivar cambio de versión automático.
En la ventana Desactivar cambio de versión automático, haga clic en Aceptar para desactivar el cambio de versión automático para todos los agentes de gestión del arrendamiento actual.

Para obtener una lista de los comandos disponibles de la CLI y desactivar la actualización automática, consulte Referencia de comandos de la CLI de Oracle Cloud Infrastructure.

Cambio de versión manual

Management Agent soporta el cambio de versión manual para los siguientes sistemas operativos:

Actualización manual de Linux (archivo RPM)

Para actualizar un agente en Linux mediante un archivo RPM, realice lo siguiente:

Descargue la última versión del archivo RPM que contiene el archivo de descarga de software del agente. Consulte Descarga del software del agente.
Para cambiar al versión del agente, ejecute el comando rpm con la opción de cambio de versión rpm -U:
```
sudo rpm -U <rpm_file_name.rpm>
```

Actualización manual de Linux (archivo ZIP)

Para actualizar un agente en Linux mediante un archivo ZIP, realice lo siguiente:

Descargue la última versión del archivo ZIP que contiene el archivo de descarga del software del agente. Consulte Descarga del software del agente.
Desplácese hasta el directorio donde haya descargado el archivo ZIP del software del agente de gestión y descomprímalo en cualquier ubicación que desee.

Para actualizar el agente, ejecute el script installer.sh con la opción -u:

installer.sh -u

El resultado es similar al siguiente:

sudo ./installer.sh -u 
Checking pre-requisites
    Checking available disk space for agent upgrade    
    Checking agent version

Executing install
    Unpacking software zip
    Copying files to destination dir (/opt/oracle/mgmt_agent)
    Updating communication wallet
    Creating 'mgmt_agent' daemon
    Starting mgmt_agent
    Agent Install Logs: /opt/oracle/mgmt_agent/installer-logs/installer.log.0

Agent upgrade successful

Cambio de versión manual de Windows

Para cambiar la versión de un agente en Windows, realice lo siguiente:

Conéctese como usuario Administrator y abra una ventana de símbolo del sistema.
Descargue la última versión del archivo ZIP que contiene el archivo de descarga del software del agente. Consulte Descarga del software del agente.
Desplácese hasta el directorio donde haya descargado el archivo ZIP del software del agente de gestión y descomprímalo en cualquier ubicación que desee.

Para actualizar el agente, ejecute el script installer.bat con la opción -u: installer.bat -u.

El resultado es similar al siguiente:

C:\Users\test_agent>installer.bat -u 
Checking pre-requisites

     Checking if C:\Oracle\mgmt_agent\200821.0751 directory exists 
     Checking available disk space for agent install
     Checking Java version
              Java version: 1.8.0_261 found at C:\Program Files\Java\jdk1.8.0_261

Executing Upgrade
        Unpacking software zip
        Copying files to destination dir(C:\Oracle\mgmt_agent)
        Initializing software from template
        Creating mgmt_agent service

Agent Upgrade  successful

Cambio de versión manual de Solaris

Para cambiar la versión de un agente en Solaris, realice lo siguiente:

Descargue la última versión del archivo ZIP que contiene el archivo de descarga de software del agente. Consulte Descarga del software del agente.
Navegue hasta el directorio en el que ha descargado el archivo ZIP del software del agente de gestión y descomprímalo en cualquier ubicación preferida.

Para cambiar la versión del agente, conéctese como usuario root y ejecute el script installer.sh con la opción -u:

installer.sh -u

El resultado es similar al siguiente:

sudo ./installer.sh -u 
Checking pre-requisites
    Checking available disk space for agent upgrade    
    Checking agent version

Executing install
    Unpacking software zip
    Copying files to destination dir (/opt/oracle/mgmt_agent)
    Updating communication wallet
    Creating 'mgmt_agent' daemon
    Starting mgmt_agent
    Agent Install Logs: /opt/oracle/mgmt_agent/installer-logs/installer.log.0

Agent upgrade successful

Actualización manual de AIX (archivo ZIP)

Para actualizar un agente en AIX mediante un archivo ZIP, realice lo siguiente:

Descargue la última versión del archivo ZIP que contiene el archivo de descarga del software del agente. Consulte Descarga del software del agente.
Desplácese hasta el directorio donde haya descargado el archivo ZIP del software del agente de gestión y descomprímalo en cualquier ubicación que desee.

Para actualizar el agente, ejecute el script installer.sh con la opción -u:

installer.sh -u

El resultado es similar al siguiente:

sudo ./installer.sh -u 
Checking pre-requisites
        Checking available disk space for agent upgrade
        Checking agent version

Executing install
        Unpacking software zip
        Copying files to destination dir (/opt/oracle/mgmt_agent)
        Updating communication wallet
        Creating mgmt_agent daemon
        Starting mgmt_agent
        Agent Install Logs: /opt/oracle/mgmt_agent/installer-logs/installer.log.0

Agent upgrade successful

Eliminación de instancias de Management Agent

Al eliminar un agente de gestión asociado a un host, se anula el registro del agente de gestión de Management Agents Cloud Service antes de que se elimine del host.

Puede eliminar un agente de un host por los siguientes motivos:

Ya no es necesario un agente desplegado en el host de destino.
Ya no necesita recopilar datos, métricas de rendimiento o logs de un host de destino específico.
Ha modificado la topología del despliegue.

En este tema se explica cómo eliminar instancias de Management Agent.

Eliminación de agentes de la interfaz de usuario

Para eliminar agentes de la interfaz de usuario, haga lo siguiente:

Seleccione el agente de la lista Agentes y haga clic en el menú Acción.

Figura 4-1 Suprimir agente
Haga clic en Suprimir agente.
Pulse Suprimir para confirmar la selección.

El agente se eliminará de la interfaz de usuario de Management Agent, pero el software del agente no se suprimirá del host de destino. Los usuarios deben conectarse al host y eliminar manualmente el software del agente del host. Para Linux, utilice el comando rpm con la opción -e.

Eliminación de agentes de la interfaz de línea de comandos

Al eliminar un agente de la interfaz de línea de comandos, el agente y el software del agente se eliminarán del host.

Elimine (desinstale) Management Agent de los siguientes sistemas operativos:

Linux con el comando RPM

Ejecute el comando rpm con la opción -e.

sudo rpm -e <rpm_name>

Linux con el script de desinstalador

Ejecute el script uninstaller.sh si ha instalado el agente mediante los archivos ZIP.

El resultado es similar al siguiente:

$ sudo bash /opt/oracle/mgmt_agent/agent_inst/bin/uninstaller.sh
Executing pre-remove step from uninstall
Attempting to remove the agent from Management Agent Cloud service, please do not interrupt...
Attempting to remove the agent from Management Agent Cloud service, please do not interrupt...
Agent was removed from Management Agent Cloud service successfully.
Detected Oracle Linux Server (Red Hat family):
Stopping mgmt_agent...
Removing mgmt_agent daemon from systemd...
Removed symlink/etc/systemd/system/multi-user.target.wants/mgmt_agent.service.
Agent was removed from the host successfully.
Executing post-remove step from uninstall
Agent state directory was removed from the host successfully.

Nota

Si ha instalado Management Agent mediante un volumen externo en Linux, el script de desinstalador de Management Agent elimina todos los datos del directorio /opt/oracle/mgmt_agent y, en algunos sistemas operativos, también elimina el directorio de destino al que apunta el enlace simbólico.

Windows

Abra una ventana del símbolo del sistema, vaya al directorio base de instalación del agente y ejecute el script uninstaller.bat.

El resultado es similar al siguiente:

C:\Oracle>mgmt_agent\uninstaller.bat
Removing agent from Management Agent Cloud Service
Attempting to remove the agent from Management Agent Cloud service, please do not interrupt...
Agent was removed from Management Agent Cloud service successfully.
Removing agent service from the host
Agent service was removed from the host successfully
Removing agent directories

Asegúrese de que todas las demás ventanas del símbolo del sistema estén cerradas o no apunten al directorio raíz del agente antes de ejecutar el script uninstaller.bat.

Solaris

Ejecute el script uninstaller.sh como usuario root.

El resultado es similar al siguiente:

sudo bash /opt/oracle/mgmt_agent/agent_inst/bin/uninstaller.sh
Executing pre-remove step from uninstall
Attempting to remove the agent from Management Agent Cloud service, please do not interrupt...
Attempting to remove the agent from Management Agent Cloud service, please do not interrupt...
Agent was removed from Management Agent Cloud service successfully.
Detected Oracle Linux Server (Red Hat family):
Stopping mgmt_agent...
Removing mgmt_agent daemon from systemd...
Removed symlink /etc/systemd/system/multi-user.target.wants/mgmt_agent.service.
Agent was removed from the host successfully.
Executing post-remove step from uninstall
Agent state directory was removed from the host successfully.

AIX

Ejecute el script uninstaller.sh como usuario root.

El resultado es similar al siguiente:

sudo sh /opt/oracle/mgmt_agent/agent_inst/bin/uninstaller.sh
Executing pre-remove step from uninstall
Attempting to remove the Agent from Management Agent Cloud service, please do not interrupt...
Attempting to remove the Agent from Management Agent Cloud service, please do not interrupt...
Agent was removed from Management Agent Cloud service successfully.
Detected AIX:
Stopping mgmt_agent...
Waiting for mgmt_agent to exit...
Stopped mgmt_agent.
Removing mgmt_agent daemon...
0513-083 Subsystem has been Deleted.
Agent was removed from the host successfully.
Executing post-remove step from uninstall
Agent state directory was removed from the host successfully.

Uso de un usuario del sistema operativo no por defecto para instalar Management Agent

Oracle recomienda realizar la instalación del agente de gestión con el usuario de sistema operativo por defecto: mgmt_agent, pero según sus requisitos, puede que necesite realizar la instalación con un usuario de sistema operativo diferente.

En esta sección se describe cómo instalar Management Agent mediante un usuario diferente de mgmt_agent, el usuario del sistema operativo por defecto.

Requisitos

Nota

Al seleccionar un usuario del sistema operativo que no sea mgmt_agent para realizar la instalación del agente de gestión en sistemas Linux o Unix, se deben tener en cuenta las siguientes consideraciones:

Seleccione un usuario del sistema operativo con privilegios limitados.
El usuario del sistema operativo mgmt_agent predeterminado es un usuario del sistema operativo con el privilegio mínimo sin shell de inicio de sesión. Si decide seleccionar otro usuario del sistema operativo, asegúrese de que el usuario seleccionado tenga privilegios limitados.
Management Agent es una aplicación de varios threads y cada thread (LWP) cuenta para el límite de usuarios del sistema operativo. Asegúrese de que el límite de usuario (ulimit) para max user processes se define según corresponda comprobando:
```
ulimit -u
```
La elección de un límite inadecuado puede provocar inestabilidad del agente de gestión y de las aplicaciones que se ejecutan como el usuario del sistema operativo seleccionado.

Identifique un usuario del sistema operativo válido para realizar la instalación del agente de gestión y utilícelo como valor para la variable RUN_AGENT_AS_USER.
Oracle recomienda que el usuario del sistema operativo seleccionado tenga menos privilegios y ningún shell de inicio de sesión.
```
id -un <username>
```
Ejemplo1:
```
id -un myexistinguser
```
El usuario del sistema operativo myexistinguser existe. La salida devuelve el valor del usuario seleccionado y tiene un aspecto similar al siguiente:
```
myexistinguser
```
Ejemplo2:
```
id -un mytestuser2
```
El usuario del sistema operativo mytestuser2 no existe y no es un usuario válido. La salida no devuelve ningún valor de usuario y tiene un aspecto similar al siguiente:
```
id: mytestuser2: no such user
```
Identifique el grupo primario del usuario que se va a utilizar como valor para la variable AGENT_USER_GROUP.
Asegúrese de que el valor de AGENT_USER_GROUP sea el grupo de usuarios principal del usuario del sistema operativo seleccionado.
Nota

El uso de un grupo secundario no está soportado y puede provocar una corrupción del agente de gestión.
```
id -gn <username>
```
Ejemplo:
```
id -gn myexistinguser
```
El resultado es similar al siguiente:
```
staff
```

Definición de variables de entorno e instalación de Management Agent

Configure las siguientes variables de entorno:

RUN_AGENT_AS_USER=<selected_OS_user_for_ManagementAgent_installation>
AGENT_USER_GROUP=<OS_primary_group_of_selected_OS_user>

Ejemplo:

RUN_AGENT_AS_USER=myexistinguser
AGENT_USER_GROUP=staff

Asegúrese de que el usuario del sistema operativo root pueda acceder a la variable de entorno anterior.
Por defecto, las variables de entorno no se comparten con el usuario root.
Verifique que las variables de entorno estén definidas correctamente ejecutando lo siguiente:
```
sudo su
echo $RUN_AGENT_AS_USER
echo $AGENT_USER_GROUP
```
Por ejemplo, la salida es similar a la siguiente:
```
myexistinguser
staff
```
Si root no puede acceder a las variables de entorno, edite el archivo /etc/sudoers y agregue lo siguiente:
```
Defaults env_keep+=RUN_AGENT_AS_USER
Defaults env_keep+=AGENT_USER_GROUP
```
Lo anterior garantiza que el usuario root mantenga y pueda acceder a las variables de entorno RUN_AGENT_AS_USER y AGENT_USER_GROUP.

Después de actualizar el archivo /etc/sudoers, vuelva a definir las variables de entorno y verifique que root puede acceder a las variables de entorno.
Una vez finalizada la verificación, puede iniciar la instalación de Management Agent: conéctese como root, defina las variables de entorno e inicie la instalación de Management Agent.

Según el método que prefiera, puede seguir las instrucciones de Instalación de Management Agent en Linux (archivo RPM) o Instalación de Management Agent en Linux (archivo ZIP).

Por ejemplo, siga las instrucciones de Instalación de Management Agent en Linux (archivo RPM). En este caso, omita el paso 1, ya que ya es root y no necesita privilegios sudo. Comience en el paso 2: rpm -ivh <rpm_file_name.rpm>

Credenciales de origen de Management Agent

En esta sección se describe cómo gestionar credenciales de origen que pueden ser necesarias para permitir que Management Agent recopile datos de determinados orígenes de datos.

Después de desplegar plugins en una instancia de Management Agent, puede que necesite configurar credenciales de origen para permitir que el agente recopile datos de diferentes orígenes.

Cada origen de datos gestiona las credenciales de una forma diferente. La configuración de credenciales de origen es específica del tipo de plugin o servicio desplegado en el agente. Para obtener más información, consulte la documentación del servicio o del plugin.

Tipos de credencial

El almacén de credenciales del agente puede almacenar credenciales conocidas y comprendidas por el agente (por ejemplo, credenciales de Oracle Database), así como credenciales que solo entiende el servicio específico. El agente valida los tipos de credenciales incorporados, pero también acepta otros tipos de formato libre sin ninguna validación.

Credenciales de formato libre

Un usuario puede definir credenciales de cualquier tipo que contengan una o más propiedades confidenciales. Puesto que son de formato libre, no se pueden clasificar.

Por ejemplo:

SSHKeyCreds

Credenciales de clave RSA SSH donde el agente necesita credenciales de clave SSH.

Este es un ejemplo del posible aspecto de las credenciales. SSHUserName, SSHPrivateKey y SSHPublicKey son propiedades sensibles a mayúsculas/minúsculas.

{"source":"<DATA_SOURCE_NAME>", 
"name":"OSCreds", 
"type":"SSHKeyCreds", 
"description":"<DESCRIPTION>", 
"properties":[
{"name":"SSHUserName","value":"<USER_NAME>"},               
{"name":"SSHPrivateKey","value":"<RSA_PRIVATE_KEY>"},
{"name":"SSHPublicKey","value":"<PUBLIC KEY>"]}

Por ejemplo:

{"source":"host.myvm.example.com", 
"name":"OSCreds", 
"type":"SSHKeyCreds", 
"description":"SSH keys for a twoods user", 
"properties":[
{"name":"SSHUserName","value":"twoods"},               
{"name":"SSHPrivateKey","value":"-----BEGIN RSA PRIVATE KEY-----\nMIICXQIBAAKBgQCKWjoLfOKsjglGQcKwB0zm1o/OabClELjcOOTS1FJh6pzvrDeL\nn3IfIW9VUiyfGNkjnj4cuO0mVctaQgGVtT6H+4fL8HKjWqPg9S+uc0WBKBzaLi9H\nAoGACZctlORIVkvWSr9+PnOTGiFfgKCE9TxOhD2RZyf+ufjofhjDFPOtlojbzd9P\nZovzaWurxJPxJIon+Y6/y1/wAKUFisOlY2XJl76NKXm/00OGSfocQ3WsxapEsWwR\nalRL0l5FhXVpTV5OH3M4Dy5ksIcDqiV6r\nMejuJ++3AHlflzzoITtmS3RDlpSsd27ZH9vzV9HgFQU3volRgOZqnVm/oGXWwjl7\n-----END RSA PRIVATE KEY-----"},
{"name":"SSHPublicKey","value":"-----BEGIN PUBLIC KEY-----\nMIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQCKWjoLfOKsjglGQcKwB0zm1o/O\nabClELjcOOTS1FJh6pzvrDeLn3IfIW9VUiyfQAcfTWRwb0JtzMcRONQIDAQAB\n-----END PUBLIC KEY-----"]}

Credenciales incorporadas

El agente tiene varios tipos de credenciales incorporados. Cualquier plugin de servicio puede proporcionar credenciales al agente mediante uno de los siguientes tipos de credenciales:

Tipo de credencial para gateways y proxies de gestión

ProxyCreds

Estas credenciales se utilizan para autenticar Management Gateway o proxies de red.

Requisitos previos: el agente se debe configurar con un gateway de gestión o un proxy mediante las dos propiedades siguientes:

GatewayServerHost. Por ejemplo: GatewayServerHost=myproxy.example.com
GatewayServerPort. Por ejemplo: GatewayServerPort=80

Las siguientes propiedades de credenciales son sensibles a mayúsculas y minúsculas:

ProxyUser: nombre de usuario para la autenticación con el proxy.
ProxyPassword: contraseña utilizada para autenticar al usuario.

{"source":"<DATA_SOURCE_NAME>", 
"name":"ManagementAgent-Proxy", 
"type":"ProxyCreds", 
"description":"<DESCRIPTION>", 
"properties":[
{"name":"ProxyUser","value":"<USER_NAME>"},               
{"name":"ProxyPassword","value":"<USER_PASSWORD>"}]}

Por ejemplo:

{"source":"agent.ocid1.managementagent.oc1.iad.amaabb", 
"name":"ManagementAgent-Proxy", 
"type":"ProxyCreds", 
"description":"Proxy Credentials", 
"properties":[
{"name":"ProxyUser","value":"joe"},               
{"name":"ProxyPassword","value":"welcome_1"}]}

Nota

Estas credenciales las utiliza el agente para comunicarse con los servicios de Oracle Cloud Infrastructure. Cambiar su formato o eliminar la credencial puede tener un efecto adverso en la capacidad del agente para volver a comunicarse con los servicios de Oracle Cloud Infrastructure.

Tipo de credencial para bases de datos

DBCreds

Estas credenciales se utilizan para autenticarse en una base de datos Oracle mediante el protocolo TCP.

Las siguientes propiedades son sensibles a mayúsculas/minúsculas:

DBUserName: nombre de usuario de la base de datos.
DBPassword: contraseña del usuario de la base de datos.
DBRole: rol del usuario de la base de datos. Puede ser: SYSDBA, SYSOPER, NORMAL. Si no se especifica, se utilizará NORMAL.

{"source":"<DATA_SOURCE_NAME>", 
"name":"SQLCreds", 
"type":"DBCreds", 
"description":"<DESCRIPTION>", 
"properties":[
{"name":"DBUserName","value":"<DB_USER_NAME>"},               
{"name":"DBPassword","value":"<DB_USER_PASSWORD>"},               
{"name":"DBRole","value":"<DB_ROLE>"}]}

Por ejemplo:

{"source":"auditvault_db.myhost", 
"name":"SQLCreds", 
"type":"DBCreds", 
"description":"This is a credential that can be used for operations on DATASAFE databases.", 
"properties":[
{"name":"DBUserName","value":"sys"},               
{"name":"DBPassword","value":"sys"},               
{"name":"DBRole","value":"SYSDBA"}]}

DBANOCreds

Estas credenciales se utilizan para autenticarse en una base de datos Oracle mediante el protocolo TCP.

Las siguientes propiedades son sensibles a mayúsculas/minúsculas:

DBUserName: nombre de usuario de la base de datos.
DBPassword: contraseña del usuario de la base de datos.
DBRole: rol del usuario de la base de datos. Puede ser: SYSDBA, SYSOPER, NORMAL. Si no se especifica, se utilizará NORMAL.
DBEncryptionTypes: lista de algoritmos de cifrado separados por comas entre paréntesis.
DBEncryptionLevel: nivel de cifrado especificado por el cliente. Puede ser: Rechazado, Aceptado, Solicitado, Necesario. Si no se especifica, se utilizará el valor por defecto de los servicios ANO.
DBChecksumTypes: lista de algoritmos de total de control separados por comas entre paréntesis.
DBChecksumLevel: nivel de integridad especificado por el cliente (REJECTED, ACCEPTED, REQUESTED, REQUIRED). Si no se especifica, se utilizará el valor por defecto de los servicios ANO.

{"source":"<DATA_SOURCE_NAME>", 
"name":"SQLCreds", 
"type":"DBANOCreds", 
"description":"<DESCRIPTION>", 
"properties":[
{"name":"DBUserName","value":"<DB_USER_NAME>"},               
{"name":"DBPassword","value":"<DB_USER_PASSWORD>"},               
{"name":"DBRole","value":"<DB_ROLE>"},               
{"name":"DBEncryptionTypes","value":"<DB_ENCRYPTION_TYPE>"},               
{"name":"DBEncryptionLevel","value":"<DB_ENCRYPTION_LEVEL>"},               
{"name":"DBChecksumTypes","value":"<DB_CHECKSUM_TYPE>"},               
{"name":"DBChecksumLevel","value":"<DB_CHECKSUM_LEVEL>"}]}

Por ejemplo:

{"source":"auditvault_db.myhost", 
"name":"SQLCreds", 
"type":"DBANOCreds", 
"description":"This is a credential that can be used for operations on DATASAFE databases.", 
"properties":[
{"name":"DBUserName","value":"sys"},               
{"name":"DBPassword","value":"sys"},               
{"name":"DBRole","value":"SYSDBA"},               
{"name":"DBEncryptionTypes","value":"(AES256,AES192,AES128,3DES168,3DES112)"},               
{"name":"DBEncryptionLevel","value":"REQUIRED"},               
{"name":"DBChecksumTypes","value":"(SHA2)"},               
{"name":"DBChecksumLevel","value":"REQUESTED"}]}

DBTCPSCreds

Estas credenciales se utilizan para autenticar mediante TCPS.

Las siguientes propiedades son sensibles a mayúsculas/minúsculas:

DBUserName: nombre de usuario de la base de datos.
DBPassword: contraseña del usuario de la base de datos.
DBRole: rol del usuario de la base de datos. Puede ser: SYSDBA, SYSOPER, NORMAL. Si no se especifica, se utilizará NORMAL.
ssl_trustStoreType: tipo del almacén de confianza.
ssl_trustStoreLocation: ubicación en el sistema de archivos de la cartera del almacén de confianza. Debe ser accesible para el usuario del agente.
ssl_trustStorePassword: contraseña de la cartera del almacén de confianza.
ssl_keyStoreType: tipo del almacén de claves.
ssl_keyStoreLocation: ubicación en el sistema de archivos de la cartera del almacén de claves. Debe ser accesible para el usuario del agente.
ssl_keyStorePassword: contraseña de la cartera del almacén de claves.
ssl_server_cert_dn: nombre de dominio del certificado del servidor.

Nota

A partir de la versión de Management Agent: 230207.1529 (febrero de 2023), la propiedad ssl_server_cert_dn es opcional. (Por ejemplo: {"name":"ssl_server_cert_dn","value":"<SERVER_CERT_DN>"}).
Si la cartera del servidor contiene un valor para ella, el usuario puede proporcionarlo en las credenciales. Si está ausente en la cartera, el usuario no tiene que proporcionarla en las credenciales.

Para versiones anteriores, el agente de gestión espera que las credenciales contengan esta propiedad. Sin embargo, para indicar que no hay ningún valor para ssl_server_cert_dn, el usuario debe especificar el valor "unknownDn".

{"source":"<DATA_SOURCE_NAME>", 
"name":"SQLCreds", 
"type":"DBTCPSCreds", 
"description":"<DESCRIPTION>", 
"properties":[
{"name":"DBUserName","value":"<DB_USER_NAME>"},               
{"name":"DBPassword","value":"<DB_USER_PASSWORD>"},               
{"name":"ssl_trustStoreType","value":"<STORE_TYPE>"},               
{"name":"ssl_trustStoreLocation","value":"<STORE_LOCATION>"},               
{"name":"ssl_trustStorePassword","value":"<STORE_PASSWORD>"},               
{"name":"ssl_keyStoreType","value":"<KEY_STORE_TYPE>"},               
{"name":"ssl_keyStoreLocation","value":"<KEY_STORE_LOCATION>"},               
{"name":"ssl_keyStorePassword","value":"<KEY_STORE_PASSWORD>"},               
{"name":"ssl_server_cert_dn","value":"<SERVER_CERT_DN>"}]}

Por ejemplo:

{"source":"auditvault_db.myhost_pdb1_regress", 
"name":"SQLCreds", 
"type":"DBTCPSCreds", 
"description":"This is a TCPS credential that can be used for operations on DATASAFE databases.", 
"properties":[
{"name":"DBUserName","value":"C#AUDIT"},               
{"name":"DBPassword","value":"welcome_1"},               
{"name":"ssl_trustStoreType","value":"JKS"},               
{"name":"ssl_trustStoreLocation","value":"/home/jks_wallets/ewalletT.jks"},               
{"name":"ssl_trustStorePassword","value":"welcome_1"},               
{"name":"ssl_keyStoreType","value":"JKS"},               
{"name":"ssl_keyStoreLocation","value":"/home/jks_wallets/ewalletK.jks"},               
{"name":"ssl_keyStorePassword","value":"welcome_1"},               
{"name":"ssl_server_cert_dn","value":"CN=myvm.example.com"}]}

Adición o actualización de credenciales

Para agregar credenciales o actualizar las existentes, utilice el script credential_mgmt.sh con la operación upsertCredentials.

El script credential_mgmt.sh se encuentra en el directorio /opt/oracle/mgmt_agent/agent_inst/bin.

Sintaxis

credential_mgmt.sh -o upsertCredentials -s [service-name]

Nota

Para las instancias de Management Agent que se ejecutan en instancias informáticas mediante el plugin de Oracle Cloud Agent, la ubicación del script credential_mgmt.sh está en /var/lib/oracle-cloud-agent/plugins/oci-managementagent/polaris/agent_inst/bin.

Cree un archivo JSON con la información de credenciales.

El siguiente ejemplo es un formato de tipo de credencial para un origen datasafe_db denominado orcl123:

{"source":"datasafe_db.orcl123", 
"name":"audit_cred", 
"description":"This is the audit credential for orcl123 Oracle RDBMS system.", 
"properties":[ 
{"name":"username","value":"CLEAR[scott]"}, 
{"name":"password","value":"CLEAR[tiger]"}]
}

Por ejemplo, puede guardar el archivo como my_credentials.json.

Agregue credenciales mediante un archivo JSON.

credential_mgmt.sh -o upsertCredentials -s [service-name]

Por ejemplo, puede ejecutar lo siguiente para el servicio DataSafe mediante el archivo my_credentials.json:

cat my_credentials.json | sudo -u mgmt_agent /opt/oracle/mgmt_agent/agent_inst/bin/credential_mgmt.sh -o upsertCredentials -s datasafe

Suprima el archivo JSON creado en el paso 1.

El archivo JSON de credenciales contiene información confidencial. Los clientes son responsables de suprimir el archivo JSON de credenciales después de completar la operación de adición o actualización de credenciales.

Supresión de credenciales

Para suprimir credenciales, utilice el script credential_mgmt.sh con la operación deleteCredentials.

El script credential_mgmt.sh se encuentra en el directorio /opt/oracle/mgmt_agent/agent_inst/bin.

Sintaxis

credential_mgmt.sh -o deleteCredentials -s [service-name]

Cree un archivo JSON con el siguiente formato:
```
{"source":"datasafe_db.orcl123"
 "name":"audit_cred"} 
```
Por ejemplo, puede guardar el archivo como my_credentials.json.

Suprima las credenciales con un archivo JSON.

credential_mgmt.sh -o deleteCredentials -s [service-name]

Por ejemplo, puede ejecutar lo siguiente para el servicio DataSafe mediante el archivo my_credentials.json:

cat my_credentials.json | sudo -u mgmt_agent /opt/oracle/mgmt_agent/agent_inst/bin/credential_mgmt.sh -o deleteCredentials -s datasafe

Suprima el archivo JSON creado en el paso 1.

El archivo JSON de credenciales contiene información confidencial. Los clientes son responsables de suprimir el archivo JSON de credenciales después de completar la operación de supresión de credenciales.

Adición o actualización de alias de credencial

Para agregar un alias de credencial o actualizar uno existente, utilice el script credential_mgmt.sh con la operación aliasCredentials.

El script credential_mgmt.sh se encuentra en el directorio /opt/oracle/mgmt_agent/agent_inst/bin.

Sintaxis

credential_mgmt.sh -o aliasCredentials -s [service-name]

Cree un archivo JSON con el siguiente formato:

{"alias":
 {"source":"datasafe_db.orcl123",
  "name":"audit_cred"},
 "credential":
  {"source":"datasafe_db.host.1521.orcl123",
   "name":"datasafe_cred"}}

Por ejemplo, puede guardar el archivo como my_credentials.json.

Agregue un alias de credencial con un archivo JSON.

credential_mgmt.sh -o aliasCredentials -s [service-name]

Por ejemplo, puede ejecutar lo siguiente para el servicio DataSafe mediante el archivo my_credentials.json:

cat my_credentials.json | sudo -u mgmt_agent /opt/oracle/mgmt_agent/agent_inst/bin/credential_mgmt.sh -o aliasCredentials -s datasafe

Suprima el archivo JSON creado en el paso 1.

El archivo JSON de credenciales contiene información confidencial. Los clientes son responsables de suprimir el archivo JSON de credenciales después de completar la operación de adición o actualización de alias de credenciales.

Supresión de alias de credencial

Para suprimir un alias de credencial, utilice el script credential_mgmt.sh con la operación unaliasCredentials.

El script credential_mgmt.sh se encuentra en el directorio /opt/oracle/mgmt_agent/agent_inst/bin.

Sintaxis

credential_mgmt.sh -o unaliasCredentials -s [service-name]

Cree un archivo JSON con el siguiente formato:
```
{"source":"datasafe_db.orcl123",
 "name":"audit_cred"}
```
Por ejemplo, puede guardar el archivo como my_credentials.json.

Suprima un alias de credencial con un archivo JSON.

credential_mgmt.sh -o unaliasCredentials -s [service-name]

Por ejemplo, puede ejecutar lo siguiente para el servicio DataSafe mediante el archivo my_credentials.json:

cat my_credentials.json | sudo -u mgmt_agent /opt/oracle/mgmt_agent/agent_inst/bin/credential_mgmt.sh -o unaliasCredentials -s datasafe

Suprima el archivo JSON creado en el paso 1.

El archivo JSON de credenciales contiene información confidencial. Los clientes son responsables de suprimir el archivo JSON de credenciales después de completar la operación de supresión de alias de credenciales.

Logs de auditoría de Management Agent

El servicio Management Agent soporta el registro del servicio Audit. Este servicio registra automáticamente las llamadas a todos los puntos finales de la interfaz de programación de aplicaciones (API) pública de Oracle Cloud Infrastructure soportada como eventos de log.

Auditoría de Management Agent

El servicio Management Agent soporta la palabra clave management-agent del servicio Audit.

Puede utilizar OCI Console para ver los eventos de log del servicio Management Agent.

Abra el menú de navegación. En Gobernanza y administración, vaya a Gobernanza y haga clic en Auditoría.

Se muestra el servicio Audit.

Para buscar los eventos de log de los agentes de gestión, seleccione el compartimento deseado e introduzca management-agent en el campo KEYWORDS.

Para obtener más información sobre el servicio Audit, consulte Visión general de Audit en la documentación de Oracle Cloud Infrastructure.

Uso de Java con Management Agent

Management Agent necesita que Java Runtime Environment (JRE) esté preinstalado en cualquier entorno en el que se esté desplegando Management Agent. Para obtener información sobre los requisitos de Management Agent, consulte Requisitos genéricos para desplegar instancias de Management Agent.

JRE se utiliza para ejecutar Management Agent. Oracle recomienda cambiar a la última versión de JRE disponible ya que las nuevas actualizaciones están disponibles con correcciones de bugs y parches de seguridad.

En esta sección se explica cómo actualizar JRE para Management Agent.

Cambio de versión de JRE en Linux

En estas instrucciones, se describe cómo cambiar la versión de JRE en plataformas Linux de 64 bits, incluidos los siguientes: Oracle Linux, CentOS, Ubuntu y SUSE Linux.

Cambio de versión de JRE mediante el paquete RPM

Este es el método de cambio de versión preferido. Instala la última versión de JRE en la ubicación adecuada.

Para cambiar la versión de JRE mediante el archivo de paquete RPM que se encuentra en la página de descarga de Java, realice lo siguiente:

Descargue JRE.
Descargue la última versión de JRE de: https://www.oracle.com/java/technologies/downloads/#java8.
Cierre Management Agent.
```
sudo systemctl stop mgmt_agent
```

Actualice JRE.

sudo rpm -Uvh jre-8u<VERSION>-linux-x64.rpm

Actualice los enlaces simbólicos de Java.
Cambie los enlaces simbólicos de Java por defecto del sistema para hacer referencia a la nueva ubicación de JRE mediante el comando update-alternatives.
```
sudo update-alternatives --config java
```
También puede cambiar manualmente los enlaces simbólicos de Java por defecto si el comando update-alternatives no está disponible para la plataforma.

Para actualizar los enlaces simbólicos para cambiar el valor por defecto de Java manualmente, utilice lo siguiente:
```
sudo ln -s <path-to-java_home>/bin/java /usr/bin/java
```
Verifique el cambio de versión de JRE.
Verifique que el entorno utiliza el nuevo JRE como valor por defecto ejecutando lo siguiente:
```
env -i java -version
```
La salida es similar a la siguiente:
```
java version "1.8.0_xxx"
...
```
Inicia Management Agent.
```
sudo systemctl start mgmt_agent
```

Verifique que Management Agent se está ejecutando con el JRE actualizado.

grep "java.runtime.version" /opt/oracle/mgmt_agent/agent_inst/log/startup.info

La salida es similar a la siguiente:

java.runtime.version=1.8.0_<VERSION>

Cambio de versión de JRE mediante el archivo comprimido

Para cambiar la versión de JRE mediante el archivo comprimido (archivo tar), haga lo siguiente:

Descarga del último archivo JRE.
Descargue la última versión de https://www.oracle.com/java/technologies/downloads/#java8.
Cierre Management Agent.
```
sudo systemctl stop mgmt_agent
```
Extraiga el archivo comprimido de JRE Java a la ubicación de Java.
En el siguiente ejemplo, la ubicación de destino Java es el directorio /usr/lib/jvm/
```
sudo tar -xvfz jre-8u<VERSION>-linux-x64.tar.gz -C /usr/lib/jvm/
```
Actualice los enlaces simbólicos de Java.
Cambie los enlaces simbólicos de Java por defecto del sistema para hacer referencia a la nueva ubicación de JRE mediante el comando update-alternatives.
```
# install/register the new java with alternatives
sudo update-alternatives --install "/usr/bin/java" "java" "<path-to-java_home>/bin/java" 1

# set executables as default using update-alternatives command
sudo update-alternatives --set java "<path-to-java_home>/bin/java"
```
Como alternativa, si el comando update-alternatives no está disponible para la plataforma, puede cambiar los enlaces simbólicos Java por defecto manualmente.

Para actualizar los enlaces simbólicos para cambiar el valor por defecto de Java manualmente, utilice lo siguiente:
```
sudo ln -s <path-to-java_home>/bin/java /usr/bin/java
```
Verifique el cambio de versión de JRE.
Verifique que el entorno utiliza el nuevo JRE como valor por defecto ejecutando lo siguiente:
```
env -i java -version
```
La salida es similar a la siguiente:
```
java version "1.8.0_xxx"
...
```
Inicia Management Agent.
```
sudo systemctl start mgmt_agent
```

Verifique que Management Agent se está ejecutando con el JRE actualizado.

grep "java.runtime.version" /opt/oracle/mgmt_agent/agent_inst/log/startup.info

La salida es similar a la siguiente:

java.runtime.version=1.8.0_<VERSION>

Cambio de versión de JRE en Windows

En este tema se explica cómo cambiar la versión de JRE en plataformas de Windows de 64 bits soportadas para ejecutar Management Agent.

Las instalaciones del agente de gestión en entornos Windows requieren definir la variable de entorno JAVA_HOME antes de la instalación. Para obtener más información, consulte Actualización de JAVA_HOME personalizado para que el entorno de Windows defina la variable JAVA_HOME en una ubicación que se pueda cambiar en el futuro.

Para cambiar la versión de JRE en Windows, realice lo siguiente:

Descarga del archivo del instalador de JRE.
Descargue la última versión de JRE de https://www.oracle.com/java/technologies/downloads/#java8.
Cierre Management Agent.
```
sc stop mgmt_agent 
```
Actualice JRE.
- Haga doble clic en el archivo del instalador descargado en el paso 1 para ejecutarlo y siga las instrucciones interactivas proporcionadas por el instalador.
  Si prefiere realizar una instalación silenciosa, utilice el siguiente comando:
```
# Optional Command Line Silent Install
# Start the installer with silent (/s) switch and store output to jre8-install.log file with log (/L) switch
jre-8u<VERSION>-windows-x64.exe /s /L C:/jre8-install.log
```
Alternativa: Si prefiere no utilizar el archivo de instalador mencionado anteriormente, extraiga el archivo de almacenamiento comprimido a la ubicación deseada.

Actualice la intersección (enlaces simbólicos de Java).

Suprimir la intersección existente y crear una nueva, apuntándola a la nueva ubicación de JRE.

rd C:\Oracle\jre8-latest
mklink /J "C:\Oracle\jre8-latest" "C:\Program Files\Java\jre1.8.0_<VERSION>
Junction created for C:\Oracle\jre8-latest <<===>> C:\Program Files\Java\jre1.8.0_<VERSION>

Verifique el cambio de versión de JRE.
Verifique que el entorno utiliza el nuevo JRE como valor por defecto ejecutando lo siguiente:
```
echo %JAVA_HOME%
C:\Oracle\jre8-latest

%JAVA_HOME%/bin/java -version
# output example:
java version "1.8.0_<VERSION>"
...
```
Inicia Management Agent.
```
sc start mgmt_agent 
```
Verifique que Management Agent se está ejecutando con el JRE actualizado.
Confirme que la configuración de java.runtime.version coincide con el JRE recién instalado.
```
findstr "java.runtime.version" C:\Oracle\mgmt_agent\agent_inst\log\startup.info
java.runtime.version=1.8.0_<VERSION>
```

Actualización de JAVA_HOME personalizado

Hay entornos que no tienen una ubicación Java por defecto del sistema. En esos casos, Oracle recomienda actualizar la ubicación personalizada JAVA_HOME antes de iniciar el proceso de actualización de JRE.

Al utilizar una ubicación JAVA_HOME personalizada para la instalación de Management Agent, el cambio de versión de JRE puede causar problemas si la versión de Java está incluida en la ruta JAVA_HOME. La solución consiste en crear un enlace simbólico para la ruta JAVA_HOME que no debe hacer referencia al número de versión de JRE.

Escenario: el entorno tiene una versión de JRE, pero la ruta de acceso JAVA_HOME tiene el número de versión incluido en la ruta, aunque apunte a una versión de JRE diferente después de una actualización.

Escenario de Linux: el entorno tiene la versión de JRE: jre1.8.301 y la ruta JAVA_HOME se define como JAVA_HOME=/custom/jre1.8.301. Al cambiar a una nueva versión de JRE, por ejemplo jre1.8.311, el nuevo JRE se instala con una variable JAVA_HOME que apunta a la ubicación: /custom/jre1.8.301.
Escenario de Windows: el entorno tiene la versión de JRE: jre1.8.301 y la ruta JAVA_HOME se define como JAVA_HOME=C:\custom\jre1.8.301. Al cambiar a una nueva versión de JRE, por ejemplo: jre1.8.311, el nuevo JRE se instala con una variable JAVA_HOME que apunta a la ubicación: C:/custom/jre1.8.301.

Problema: la configuración anterior generará confusión de versión de JRE, ya que la ruta JAVA_HOME hace referencia a un valor 'jre1.8.301' aunque la versión real de JRE después de la actualización sea jre1.8.311.

Solución: Cree un enlace simbólico sin número de versión incluido como parte de él y utilícelo como valor JAVA_HOME para instalar Management Agent.

Un enlace simbólico sin referencia de número de versión simplifica el proceso de cambio de versión de JRE. El cambio de versión solo requerirá un cambio en la ubicación a la que apunta el enlace simbólico.

Solución de Linux: JAVA_HOME=/custom/jre8-latest -> /custom/jre1.8.301
Solución de Windows: JAVA_HOME=C:\custom\jre8-latest -> C:\custom\jre1.8.301

Documentación de Oracle Cloud Infrastructure

Visión general de la consola de Management Agent

Visión general

Paneles de Control

Agentes

Descargas y claves

Descarga de software de agente

Claves de instalación de agente

Despliegue de plugins de servicio

Activar logs del agente

Gestionar DataSources

Control de instancias de Management Agent

Gestión de claves de instalación

Creación de la clave de instalación

Copia de la clave de instalación

Descarga de la clave de instalación

Supresión de la clave de instalación

Cambio de versión de las instancias de Management Agent

Cambio de versión automático

Cambio de versión manual

Eliminación de instancias de Management Agent

Uso de un usuario del sistema operativo no por defecto para instalar Management Agent

Credenciales de origen de Management Agent

Tipos de credencial

Credenciales de formato libre

Credenciales incorporadas

Tipo de credencial para gateways y proxies de gestión

Tipo de credencial para bases de datos

Adición o actualización de credenciales

Supresión de credenciales

Adición o actualización de alias de credencial

Supresión de alias de credencial

Logs de auditoría de Management Agent

Uso de Java con Management Agent

Cambio de versión de JRE en Linux

Cambio de versión de JRE mediante el paquete RPM

Cambio de versión de JRE mediante el archivo comprimido

Cambio de versión de JRE en Windows

Actualización de JAVA_HOME personalizado