Admin Client

Admin Client ist ein Befehlszeilenutility. Es verwendet die von den Microservices veröffentlichte REST-API, um Steuerungs- und Konfigurationsaufgaben in einem Oracle GoldenGate-Deployment auszuführen.

Admin Client ist ein Befehlszeilenutility, mit dessen Hilfe Oracle GoldenGate-Prozesse erstellt, geändert und entfernt werden können. Dieses Utility kann anstelle der MA-Webbenutzeroberfläche verwendet werden. Das Admin-Clientprogramm befindet sich im Verzeichnis $OGG_HOME/bin, wobei $OGG_HOME das Oracle GoldenGate-Home-Verzeichnis ist. Der Name des Admin-Clientprogramms lautet adminclient.

Wenn Sie die Admin Client-Verbindung mit dem Deployment automatisieren müssen, können Sie die Benutzerzugangsdaten in einem Oracle-Wallet speichern. Die gespeicherten Zugangsdaten müssen die folgenden Merkmale aufweisen:

Einzelner Benutzername (Account) und Kennwort
Lokal in der Umgebung, in der Admin Client ausgeführt wird
Nur für den derzeit angemeldeten Benutzer verfügbar
Von Admin Client verwaltet
Mit einem Zugangsdatennamen referenziert
Für Oracle GoldenGate-Deployments und Proxyverbindungen verfügbar

Um Admin Client für Administrationsaufgaben zu verwenden, benötigen Sie Benutzerzugangsdaten, die mit dem Service Manager und Administrationsservice funktionieren. Die folgenden Konfigurationen sind für die Arbeit mit Admin Client erforderlich:

Stellen Sie sicher, dass das Verzeichnis bin der Oracle-Software Teil der Umgebungsvariablen PATH ist:
```
 export PATH=ogg_install_location/bin:$PATH
```
Wenn Sie ein sicheres Deployment mit SSL-Zertifikatsdateien (.pem oder .der) konfigurieren, müssen Sie die Umgebungsvariable OGG_CLIENT_TLS_CAPATH hinzufügen. Das ist erforderlich, damit Sie eine Verbindung zum Deployment von Admin Client herstellen können. Mit dieser Variable wird der Speicherort der Zertifikatsdateien auf dem Host angegeben. Wenn Clients nur Serverzertifikate validieren müssen, muss die Umgebungsvariable OGG_CLIENT_TLS_CAPATH eine Datei mit einem vertrauenswürdigen CA-Zertifikat referenzieren, das für den Server freigegeben ist, zu dem der Client die Verbindung herstellen soll.
```
 export OGG_CLIENT_TLS_CAPATH = <em>deployment_rootCA_certificate_location</em>
```
Hinweis: Bei Microsoft Windows ist das Standardformat für Zertifikatsdateien .der, während alle anderen Plattformen .pem als Standardformat verwenden.
Führen Sie den folgenden Befehl aus:
```
 [oracle]$ adminclient
```
Die Ausgabe zeigt den Oracle GoldenGate Admin Client-Prompt an, über den Sie die Verbindung zum Deployment von Admin Client aus herstellen können. Sie können einen Alias für den Benutzernamen und das Kennwort erstellen und den Aliasnamen in Ihrem Skript verwenden, um eine Verbindung zum Server herzustellen.
```
 OGG (not connected) 1> ADD CREDENTIALS admin USER ggadmin PASSWORD *********
```
Hier wird ein Alias namens "admin" für den Benutzer "ggadmin" und das Kennwort ** auf dem Server erstellt.

Stellen Sie jetzt über den Admin Client mit dem folgenden Befehl eine Verbindung zum Service her. Admin Client ruft den echten Benutzernamen und das Kennwort aus dem Wallet im $HOME-Verzeichnis des Benutzers ab, der das Skript ausführt, und stellt mit diesen Zugangsdaten eine Verbindung zum Service her.
```
CONNECT http(s)://my.gg.server.com AS admin
```
Stellen Sie die Verbindung zu einem Deployment oder einem Proxyserver von Admin Client aus als Sicherheitsbenutzer her. Diesen Benutzer haben Sie beim Hinzufügen des Deployments für Ihre Oracle GoldenGate-Instanz mit OGGCA erstellt.

CONNECT http(s)://localhost:port DEPLOYMENT deployment name AS security role user PASSWORD password

Note: If the password to connect to a secure or non-secure deployment from the Admin Client has an exclamation mark (!) at the end, then you must enter the password in double quotes when using the CONNECT command in a single line. Andernfalls wird das Kennwort nicht akzeptiert, und die Verbindung kann nicht hergestellt werden. Das ist für alle Deployments mit einer sicheren Kennwort-Policy erforderlich.

Syntax:
```
CONNECT server-url [ DEPLOYMENT deployment-name]
                     [ ( (   AS       deployment-credentials-name
                           | USER     deployment-user-name )
                           [ PASSWORD deployment-password  ] )
                     | TOKEN [ access-token ] ]
                     [ PROXY      proxy-uri
                     [ ( AS       proxy-credentials-name
                     |   USER     proxy-user-name      )
                       [ PASSWORD proxy-password ] ] ] [ ! ]
```
Weitere Informationen finden Sie unter dem Befehl CONNECT in der Referenz zur Befehlszeilenschnittstelle für Oracle GoldenGate.

Hinweis: Die Deployment-Zugangsdaten können nicht als USERIDALIAS im Zugangsdatenspeicher gespeichert werden, da das Oracle-Wallet, das zum Speichern von Datenbankzugangsdaten verwendet wird, vom Administrationsservice verwaltet wird. Stattdessen wird ein separates Oracle-Wallet für Admin Client erstellt. Das Oracle-Wallet wird im Benutzer-Home-Verzeichnis gespeichert.

Das folgende Beispiel zeigt das Hinzufügen eines Oracle GoldenGate-Deployment-Benutzers zum Herstellen der Verbindung zum Deployment von Admin Client aus:
```
ADD CREDENTIALS admin USER ggadmin PASSWORD *********
```
Das Kennwort für den Benutzer wird im ausgeblendeten GoldenGate-Verzeichnis $HOME gespeichert.

Ausgabe:
```
2019-02-14T00:35:38Z  INFO OGG-15114  Credential store altered.
```
Im folgenden Beispiel wird ein Alias für den Benutzernamen und das Kennwort hinzugefügt, um damit über den Admin Client eine Verbindung zum Deployment herzustellen:
```
 ADD CREDENTIALS admin USER ggadmin PASSWORD *********
```
Admin Client ruft den echten Benutzernamen und das echte Kennwort aus dem Wallet im Verzeichnis $HOME des Benutzers ab, der das Skript ausführt, und verwendet diese Zugangsdaten, um eine Verbindung zum Service herzustellen.

Ausgabe:
```
2019-02-14T00:35:38Z  INFO OGG-15114  Credential store altered.
```
Das folgende Beispiel zeigt das Hinzufügen eines Proxybenutzers des Oracle GoldenGate-Deployments zum Herstellen der Verbindung zum Deployment von Admin Client aus:
```
ADD CREDENTIALS proxy USER proxyadmin PASSWORD ********
```
Dieses Beispiel zeigt die Verwendung des CONNECT-Befehls für den Zugriff auf ein Deployment mit Admin Client:
```
OGG (Not Connected)4> CONNECT http://www.example.com:12000 deployment EAST PROXY http:111.1.1.1:3128 as proxyadmin password oggadmin-A2
Using default deployment 'Local'
OGG (http://www.example.com:12000 Local) 4>
```
Sie können die vollständige Liste der Admin-Clientbefehle mit dem Befehl HELP anzeigen. Mit dem Befehl HELP SHOWSYNTAX können Sie die Syntax für bestimmte Befehle anzeigen.