Documentazione di Oracle Cloud Infrastructure

Registrazione non riuscita per istanza o stazione di gestione

Un'istanza o una stazione di gestione possono non essere registrate nell'hub di gestione del sistema operativo per diversi motivi.

Vedere anche:

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: per il cloud in locale o di terze parti, /etc/osmh-profile risulta mancante o non valido. Per le istanze OCI, al momento della registrazione non esisteva 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 all'hub di gestione del sistema operativo 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: Managed Instance location ON_PREMISE is not compatible with a Profile registration type of: OCI_LINUX

Causa: il tipo di istanza del profilo è errato. Ad esempio, l'istanza si trova in locale o in un cloud di terze parti, ma il profilo si riferisce a un tipo di istanza OCI.

Risoluzione: identificare e utilizzare un profilo compatibile. Vedere È stato utilizzato un profilo non valido.

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.

Http Status Code: 409. Error Code: IncorrectState.

Message: Station already has an instance associated

Causa: il profilo si riferisce a una stazione di gestione ed è già utilizzato da un'altra stazione. Un profilo della stazione di gestione può essere utilizzato una sola volta.

Risoluzione: identificare e utilizzare un profilo compatibile per /etc/osmh-profile. Vedere È stato utilizzato un profilo non valido. Riprovare la registrazione.

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>

Causa: l'agente MACS (Management Agent Cloud Service) non è in esecuzione come previsto.

Risoluzione: verificare che l'agente MACS sia configurato correttamente e riavviare l'agente. Vedere Risoluzione dei problemi MACS.

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

  1. Determinare la posizione del file osmh-agent.log.
  2. 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, per un'istanza OCI di Oracle Linux:

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

    Ad esempio, per un'istanza in locale:

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

    Ad esempio, per un'istanza di 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"
  3. 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 per le istanze OCI

  1. Aprire il menu di navigazione e selezionare Observability & Management.
  2. In Hub di gestione del sistema operativo selezionare Istanze.
  3. Selezionare il compartimento contenente l'istanza a cui si è interessati.
  4. Selezionare il nome dell'istanza.
  5. Selezionare Imposta profilo.
  6. Selezionare il compartimento e il profilo corretto da utilizzare per la registrazione.
  7. Selezionare Imposta.

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

Per aggiornare il profilo per le istanze cloud on premise o di terze parti, effettuare le operazioni riportate di seguito.

  1. Visualizzare i dettagli del profilo.
  2. Copiare il contenuto /etc/osmh-profile.
  3. Eseguire il login all'istanza come utente con privilegi sudo.
  4. Sostituire /etc/osmh-profile con il profilo corretto. L'istanza verrà registrata la prossima volta che il plugin Hub di gestione del sistema operativo esegue il check-in con il servizio.

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 compartimento figlio 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>).

Vedere anche: Risoluzione dei problemi: problemi dei criteri.

Il sistema non è in grado di leggere /etc/sudoers.d

Per le istanze di stazioni di gestione, on-premise o cloud di terze parti, il file /etc/sudoers deve includere /etc/sudoers.d affinché Management Agent Cloud Service (MACS) distribuisca il plugin Hub di gestione del sistema operativo.

Ciò è indicato dal seguente errore:

/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

Dove /opt/oracle/mgmt_agent/agent_inst/log/mgmt_agent.log mostra quanto segue:

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

Per risolvere il problema:

  1. Modificare il file /etc/sudoers. 
    sudo visudo
  2. Aggiungere le seguenti righe e salvare il file. 
    ## Read drop-in files from /etc/sudoers.d (the # here does not mean a comment)
#includedir /etc/sudoers.d
  3. Rieseguire setup.sh. Vedere Registrazione di un'istanza non OCI o Registrazione di una stazione di gestione.

La registrazione dell'istanza è stata annullata in precedenza

Se in precedenza è stata annullata la registrazione di un'istanza dall'hub di gestione del sistema operativo, sono disponibili ulteriori passi per la nuova registrazione con il servizio. Il processo dipende dalla posizione dell'istanza.

Istanze OCI

La nuova registrazione di un'istanza OCI di cui è stata annullata la registrazione 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:

  • Oracle Linux

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

  • Windows 2019 e 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

Istanze cloud on premise o di terze parti

La nuova registrazione di un'istanza non OCI registrata in precedenza potrebbe richiedere l'installazione del Management Agent o la distribuzione manuale del plugin agente dell'hub di gestione del sistema operativo.

Per registrare di nuovo l'istanza, effettuare le operazioni riportate di seguito.

  1. Eseguire il login all'istanza come utente con privilegi sudo.

  2. Verificare lo stato del Management Agent.

    sudo systemctl status mgmt_agent
  3. Se il file mgmt_agent non viene trovato, registrare l'istanza come se fosse nuova. Vedere Registrazione di un'istanza non OCI. Ignorare i rimanenti passi di questa procedura.
  4. Se il file mgmt_agent è presente, avviare l'agente e creare il file /etc/osmh-profile:

    1. Avviare il file mgmt_agent:

      sudo systemctl start mgmt_agent

    2. Creare il file /etc/osmh-profile utilizzando un editor di testo. Assicurarsi che il nome file non abbia un'estensione file.

      sudo vi /etc/osmh-profile

  5. Nella console distribuire il plugin agente dell'hub di gestione del sistema operativo nell'istanza.

    1. Nella console passare a Osservabilità e gestione. In Management Agent, selezionare Agenti.
    2. In Ambito, selezionare il compartimento.
    3. Individuare l'agente corretto individuando il nome host nella colonna Nome. Selezionare il nome dell'agente nella lista.
    4. Selezionare Distribuisci plugin.
    5. Selezionare Hub di gestione del sistema operativo, quindi Aggiorna.
    6. Attendere alcuni minuti, quindi verificare che l'istanza sia stata registrata.

Sistema operativo non impostato sull'ora corrente

Gli errori di timeout durante la registrazione possono verificarsi quando l'ora sull'istanza è diversa dall'ora utilizzata nel servizio Hub di gestione del sistema operativo. Una deviazione dell'orologio di oltre 5 minuti può causare questi tipi di errori.

Durante la registrazione della stazione di gestione o dell'istanza, viene segnalato il seguente errore durante l'esecuzione dello 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.
  1. Determinare se esiste un disallineamento del clock controllando la data dell'endpoint del servizio managementagent rispetto all'istanza o alla stazione di gestione. 
    curl -s --head https://managementagent.<region>.oci.oraclecloud.com | grep Date
    date -u

    Ad esempio:

    $ 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
  2. Se la data o l'ora dell'istanza o della stazione di gestione è diversa dall'ora riportata dal servizio, aggiornare l'ora del sistema operativo in modo che corrisponda al servizio.

    Se si utilizzano funzioni di sincronizzazione dell'ora come Chrony o NTP (Network Time Protocol), verificare l'impostazione e il funzionamento.

    Ad esempio, eseguire i seguenti comandi per verificare la configurazione:

    chronyc sources -a
    chronyc tracking