Echec de l'inscription de l'instance

L'inscription d'une instance à Autonomous Linux peut échouer pour plusieurs raisons.

Messages d'erreur osmh-agent.log communs

Pour résoudre les problèmes d'inscription, commencez par rechercher les messages d'erreur suivants dans le fichier osmh-agent.log. Reportez-vous à Examen des fichiers journaux sur une instance pour identifier l'emplacement du fichier journal.


Code et message	Cause et résolution possibles
`Http Status Code: 400. Error Code: MissingParameter.` `Message: Registration profile is required for on-boarding instances, but none was provided.`	Cause : il n'y avait pas de profil par défaut compatible lors de l'inscription. Résolution : identifiez et utilisez un profil compatible. Voir Un profil non valide a été utilisé.
`Http Status Code: 404. Error Code: NotAuthorizedOrNotFound.` `Message: Authorization failed or requested resource not found.`	Cause : les stratégies en cours n'autorisent pas le service à accéder à l'instance. Le plus souvent, le groupe dynamique n'inclut pas de règles de correspondance pour le compartiment qui contient l'instance. Il existe également une instruction de stratégie manquante ou incorrecte. Résolution : vérifiez que les stratégies sont correctes. Reportez-vous à Instruction de stratégie incorrecte ou règle de groupe dynamique manquante.
`Http Status Code: 409. Error Code: Conflict.` `Message: Invalid Managed Instance osFamily ORACLE_LINUX_8 does not match Profile osFamily: ORACLE_LINUX_7`	Cause : le système d'exploitation du profil est incorrect. Par exemple, l'instance est Oracle Linux 8 mais le profil est Oracle Linux 7. Résolution : identifiez et utilisez un profil compatible. Voir Un profil non valide a été utilisé.

Messages d'erreur courants de l'agent Oracle Cloud

Pour les instances OCI, utilisez le statut de connexion de l'agent OS Management Hub pour résoudre les problèmes d'inscription. Dans la console, dans l'onglet Agent Oracle Cloud de la page de détails de l'instance Compute, vous pouvez voir l'un des messages d'erreur suivants.


Message d'erreur	Cause et résolution possibles
`Agent OS Management Hub de module d'extension absent pour l'instance ocid1.instance.oc1.iad.<ocid>`	Cause : l'agent OS Management Hub n'est pas installé sur l'instance. Cela se produit généralement lorsque le service ne peut pas accéder à l'instance en raison d'un problème de stratégie. Résolution : vérifiez que les instructions de stratégie sont correctes et que l'instance est incluse dans le groupe dynamique. Reportez-vous à Instruction de stratégie incorrecte ou règle de groupe dynamique manquante.
`échec du démarrage d'osmh-agent avec [échec de la recherche d'image]. L'instance n'a pas pu s'inscrire auprès d'OS Management Hub.`	Cause : l'agent OS Management Hub ne peut pas démarrer sur l'instance. Cela se produit généralement lorsque le service ne peut pas accéder à l'instance en raison d'un problème de stratégie. Résolution : vérifiez que les instructions de stratégie sont correctes et que l'instance est incluse dans le groupe dynamique. Si vous n'utilisez pas le domaine d'identité par défaut, vérifiez que vous avez indiqué le domaine d'identité dans les instructions de stratégie. Reportez-vous à Instruction de stratégie incorrecte ou règle de groupe dynamique manquante.

Un profil non valide a été utilisé

Vérifiez le fichier osmh-agent.log et identifiez le profil correct

Déterminez l'emplacement du fichier osmh-agent.log.
Examinez le fichier journal et recherchez le mot-clé "Code d'erreur" pour déterminer s'il existe une erreur de profil. Reportez-vous à Messages d'erreur communs osmh-agent.log.
Exemple :
```
sudo grep -i "error code" /var/lib/oracle-cloud-agent/plugins/oci-osmh/osmh-agent/stateDir/log/osmh-agent.log
```
Identifiez (ou créez) un profil qui correspond à la version de système d'exploitation, à l'architecture et à l'emplacement de l'instance en cours d'inscription.

Pour mettre à jour le profil

Ouvrez le menu de navigation et sélectionnez Observation et gestion. Sous Autonomous Linux, sélectionnez Instances.
Sous Portée de liste, sélectionnez le compartiment contenant l'instance.
Sélectionnez le nom de l'instance.
Sélectionnez Définir le profil.
Sélectionnez le compartiment et le profil correct à utiliser pour l'inscription.
Sélectionnez Ensemble.

La mise à jour du statut de l'instance peut prendre plusieurs minutes.

Instruction de stratégie incorrecte ou règle de groupe dynamique manquante

Si vous rencontrez les erreurs suivantes lors de l'inscription d'une instance, cela peut indiquer que les instructions de stratégie ou les règles de groupe dynamique ne sont pas définies correctement.

osmh-agent.log contient :

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>

Sinon, l'onglet Agent Oracle Cloud de la page de détails de l'instance Compute affiche l'un des messages suivants :

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.

Pour résoudre le problème, vérifiez que vous avez correctement configuré les instructions de stratégie et les règles de groupe dynamique. Le plus souvent, le groupe dynamique n'inclut pas l'instance.

Vérifiez les points suivants :

Assurez-vous d'avoir inclus une règle de groupe dynamique pour chaque compartiment et sous-compartiment contenant les instances que le service doit gérer. Les groupes dynamiques ne prennent pas en charge l'héritage de compartiment.
Si vous n'utilisez pas le domaine d'identité default, assurez-vous que chaque instruction de stratégie comporte le domaine d'identité avant le nom du groupe ou du groupe dynamique (par exemple, <identity_domain_name>/<dynamic_group_name>).

L'enregistrement de l'instance a été annulé

La réinscription d'une instance qui a été désinscrite échouera tant que vous n'aurez pas supprimé le fichier de désinscription sur l'instance. Ce fichier empêche l'instance de s'inscrire auprès du service. Lorsque vous essayez d'inscrire une instance contenant ce fichier, le module d'extension d'agent affiche l'erreur suivante : started oci-osmh under unregistered mode.

Enlevez le fichier suivant avant d'inscrire l'instance :

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