Documentación de Oracle Cloud Infrastructure

Activación de instancias de Management Agent en instancias informáticas

Al utilizar una instancia informática, puede utilizar las capacidades de Oracle Cloud Agent para activar el plugin de Management Agent.

Antes de continuar, confirme que ha completado los requisitos. Para obtener más información, consulte Realización de requisitos para desplegar agentes de gestión en instancias informáticas.

Activar agentes de gestión

Los agentes de gestión se pueden activar mediante la consola de OCI o la API de Compute.
Nota

El plugin del agente de gestión en instancias informáticas se ejecuta en la máquina virtual de Java (JVM). A partir de marzo de 2023, el plugin del agente de gestión se despliega con un tiempo de ejecución de Java (JRE).

El tiempo de ejecución de Java siempre se mantiene actualizado como parte del proceso de actualización del agente de gestión para abordar las vulnerabilidades de seguridad recién detectadas. Después de activar el plugin del agente de gestión, es importante ejecutar la última versión del software del plugin del agente de gestión activando actualizaciones automáticas o invocando manualmente la operación de actualización periódicamente. Para obtener más información, consulte Actualización de agentes de gestión en instancias informáticas.

Activación de instancias de Management Agent mediante la consola

Para confirmar si el plugin de Management Agent está activado para una instancia:
  1. Abra el menú de navegación y haga clic en Recursos informáticos. En Recursos informáticos, haga clic en Instancias.
  2. Haga clic en la instancia en la que esté interesado.
  3. Haga clic en el separador Oracle Cloud Agent.

    Se muestra la lista de plugins.

  4. Alterne el conmutador Activado para el plugin de Management Agent.

Para obtener más información, consulte Gestión de plugins mediante la consola.

Activación de instancias de Management Agent mediante la API de Compute

Para obtener información sobre el uso de la API, consulte API de REST.

Para obtener información sobre los SDK, consulte Software development kits e interfaz de línea de comandos.

Utilice las siguientes operaciones de API para gestionar Management Agent como plugin de Oracle Cloud Agent:

  • LaunchInstance: activa o desactiva plugins o para todos los plugins al crear una instancia.

  • UpdateInstance: activa o desactiva plugins individuales, y para o inicia todos los plugins para una instancia existente.

A continuación, se muestra un extracto de la muestra de Java que se encuentra en las operaciones de API LaunchInstance o UpdateInstance, que permite al usuario activar Management Agent durante el inicio o la actualización de la instancia informática, respectivamente: 
... 
    .agentConfig(LaunchInstanceAgentConfigDetails.builder()
			.isMonitoringDisabled(false)
			.isManagementDisabled(true)
			.areAllPluginsDisabled(false)
			.pluginsConfig(new ArrayList<>(Arrays.asList(InstanceAgentPluginConfigDetails.builder()
					.name("Management Agent")   
					.desiredState(InstanceAgentPluginConfigDetails.DesiredState.Enabled).build()))).build())
...

Donde .name("Management Agent") indica que es para el plugin de Management Agent y .desiredState(InstanceAgentPluginConfigDetails.DesiredState.Enabled).build()))).build()) indica que se active Management Agent.

Para obtener más información, consulte Gestión de plugins mediante la API.

Configuración de Oracle Cloud Agent con Management Gateway

Para configurar Management Gateway para un agente de gestión activado en una instancia de Oracle Cloud Compute:

  1. Actualice el archivo emd.properties.
    1. Vaya al archivo emd.properties, normalmente en la siguiente ubicación:
      /var/lib/oracle-cloud-agent/plugins/oci-managementagent/polaris/agent_inst/config/emd.properties
    2. Al final del archivo, agregue las siguientes 3 entradas:
      GatewayServerHost=<gateway host>
GatewayServerPort=<gateway port>
GatewayServerCredentialTimeout=30s
  2. A continuación, si Management Gateway está configurado con un nombre de usuario y una contraseña de proxy, debe introducir las credenciales de Management Gateway en Management Agent.
    1. Utilice el siguiente comando para ver el contenido del archivo /tmp/cred.json. 
      cat /tmp/cred.json |sudo -u oracle-cloud-agent /var/lib/oracle-cloud-agent/plugins/oci-managementagent/polaris/agent_inst/bin/credential_mgmt.sh -o upsertCredentials -s Agent
    2. En el archivo /tmp/cred.json, sustituya los siguientes valores por las credenciales reales de Management Agent para su entorno:
      • OCID con el siguiente formato: agent.ocid1.managementagent.oc1.phx.unique-id
      • ejemplo-usuario
      • ejemplo-contraseña
        {"source":"agent.ocid1.managementagent.oc1.phx.unique-id",
"name":"ManagementAgent-Proxy",
"type":"ProxyCreds",
"description":"Proxy Credentials",
"properties":[
{"name":"ProxyUser","value":"example-username"},
{"name":"ProxyPassword","value":"example-password"}]}
  3. Introduzca el siguiente comando para reiniciar el agente de Oracle Cloud:
    systemctl restart oracle-cloud-agent