Managementgatewayport

Um den Portwert von Management Gateway zu ändern, bearbeiten Sie die Datei gateway.properties, und ersetzen Sie den aktuellen Wert der Eigenschaft GatewayPort durch die gewünschte Portnummer.

Wenn sich der Eigenschaftswert GatewayPort ändert, müssen alle Management-Agents, die dieses Managementgateway verwenden, so geändert werden, dass der neue Portwert verwendet wird. Weitere Informationen finden Sie unter Management-Agents nach Änderungen an der Management Gateway-Konfiguration aktualisieren.

Managementgatewayzugangsdaten

Das Gateway ist in der Regel für die Verwendung von Zugangsdaten konfiguriert: Benutzername und Kennwort sind für die Anmeldung erforderlich.

Diese Zugangsdaten werden in Oracle Wallets gespeichert. Informationen zum Hinzufügen, Aktualisieren oder Löschen von Zugangsdaten finden Sie unter Managementgateway-Zugangsdaten konfigurieren.

Wenn sich die Zugangsdaten von Management Gateway ändern, müssen alle Management Agents, die das Management Gateway verwenden, so geändert werden, dass sie die neuen Zugangsdaten verwenden. Weitere Informationen finden Sie unter Management-Agents nach Änderungen an der Management Gateway-Konfiguration aktualisieren.

Das Management Gateway speichert sensible Informationen wie Zugangsdaten in Oracle Wallets.

Nach der Installation eines Management Gateways müssen Sie möglicherweise Zugangsdaten konfigurieren.

• Management Gateway unter Linux aktualisieren
• Management Gateway unter Linux mit einer ZIP-Datei upgraden
• Upgrade von Management Gateway unter Windows

Management Gateway unter Linux aktualisieren

Management Gateway unter Linux mit einer ZIP-Datei upgraden

So führen Sie ein Gatewayupgrade unter Linux mit einer ZIP-Datei durch:

• Laden Sie die neueste Version der ZIP-Datei mit dem Herunterladen der Gateway-Software herunter. Weitere Informationen finden Sie unter Management Gateway-Software herunterladen
• Navigieren Sie zu dem Verzeichnis, in das Sie die ZIP-Datei der Management Gateway-Software heruntergeladen haben, und dekomprimieren Sie sie an einem beliebigen bevorzugten Speicherort.
• Um das Gateway upzugraden, führen Sie das Skript installer.sh mit der Option:-u aus

  installer.sh -u

• Die Ausgabe sieht folgendermaßen aus:

  sudo ./installer.sh -u
  Checking pre-requisites
          Checking available disk space for gateway upgrade
          Checking agent version 
  
  Executing install
          Unpacking software zip
          Copying files to destination dir (/opt/oracle/mgmt_agent)
          Updating communication wallet 
          Creating 'mgmt_gateway' daemon
          Starting mgmt_gateway
          Gateway Install Logs: /opt/oracle/mgmt_agent/installer-logs/installer.log
  
  Gateway upgrade successful

Upgrade von Management Gateway unter Windows

Wenn Sie ein Managementgateway von einem Host entfernen, wird die Registrierung des Managementgateways beim Management Agent Cloud Service aufgehoben, bevor es vom Host entfernt wird.

Um Management Gateway von den folgenden Betriebssystemen zu entfernen oder zu deinstallieren, gehen Sie wie folgt vor:

• Linux mit RPM-Befehl
• Linux mit Deinstallationsskript
• Windows

Management Gateway unter Linux mit dem RPM-Befehl entfernen

sudo rpm -e <rpm_name>

Management Gateway unter Linux mit einem Deinstallationsskript entfernen

Führen Sie das Skript uninstaller.sh aus, wenn Sie das Management Gateway mit den ZIP-Dateien installiert haben.

Die Ausgabe sieht ungefähr folgendermaßen aus:

$ sudo bash /opt/oracle/mgmt_agent/agent_inst/bin/uninstaller.sh
Executing pre-remove step from uninstall
Attempting to remove the Gateway from Management Agent Cloud service, please do not interrupt...
Attempting to remove the Gateway from Management Agent Cloud service,please do not interrupt...
Gateway was removed from Management Agent Cloud service successfully.
Detected Oracle Linux Server (Red Hat family):
Stopping mgmt_gateway...
Removing mgmt_gateway daemon from systemd...
Removed symlink /etc/systemd/system/multi-user.target.wants/mgmt_gateway.service.
Gateway was removed from the host successfully.
Executing post-remove step from uninstall
Gateway state directory was removed from the host successfully.

Management Gateway unter Windows entfernen

Öffnen Sie ein Eingabeaufforderungsfenster, navigieren Sie zum Management Gateway-Installationshauptverzeichnis, und führen Sie das Skript uninstaller.bat aus.

C:\Oracle>mgmt_agent\uninstaller.bat
Removing Management Gateway from the OCI service console.
Attempting to remove the agent from Management Agent Cloud service, do not interrupt...
Gateway was removed from the Management Agent Cloud service successfully.
Removing Management Gateway service from the host 
Management Gateway service was removed from the host successfully
Removing Management Gateway directories

Bevor Sie das Skript uninstaller.bat ausführen, müssen Sie sicherstellen, dass alle anderen Befehlszeilenfenster geschlossen sind oder nicht auf das Management Gateway-Home-Verzeichnis verweisen.

1. Öffnen Sie in der Oracle Cloud-Konsole das Navigationsmenü, und wählen Sie Identität und Sicherheit aus.
2. Gehen Sie zu Zertifikate, und wählen Sie Zertifikate aus.
3. Klicken Sie auf Zertifikat erstellen.
4. Wählen Sie das Compartment aus, in das Sie das Zertifikat importieren möchten. Es muss sich dabei um dasselbe Compartment handeln, in dem das Management Gateway installiert ist.
5. Um ein Zertifikat zu importieren, das Sie mit einer Certificate Authority (CA) verwalten möchten, klicken Sie als Zertifikatstyp auf Importiert.
6. Geben Sie einen eindeutigen Anzeigenamen für das Zertifikat ein. Geben Sie dabei keine vertraulichen Informationen ein.
7. Optional können Sie eine Beschreibung für das Zertifikat eingeben.
8. Sie müssen einen Private Key und das Kettenzertifikat eingeben.

   Das Zertifikat kann jetzt verwendet werden, wenn der Zertifikatsstatus in der Oracle Cloud-Konsole Aktiv lautet.

9. Als Nächstes müssen Sie die Zertifikats-OCID kopieren und dann die OCID als Parameter in der Management Gateway-Antwortdatei während der Management Gateway-Installation mit dem folgenden Format eingeben (siehe Antwortdatei für Management Gateway konfigurieren).

   GatewayCertOcid=ocid1.certificate.oc1.iad.<unique-id>

10. Gehen Sie folgendermaßen vor, um dieselben Zertifikate in Management Agent zu importieren, sodass die vollständige End-to-End-Interaktion funktioniert.

Voraussetzungen

1. Geben Sie einen gültigen BS-Benutzer an, um die Management Gateway-Installation auszuführen, und verwenden Sie ihn als Wert für die Variable RUN_AGENT_AS_USER.
   Oracle empfiehlt, dass der ausgewählte BS-Benutzer über die geringsten Berechtigungen und keine Anmeldeshell verfügt.

   id -un <username>

   Beispiel 1:

   id -un myexistinguser

   Der BS-Benutzer myexistinguser ist vorhanden. Die Ausgabe gibt den Wert des ausgewählten Benutzers zurück und sieht ungefähr wie folgt aus:

   myexistinguser

   Beispiel 2:

   id -un mytestuser2

   Der BS-Benutzer mytestuser2 ist nicht vorhanden und kein gültiger Benutzer. Die Ausgabe gibt keinen Benutzerwert zurück und sieht in etwa wie folgt aus:

   id: mytestuser2: no such user

2. Geben Sie die primäre Gruppe des Benutzers an, die als Wert für die Variable AGENT_USER_GROUP verwendet werden soll.
   Stellen Sie sicher, dass der Wert für AGENT_USER_GROUP die primäre Benutzergruppe des ausgewählten BS-Benutzers ist.

   Hinweis
   
   Die Verwendung einer sekundären Gruppe wird nicht unterstützt und kann zu einer Beschädigung des Management Gateways führen.

   id -gn <username>

   Beispiel:

   id -gn myexistinguser

   Die Ausgabe sieht ungefähr folgendermaßen aus:

   staff

Umgebungsvariablen festlegen und Management Gateway installieren

1. Legen Sie die folgenden Umgebungsvariablen fest:

   RUN_AGENT_AS_USER=<selected_OS_user_for_ManagementGateway_installation>
   AGENT_USER_GROUP=<OS_primary_group_of_selected_OS_user>

   Beispiel:

   RUN_AGENT_AS_USER=myexistinguser
   AGENT_USER_GROUP=staff

2. Stellen Sie sicher, dass der BS-Benutzer root auf die obige Umgebungsvariable zugreifen kann.

   Standardmäßig werden die Umgebungsvariablen nicht mit dem Benutzer root gemeinsam verwendet.

3. Prüfen Sie, ob die Umgebungsvariablen ordnungsgemäß festgelegt sind, indem Sie die folgenden Schritte ausführen:

   sudo su
   echo $RUN_AGENT_AS_USER
   echo $AGENT_USER_GROUP

   Beispiel: Die Ausgabe sieht wie folgt aus:

   myexistinguser
   staff

   Wenn root nicht auf die Umgebungsvariablen zugreifen kann, bearbeiten Sie die Datei /etc/sudoers, und fügen Sie Folgendes hinzu:

   Defaults env_keep+=RUN_AGENT_AS_USER
   Defaults env_keep+=AGENT_USER_GROUP

   Mit den obigen Angaben wird sichergestellt, dass die Umgebungsvariablen RUN_AGENT_AS_USER und AGENT_USER_GROUP beibehalten werden und der Benutzer root darauf zugreifen kann.

   Nachdem Sie die Datei /etc/sudoers aktualisiert haben, legen Sie die Umgebungsvariablen erneut fest, und prüfen Sie, ob root auf die Umgebungsvariablen zugreifen kann.

4. Nachdem die Verifizierung abgeschlossen ist, können Sie die Management Gateway-Installation starten: Melden Sie sich als root an, legen Sie die Umgebungsvariablen fest, und starten Sie dann die Management Gateway-Installation.

   Je nach bevorzugter Methode können Sie die Anweisungen unter Management Gateway auf Linux-RPM-Datei installieren oder Management Gateway auf Linux-ZIP-Datei installieren befolgen.

   Beispiel: Befolgen Sie die Anweisungen unter Management Gateway auf Linux RPM-Datei installieren. Überspringen Sie in diesem Fall Schritt 1, da Sie bereits root sind und keine sudo-Berechtigungen erforderlich sind. Beginnen Sie mit Schritt 2: rpm -ivh <rpm_file_name.rpm>