OCI GoldenGate-Deployments verwalten

Erfahren Sie mehr über GoldenGate-Versionen, wie und wann Sie Benachrichtigungen aktualisieren, empfangen oder schlummern und wie Sie Upgrades zurücksetzen.

Informationen zu GoldenGate-Versionen

OCI GoldenGate unterstützt mehrere gleichzeitige Versionen, wie Oracle GoldenGate, Oracle GoldenGate for Big Data und Oracle GoldenGate for MySQL, um nur einige zu nennen. Einzelheiten zur entsprechenden Version finden Sie in der Versionsreferenz.

Jedes Release hat eine Build-Nummer. Es gibt drei Typen von Releases:

• Hauptversion: Die erste Nummer in der Build-Nummer gibt ein Major Release an. Beispiel: 21.

• Bundle: Die zweite Zahl gibt das Bundle-Release an. Ein Bundle-Release ist eine Reihe von Bugfixes für eine Major-Version. Beispiel: 21.5

• Minor: Die nachgestellten Zahlen geben eine Minor Release an. Eine kleinere Version besteht aus einem oder mehreren Bugfixes in einer Bundle-Version. Beispiel: 21.5.0.0.0.

Hinweis: Alle Release-Typen können Sicherheitsfixes enthalten.

Abhängig vom Typ des Releases und davon, ob es einen Sicherheitsfix enthält oder nicht, haben Sie eine bestimmte Zeit für das Upgrade Ihres Deployments, wenn eine neue Version verfügbar ist:

Releasetyp	Major	Bündel	Minor
Nicht-Sicherheitsfix	365 Tage	180 Tage	Nicht zutreffend
Sicherheitsfix	Nicht zutreffend	14 Tage	14 Tage

Wenn Sie kein manuelles Upgrade innerhalb des angegebenen Zeitrahmens durchführen, wird Ihr Deployment am Ende dieses Zeitrahmens automatisch auf die neueste Version upgegradet.

Hinweis: Sie können das Datum, an dem eine Version unterstützt wird, bis im Fenster "Deployment upgraden" und in der Liste "Upgrades" anzeigen.

Einstellung von Versionen

Eine GoldenGate-Version ist ab dem Datum ihrer Veröffentlichung bis zu dem Datum verfügbar, an dem sie veraltet ist. Wenn eine Version veraltet ist, können Sie sie nicht mehr für die Erstellung oder das Upgrade des Deployments auswählen.

Veraltete Perioden verwenden dieselben Zeitrahmen wie Versionsupgrades. Beispiel:

• 365 Tage nach einer Major-Version ist die vorherige Major-Version veraltet.

• 180 Tage nach einer Bundle-Version sind frühere Bundle-Versionen derselben Major-Version veraltet.

• 14 Tage nach einem Security-Fix-Release (für Bundle- oder Minor-Releases) sind alle vorherigen Versionen desselben Major-Releases veraltet.

Hinweis: Ab April 2027 werden alle 21c-Datenreplikations-Deployments automatisch auf die neueste verfügbare Releaseversion upgegradet. Die Releasedaten können zwischen den Regionen variieren.

Upgrades planen

Sie können Wartungsfenster anpassen, die definieren, wann das Deployment upgegradet werden soll. Wenn Sie kein Wartungsfenster definieren, berechnet OCI GoldenGate die beste Zeit für das Upgrade des Deployments basierend auf dem Releasedatum der neuesten Version und führt dann ein automatisches Upgrade Ihres Deployments am Wochenende durch, das dem berechneten Ende des Zeitraums für das automatische Upgrade am nächsten liegt.

Hinweis: Wenn eine neue Version eines Major-, Bundle- oder Minor-Release veröffentlicht wird, plant OCI GoldenGate ein Upgrade für Sie basierend auf der jeweiligen Zeitleiste (365 Tage für Major, 180 Tage für Bundle, 14 Tage für Minor mit Sicherheitsfix). Wenn eine neuere Version desselben Release verfügbar ist, aktualisiert der Service Ihr Deployment mit der neuesten verfügbaren Version, das geplante Datum bleibt jedoch unverändert.

Sie können das OCI GoldenGate-Wartungsfenster anpassen, wenn Sie das Deployment erstellen oder wenn Sie ein vorhandenes Deployment bearbeiten. Wenn eine neue GoldenGate-Version verfügbar wird, wird das Deployment automatisch an genau dem ausgewählten Tag und der ausgewählten Uhrzeit upgegradet. Es ist jedoch möglich, dass Deployments automatisch vor dem gewählten Tag und der gewählten Uhrzeit ein Upgrade durchführen, wenn der ausgewählte Upgradezeitrahmen für ein manuelles Upgrade außerhalb des Wartungsfensters liegt.

Angenommen, Sie haben am 1. Januar noch 30 Tage Zeit, um Ihr Deployment zu aktualisieren. Bis zum Dienstag, dem 31. Januar, müssen Sie dann ein manuelles Upgrade durchführen. Ihr individuelles Wartungsfenster beginnt jedoch sonntags um 10 Uhr. Mit diesem Wartungsfenster führt OCI GoldenGate ein Upgrade Ihres Deployments am folgenden Sonntag um 10 Uhr durch, da OCI GoldenGate Ihr benutzerdefiniertes Fenster immer priorisiert.

So bearbeiten Sie das benutzerdefinierte Wartungsfenster:

1. Wählen Sie auf der Seite "Deployment-Details" unter "GoldenGate" im Bereich "Deployment" unter "Wartung" die Option Bearbeiten aus.

2. Gehen Sie im Dialogfeld "Verwaltungsparameter bearbeiten" wie folgt vor:

   1. (Optional) Wählen Sie Wartungsfenster anpassen aus, um die folgenden Felder von ihren Standardwerten zu ändern.

   2. Geben Sie unter Zeitraum für automatisches Upgrade bei Major Releases in Tagen einen Wert zwischen 0 und 365 ein.

   3. Geben Sie unter Periode für automatisches Upgrade von Bundle-Releases in Tagen einen Wert zwischen 0 und 180 ein.

   4. Geben Sie unter Automatisches Upgrade des Sicherheitspfads in Tagen einen Wert zwischen 0 und 14 ein.

   5. (Optional) Wählen Sie Automatisches Upgrade für Minor Release aktivieren aus, und geben Sie einen Wert für Zeitraum für automatisches Upgrade für Minor Release in Tagen ein.

3. Wählen Sie Änderungen speichern aus.

Vor dem Upgraden

Stellen Sie vor dem Upgrade eines Deployments sicher, dass Sie die folgenden Aufgaben ausführen und Transaktionen mit langer Ausführungszeit prüfen.

Stellen Sie sicher, dass Archive Logs für die Wiederherstellung verfügbar sind

Verwenden Sie den folgenden Befehl im Admin-Client, um das älteste Archivprotokoll zu bestimmen, das Sie beim Extract-Start möglicherweise wiederherstellen müssen. Im Feld Recovery Checkpoint wird das älteste Log angezeigt, das für das Recovery benötigt wird.

Admin Client > INFO EXTRACT group_name, SHOWCH

Es ist am besten, Upgrade-Aktivitäten außerhalb der Spitzenzeiten durchzuführen. Wenn Transaktionen mit großer und langer Ausführungszeit im Quellsystem vorhanden sind, kann es sein, dass der neue Extract die Verarbeitung vom normalen Recovery-Checkpoint aus starten muss. als dem gebundenen Recovery-Checkpoint, wenn sich der erste Datensatz der ältesten offenen Transaktion zum Zeitpunkt des Stopps von Extract in einem Log befindet, das sich nicht im System befindet.

Transaktionen mit langer Ausführungszeit löschen

Um Transaktionen mit langer Ausführungszeit zu löschen, haben Sie zwei Möglichkeiten:

• Sie können die Archive wieder in das im Recovery-Checkpoint gezeigte Archiv zurückschreiben. Dazu gehören:

  Admin Client > INFO EXTRACT

  (Wenn die Quelldatenbank dies unterstützt.)

• Sie können die Transaktionen mit langer Ausführungszeit löschen, die für den Extract gelten, für den Sie ein Upgrade durchführen. Dazu können Sie die Transaktionen überspringen oder sie als festgeschriebene Transaktionen in den Trail zwingen. Das Überspringen einer Transaktion kann zu Datenverlust führen, und das Erzwingen einer Transaktion in den Trail kann unerwünschte Daten zum Trail hinzufügen, wenn die Transaktion zurückgerollt wird. So überspringen oder erzwingen Sie eine Transaktion:

  1. Offene Transaktionen anzeigen:

     Admin Client > SEND EXTRACT group_name, SHOWTRANS

  2. Erfassen Sie die Transaktions-ID aller Transaktionen, die Sie bereinigen möchten.

  3. Bereinigen Sie alte Transaktionen mit SEND EXTRACT und entweder mit der Option SKIPTRANS, um eine Transaktion zu überspringen, oder mit FORCETRANS, um eine Transaktion im aktuellen Status als festgeschriebene Transaktion in den Trail zu zwingen. Beispiel:

     Admin Client > SEND EXTRACT group_name, {SKIPTRANS | FORCETRANS transaction_ID [THREAD n] [FORCE]}

  4. Nachdem Sie die Bereinigung von Transaktionen mit langer Ausführungszeit abgeschlossen haben, erzwingen Sie einen Bounded Recovery Checkpoint.

     Admin Client> SEND EXTRACT group_name, BR BRCHECKPOINT IMMEDIATE

Replicats synchronisieren

Stellen Sie bei Deployments mit parallelen Replicats sicher, dass Sie Replicats synchronisieren, bevor Sie ein Upgrade durchführen:

Admin Client > SYNCHRONIZE REPLICAT group_name

Weitere Informationen finden Sie in der Befehlszeilenschnittstellenreferenz SYNCHRONIZE REPLICAT.

Deployment upgraden

Stellen Sie sicher, dass Sie zuerst die Schritte Bevor Sie ein Upgrade ausführen ausführen.

Wenn Sie ein Deployment upgraden, geschieht Folgendes:

• Das Deployment wird gestoppt und nach Abschluss des Upgrades neu gestartet.

• Alle Oracle GoldenGate-Prozesse werden gestoppt und neu gestartet, wenn sie für automatisches Starten konfiguriert sind.

So upgraden Sie ein Deployment:

1. Wählen Sie auf der Seite "Deployments" das Deployment aus, das Sie upgraden möchten.

2. Wählen Sie auf der Seite mit den Deployment-Details im Menü Aktionen die Option Upgrade aus.

3. Wählen Sie im Bereich Deployment upgraden eine verfügbare GoldenGate-Version für das Upgrade aus, und wählen Sie Upgrade aus.

Hinweis: Weitere Informationen zu Versionen.

Die Ausführung des Upgrades kann einige Minuten dauern. Wählen Sie nach Abschluss des Upgrades auf die Seite "Deployment-Details" die Option Upgrades, um die Upgradehistorie anzuzeigen, oder wenn während des Upgradeprozesses ein Problem aufgetreten ist.

Heartbeat-Tabellen aktualisieren

Sie müssen auch Heartbeat-Tabellen upgraden, wenn sie in Ihrem Deployment verwendet werden. Nachdem Sie das Upgrade abgeschlossen haben, können Sie:

• Führen Sie den Befehl UPGRADE HEARTBEATTABLE im Admin-Client aus, um zusätzliche Spalten für Tabellen und Lag-Ansichten hinzuzufügen. GoldenGate verwendet diese zusätzlichen Spalten, um die Extract-Neustartposition zu verfolgen. Weitere Informationen.

• Öffnen Sie in der Deployment-Konsole das Navigationsmenü für die Administrationskonsole, und wählen Sie "Konfiguration" aus. Melden Sie sich bei der Datenbank an. Wenn Taktüberwachungstabellen angezeigt werden, wählen Sie im Menü "Aktion" die Option "Upgrade".

Upgradebenachrichtigungen

OCI GoldenGate sendet Ereignisbenachrichtigungen, wenn ein Upgrade verfügbar ist und ein Upgrade geplant ist. Weitere Informationen finden Sie unter Ereignistypen für GoldenGate-Upgrades oder Weitere Informationen zu Ereignissen.

Zeit für Upgrade	< 180 Tage	< 30 Tage	< 7 Tage
Benachrichtigungsperiode	Alle 30 Tage	Alle 7 Tage	Täglich

Hinweis: OCI GoldenGate sendet täglich Benachrichtigungen über Sicherheitsfixes.

Sie können auch über bevorstehende Upgrades über die Benachrichtigungsbanner erfahren, die auf der Seite mit den Deployment-Details angezeigt werden.

Benachrichtigungen im Standby-Modus erinnern

Sie können Ereignis- und Bannerbenachrichtigungen schlummern oder verzögern. Die Schlummerperiode ändert sich, wenn Sie näher am Ende des Zeitrahmens für ein manuelles Upgrade sind.

Zeit für Upgrade	< 180 Tage	< 30 Tage	< 7 Tage
Schlummerperiode	30 Tage	7 Tage	Nicht zulässig

Hinweis: Schlummern für Sicherheitsfixes von Klein- oder Bundle-Upgrades ist nicht zulässig.

Sie können die Erinnerung jederzeit abbrechen.

Rollback-Upgrades

Sie können ein Rollback einer Deployment-Version auf die vorherige Version durchführen. Ein Rollback ist nur für das letzte erfolgreiche Upgrade auf die vorherige Version zulässig.

Hinweis: Beim Rollback wird das Deployment-Dateisystem vor dem Upgrade auf den letzten Status zurückgesetzt.

Ein Rollback ist nicht zulässig, wenn die vorherige Version veraltet ist.

So führen Sie ein Rollback für ein Upgrade durch:

1. Wählen Sie auf der Seite "Deployments" das Deployment aus, dessen Rollback Sie ausführen möchten.

2. Wählen Sie auf der Seite mit den Deployment-Details Upgrades aus.

3. Suchen Sie in der Liste "Upgrades" die neueste vorherige Version, und wählen Sie im Menü "Aktion" die Option Rollback aus.

4. Wählen Sie die Version aus, zu der ein Rollback durchgeführt werden soll, und wählen Sie Rollback aus.

Hinweis: Eine Liste der verfügbaren Versionen finden Sie in der Versionsreferenz.

Der Status Ihres Deployments ändert sich in "Aktualisieren". Dieser Vorgang dauert einige Minuten.

Upgrades neu planen

Sie können Ihre automatisch geplanten Upgrades neu planen. Sie können das Upgrade auf ein späteres Datum verschieben oder auf ein späteres Datum verschieben.

Hinweis: Bei der Neuplanung werden die Wartungsfenster nicht berücksichtigt. Ihr neu geplantes Datum darf nicht nach dem definierten Wert von OCI GoldenGate liegen. Weitere Informationen finden Sie unter Info zu GoldenGate-Versionen.

So planen Sie ein Upgrade neu:

1. Wählen Sie auf der Seite "Deployments" das Deployment aus, dessen Upgrade Sie neu planen möchten.

2. Wählen Sie auf der Seite mit den Deployment-Details Upgrades aus.

3. Suchen Sie in der Liste "Upgrades" die neueste vorherige Version, und wählen Sie im Menü "Aktion" die Option Neu planen aus.

4. Wählen Sie im Fenster "Deployment-Upgrade neu planen" das Datum und die Uhrzeit für das Upgrade aus.

5. Wählen Sie Änderungen speichern aus.

In der Liste "Upgrades" spiegelt das geplante Datum und die geplante Uhrzeit die Änderungen wider.

Upgrades abbrechen

Sie können ein automatisch geplantes Upgrade nur abbrechen, wenn es sich bei der Zielversion um ein Minor Release handelt.

Hinweis: Wenn Sie ein Upgrade auf ein Minor Release abbrechen, werden die automatischen Upgrades für Minor Releases nicht implizit deaktiviert und müssen manuell deaktiviert werden. Sie können das automatische Upgrade von Minor Releases auf der Seite mit den Deployment-Details deaktivieren. Weitere Informationen finden Sie unter Upgrades planen.

So brechen Sie ein Upgrade ab:

1. Wählen Sie auf der Seite "Deployments" das Deployment aus, dessen Upgrade Sie abbrechen möchten.

2. Wählen Sie auf der Seite mit den Deployment-Details Upgrades aus.

3. Suchen Sie in der Liste "Upgrades" die neueste vorherige Version, und wählen Sie im Menü "Aktion" die Option Abbrechen aus.

4. Wählen Sie im Fenster "Deployment-Upgrade abbrechen" die Option Deployment-Upgrade abbrechen.

Der Status des Upgrades wird in "Abgebrochen" geändert.

Bekannte Probleme

Nach dem Upgrade auf Oracle GoldenGate 23.26.x, Deployment-Konsole 502 Fehler "Fehlerhaftes Gateway" oder "GoldenGate-Prozesse nach Anmeldung nicht auflisten"

Oracle Cloud Infrastructure GoldenGate 23.26-Deployments können nach dem Upgrade von früheren Labels auf Version 23.26.x oder nach einem Stopp-/Startvorgang bei einem 23.26.x-Deployment fehlerhaft werden.

Problemumgehung: Das Upgrade wirkte sich auf Oracle Deployments aus, um oggoracle:23.26.1.0.0_260331 zu beschriften, um dieses Problem zu beheben.

Bei Big Data-Labels und anderen Labels, die nicht von Oracle stammen, wird in Kürze ein Fix angekündigt. Wenden Sie sich an den Support, um die manuelle Interimsminderung zu erhalten und Auswirkungen zu vermeiden.

Probleme beim Rollback von Builds des Typs 21.15 oder 23.x auf 21.14

Wenn Sie versuchen, einen 21.15- oder 23.x-Build auf einen der folgenden Builds zurückzusetzen:

• Oracle (21.14.0.0.0_240525)

• Big Data (21.14.0.0.0_240515)

• MySQL (21.14.0.0.0_240404)

• MSSQL (21.14.0.0.0_240404)

Es kann eines der folgenden Probleme auftreten:

• Problem mit fehlenden Verbindungen/Zugangsdaten aufgrund der neuen Wallet-Verschlüsselungsfunktion, die ab 21.15 eingeführt wurde.

  Problemumgehung: Sie müssen die Zuweisung und Neuzuweisung vorhandener Verbindungen zum Deployment aufheben und fehlende Benutzer neu erstellen, die für alle verwendeten Verteilungs- oder Empfangspfade erforderlich sind.

• Service Manager kann aufgrund eines Problems mit dem Performancemetrikservice in Rollbacks von 23.x auf 21.14 nicht gestartet werden. Wenden Sie sich an Oracle Support, wenn dieses Problem auftritt.

• Oracle GoldenGate-Prozesse sind mit dem Fehler "OGG-02431 Ungültiger Datensatzheader in Checkpoint-Datei gefunden" nicht erfolgreich.

  Problemumgehung: Führen Sie ein Upgrade des Deployments auf den neuesten 21.14-Build aus, der in der Serie verfügbar ist. Falls das Problem weiterhin besteht, wenden Sie sich an Oracle Support.