Registrazione dell'istanza non riuscita

Un'istanza può non essere registrata con Autonomous Linux per diversi motivi.

Messaggi di errore osmh-agent.log comuni

Per risolvere i problemi di registrazione, iniziare esaminando il file osmh-agent.log per i seguenti messaggi di errore. Per identificare la posizione del file di log, vedere Esame dei file di log in un'istanza.


Codice e messaggio	Causa e soluzione possibili
`Http Status Code: 400. Error Code: MissingParameter.` `Message: Registration profile is required for on-boarding instances, but none was provided.`	Causa: alla registrazione non era presente un profilo predefinito compatibile. Risoluzione: identificare e utilizzare un profilo compatibile. Vedere È stato utilizzato un profilo non valido.
`Http Status Code: 404. Error Code: NotAuthorizedOrNotFound.` `Message: Authorization failed or requested resource not found.`	Causa: i criteri correnti non consentono al servizio di accedere all'istanza. In genere, il gruppo dinamico non include regole di corrispondenza per il compartimento che contiene l'istanza. Oppure, è presente un'istruzione criterio mancante o errata. Risoluzione: verificare che i criteri siano corretti. Vedere Istruzione dei criteri errata o regola di gruppo dinamico mancante.
`Http Status Code: 409. Error Code: Conflict.` `Message: Invalid Managed Instance osFamily ORACLE_LINUX_8 does not match Profile osFamily: ORACLE_LINUX_7`	Causa: il profilo ha un sistema operativo errato. Ad esempio, l'istanza è Oracle Linux 8, ma il profilo è Oracle Linux 7. Risoluzione: identificare e utilizzare un profilo compatibile. Vedere È stato utilizzato un profilo non valido.

Messaggi comuni di errore dell'agente Oracle Cloud

Per le istanze OCI, utilizzare lo stato del plugin dell'agente hub di gestione del sistema operativo per risolvere i problemi di registrazione. Nella console, nella scheda Agente Oracle Cloud della pagina dei dettagli dell'istanza di computazione, potrebbe essere visualizzato uno dei seguenti messaggi di errore.


Messaggio di errore	Causa e soluzione possibili
`Agente dell'hub di gestione del sistema operativo del plugin non presente per l'istanza ocid1.instance.oc1.iad.<ocid>`	Causa: l'agente dell'hub di gestione del sistema operativo non è installato nell'istanza. In genere ciò si verifica quando il servizio non è in grado di accedere all'istanza a causa di un problema del criterio. Risoluzione: verificare che le istruzioni dei criteri siano corrette e che l'istanza sia inclusa nel gruppo dinamico. Vedere Istruzione dei criteri errata o regola di gruppo dinamico mancante.
`avvio di osmh-agent con [immagine di ricerca non riuscito. Impossibile registrare l'istanza con l'hub di gestione del sistema operativo.`	Causa: l'agente dell'hub di gestione del sistema operativo non può essere avviato nell'istanza. In genere ciò si verifica quando il servizio non è in grado di accedere all'istanza a causa di un problema del criterio. Risoluzione: verificare che le istruzioni dei criteri siano corrette e che l'istanza sia inclusa nel gruppo dinamico. Se non si utilizza il dominio di Identity predefinito, verificare di aver specificato il dominio di Identity nelle istruzioni dei criteri. Vedere Istruzione dei criteri errata o regola di gruppo dinamico mancante.

È stato utilizzato un profilo non valido

Controllare il file osmh-agent.log e identificare il profilo corretto

Determinare la posizione del file osmh-agent.log.
Esaminare il file di log, cercando la parola chiave "Codice errore", per determinare se esiste un errore del profilo. Vedere Messaggi di errore comuni osmh-agent.log.
ad esempio:
```
sudo grep -i "error code" /var/lib/oracle-cloud-agent/plugins/oci-osmh/osmh-agent/stateDir/log/osmh-agent.log
```
Identificare (o creare) un profilo che corrisponda alla versione del sistema operativo, all'architettura e alla posizione dell'istanza che si sta registrando.

Per aggiornare il profilo

Aprire il menu di navigazione e selezionare Osservabilità e gestione. In Autonomous Linux, selezionare Istanze.
In Ambito lista, selezionare il compartimento che contiene l'istanza.
Selezionare il nome dell'istanza.
Selezionare Imposta profilo.
Selezionare il compartimento e il profilo corretto da utilizzare per la registrazione.
Selezionare Imposta.

L'aggiornamento dello stato dell'istanza può richiedere alcuni minuti.

Istruzione del criterio errata o regola del gruppo dinamico mancante

Se si verificano i seguenti errori durante la registrazione di un'istanza, è possibile che le istruzioni dei criteri o le regole dei gruppi dinamici non siano impostate correttamente.

Il file 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>

In alternativa, la scheda Agente Oracle Cloud nella pagina dei dettagli dell'istanza di computazione mostra uno dei seguenti messaggi:

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.

Per risolvere il problema, verificare di aver configurato correttamente le istruzioni dei criteri e le regole dei gruppi dinamici. In genere, il gruppo dinamico non include l'istanza.

Verificare quanto riportato di seguito.

Assicurarsi di aver incluso una regola di gruppo dinamico per ogni compartimento e sottocompartimento contenente le istanze che si desidera gestire dal servizio. I gruppi dinamici non supportano l'ereditarietà del compartimento.
Se non si utilizza il dominio di Identity default, assicurarsi che ogni istruzione criterio disponga del dominio di Identity prima del nome del gruppo o del gruppo dinamico (ad esempio, <identity_domain_name>/<dynamic_group_name>).

La registrazione dell'istanza è stata annullata in precedenza

La nuova registrazione di un'istanza che è stata annullata non riuscirà finché non verrà rimosso il file di annullamento della registrazione nell'istanza. Questo file impedisce all'istanza di registrarsi con il servizio. Quando si tenta di registrare un'istanza che contiene questo file, il plugin agente visualizza il seguente errore: started oci-osmh under unregistered mode.

Rimuovere il file seguente prima di registrare l'istanza:

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