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

  Se muestra la consola de Management Agent.

1. Cree un directorio para almacenar los certificados de autoridad de certificación raíz (CA) de confianza adicionales en formato PEM. En el siguiente ejemplo, el directorio tmp es un ejemplo. Puede utilizar cualquier directorio y confirmar que el usuario del agente tiene acceso de lectura a cada directorio de la ruta de los certificados.

   mkdir /tmp/crt

2. A continuación, introduzca el siguiente comando para copiar todos los certificados de confianza personalizados en formato PEM en el nuevo directorio creado en el paso anterior.

   cp *.pem /tmp/crt

3. Defina permisos para el directorio y su contenido para permitir que el agente independiente acceda a los certificados.

   chmod 644 /tmp/crt

4. Para agregar certificados protegidos personalizados al agente de gestión durante la instalación o la configuración, debe especificar el directorio para los certificados en el archivo de respuesta input.rsp.

   importTrustedCertsDirectory=/tmp/crt

5. Ahora, puede ejecutar la instalación para importar los certificados en Management Agent.
6. Después de la instalación, puede utilizar el siguiente comando y sustituir lo siguiente por valores para su entorno, para verificar los certificados de confianza importados correctamente en el almacén de claves del agente. Sustituya <CUSTOM_CERTIFICATE_FILE_NAME> por el nombre de archivo de certificado personalizado en su entorno, por ejemplo: my-cert.pem

   keytool -list -keystore /opt/oracle/mgmt_agent/agent_inst/config/security/comm/commwallet.jks -alias <CUSTOM_CERTIFICATE_FILE_NAME>

   El archivo commwallet.pem es un certificado personalizado que se agrega al almacén de certificados de confianza del agente.

1. Utilice los siguientes comandos para crear un directorio trustedcerts para importar los certificados de confianza a esta ubicación: /var/lib/oracle-cloud-agent/plugins/oci-managementagent/. Confirme que el usuario oracle-cloud-agent es propietario del directorio.

   cd /var/lib/oracle-cloud-agent/plugins/oci-managementagent/
   mkdir trustedcerts
   chown oracle-cloud-agent:oracle-cloud-agent trustedcerts/

2. Copie todos los certificados de confianza personalizados en formato PEM en el nuevo directorio creado en el paso anterior.

   cp *.pem /var/lib/oracle-cloud-agent/plugins/oci-managementagent/trustedcerts

3. Ahora, puede ejecutar la instalación del agente de OCA para importar los certificados al agente de gestión.
4. Después de la instalación, puede utilizar el siguiente comando para verificar los certificados de confianza importados correctamente en el almacén de claves del agente. Sustituya <CUSTOM_CERTIFICATE> por el nombre de archivo de certificado personalizado en su entorno, por ejemplo: my-cert.pem

   keytool -list -keystore /var/lib/oracle-cloud-agent/plugins/oci-managementagent/polaris/agent_inst/config/security/comm/commwallet.jks -alias <CUSTOM_CERTIFICATE>

   El archivo commwallet.pem es un certificado personalizado que se agrega al almacén de certificados de confianza del agente.

• Despliegue de un plugin mediante la página Agentes
• Despliegue de un plugin durante la instalación de Management Agent

1. En el menú de la izquierda, haga clic en Agentes para abrir la página Agentes.

2. En la lista Agentes, haga clic en el agente deseado donde desea desplegar el plugin.

   Aparecerá la página de detalles del agente.

   
   
   

3. Haga clic en Desplegar plugins.

   Se muestra la ventana Desplegar plugins.

4. Seleccione el plugin y seleccione Actualizar.

   Ahora, el plugin seleccionado se desplegará en el agente deseado.

1. 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 de gestión y Creación de la clave de instalación.

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

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

4. Instale Management Agent como se describe en Instalación de Management Agent para completar la instalación.

• Comprobar estado del plugin de servicio
• Comprobar estado de solicitud de trabajo

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

• Vaya a Observability & Management y vaya a Log Analytics.
• En la página Log 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.

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

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

• 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 orígenes de datos.

  En la ventana Orígenes de datos se 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 de creación del 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 origen de datos.

  Utilice Ver origen de datos 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 origen de datos para agregar un origen de datos.

  • Seleccione el tipo de origen de datos 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 origen de datos: utilice el menú de acción para suprimir un origen de datos.
• Editar origen de datos: 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.

1. Conéctese como usuario con permisos sudo.

2. Ejecute el siguiente comando:

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

   Para Oracle Linux 7: sudo systemctl start mgmt_agent

1. Conéctese como usuario Administrator y abra una ventana de símbolo del sistema.

2. Ejecute el siguiente comando: net start mgmt_agent

1. Inicie sesión como usuario con permisos sudo para ejecutar comandos como usuario root.

2. Ejecute el siguiente comando:

   sudo /etc/init.d/mgmt_agent start

1. Conéctese como usuario con permisos sudo.

2. Ejecute el siguiente comando:

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

   Para Oracle Linux 7: sudo systemctl stop mgmt_agent

1. Conéctese como usuario Administrator y abra una ventana de símbolo del sistema.

2. Ejecute el siguiente comando: net stop mgmt_agent

1. Conéctese como usuario que tenga el privilegio sudo para ejecutar comandos como usuario root.

2. Ejecute el siguiente comando:

   sudo /etc/init.d/mgmt_agent stop

1. Conéctese como usuario Administrator y abra una ventana de símbolo del sistema.

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

1. Conéctese como usuario que tenga el privilegio sudo para ejecutar comandos como usuario root.

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

• Cambio de versión automático
• Cambio de versión manual

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

• Eliminación de agentes de la interfaz de usuario

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

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

   Figura 4-1 Suprimir agente

   

2. Haga clic en Suprimir agente.

3. Pulse Suprimir para confirmar la selección.

• Linux con el comando RPM
• Linux con el script de desinstalador
• Windows
• Solaris
• AIX

sudo rpm -e <rpm_name>

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

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

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.

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.

• Opción 1. En el servicio Management Agent, Oracle recomienda utilizar la consola de Oracle Cloud o la API para agregar credenciales con nombre.
• Opción 2. Puede configurar credenciales de origen en los archivos de configuración del agente para permitir que el agente recopile datos de diferentes orígenes.

• Consola de Oracle Cloud
• API de credenciales con nombre de Management Agent

• Confirme que la versión de Management Agent: 250704.1404 o superior está instalada.
• Configure lo siguiente para el usuario:
  • Agregue los permisos necesarios para las credenciales con nombre. Consulte Escenarios de usuario y Detalles de referencia de política de servicio de Management Agent.
  • Agregue la siguiente política para credenciales con nombre. Consulte la Tabla 2-1 para Management Agent.

    ALLOW GROUP <group-name> TO MANAGE management-agent-named-credentials IN <compartment_name>

  • Crear un secreto en un almacén de claves. Para ello, necesita un permiso adicional para crear un secreto, consulte Creación de un secreto en un almacén y Detalles del almacén, la gestión de claves y los secretos. El almacén y el secreto pueden estar en diferentes compartimentos. Y tanto el almacén como el secreto pueden estar en un compartimento diferente al del agente.
  • Configure los siguientes permisos para poder leer el paquete de secretos. Consulte Detalles del almacén, la gestión de claves y los secretos.
    • Para mostrar los permisos VAULT_INSPECT y VAULT_READ de los almacenes.
    • Para mostrar los secretos de los permisos SECRET_INSPECT y SECRET_READ.
• Configure los permisos y las políticas para el recurso de agente, para ello:

  • Cree un grupo dinámico para el recurso de agente mediante el siguiente ejemplo. Sustituya ocid1.compartment.oc1.agentcompartmentid por el OCID del compartimento para el agente. Consulte Cómo crear un grupo dinámico en la consola y Gestión de grupos dinámicos.

    ALL {resource.type='managementagent', resource.compartment.id='ocid1.compartment.oc1.agentcompartmentid'}

  • Agregue la siguiente política para permitir que el grupo dinámico lea el secreto en un compartimento específico, sustituya ocid1.compartment.oc1.secretcompartmentid por el OCID del compartimento para el secreto. Consulte Actualización de una sentencia de política.

    allow dynamic-group X to read secret-bundles in compartment ocid1.compartment.oc1.secretcompartmentid

  • El agente también debe tener permisos y políticas para cualquier recurso de OCI que se utilice para crear credenciales con nombre. Por ejemplo, si el agente utiliza credenciales con nombre para interactuar con una base de datos autónoma, debe crear una política para permitir que el grupo dinámico del agente lea la cartera de la base de datos autónoma. Por ejemplo:

    allow dynamic-group X to read autonomous-databases in compartment DB_COMPARTMENT

• Un usuario operador con el permiso MGMT_AGENT_NAMED_CREDENTIAL_APPLY y, a continuación, los agentes a los que el usuario tiene acceso pueden utilizar credenciales con nombre para realizar acciones sin tener acceso a contraseñas. Un usuario con este permiso no podrá ver el almacén ni los OCID secretos que contiene la credencial con nombre.
• Un usuario administrador, con los siguientes permisos, puede realizar las operaciones CRUD estándar en credenciales con nombre y no tendrá acceso para leer el paquete de secretos del almacén.

  • MGMT_AGENT_NAMED_CREDENTIAL_CREATE

  • MGMT_AGENT_NAMED_CREDENTIAL_UPDATE

  • MGMT_AGENT_NAMED_CREDENTIAL_DELETE

• Si un usuario tiene el permiso MGMT_AGENT_DELETE, el usuario puede suprimir el recurso de agente y todas las credenciales con nombre asociadas también se suprimirán.
  Nota
  
  La supresión de un agente o una credencial con nombre no afecta al secreto almacenado en el almacén de OCI.

1. Abra el menú de navegación y seleccione Observación y gestión. En Agente de gestión, seleccione Agentes.
2. Seleccione el compartimento que contiene los agentes que desea mostrar. Seleccione la opción para incluir subcompartimentos para obtener una visión general de los detalles del agente en el compartimento seleccionado, incluidos los compartimentos secundarios.
3. En el menú Acciones, seleccione Gestionar credenciales con nombre.
   • O bien, puede ir a la página Detalles de agente, seleccionar la opción Más acciones y, a continuación, seleccionar Gestionar credenciales con nombre.
4. Introduzca el nombre de credencial. Opcionalmente, puede introducir una descripción.
5. Seleccione el tipo de credencial que desea agregar en la lista desplegable Tipo de credencial.
6. Para cada campo o atributo del tipo de credencial seleccionado, introduzca un valor o seleccione un identificador de recurso o seleccione un almacén y un identificador secreto.

   Si el recurso existe en un compartimento diferente, puede seleccionar Cambiar compartimento para cambiar el compartimento y buscar el valor del recurso.

7. Para agregar etiquetas, seleccione Mostrar opciones avanzadas.
   • Para agregar etiquetas, seleccione un espacio de nombres de etiqueta, introduzca una clave de etiqueta y un valor de etiqueta y, a continuación, seleccione Agregar etiqueta. Puede restringir el acceso a las credenciales agregando etiquetas. Si tiene los permisos necesarios para crear una credencial con nombre, también tiene los permisos para agregar etiquetas de formato libre. Para agregar una etiqueta definida, también debe tener los permisos para el espacio de nombres de la etiqueta. Para obtener más información, consulte Visión general de etiquetado y para obtener más información sobre cómo agregar una etiqueta al crear un recurso, consulte Trabajar con etiquetas de recursos.
   • Para suprimir una etiqueta, seleccione la X.
8. Seleccione Guardar para agregar la credencial con nombre al agente. Si no puede guardar las credenciales con nombre, confirme que ha introducido todos los campos necesarios.

   Cuando se guardan las credenciales con nombre, se envía una solicitud de trabajo al agente. Una vez finalizada la solicitud de trabajo, el agente puede utilizar estas credenciales con nombre para realizar varias tareas en varios plugins o servicios desplegados en el agente.

   Nota
   
   Si la solicitud de trabajo falla, confirme que el agente tiene el permiso SECRET_READ para acceder a los secretos del almacén y realizar la operación GetSecret, consulte Detalles del almacén, la gestión de claves y los secretos.

   Para editar o suprimir credenciales con nombre para un agente:

   1. Busque el agente que desea actualizar para que pueda:
      • Vaya a la página de lista Agentes. Junto al agente que desea actualizar, seleccione el menú Acciones y, a continuación, seleccione Gestionar credenciales con nombre.
      • También puede ir a la página Detalles de agente, seleccionar la opción Más acciones y, a continuación, seleccionar Gestionar credenciales con nombre.
   2. Seleccione Editar o Suprimir. Puede editar los detalles del almacén para el nombre de usuario y la contraseña. No puede editar el nombre ni el tipo de credencial.
      Nota
      
      Si suprime una credencial con nombre que está activamente en uso, la supervisión del origen en el agente se puede interrumpir.

• Tipos de Credenciales de Origen
• 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

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

• 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