Échec de l'enregistrement de l'instance

Une instance peut ne pas s'inscrire auprès d'Autonomous Linux pour plusieurs raisons.

Messages d'erreur communs osmh-agent.log

Pour résoudre les problèmes d'enregistrement, commencez par examiner le fichier osmh-agent.log pour connaître les messages d'erreur suivants. Voir Examen des fichiers journaux d'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 Le profil non valide a été utilisé.
`Http Status Code: 404. Error Code: NotAuthorizedOrNotFound.` `Message: Authorization failed or requested resource not found.`	Cause : Les politiques courantes 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. Ou, il y a un énoncé de politique manquant ou incorrect. Résolution : Vérifiez que les politiques sont correctes. Voir Énoncé de politique incorrect 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 profil a le mauvais système d'exploitation. Par exemple, l'instance est Oracle Linux 8, mais le profil est Oracle Linux 7. Résolution : Identifiez et utilisez un profil compatible. Voir Le profil non valide a été utilisé.

Messages d'erreur courants d'Oracle Cloud Agent

Pour les instances OCI, utilisez le statut de plugiciel de l'agent du centre de gestion du système d'exploitation pour résoudre les problèmes d'enregistrement. Dans la console, dans l'onglet Oracle Cloud Agent de la page des détails de l'instance de calcul, vous pouvez voir l'un des messages d'erreur suivants.


Message d'erreur	Cause et résolution possibles
`Agent du centre de gestion du système d'exploitation du plugiciel absent pour l'instance ocid1.instance.oc1.iad.<ocid>`	Cause : L'agent du centre de gestion du système d'exploitation 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 politique. Résolution : Vérifiez que vos énoncés de politique sont corrects et que l'instance est incluse dans le groupe dynamique. Voir Énoncé de politique incorrect ou règle de groupe dynamique manquante.
`échec du démarrage de osmh-agent avec [échec de la consultation de l'image]. L'instance n'a pas pu s'inscrire au centre de gestion du système d'exploitation.`	Cause : L'agent du centre de gestion du système d'exploitation 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 politique. Résolution : Vérifiez que vos énoncés de politique sont corrects 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 spécifié le domaine d'identité dans les énoncés de politique. Voir Énoncé de politique incorrect 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, en recherchant le mot clé "Code d'erreur", pour déterminer s'il existe une erreur de profil. Voir Messages d'erreur osmh-agent.log courants.
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 du système d'exploitation, à l'architecture et à l'emplacement de l'instance que vous enregistrez.

Pour mettre à jour le profil

Ouvrez le menu de navigation et sélectionnez Observabilité et gestion.
Sous Autonomous Linux, sélectionnez Instances.
Sélectionnez le compartiment qui contient l'instance qui vous intéresse.
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 Définir.

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

Énoncé de politique incorrect ou règle de groupe dynamique manquante

Si vous rencontrez les erreurs suivantes lors de l'enregistrement d'une instance, cela peut indiquer que les énoncés de politique ou les règles de groupe dynamique ne sont pas définis 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>

Ou l'onglet Oracle Cloud Agent de la page Détails de l'instance de calcul 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 énoncés de politique et les règles de groupe dynamique. Le plus souvent, le groupe dynamique n'inclut pas l'instance.

Vérifiez les éléments suivants :

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

L'instance n'a pas été enregistrée précédemment

La réinscription d'une instance qui n'a pas été enregistrée échouera jusqu'à ce que vous supprimiez le fichier de désinscription sur l'instance. Ce fichier empêche l'instance de s'enregistrer auprès du service. Lorsque vous tentez d'enregistrer une instance qui contient ce fichier, le plugiciel d'agent affiche l'erreur suivante : started oci-osmh under unregistered mode.

Supprimez le fichier suivant avant d'enregistrer l'instance :

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