Oracle GoldenGate-Microservices mit REST-APIs upgraden

Erfahren Sie, wie Sie mit den REST-APIs ein Upgrade von Oracle GoldenGate-Microservices durchführen.

An dieser Stelle sollten Sie ein neues Oracle GoldenGate 26ai MA-Home und alle früheren Release-Homes von Oracle GoldenGate MA verwenden.

Service Manager upgraden

Nachdem Sie die neueste Oracle GoldenGate MA-Version installiert haben, führen Sie ein Upgrade des Service Managers durch.

Wenn Sie Oracle Grid Infrastructure Agent (XAG) verwenden, deaktivieren Sie die Instanz GoldenGate, bevor Sie das Upgrade von Service Manager durchführen:

 $ agctl disable goldengate <GoldenGate Name>

Beim Upgrade des Service Managers können Sie das folgende cURL-Beispiel verwenden, um das Oracle GoldenGate-Home zu aktualisieren:

curl -u adminname:adminpwd -X PATCH \
   https://hostname:port/services/v2/deployments/ServiceManager \
  -H 'cache-control: no-cache' \
  -d '{"oggHome":"new OGG_HOME_absolute_path", "status":"restart"}'

Geben Sie in dieser Syntax den absoluten Verzeichnispfad des neuen Oracle GoldenGate-Home-Verzeichnisses ein, wie /u01/app/oracle/product/26ai/gghome_1.

Wenn Sie XAG nicht verwenden, prüfen Sie mit dem folgenden Befehl, ob Service Manager über die neue $OGG_HOME ausgeführt wird:

ps -ef | grep -i servicemanager

Wenn der Service Manager nicht ausgeführt wird, führen Sie den folgenden Befehl aus, um ihn neu zu starten:

cd $NEW_OGG_HOME/bin
$ ./ServiceManager

Wenn Sie XAG verwenden, aktualisieren Sie die Parameter GoldenGate –gg_home und --oracle_home:

$ agctl modify goldengate <GoldenGate Name>  --gg_home <New OGG_HOME directory> --oracle_home <New OGG_HOME directory>/lib/instantclient

HINWEIS: Wenn Sie XAG verwenden, müssen die vom upgegradeten Service Manager verwalteten Deployments ebenfalls upgegradet werden. Es wird nicht unterstützt, Deployments unter einem Service Manager mit einem anderen GoldenGate-Softwarerelease oder OGG_HOME als Service Manager auszuführen.

Deployment upgraden

Deployments können im selben Schritt mit dem Service Manager upgegradet werden, oder sie können zu einem späteren Zeitpunkt nach dem Upgrade des Service Managers aktualisiert werden.

So upgraden Sie ein Deployment:

1. Stoppen Sie alle Extract- und Replicat-Prozesse ordnungsgemäß:

   • Prüfen Sie auf offene (lange laufende) Transaktion und gebundenes Recovery, da es länger dauern kann, Extract ordnungsgemäß zu stoppen.

   • Wenn unnötige offene Transaktionen sichtbar sind, z.B. SEND EXTRACT group_name SHOWTRANS, können diese Transaktionen übersprungen oder sofort zum Stoppen gezwungen werden. In diesem Fall kann ein Bounded Recovery-Checkpoint mit dem folgenden Befehl abgerufen werden:

     SEND EXTRACT group_name, BR BRCHECKPOINT immediate

2. (Nur Oracle GoldenGate für Oracle AI Database) Für das Unified Build-Feature muss nur die TNS_ADMIN an die Oracle Database-Clientsoftware in Oracle GoldenGate angepasst werden.

   curl -k -u adminname:adminpwd -X PATCH
   \  https://server.oracle.com:9000/services/v2/deployments/uat_01
   \  -H 'cache-control: no-cache'
   \  -d '{"environment": [, {"name": "TNS_ADMIN" , "value": "/u01/app/oracle/network/admin"} ] }'

   Hinweis: Beim Upgrade von 21c auf 26ai ist dieser Schritt nicht erforderlich. Beim Upgrade von Oracle GoldenGate 19c (oder früher) auf 26ai benötigen Sie nur die Umgebungsvariable TNS_ADMIN.

   Die Umgebungsvariable OGG_HOME kann DATABASE_HOME, LD_LIBRARY_PATH und JAVA_HOME automatisch erkennen.

3. (nur Oracle GoldenGate für SQL Server) Oracle GoldenGate 26ai für SQL Server unter Linux enthält einen ODBC-Treiber für die Datenbankkonnektivität. Obwohl es nicht erforderlich ist, wird empfohlen, den im Paket enthaltenen Treiber zu verwenden. Um den in einem Package integrierten Treiber zu verwenden, müssen zwei neue Umgebungsvariablen erstellt und alle zuvor erstellten odbc.ini-Dateien aktualisiert werden. Fügen Sie dem Deployment die folgenden Umgebungsvariablen hinzu:

    curl -k -u adminname:adminpwd -X PATCH
    \  https://server.oracle.com:9000/services/v2/deployments/uat_01
    \  -H 'cache-control: no-cache'
    \  -d '{"environment": [ , {"name": "ODBCSYSINI" , "value": "*${OGG_HOME}/msodbc*"}
                          , {"name": "ODBCINI"    , "value": "*${OGG_HOME}/msodbc/odbc.ini*"}] }'

   Kopieren Sie nach dem Erstellen der neuen Umgebungsvariablen die vorhandene Datei odbc.ini in den Oracle GoldenGate-Ordner msodbc, und ändern Sie den ODBC-Treiberwert eines beliebigen DSN-Eintrags wie folgt:

    Driver=Microsoft ODBC Driver for SQL Server

4. Führen Sie diesen cURL-Befehl aus, um das Oracle GoldenGate-Deployment upzugraden:

    curl -u SM username: SM password -X PATCH
   http://hostname:servicemanager port/services/v2/deployments/Deployment-name
   
   -H 'cache-control: no-cache'
   
   -d '{"oggHome":" new OGG_HOME complete path","status":"restart"}'

5. Starten Sie alle Extracts und Replicats.

   Wenn Sie XAG verwenden, aktivieren Sie die Instanz GoldenGate nach dem Upgrade des Deployments erneut:

    $ agctl enable goldengate <GoldenGate Name>

Wenn Service Manager und Deployment neu gestartet wurden, ist das Upgrade abgeschlossen.

Hinweis: Informationen zu Oracle GoldenGate für PostgreSQL finden Sie unter Schritte nach dem Upgrade, bevor Sie Exportvorgänge starten.