Mit dem Admin-Client können Sie eine Verbindung zu OCI GoldenGate herstellen, um Aufgaben zu konfigurieren und Prozessinformationen und Logmeldungen anzuzeigen. Sie können den Admin-Client auf zwei verschiedene Arten starten:

• Klicken Sie auf der Seite "Deployment" auf Admin-Client starten.
• Starten Sie CloudShell, und führen Sie dann den Admin-Client aus.

Bei Deployments mit aktivierter IAM-Authentifizierung müssen Sie zuerst ein Zugriffstoken generieren, um AdminClient zu verwenden. So generieren Sie ein Zugriffstoken und melden sich beim Admin-Client an:

1. Klicken Sie in der globalen Oracle Cloud-Navigationsleiste auf Profil, Mein Profil.
2. Klicken Sie auf Ihrer Profilseite unter Ressourcen auf Meine Zugriffstoken.
3. Wählen Sie unter Persönliches Zugriffstoken generieren die Option Ruft andere APIs auf aus.
4. Wählen Sie das Deployment für die Verbindung mit dem Admin-Client aus.
5. Setzen Sie den Tokenablauf auf 30 Minuten.
6. Klicken Sie auf Token herunterladen.
7. Öffnen Sie die heruntergeladene Tokendatei, und kopieren Sie den Inhalt.
8. Führen Sie im Admin-Client den folgenden Befehl aus, um eine Verbindung zu Ihrem Deployment herzustellen. Stellen Sie sicher, dass Sie <deployment_url> auf der Detailseite des Deployments durch die Konsolen-URL und <token> durch den heruntergeladenen Tokeninhalt ersetzen.

   connect <deployment_url> <token> !

Weitere Informationen finden Sie unter Verbindung zu GoldenGate mit IDCS Federation mit AdminClient herstellen.

adminclient
connect <deployment-public-url-or-ip> as <goldengate-user> password <goldengate-password> !

So stellen Sie eine Verbindung zu einem privaten OCI GoldenGate-Deployment im Admin-Client her:

1. Klicken Sie in der globalen Navigationsleiste der Oracle Cloud-Konsole auf Cloud-Shell. Wenn Sie zum ersten Mal eine Verbindung zu Cloud-Shell herstellen, kann der Vorgang etwas länger dauern.
2. Sie können den folgenden Befehl ausführen, um SSH-Schlüssel zu generieren, oder diesen Schritt überspringen und die Schlüssel generieren, wenn Sie die Bastion erstellen:

   ssh-keygen -t rsa

   Behalten Sie den Standarddateinamen bei, und geben Sie bei Aufforderung keine Passphrase ein. Der Private Key befindet sich unter ~/ssh/id_rsa und der Public Key unter ~/ssh/id_rsa.pub.

3. Notieren Sie sich auf der Seite "Deployment" die Informationen unter Private IP und Subnetz des Deployments.
4. Erstellen Sie eine Bastion.
   1. Wählen Sie im Menü Oracle Cloud-Konsole die Option Identität und Sicherheit aus, und wählen Sie dann Bastion aus.
   2. Klicken Sie auf Bastion erstellen.
   3. Geben Sie im Bereich "Bastion erstellen" einen Namen ein, und wählen Sie dann das Subnetz aus, in dem sich das Deployment befindet.
   4. Geben Sie unter "CIDR-Blockausnahmeliste" 0.0.0.0/0 ein.
   5. Klicken Sie auf Bastion erstellen.
5. Erstellen Sie eine Session.
   1. Sobald die Bastion den Status "Aktiv" aufweist, klicken Sie auf der Detailseite der Bastion auf Session erstellen.
   2. Wählen Sie unter "Sessiontyp" SSH-Portweiterleitungssession aus.
   3. Geben Sie einen Namen für die Session ein.
   4. Wählen Sie für die Verbindung mit dem Ziel die Option "IP-Adresse" aus, und geben Sie dann die private IP-Adresse des Deployments ein.
   5. Geben Sie unter "Port" die Nummer 443 ein.
   6. Fügen Sie unter "SSH-Schlüssel hinzufügen" den Inhalt des zuvor in Cloud-Shell kopierten Public Keys (~/SSH/id_rsa.pub) ein.
   7. Klicken Sie auf Session erstellen.
6. Sobald die Bastionsession den Status "Aktiv" aufweist, wählen Sie im Menü "Aktionen" (Auslassungspunkte) die Option SSH-Befehl anzeigen aus.
7. Geben Sie im Dialogfeld "SSH-Befehl anzeigen" den Pfad zum Private Key (~/SSH/id_rsa) anstelle von <private-key> ein, und ersetzen Sie <localport> durch den Port in Cloud-Shell, der die Verbindung zur Bastion weiterleitet.
   Hinweis
   
   Cloud-Shell lässt keine Portweiterleitung auf einem privilegierten Port mit sudo-Zugriff zu. Daher müssen Sie einen nicht privilegierten Port wie 7443 verwenden. Nachdem der Befehl einmal im Vordergrund ausgeführt wurde, um den Bastionhost zu known_hosts hinzuzufügen, können Sie ein Et-Zeichen (&) an das Ende des Befehls anhängen, damit er beim nächsten Mal im Hintergrund ausgeführt werden kann.
8. Kopieren Sie den Befehl, und führen Sie ihn in Cloud-Shell aus. Nachrichten vom Typ bind: Cannot assign requested address können Sie ignorieren.
9. Starten Sie den Admin-Client.

   adminclient

10. Stellen Sie eine Verbindung zum OCI GoldenGate-Deployment her.

    connect 127.0.0.1:7443 as <goldengate-user> password <goldengate-password> !

    Hinweis
    
    Das Ausrufezeichen (!) am Ende des Befehls ist sehr wichtig. Ohne dieses Zeichen verläuft der Befehl nicht erfolgreich und gibt einen Fehler zurück.

Wenn die Verbindung erfolgreich hergestellt wurde, können Sie einen der folgenden Befehle ausführen:

• Status der OCI GoldenGate-Prozesse anzeigen:

  info all

• Statistiken für den Extract anzeigen:

  view stats

• Inhalt der ggserror-Logdatei anzeigen:

  view messages

• Traildateien löschen, die nicht mehr von Extracts verwendet werden:

  purge exttrail <trail-file-name>

Eine vollständige Liste der Befehle finden Sie unter Befehle der AdminClient-Befehlszeilenschnittstelle.