Oracle Cloud Infrastructure-Dokumentation

Nicht-OCI-Instanz registrieren

Registrieren Sie eine On-Premise- oder unterstützte Drittanbieter-Cloud-Instanz, indem Sie die erforderlichen Packages installieren, ein Registrierungsprofil hinzufügen und den Management Agent installieren.

Wichtig

Das Klonen einer VM, die bereits bei OS Management Hub registriert ist, wird nicht unterstützt.

Bevor Sie beginnen

Bevor Sie eine Instanz bei OS Management Hub registrieren, müssen Sie folgende Schritte ausführen:

Registrierungsprofil zur Instanz hinzufügen

  1. Kopieren Sie in der Konsole den Inhalt des Softwarequell-, Gruppen- oder Lebenszyklusprofils.
    1. Öffnen Sie das Navigationsmenü, und wählen Sie Beobachtbarkeit und Management aus. Wählen Sie unter OS Management Hub die Option Profile aus.
    2. Wählen Sie den Namen des Profils.
    3. Prüfen Sie, ob die Profilinformationen eine Managementstation identifizieren. Dadurch wird bestätigt, dass das Profil für On-Premise- oder Cloud-Instanzen von Drittanbietern gilt.
    4. Wenn das Profil den richtigen Typ aufweist, wählen Sie Anzeigen aus.
    5. Kopieren Sie den Inhalt des Profils.
  2. Melden Sie sich bei der Instanz als Benutzer mit sudo-Berechtigungen an
  3. Erstellen Sie die Datei /etc/osmh-profile (ohne Dateierweiterung für den Dateinamen) mit einem Texteditor. Beispiele: 
    sudo vi /etc/osmh-profile
  4. Fügen Sie den Profilinhalt ein, den Sie aus der Konsole kopiert haben, und speichern Sie die Datei.

Installieren Sie den Management Agent

Installieren Sie die Management Agent-Software auf der Instanz. Der Management Agent verwendet das OS Management Hub-Plug-in, um Instanzen beim OS Management Hub-Service zu registrieren.

Hinweis

Ausführliche Schritte zur Installation der Management Agent-Software finden Sie in Management-Agents installieren.
  1. Prüfen Sie, ob /etc/sudoers /etc/sudoers.d enthält: 
    sudo visudo

    Prüfen Sie, ob die folgenden Zeilen vorhanden sind. Wenn nicht, fügen Sie sie hinzu und speichern Sie die Datei.

    ## Read drop-in files from /etc/sudoers.d (the # here does not mean a comment)
#includedir /etc/sudoers.d
  2. Installieren Sie erforderliche Packages. Dazu gehört Java 8 (mindestens 1.8u281 oder eine neuere Version 1.8).

    Java 8 muss auf der Instanz installiert sein, bevor Sie die Management Agent-Software installieren.

    Oracle Linux 9
    sudo dnf install -y java-1.8.0-openjdk chkconfig
    Oracle Linux 8
    sudo dnf install -y java-1.8.0-openjdk
    Oracle Linux 7
    sudo yum install -y java-1.8.0-openjdk
  3. Legen Sie die Umgebungsvariable JAVA_HOME für die Verwendung von Java 8 fest. Wenn Sie die Variable festlegen, wird sichergestellt, dass MACS die korrekte Java-Version verwendet, wenn sich neuere Versionen im System befinden. 
    JAVA_HOME=/usr/lib/jvm/jre-1.8.0-openjdk ; export JAVA_HOME
  4. Navigieren Sie zu dem Verzeichnis, das die RPM-Datei der heruntergeladenen Management Agent-Software enthält, und führen Sie den folgenden Befehl aus, um die RPM-Datei zu installieren:
    Oracle Linux 8 oder 9
    sudo --preserve-env=JAVA_HOME dnf install -y <rpm_file_name>.rpm
    Oracle Linux 7
    sudo --preserve-env=JAVA_HOME yum install -y <rpm_file_name>.rpm

Management Agent einrichten

Aktivieren Sie den Management Agent mit dem OS Management Hub-Plug-in. Bei der Aktivierung registriert sich die Instanz beim OS Management Hub-Service in dem im Installationsschlüssel angegebenen Compartment und mit dem mit dem Profil verknüpften Inhalt.

  1. Konfigurieren Sie das Management Agent-Plug-in so, dass es als Root ausgeführt wird. Das OS Management Hub-Plug-in muss als Root ausgeführt werden, um die Instanz zu patchen. Beispiel: 
    sudo tee /etc/sudoers.d/mgmt_agent <<EOF
## Allows Management Agent to change ownership of deployed External Plugin
mgmt_agent ALL=(ALL) NOPASSWD:/opt/oracle/mgmt_agent/agent_inst/bin/chown_recursive_ep.sh
## Allows Management Agent to run External Plugin under root user
mgmt_agent ALL=(root) NOPASSWD:SETENV: /opt/oracle/mgmt_agent/plugins/osmh/*/osmh
## Disable requiretty for Management Agent
Defaults:mgmt_agent !requiretty
EOF
  2. Legen Sie die Berechtigungen für die Datei auf 440 fest. 
    sudo chmod 440 /etc/sudoers.d/mgmt_agent
  3. Kopieren Sie in der Konsole den Management Agent-Installationsschlüssel, mit dem die Instanz registriert werden soll.
    1. Öffnen Sie das Navigationsmenü, und wählen Sie Beobachtbarkeit und Management aus. Wählen Sie unter Management Agent die Option Downloads und Schlüssel aus.
    2. Suchen Sie unter Schlüssel installieren den Schlüssel, mit dem Sie die Instanz registrieren möchten.
    3. Wählen Sie das Menü Aktionen für den Schlüssel, und wählen Sie Schlüssel in Zwischenablage kopieren aus.
  4. Erstellen Sie manuell eine Antwortdatei (input.rsp) mit einem Texteditor, und ersetzen Sie <MACS_KEY> durch den Installationsschlüssel, den Sie im vorherigen Schritt kopiert haben.

    Beispiele:

    cat >/tmp/input.rsp <<EOF
ManagementAgentInstallKey = <MACS_KEY>
Service.plugin.osmh.download = true
GatewayServerHost = <STATION_OR_LOAD_BALANCER_HOSTNAME>
GatewayServerPort = <STATION_PROXY_PORT>
EOF

    Die Datei input.rsp erfordert die folgenden obligatorischen Parameter.

    • ManagementAgentInstallKey: Installationsschlüssel, der zur Validierung der Identität der Domain und der Authentizität der Installation erforderlich ist.
    • Service.plugin.osmh.download = true: Stellt das OS Management Hub-(osmh-)Plug-in während der Agent-Installation bereit.

    Um die Verwaltungsstation als Proxy für die gesamte OS Management Hub-Kommunikation mit der Instanz zu verwenden, fügen Sie die folgenden Parameter in die Datei input.rsp ein.

    Um den Hostnamen und den Proxyport der Managementstation zu identifizieren, führen Sie die folgenden Schritte in der Konsole aus:

    1. Öffnen Sie das Navigationsmenü, und wählen Sie Beobachtbarkeit und Management aus. Wählen Sie unter OS Management Hub die Option Profile aus.
    2. Wählen Sie das der Instanz zugeordnete Profil aus.
    3. Wählen Sie im Abschnitt Profilinformationen den Namen der Managementstation aus.
    4. Klicken Sie auf die Registerkarte Konfiguration.
    5. Zeichnen Sie die Werte Hostname und Proxy Listening Port auf, die in der Datei input.rsp verwendet werden sollen.
  5. Konfigurieren Sie den Management Agent, indem Sie das Skript setup.sh mit der Antwortdatei ausführen. 
    sudo /opt/oracle/mgmt_agent/agent_inst/bin/setup.sh opts=/tmp/input.rsp

    Ein erfolgreiches Setup gibt die folgende Meldung zurück: Agent setup completed and the agent is running. Das Setup des OS Management Hub-Plug-ins kann im Hintergrund einige Minuten dauern.

Instanzregistrierung und -details prüfen

Prüfen Sie die bei OS Management Hub registrierte Instanz.

  1. Öffnen Sie das Navigationsmenü, und wählen Sie Beobachtbarkeit und Management aus. Wählen Sie unter OS Management Hub die Option Instanzen aus.
  2. Wählen Sie unter Geltungsbereich auf Liste das Compartment aus, das die Instanz enthält.
  3. Stellen Sie sicher, dass die Instanz in der Tabelle angezeigt wird, und prüfen Sie, ob der Status Aktiv lautet.
    Tipp

    Informationen zum Beheben von Registrierungsproblemen finden Sie unter Registrierung für Instanz oder Managementstation nicht erfolgreich.

  4. Wählen Sie den Namen der Instanz aus, um deren Details anzuzeigen.

    Unter Instanzinformationen können Sie Details zur Instanz anzeigen, z.B. das Registrierungsprofil, mit dem sie sich beim Service registriert hat, und ggf. ob es Mitglied einer Gruppe oder einer Lebenszyklusumgebung ist.

    Hinweis

    Die Meldung des anfänglichen Package- und Modulbestands an den Service kann einige Minuten dauern.