Upgrade von Oracle GoldenGate Microservices - GUI-basiert

Erfahren Sie, wie Sie mit der GUI ein Upgrade von Oracle GoldenGate-Microservices durchführen.

An dieser Stelle sollten Sie ein neues Oracle GoldenGate 26ai Microservices-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>

So führen Sie das Service Manager-Upgrade aus:

1. Melden Sie sich über die URL bei Service Manager an: https://hostname:servicemanager_port

2. Blenden Sie den Link ServiceManager im Abschnitt Deployments der Seite "Service Manager - Überblick" ein.

3. Klicken Sie auf Details und dann auf das Stiftsymbol neben dem Abschnitt "Deployment-Details", um das Dialogfeld zum Bearbeiten des Home-Pfads GoldenGate zu öffnen.

4. Aktualisieren Sie den Oracle GoldenGate-Home-Pfad mit dem vollständigen Pfad zum neuen Oracle GoldenGate-Home.

5. Klicken Sie auf Apply.

6. Verwenden Sie die Dropdown-Liste Aktion, um den Service Manager neu zu starten.

   Wenn Sie XAG verwenden, aktualisieren Sie die Instanzparameter GoldenGate:

    $ 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. Die Ausführung von Deployments unter einem Service Manager mit einem anderen GoldenGate-Softwarerelease als Service Manager wird nicht unterstützt.

Deployment upgraden

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. Prüfen Sie den aktuellen Speicherort des Oracle GoldenGate 26ai-Home-Verzeichnisses im Service Manager.

   1. Melden Sie sich beim Service Manager an: http://hostname:servicemanager_port

   2. Blenden Sie auf der Service Manager-Homepage im Abschnitt "Deployments" den Link ServiceManager ein.

   3. Kopieren Sie den Pfad für das Oracle GoldenGate-Home.

3. Kehren Sie zum Abschnitt Deployments zurück, und blenden Sie den Link des Deployments ein, für das ein Upgrade durchgeführt werden soll.

4. Klicken Sie auf Details und dann auf das Symbol Stift neben dem Abschnitt Deployment-Details, um das Dialogfeld zum Bearbeiten des Pfads GoldenGate Home zu öffnen.

5. Aktualisieren Sie den Oracle GoldenGate-Home-Pfad mit dem vollständigen Pfad zum neuen Oracle GoldenGate-Home-Verzeichnis.

6. Klicken Sie auf Weiterleiten, und bestätigen Sie, dass der Oracle GoldenGate-Home-Pfad aktualisiert wurde.

7. Abhängig von der Datenbank des Deployments, das upgegradet wird, können zusätzliche Änderungen an den Einstellungen der Umgebungsvariablen vorgenommen werden.

   Klicken Sie auf Konfiguration, um die Einstellungen für die Umgebungsvariablen bei Bedarf zu ändern.

   (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.

   TNS_ADMIN = Speicherort von tnsnames.ora und sqlnet.ora

   Die Umgebungsvariable OGG_HOME kann DATABASE_HOME, LD_LIBRARY_PATH und JAVA_HOME automatisch erkennen. 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.

   (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:

   • ODBCSYSINI = ${OGG_HOME}/msodbc

   • ODBCINI = ${OGG_HOME}/msodbc/odbc.ini

   Nachdem Sie die neuen Umgebungsvariablen erstellt haben, kopieren Sie die vorhandene Datei odbc.ini in den Ordner GoldenGate msodbc, und ändern Sie den ODBC-Treiberwert eines beliebigen DSN-Eintrags wie folgt:

   Driver=Microsoft ODBC Driver for SQL Server

8. Klicken Sie auf Weiterleiten, um die Änderungen an den Umgebungsvariablen zu speichern.

9. Kehren Sie zur Service Manager-Homepage zurück.

10. Klicken Sie im Feld Aktionen für das Deployment auf das Symbol Neu starten, und klicken Sie auf OK, um das Deployment neu zu starten.

11. Melden Sie sich wieder beim neuen Adminstration Service an, und 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 Deployments 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.