Fallo de registro para instancia o estación de gestión

Una instancia o estación de gestión puede no registrarse en OS Management Hub por varios motivos.

Consulte también:

Problema conocido: Las imágenes de la plataforma más antiguas o Traiga sus propias imágenes no se registrarán
'No hay ningún perfil disponible' al activar el plugin de OS Management Hub

Mensajes de Error comunes para osmh-agent.log

Para solucionar problemas de registro, comience examinando el archivo osmh-agent.log para ver los siguientes mensajes de error. Consulte Examining Log Files on an Instance para identificar la ubicación del archivo log.


Código y mensaje	Causa y resolución posibles
`Http Status Code: 400. Error Code: MissingParameter.` `Message: Registration profile is required for on-boarding instances, but none was provided.`	Causa: para la nube local o de terceros, falta `/etc/osmh-profile` o no es válido. Para las instancias de OCI, no había un perfil por defecto compatible en el registro. Resolución: identifique y utilice un perfil compatible. Consulte Se ha utilizado un perfil no válido.
`Http Status Code: 404. Error Code: NotAuthorizedOrNotFound.` `Message: Authorization failed or requested resource not found.`	Causa: las políticas actuales no permiten que OS Management Hub acceda a la instancia. Normalmente, el grupo dinámico no incluye reglas de coincidencia para el compartimento que contiene la instancia. O bien, hay una sentencia de política faltante o incorrecta. Resolución: compruebe que las políticas son correctas. Consulte Sentencia de política incorrecta o regla de grupo dinámico faltante.
`Http Status Code: 409. Error Code: Conflict.` `Message: Managed Instance location ON_PREMISE is not compatible with a Profile registration type of: OCI_LINUX`	Causa: el perfil tiene un tipo de instancia incorrecto. Por ejemplo, la instancia se encuentra localmente o en una nube de terceros, pero el perfil es para un tipo de instancia de OCI. Resolución: identifique y utilice un perfil compatible. Consulte Se ha utilizado un perfil no válido.
`Http Status Code: 409. Error Code: Conflict.` `Message: Invalid Managed Instance osFamily ORACLE_LINUX_8 does not match Profile osFamily: ORACLE_LINUX_7`	Causa: el perfil tiene un sistema operativo incorrecto. Por ejemplo, la instancia es Oracle Linux 8, pero el perfil es Oracle Linux 7. Resolución: identifique y utilice un perfil compatible. Consulte Se ha utilizado un perfil no válido.
`Http Status Code: 409. Error Code: IncorrectState.` `Message: Station already has an instance associated`	Causa: el perfil es para una estación de gestión y ya lo utiliza otra estación. Un perfil de estación de gestión solo se puede utilizar una vez. Resolución: identifique y utilice un perfil compatible para `/etc/osmh-profile`. Consulte Se ha utilizado un perfil no válido. A continuación, vuelva a intentar el registro.
`TokenRefreshAuthenticationException: Token refresh failed due to authentication issues due to AuthenticationException` `HTTP 401: NotAuthenticated` `Unable to authenticate the request for ocid1.managementagent.oc1.iad.<ocid>`	Causa: el agente de Management Agent Cloud Service (MACS) no se está ejecutando como se esperaba. Resolución: verifique que el agente MACS esté configurado correctamente y reinicie el agente. Consulte Troubleshooting MACS.

Mensajes de error comunes de Oracle Cloud Agent

Para las instancias de OCI, utilice el estado de plugin del agente del hub de gestión del sistema operativo para solucionar problemas de registro. En la consola, en el separador Oracle Cloud Agent de la página de detalles de la instancia informática, puede ver uno de los siguientes mensajes de error.


Mensaje de Error	Causa y solución posibles
`El agente del hub de gestión del sistema operativo del plugin no está presente para la instancia ocid1.instance.oc1.iad.<ocid>`	Causa: el agente del hub de OS Management no está instalado en la instancia. Esto suele ocurrir cuando el servicio no puede acceder a la instancia debido a un problema de política. Resolución: compruebe que las sentencias de política son correctas y que la instancia está incluida en el grupo dinámico. Consulte Sentencia de política incorrecta o regla de grupo dinámico faltante.
`fallo al iniciar osmh-agent con [fallo de imagen de consulta]. La instancia no se ha podido registrar con OS Management Hub.`	Causa: el agente del hub de OS Management no se puede iniciar en la instancia. Esto suele ocurrir cuando el servicio no puede acceder a la instancia debido a un problema de política. Resolución: compruebe que las sentencias de política son correctas y que la instancia está incluida en el grupo dinámico. Si no utiliza el dominio de identidad por defecto, verifique que ha especificado el dominio de identidad en las sentencias de política. Consulte Sentencia de política incorrecta o regla de grupo dinámico faltante.

Se ha utilizado un perfil no válido

Compruebe el archivo osmh-agent.log e identifique el perfil correcto

Determine la ubicación del archivo osmh-agent.log.

Examine el archivo de registro y busque la palabra clave "Error Code" para determinar si existe un error de perfil. Consulte Mensajes de error comunes de osmh-agent.log.

Por ejemplo, para una instancia de OCI de Oracle Linux:

sudo grep -i "error code" /var/lib/oracle-cloud-agent/plugins/oci-osmh/osmh-agent/stateDir/log/osmh-agent.log

Por ejemplo, para una instancia local:

sudo grep  -i "error code" /opt/oracle/mgmt_agent/plugins/osmh/stateDir/log/osmh-agent.log

Por ejemplo, para una instancia de Windows:

Get-Content C:\Windows\ServiceProfiles\OCAOSMH\AppData\Local\OracleCloudAgent\plugins\oci-osmh\osmh-agent\stateDir\log\osmh-agent.log | Select-String -Pattern "Error Code"

Identifique (o cree) un perfil que coincida con la versión del sistema operativo, la arquitectura y la ubicación de la instancia que está registrando.

Para actualizar el perfil de las instancias de OCI

Abra el menú de navegación y seleccione Observability & Management.
En OS Management Hub, seleccione Instances.
Seleccione el compartimento que contiene la instancia que le interesa.
Seleccione el nombre de la instancia.
Seleccione Definir perfil.
Seleccione el compartimento y el perfil correcto que se utilizará para el registro.
Seleccione Definir.

El estado de la instancia puede tardar varios minutos en actualizarse.

Para actualizar el perfil de las instancias en la nube locales o de terceros:

Ver los detalles del perfil.
Copie el contenido /etc/osmh-profile.
Conéctese a la instancia como usuario con privilegios sudo.
Sustituya /etc/osmh-profile por el perfil corregido. La instancia se registrará la próxima vez que el plugin de OS Management Hub se proteja con el servicio.

Falta la regla de grupo dinámico o la sentencia de política es incorrecta

Si se producen los siguientes errores al registrar una instancia, puede indicar que las sentencias de política o las reglas de grupo dinámico no están definidas correctamente.

osmh-agent.log contiene:

ERROR: failed to update managed instance: Error returned by  Service. Http Status Code: 404.
                    Error Code: NotAuthorizedOrNotFound. Opc request id: <requestID>. Message: Authorization failed or requested resource not found.
                    ...
                    Request Endpoint: PUT https://osmh.<region>.oci.oraclecloud.com/20220901/agent/managedInstances/ocid1.managementagent.oc1.iad.<ocid>

O bien, el separador Oracle Cloud Agent de la página de detalles de la instancia informática muestra uno de los siguientes mensajes:

Plugin OS Management Hub Agent not present for instance ocid1.instance.oc1.iad.<ocid>

failed to start osmh-agent with [lookup image failed. The instance could not register with OS Management Hub.

Para resolver el problema, verifique que haya configurado correctamente las sentencias de política y las reglas de grupo dinámico. Normalmente, el grupo dinámico no incluye la instancia.

Verifique los siguientes datos:

Asegúrese de que ha incluido una regla de grupo dinámico para cada compartimento y compartimento secundario que contiene las instancias que desea que gestione el servicio. Los grupos dinámicos no soportan la herencia de compartimentos.
Si no utiliza el dominio de identidad default, asegúrese de que cada sentencia de política tenga el dominio de identidad antes del nombre de grupo o grupo dinámico (por ejemplo, <identity_domain_name>/<dynamic_group_name>).

Consulte también: Solución de problemas: problemas de políticas.

El sistema no puede leer /etc/sudoers.d

Para las estaciones de gestión, las instancias locales o de nube de terceros, el archivo /etc/sudoers debe incluir /etc/sudoers.d para que Management Agent Cloud Service (MACS) despliegue el plugin de OS Management Hub.

Esto lo indica el siguiente error:

/opt/oracle/mgmt_agent/agent_inst/bin/setup.sh opts=/tmp/input.rsp
...
Starting plugin deployment for: [osmh]
Deploying service plugin(s)...Failed.
        Requested external plugins [osmh] could not be deployed

Donde /opt/oracle/mgmt_agent/agent_inst/log/mgmt_agent.log muestra lo siguiente:

[/bin/sudo, -n, /opt/oracle/mgmt_agent/agent_inst/bin/chown_recursive_ep.sh, chown_recursive, root:mgmt_agent, osmh], timeout=PT5M]

Para resolver el problema:

Edite el archivo /etc/sudoers.
```
sudo visudo
```

Agregue las siguientes líneas y guarde el archivo.

## Read drop-in files from /etc/sudoers.d (the # here does not mean a comment)
#includedir /etc/sudoers.d

Vuelva a ejecutar setup.sh. Consulte Registro de una instancia no de OCI o Registro de una estación de gestión.

La instancia se ha anulado el registro anteriormente

Si ha anulado previamente el registro de una instancia de OS Management Hub, hay pasos adicionales para volver a registrarla con el servicio. El proceso depende de la ubicación de la instancia.

Instancias de OCI

El nuevo registro de una instancia de OCI que se ha anulado el registro fallará hasta que elimine el archivo de anulación de registro en la instancia. Este archivo impide que la instancia se registre con el servicio. Al intentar registrar una instancia que contiene este archivo, el plugin del agente muestra el siguiente error: started oci-osmh under unregistered mode.

Elimine el siguiente archivo antes de registrar la instancia:

Oracle Linux

/var/lib/oracle-cloud-agent/plugins/oci-osmh/osmh-agent-unregister

Windows 2019 y 2022

C:\Windows\ServiceProfiles\OCAOSMH\AppData\Local\OracleCloudAgent\plugins\oci-osmh\osmh-agent-unregister

Windows 2016

C:\Users\OCAOSMH\AppData\Local\OracleCloudAgent\plugins\oci-osmh\osmh-agent-unregister

Instancias en la nube locales o de terceros

El nuevo registro de una instancia que no es de OCI y que se ha registrado anteriormente puede requerir la instalación del agente de gestión o el despliegue manual del plugin del agente de OS Management Hub.

Para volver a registrar la instancia:

Conéctese a la instancia como usuario con privilegios sudo.
Compruebe el estado del agente.
```
sudo systemctl status mgmt_agent
```
Si no se encuentra mgmt_agent, registre la instancia como si fuera nueva. Consulte Registro de una instancia no de OCI. Omita los pasos restantes de este procedimiento.
Si mgmt_agent está presente, inicie el agente y cree el archivo /etc/osmh-profile:
1. Inicie mgmt_agent:
```
sudo systemctl start mgmt_agent
```
2. Cree el archivo /etc/osmh-profile con un editor de texto. Asegúrese de que el nombre de archivo no tenga extensión de archivo.
```
sudo vi /etc/osmh-profile
```
En la consola, despliegue el plugin del agente del hub de gestión del sistema operativo en la instancia.
1. En la consola, vaya a Observability & Management. En Agente de gestión, seleccione Agentes.
2. En Ámbito, seleccione el compartimento.
3. Busque el agente correcto buscando el nombre de host en la columna Nombre. Seleccione el nombre del agente en la lista.
4. Seleccione Desplegar plugins.
5. Seleccione Hub de OS Management y, a continuación, seleccione Actualizar.
6. Espere unos minutos y, a continuación, verifique que la instancia se ha registrado.

El sistema operativo no está definido en la hora actual

Los errores de timeout en el registro se pueden producir cuando la hora de la instancia es diferente de la hora utilizada en el servicio OS Management Hub. Un sesgo de reloj de más de 5 minutos puede causar este tipo de errores.

Durante el registro de la estación de gestión o la instancia, se informa el siguiente error al ejecutar el script /opt/oracle/mgmt_agent/agent_inst/bin/setup.sh:

Starting plugin deployment for: [osmh] 
Deploying service plugin(s)..............................Timed out.
Agent is unable to check if it deployed requested service plugin(s) successfully or not. Please check back later on the console.

Determine si existe un sesgo de reloj comprobando la fecha de punto final del servicio managementagent con respecto a la instancia o la estación de gestión.

curl -s --head https://managementagent.<region>.oci.oraclecloud.com | grep Date

date -u

Por ejemplo:

$ curl -s --head https://managementagent.us-phoenix-1.oci.oraclecloud.com | grep Date
Date: Tue, 13 Jun 2023 15:42:17 GMT
$ date -u
Tue Jun 13 15:42:19 UTC 2023

Si la fecha u hora de la instancia o estación de gestión es diferente de las horas registradas por el servicio, actualice la hora del sistema operativo para que coincida con el servicio.
Si se utilizan utilidades de sincronización de hora como Chrony o el protocolo de hora de red (NTP), verifique su configuración y funcionamiento.

Por ejemplo, ejecute los siguientes comandos para verificar la configuración:
```
chronyc sources -a
```
```
chronyc tracking
```

Documentación de Oracle Cloud Infrastructure