Echec de l'inscription pour l'instance ou la station de gestion

Une instance ou une station de gestion peut ne pas s'inscrire auprès d'OS Management Hub pour plusieurs raisons.

Reportez-vous également à :

Problème connu : les anciennes images de la plate-forme ou Bring Your Own Images ne s'enregistreront pas
'Aucun profil disponible' lors de l'activation du module d'extension OS Management Hub

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 : pour le cloud sur site ou tiers, `/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 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 OS Management Hub à 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: 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 site ou dans un cloud tiers, mais le profil est pour un type d'instance OCI. Résolution : identifiez et utilisez un profil compatible. Voir Un 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 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é.
`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 Un profil non valide a été utilisé. Réessayez ensuite 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 Management Agent Cloud Service (MACS) n'est pas en cours d'exécution comme prévu. Résolution : vérifiez que l'agent MACS est correctement configuré et redémarrez l'agent. Reportez-vous à la section Troubleshooting MACS.

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.

Par exemple, pour une instance OCI Oracle Linux :

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 site :

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 de système d'exploitation, à l'architecture et à l'emplacement de l'instance en cours d'inscription.

Procédure de mise à jour du profil pour les instances OCI

Ouvrez le menu de navigation et sélectionnez Observation & gestion.
Sous OS Management Hub, 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 Ensemble.

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

Pour mettre à jour le profil pour les instances cloud sur site ou tierces, procédez comme suit :

Afficher les détails du profil.
Copiez le contenu /etc/osmh-profile.
Connectez-vous à l'instance en tant qu'utilisateur disposant des privilèges sudo.
Remplacez /etc/osmh-profile par le profil corrigé. L'instance s'inscrit lors de la prochaine réinsertion du module d'extension OS Management Hub auprès du service.

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 que vous avez inclus une règle de groupe dynamique pour chaque compartiment et compartiment enfant contenant les instances que vous voulez gérer par le service. 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>).

Voir aussi : Dépannage : problèmes de stratégie.

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

Pour les stations de gestion, les instances sur site ou cloud tiers, le fichier /etc/sudoers doit inclure /etc/sudoers.d pour que l'agent de gestion Cloud Service (MACS) déploie le module d'extension OS Management Hub.

Cela 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 les éléments suivants :

[/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, procédez comme suit :

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

Exécutez à nouveau setup.sh. Reportez-vous à Inscription d'une instance non OCI ou à Inscription d'une station de gestion.

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

Si vous avez précédemment désinscrit une instance de OS Management Hub, des étapes supplémentaires sont nécessaires pour la réinscrire auprès du service. Le processus dépend de l'emplacement de l'instance.

Instances OCI

La réinscription d'une instance OCI non inscrite échouera tant que vous n'aurez pas enlevé le fichier d'annulation d'inscription 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 :

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 cloud sur site ou tierces

La réinscription d'une instance non OCI précédemment inscrite peut nécessiter l'installation de l'agent de gestion ou le déploiement manuel du module d'extension d'agent OS Management Hub.

Pour réenregistrer l'instance, procédez comme suit :

Connectez-vous à l'instance en tant qu'utilisateur disposant des privilèges sudo.
Vérifiez le statut de l'agent de gestion.
```
sudo systemctl status mgmt_agent
```
Si l'élément mgmt_agent est introuvable, enregistrez l'instance comme si elle était nouvelle. Reportez-vous à Inscription 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 de fichier.
```
sudo vi /etc/osmh-profile
```
Dans la console, déployez le module d'extension d'agent OS Management Hub sur l'instance.
1. Dans la console, accédez à Observation et gestion. Sous Agent de gestion, sélectionnez Agents.
2. Sous Portée, sélectionnez votre 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 modules d'extension.
5. Sélectionnez OS Management Hub, puis Mettre à jour.
6. Attendez quelques minutes, puis vérifiez que l'instance est inscrite.

OS non défini sur l'heure actuelle

Des erreurs d'expiration peuvent survenir lors de l'inscription lorsque l'heure de l'instance est différente de l'heure utilisée dans le service OS Management Hub. Un écart d'horloge de plus de 5 minutes peut entraîner ces types d'erreur.

Lors de l'inscription 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 si l'écart d'horloge existe en vérifiant la date d'adresse de 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 du poste de gestion est différente du temps saisi par le service, mettez à jour l'heure du système d'exploitation pour qu'elle corresponde au service.
Si des utilitaires de synchronisation de l'heure tels que Chrony ou Network Time Protocol (NTP) sont utilisés, 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 Oracle Cloud Infrastructure