Registrierung für Instanz nicht erfolgreich

Eine Instanz kann sich aus verschiedenen Gründen nicht bei Autonomous Linux registrieren.

Allgemeine osmh-agent.log-Fehlermeldungen

Um Registrierungsprobleme zu beheben, prüfen Sie zunächst die Datei osmh-agent.log auf die folgenden Fehlermeldungen. Informationen zum Speicherort der Logdatei finden Sie unter Logdateien auf einer Instanz untersuchen.


Code und Nachricht	Mögliche Ursache und Lösung
`Http Status Code: 400. Error Code: MissingParameter.` `Message: Registration profile is required for on-boarding instances, but none was provided.`	Ursache: Bei der Registrierung war kein kompatibles Standardprofil vorhanden. Lösung: Identifizieren und verwenden Sie ein kompatibles Profil. Siehe Ungültiges Profil wurde verwendet.
`Http Status Code: 404. Error Code: NotAuthorizedOrNotFound.` `Message: Authorization failed or requested resource not found.`	Ursache: Die aktuellen Policys lassen den Zugriff des Service auf die Instanz nicht zu. In der Regel enthält die dynamische Gruppe keine Übereinstimmungsregeln für das Compartment, das die Instanz enthält. Oder es gibt eine fehlende oder falsche Policy-Anweisung. Lösung: Prüfen Sie, ob die Policys korrekt sind. Siehe Falsche Policy-Anweisung oder fehlende Regel für dynamische Gruppen.
`Http Status Code: 409. Error Code: Conflict.` `Message: Invalid Managed Instance osFamily ORACLE_LINUX_8 does not match Profile osFamily: ORACLE_LINUX_7`	Ursache: Das Profil hat das falsche Betriebssystem. Beispiel: Die Instanz ist Oracle Linux 8, das Profil ist jedoch Oracle Linux 7. Lösung: Identifizieren und verwenden Sie ein kompatibles Profil. Siehe Ungültiges Profil wurde verwendet.

Häufige Oracle Cloud Agent-Fehlermeldungen

Verwenden Sie für OCI-Instanzen den Plug-in-Status des OS Management Hub-Agent, um Registrierungsprobleme zu beheben. In der Konsole wird auf der Registerkarte "Oracle Cloud Agent" auf der Detailseite der Compute-Instanz möglicherweise eine der folgenden Fehlermeldungen angezeigt.


Fehlermeldung	Mögliche Ursache und Lösung
`Plug-in-OS Management Hub-Agent nicht vorhanden für Instanz ocid1.instance.oc1.iad.<ocid>`	Ursache: Der OS Management Hub-Agent ist nicht auf der Instanz installiert. Dies tritt in der Regel auf, wenn der Service aufgrund eines Policy-Problems nicht auf die Instanz zugreifen kann. Lösung: Prüfen Sie, ob die Policy-Anweisungen korrekt sind und ob die Instanz in der dynamischen Gruppe enthalten ist. Siehe Falsche Policy-Anweisung oder fehlende Regel für dynamische Gruppen.
`Osmh-Agent konnte nicht mit [Lookup-Image nicht gestartet werden. Die Instanz konnte nicht bei OS Management Hub registriert werden.`	Ursache: Der OS Management Hub-Agent kann nicht auf der Instanz gestartet werden. Dies tritt in der Regel auf, wenn der Service aufgrund eines Policy-Problems nicht auf die Instanz zugreifen kann. Lösung: Prüfen Sie, ob die Policy-Anweisungen korrekt sind und ob die Instanz in der dynamischen Gruppe enthalten ist. Wenn Sie die Standardidentitätsdomain nicht verwenden, prüfen Sie, ob Sie die Identitätsdomain in den Policy-Anweisungen angegeben haben. Siehe Falsche Policy-Anweisung oder fehlende Regel für dynamische Gruppen.

Es wurde ein ungültiges Profil verwendet

Prüfen Sie die Datei osmh-agent.log, und identifizieren Sie das korrekte Profil

Bestimmen Sie den Speicherort der Datei osmh-agent.log.
Prüfen Sie die Logdatei und suchen Sie nach dem Schlüsselwort "Fehlercode", um festzustellen, ob ein Profilfehler vorhanden ist. Siehe Allgemeine osmh-agent.log-Fehlermeldungen.
Beispiele:
```
sudo grep -i "error code" /var/lib/oracle-cloud-agent/plugins/oci-osmh/osmh-agent/stateDir/log/osmh-agent.log
```
Identifizieren (oder erstellen) Sie ein Profil, das mit der BS-Version, Architektur und dem Speicherort der zu registrierenden Instanz übereinstimmt.

So aktualisieren Sie das Profil

Öffnen Sie das Navigationsmenü, und wählen Sie Beobachtbarkeit und Management aus. Wählen Sie unter Autonomous Linux die Option Instanzen aus.
Wählen Sie unter Geltungsbereich auflisten das Compartment aus, das die Instanz enthält.
Wählen Sie den Namen der Instanz aus.
Wählen Sie Profil festlegen aus.
Wählen Sie das Compartment und das korrekte Profil für die Registrierung aus.
Wählen Sie Set aus.

Es kann einige Minuten dauern, bis der Status der Instanz aktualisiert wird.

Falsche Policy-Anweisung oder fehlende Regel für dynamische Gruppe

Wenn beim Registrieren einer Instanz die folgenden Fehler auftreten, kann dies darauf hinweisen, dass die Policy-Anweisungen oder Regeln für dynamische Gruppen nicht korrekt festgelegt sind.

Die osmh-agent.log enthält:

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>

Auf der Registerkarte "Oracle Cloud Agent" auf der Detailseite der Compute-Instanz wird auch eine der folgenden Meldungen angezeigt:

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.

Um das Problem zu beheben, prüfen Sie, ob Sie die Policy-Anweisungen und die Regeln für dynamische Gruppen richtig konfiguriert haben. Meistens enthält die dynamische Gruppe die Instanz nicht.

Prüfen Sie Folgendes:

Stellen Sie sicher, dass Sie eine dynamische Gruppenregel für jedes Compartment und Sub-Compartment mit Instanzen enthalten, die Sie vom Service verwalten möchten. Dynamische Gruppen unterstützen keine Compartment-Vererbung.
Wenn Sie die Identitätsdomain default nicht verwenden, stellen Sie sicher, dass jede Policy-Anweisung die Identitätsdomain vor dem Namen der Gruppe oder dynamischen Gruppe hat (Beispiel: <identity_domain_name>/<dynamic_group_name>).

Registrierung der Instanz wurde zuvor aufgehoben

Die erneute Registrierung einer nicht registrierten Instanz verläuft nicht erfolgreich, bis Sie die Aufhebungsdatei auf der Instanz entfernen. Diese Datei verhindert, dass sich die Instanz beim Service registriert. Wenn Sie versuchen, eine Instanz zu registrieren, die diese Datei enthält, zeigt das Agent-Plug-in den folgenden Fehler an: started oci-osmh under unregistered mode.

Entfernen Sie die folgende Datei, bevor Sie die Instanz registrieren:

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