Verwalten Sie Ihre OCI GoldenGate-Deployments

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

Verwandte Themen

Informationen zu GoldenGate-Versionen

OCI GoldenGate unterstützt mehrere nebenläufige Versionen, z.B. Oracle GoldenGate, Oracle GoldenGate für Big Data und Oracle GoldenGate für MySQL, um nur einige zu nennen. Weitere Informationen zur entsprechenden Version finden Sie in der Versionsreferenz.

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

  • Major: Die erste Zahl 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 ein Major Release. Beispiel: 21.5
  • Minor: Die nachstehenden Zahlen geben ein Minor Release an. Eine kleinere Version besteht aus einer oder mehreren Bugfixes für ein Bundle Release. Beispiel: 21.5.0.0.0.

Hinweis:

Alle Releasetypen können Sicherheitsfixes enthalten.

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

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

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

Hinweis:

Sie können das Datum anzeigen, bis zu dem eine Version im Fenster "Upgradebereitstellung" und in der Liste "Upgrades" unterstützt wird.

Einstellung von Versionen

Eine GoldenGate-Version ist ab dem Datum der Veröffentlichung bis zum Datum der Einstellung verfügbar. Wenn eine Version veraltet ist, können Sie sie nicht mehr zur Erstellung oder zum 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 einem Bundle-Versionsrelease sind frühere Bundle-Versionen desselben Major-Release veraltet.
  • 14 Tage nach einem Security Fix Release (für Bundle oder Minor Releases) sollten alle vorherigen Versionen desselben Major Releases nicht mehr verwendet werden.

Hinweis:

Das Freigabedatum kann je nach Region unterschiedlich sein.

Upgrades planen

Sie können Wartungsfenster anpassen, die den Beginn des Zeitraums definieren, in dem das Deployment upgegradet werden soll, wenn eine neue GoldenGate-Version verfügbar ist. Wenn Sie kein Wartungsfenster definieren, berechnet OCI GoldenGate den besten Zeitpunkt für das Upgrade des Deployments auf Basis des Releasedatums der neuesten Version.

Hinweis:

Wenn kein Wartungsfenster definiert ist, plant OCI GoldenGate Upgrades am Wochenende, das dem berechneten Ende des Zeitraums für das automatische Upgrade am nächsten liegt.

Sie können das Wartungsfenster OCI GoldenGate beim Erstellen des Deployments oder später auf der Seite mit den Deployment-Details anpassen. Wenn eine neue GoldenGate-Version verfügbar ist, wird das Deployment automatisch zu dem ausgewählten Tag und der Uhrzeit upgegradet. Deployments können jedoch automatisch vor dem ausgewählten Tag und der ausgewählten Uhrzeit upgegradet werden, wenn der Zeitrahmen der neuen Version für das manuelle Upgrade außerhalb des benutzerdefinierten Wartungsfensters liegt.

Beispiel: Am 1. Januar 2023 haben Sie noch 30 Tage Zeit, um Ihr Deployment zu aktualisieren. Anschließend haben Sie bis Dienstag, den 31. Januar, Zeit für ein manuelles Upgrade. Ihr individuelles Wartungsfenster beginnt jedoch sonntags um 10 Uhr. Mit diesem Wartungsfenster aktualisiert OCI GoldenGate Ihr Deployment am Sonntag, den 4. Februar, um 10 Uhr, da OCI GoldenGate Ihr benutzerdefiniertes Fenster immer priorisiert.

So bearbeiten Sie das benutzerdefinierte Wartungsfenster:

  1. Klicken Sie auf der Seite mit den Deployment-Details unter GoldenGate im Bereich mit den Deployment-Informationen für die Wartung auf Bearbeiten.
  2. Im Dialogfeld "Wartungsparameter bearbeiten":
    1. (Optional) Wählen Sie Wartungsfenster anpassen aus, um die folgenden Felder von ihren Standardwerten zu ändern.
    2. Geben Sie unter Zeitraum für automatische Upgrades für Major Releases in Tagen einen Wert zwischen 0 und 365 ein.
    3. Geben Sie unter Bundle-Release - Periode für automatisches Upgrade in Tagen einen Wert zwischen 0 und 180 ein.
    4. Geben Sie unter Periode für 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. Klicken Sie auf Änderungen speichern.

Vor dem Upgrade

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

Stellen Sie sicher, dass Archive-Logs für das Recovery verfügbar sind

Bestimmen Sie mit dem folgenden Befehl im Admin-Client das älteste Archivlog, das Sie beim Extrahieren wiederherstellen müssen. Das Feld Recovery Checkpoint zeigt das älteste Log an, 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 große Transaktionen mit langer Ausführungszeit vorhanden sind, können Sie bedenken, dass der neue Extract auf dem Quellsystem möglicherweise mit der Verarbeitung vom normalen Recovery Checkpoint aus beginnen muss. als der gebundene 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 Optionen:

  • Sie können die Archive wiederherstellen und in das im Recovery-Checkpoint gezeigte wiederherstellen:
    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 zu aktualisierenden Extract gelten. Dies kann geschehen, indem 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 im Trail kann zu unerwünschten Daten im Trail führen, 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. Notieren Sie sich die Transaktions-ID jeder Transaktion, die Sie bereinigen möchten.
    3. Bereinigen Sie alte Transaktionen mit SEND EXTRACT und 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 Transaktionen mit langer Ausführungszeit bereinigt 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 vor dem Upgrade synchronisieren:
Admin Client > SYNCHRONIZE REPLICAT group_name

Weitere Informationen finden Sie in der Referenz auf die Befehlszeilenschnittstelle SYNCHRONIZE REPLICAT.

Deployment upgraden

Stellen Sie sicher, dass Sie zuerst die Vor dem Upgrade-Schritte 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 klicken Sie auf Upgrade durchführen.

    Hinweis:

    Weitere Informationen zu Versionen.

Die Ausführung des Upgrades kann einige Minuten dauern. Klicken Sie auf die Seite "Deployment-Details" auf Upgrades, nachdem das Upgrade abgeschlossen ist, um die Upgradehistorie anzuzeigen, oder wenn während des Upgradeprozesses ein Problem auftreten.

Heartbeat-Tabellen upgraden
Außerdem müssen Sie Heartbeat-Tabellen aktualisieren, wenn sie in Ihrem Deployment verwendet werden. Nachdem Sie das Upgrade abgeschlossen haben, haben Sie folgende Möglichkeiten:
  • Führen Sie den Befehl UPGRADE HEARTBEATTABLE im Admin-Client aus, um zusätzliche Spalten für Tabellen und Verzögerungsansichten 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 klicken Sie auf "Konfiguration". 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 Ihnen Ereignisbenachrichtigungen, wenn ein Upgrade verfügbar ist und wenn ein Upgrade geplant ist. Weitere Informationen finden Sie unter GoldenGate Upgradeereignistypen oder Weitere Informationen zu Ereignissen.

Zeit für das Upgrade < 180 Tage < 30 Tage < 7 Tage
Kündigungsfrist Alle 30 Tage Alle 7 Tage Täglich

Hinweis:

OCI GoldenGate sendet täglich Benachrichtigungen zu Sicherheitsfixes.

Informationen zu bevorstehenden Upgrades erhalten Sie auch über die Benachrichtigungsbanner, die auf der Seite mit den Deployment-Details angezeigt werden.

Benachrichtigungen in den Warenkorb legen

Sie können Ereignis- und Bannerbenachrichtigungen erneut erinnern oder verzögern. Die Schlummerzeit ändert sich, wenn Sie sich dem Ende des Zeitrahmens für ein manuelles Upgrade nähern.

Zeit für das Upgrade < 180 Tage < 30 Tage < 7 Tage
Erneute Erinnerung 30 Tage 7 Tage Nicht zulässig

Hinweis:

Snooze für Sicherheitskorrekturen kleinerer oder Bundle-Upgrades ist nicht zulässig.

Sie können die erneute Erinnerung jederzeit abbrechen.

Rollback-Upgrades

Sie können eine Deployment-Version auf die vorherige zurücksetzen. 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 seinen letzten Status zurückgesetzt.

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

So setzen Sie ein Upgrade zurück:

  1. Wählen Sie auf der Seite "Deployments" das Deployment aus, das Sie zurücksetzen 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 dann im Menü "Aktion" die Option Rollback.
  4. Wählen Sie die Version aus, zu der ein Rollback durchgeführt werden soll, und klicken Sie auf Rollback.

    Hinweis:

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

Der Status Ihres Deployments ändert sich in "Wird aktualisiert" und dauert einige Minuten.

Upgrades neu planen

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

Hinweis:

Bei der Neuplanung werden keine Wartungsfenster berücksichtigt. Das neu geplante Datum darf nicht nach dem definierten Wert von OCI GoldenGate liegen. Weitere Informationen finden Sie unter Informationen 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 dann im Menü "Aktion" die Option Neu planen.
  4. Wählen Sie im Fenster "Deployment-Upgrade neu planen" das Datum und die Uhrzeit für die Durchführung des Upgrades aus.
  5. Klicken Sie auf Änderungen speichern.

In der Liste "Upgrades" spiegeln 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 kleines 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 dann im Menü "Aktion" die Option Abbrechen.
  4. Klicken Sie im Fenster "Deployment-Upgrade abbrechen" auf Deployment-Upgrade abbrechen.

Der Status des Upgrades wird auf "Abgebrochen" aktualisiert.

Bekannte Probleme

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

Beim Rollback eines 21.15- oder 23.x-Builds auf:

  • Oracle (21.14.0.0_240525)
  • Big Data (21.14.0.0,0)
  • MySQL (21.14.0.0_240404)
  • MSSQL (21.14.0.0_240404)

Es kann zu einem der folgenden Probleme kommen:

  • Fehlendes Problem bei 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 Empfängerpfade 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 in der Serie verfügbaren Build 21.14 durch. Wenden Sie sich an Oracle Support, wenn das Problem weiter besteht.