Échec de l'inscription de l'instance ou du poste de gestion

Une instance ou une station de gestion peut ne pas s'inscrire au centre de gestion du système d'exploitation pour plusieurs raisons.

Voir aussi :

Problème connu : Les images de plate-forme plus anciennes ou Apportez vos propres images ne s'enregistreront pas
'Aucun profil disponible' lors de l'activation du plugiciel du centre de gestion du système d'exploitation

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 : Pour le nuage sur place ou de tierce partie, `/etc/osmh-profile` est manquant ou non valide. Pour les instances OCI, 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 ne permettent pas au centre de gestion de système d'exploitation d'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: Managed Instance location ON_PREMISE is not compatible with a Profile registration type of: OCI_LINUX`	Cause : Le type d'instance du profil est incorrect. Par exemple, l'instance est située sur place ou dans un nuage de tierce partie, mais le profil est pour un type d'instance OCI. Résolution : Identifiez et utilisez un profil compatible. Voir Le profil non valide a été utilisé.
`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é.
`Http Status Code: 409. Error Code: IncorrectState.` `Message: Station already has an instance associated`	Cause : Le profil est destiné à une station de gestion et est déjà utilisé par une autre station. Un profil de station de gestion ne peut être utilisé qu'une seule fois. Résolution : Identifiez et utilisez un profil compatible pour `/etc/osmh-profile`. Voir Le profil non valide a été utilisé. Ensuite, réessayez l'enregistrement.
`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>`	Cause : L'agent MACS (Management Agent Cloud Service) ne s'exécute pas comme prévu. Résolution : Vérifiez que l'agent MACS est correctement configuré et redémarrez l'agent. Voir Dépannage de MACS.

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.

Par exemple, pour une instance Oracle Linux OCI :

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

Par exemple, pour une instance sur place :

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

Par exemple, pour une instance 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"

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 des instances OCI

Ouvrez le menu de navigation et sélectionnez Observabilité et gestion.
Sous Centre de gestion du système d'exploitation, 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.

Pour mettre à jour le profil des instances en nuage sur place ou de tierce partie :

Voir les détails du profil.
Copiez le contenu /etc/osmh-profile.
Connectez-vous à l'instance en tant qu'utilisateur doté des privilèges sudo.
Remplacez /etc/osmh-profile par le profil corrigé. L'instance enregistrera la prochaine fois que le plugiciel du centre de gestion du système d'exploitation sera intégré au service.

É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>).

Voir aussi : Dépannage : Problèmes de politique.

Le système ne peut pas lire /etc/sudoers.d

Pour les stations de gestion, les instances sur place ou de nuage tiers, le fichier /etc/sudoers doit inclure /etc/sudoers.d pour que l'agent de gestion Cloud Service (MACS) déploie le plugiciel du centre de gestion du système d'exploitation.

Ceci est indiqué par l'erreur suivante :

/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

Où /opt/oracle/mgmt_agent/agent_inst/log/mgmt_agent.log affiche ce qui suit :

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

Pour résoudre le problème :

Modifiez le fichier /etc/sudoers.
```
sudo visudo
```

Ajoutez les lignes suivantes et enregistrez le fichier.

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

Réexécutez setup.sh. Voir Enregistrement d'une instance non OCI ou Enregistrement d'un poste de gestion.

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

Si vous avez précédemment désinscrit une instance du centre de gestion du système d'exploitation, des étapes supplémentaires sont nécessaires pour la réinscrire auprès du service. Le traitement dépend de l'emplacement de l'instance.

Instances OCI

La réinscription d'une instance OCI qui n'a pas été enregistrée échouera tant que vous n'aurez pas supprimé 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 :

Oracle Linux

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

Windows 2019 et 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

Instances en nuage sur place ou de tierce partie

La réinscription d'une instance non OCI précédemment enregistrée peut nécessiter l'installation de l'agent de gestion ou le déploiement manuel du plugiciel d'agent du centre de gestion du système d'exploitation.

Pour réenregistrer l'instance :

Connectez-vous à l'instance en tant qu'utilisateur doté des privilèges sudo.
Vérifiez le statut de l'agent de gestion.
```
sudo systemctl status mgmt_agent
```
Si mgmt_agent est introuvable, enregistrez l'instance comme si elle était nouvelle. Voir Enregistrement d'une instance non OCI. Ignorez les étapes restantes de cette procédure.
Si mgmt_agent est présent, démarrez l'agent et créez le fichier /etc/osmh-profile :
1. Démarrez mgmt_agent :
```
sudo systemctl start mgmt_agent
```
2. Créez le fichier /etc/osmh-profile à l'aide d'un éditeur de texte. Assurez-vous que le nom de fichier n'a pas d'extension.
```
sudo vi /etc/osmh-profile
```
Dans la console, déployez le plugiciel d'agent du centre de gestion du système d'exploitation sur l'instance.
1. Dans la console, naviguez jusqu'à Observabilité et gestion. Sous Agent de gestion, sélectionnez Agents.
2. Sous Portée, sélectionnez le compartiment.
3. Localisez l'agent approprié en recherchant le nom d'hôte dans la colonne Nom. Sélectionnez le nom de l'agent dans la liste.
4. Sélectionnez Déployer les plugiciels.
5. Sélectionnez Centre de gestion du système d'exploitation, puis Mettre à jour.
6. Attendez quelques minutes, puis vérifiez que l'instance est enregistrée.

OS non défini à l'heure courante

Des erreurs de temporisation peuvent se produire lors de l'enregistrement lorsque l'heure de l'instance est différente de celle utilisée dans le service du centre de gestion du système d'exploitation. Un décalage d'horloge de plus de 5 minutes peut causer ce type d'erreurs.

Lors de l'enregistrement de la station de gestion ou de l'instance, l'erreur suivante est signalée lors de l'exécution du 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.

Déterminez s'il existe un décalage d'horloge en vérifiant la date du point d'extrémité du service managementagent par rapport à l'instance ou à la station de gestion.

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

date -u

Exemple :

$ 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 date ou l'heure de l'instance ou de la station de gestion est différente de l'heure indiquée par le service, mettez à jour l'heure du système d'exploitation pour qu'elle corresponde au service.
Si des fonctions de synchronisation temporelle telles que Chrony ou Network Time Protocol (NTP) sont utilisées, vérifiez leur configuration et leur fonctionnement.

Par exemple, exécutez les commandes suivantes pour vérifier la configuration :
```
chronyc sources -a
```
```
chronyc tracking
```

Documentation sur Oracle Cloud Infrastructure