Rollback von Apigee Edge 4.52.02 durchführen

Wenn bei einem Update auf Edge 4.52.02 ein Fehler auftritt, können Sie die Komponente, die den Fehler verursacht hat, rückgängig machen und das Update dann noch einmal versuchen.

Sie können Edge 4.52.02 auf eine der folgenden Hauptversionen zurücksetzen:

  • Version 4.52.01
  • Version 4.52.00
  • Version 4.51.00

Wenn Sie eine Version rückgängig machen, wird jede Komponente rückgängig gemacht, die Sie möglicherweise aktualisiert haben. Je nach der Version, von der aus Sie gestartet sind, müssen Sie möglicherweise spezielle Schritte ausführen, bevor Sie bestimmte Softwarekomponenten rückgängig machen können. In der folgenden Tabelle sind die verschiedenen Softwarekomponenten aufgeführt, für die beim Rollback möglicherweise spezielle Schritte erforderlich sind:

Rollback auf Version Besondere Hinweise für Software
4.52.01 Cassandra
4.52.00 ZooKeeper, Cassandra, Qpid
4.51.00 Zookeeper, Postgres, Cassandra, Qpid

Es gibt zwei Szenarien, in denen Sie ein Rollback ausführen können:

  1. Führen Sie ein Rollback auf eine vorherige Haupt- oder Nebenversion durch. Beispiel: von 4.52.02 auf 4.52.00.
  2. Rollback auf einen früheren Patch-Release im selben Release durchführen Beispiel: von 4.52.00.02 auf 4.52.00.01.

Weitere Informationen finden Sie im Apigee Edge-Releaseprozess.

Reihenfolge des Rollbacks

Das Rollback der Komponenten sollte in umgekehrter Reihenfolge des Upgrades erfolgen, mit der Ausnahme, dass Verwaltungsserver nach Cassandra rückgesetzt werden sollten. Cassandra, Laufzeitkomponenten und der Verwaltungsserver sollten alle mithilfe eines Rechenzentrums-zu-Rechenzentrums-Ansatzes (DC-by-DC) rückgängig gemacht werden, wobei der Traffic vorübergehend an die funktionsfähigen Rechenzentren weitergeleitet wird.

Ein typischer allgemeiner Ablauf für das Rollback für Private Cloud 4.52.02 sieht so aus:

Ein Rechenzentrum

Bei der Einrichtung eines einzelnen Rechenzentrums hat das Rollback-Verfahren erhebliche Auswirkungen auf den Laufzeittraffic und bestimmte Verwaltungs-APIs.

  1. Qpid und andere analysebezogene Komponenten zurücksetzen
  2. Router und Nachrichtenprozessoren rücksetzen
  3. Cassandra-Rollback
  4. Rollback-Verwaltungsserver
  5. Rollback für Postgres und Zookeeper

Mehrere Rechenzentren

Bei einer Einrichtung mit mehreren Rechenzentren sollten Rollbacks nach dem DC-by-DC-Ansatz (Data Center by Data Center) erfolgen, indem der Traffic vorübergehend an die funktionsfähigen Rechenzentren weitergeleitet wird. So wird die Verkehrskontinuität sichergestellt, Ausfallzeiten vermieden und ein kontrollierter Rollback-Prozess für Cassandra, Managementserver und Laufzeitknoten ermöglicht.

  1. Führen Sie auf allen DCs ein Rollback von Qpid und anderen analysebezogenen Komponenten durch.
  2. Blockieren Sie den Traffic im ersten Rechenzentrum und leiten Sie ihn an andere Rechenzentren weiter.
  3. Router und Nachrichtenprozessoren im ersten Rechenzentrum zurücksetzen.
  4. Führen Sie einen Rollback von Cassandra im ersten Rechenzentrum durch.
  5. Rollback-Verwaltungsserver im ersten Rechenzentrum.
  6. Heben Sie die Blockierung des Traffics im ersten Rechenzentrum auf und führen Sie die Schritte 2 bis 6 aus, bis die Laufzeitknoten, Cassandra und der Verwaltungsserver im letzten Rechenzentrum zurückgesetzt wurden.
  7. Führen Sie ein Rollback von Postgres, Zookeeper und LDAP auf allen DCs durch.

Angenommen, Sie haben Ihren gesamten Cassandra-Cluster, alle Verwaltungsserver und einige Runtime Message Processors (RMPs) von Version 4.52.01 auf 4.52.02 aktualisiert und müssen ein Rollback ausführen. In diesem Fall sollte der Rollback so durchgeführt werden:

  1. Blockieren Sie den Traffic zum ersten Rechenzentrum (DC) und leiten Sie den Traffic an die anderen aktiven Rechenzentren weiter, um die Dienstkontinuität zu gewährleisten.
  2. Router und Nachrichtenprozessoren im ersten Rechenzentrum zurücksetzen
  3. Führen Sie einen Cassandra-Rollback im ersten Rechenzentrum durch, indem Sie es aus einer Sicherung oder einem VM-Snapshot wiederherstellen.
  4. Führen Sie im ersten Rechenzentrum ein Rollback des Verwaltungsservers durch.
  5. Entsperren Sie den Traffic zum ersten Rechenzentrum.
  6. Wiederholen Sie die Schritte 1 bis 5 für jedes verbleibende Rechenzentrum, bis alle Laufzeitknoten, Cassandra- und Verwaltungsserver rückgängig gemacht wurden.

Wer kann ein Rollback ausführen?

Der Nutzer, der ein Rollback ausführt, muss derselbe sein wie der Nutzer, der Edge ursprünglich aktualisiert hat, oder ein Nutzer, der als Root ausgeführt wird.

Standardmäßig werden Edge-Komponenten als Nutzer „apigee“ ausgeführt. In einigen Fällen führen Sie Edge-Komponenten möglicherweise als unterschiedliche Nutzer aus. Wenn der Router beispielsweise auf privilegierte Ports zugreifen muss, z. B. auf Ports unter 1.000, müssen Sie ihn als Root oder als Nutzer mit Zugriff auf diese Ports ausführen. Sie können auch eine Komponente als einen Nutzer und eine andere Komponente als einen anderen Nutzer ausführen.

Komponenten mit gemeinsamem Code

Die folgenden Edge-Komponenten teilen sich gemeinsamen Code. Wenn Sie also eine dieser Komponenten auf einem Knoten rückgängig machen möchten, müssen Sie alle diese Komponenten auf diesem Knoten rückgängig machen.

  • edge-management-server (Verwaltungsserver)
  • edge-message-processor (Nachrichtenprozessor)
  • edge-router (Router)
  • edge-postgres-server (Postgres-Server)
  • edge-qpid-server (Qpid-Server)

Wenn Sie beispielsweise den Verwaltungsserver, den Router und den Nachrichtenprozessor auf dem Knoten installiert haben, müssen Sie alle drei zurücksetzen, um einen davon rückgängig zu machen.

Rollback von Cassandra

Wenn ein größeres Upgrade von Cassandra auf einem bestimmten Cassandra-Knoten durchgeführt wird, ändert Cassandra das Schema der auf dem Knoten gespeicherten Daten, was ein direktes Rollback unmöglich macht. Es gibt zwei Methoden für Rollbacks. Welche dieser Methoden Sie verwenden, hängt vom Status des Upgrades ab, von dem Sie rückgängig machen möchten.

Methoden für das Rollback

Rollback-Szenarien

Edge for Private Cloud 4.52.02 enthält ein Upgrade für Cassandra und den Treiber, der vom Message Processor und vom Verwaltungsserver zum Herstellen einer Verbindung zu Cassandra verwendet wird. Daher sind Upgrades und Rollbacks dieser drei Komponenten eng miteinander verbunden. In der folgenden Tabelle sind allgemeine Beispiele für Rollback-Szenarien für diese drei Komponenten aufgeführt. Das Zurücksetzen anderer Komponenten sollte gemäß dem Abschnitt Reihenfolge des Rollbacks erfolgen.

In diesem Abschnitt werden verschiedene Rollback-Szenarien sowie die empfohlene Methodik beschrieben, die auf den oben beschriebenen Ansätzen basiert.

Szenario Rollback-Strategie
Ein Rechenzentrum, einige Cassandra-Knoten wurden aktualisiert Sicherung wiederherstellen
Ein Rechenzentrum, alle Cassandra-Knoten aktualisiert Sicherung wiederherstellen
Ein Rechenzentrum, alle Knoten (Cassandra, Verwaltungsserver und Laufzeitknoten) werden aktualisiert
Mehrere Rechenzentren, einige/alle Cassandra-Knoten im ersten Rechenzentrum wurden aktualisiert Aus vorhandenem Rechenzentrum neu erstellen
Mehrere Rechenzentren, alle Cassandra-Knoten, Verwaltungsserver und Laufzeitknoten im ersten Rechenzentrum wurden aktualisiert

Dies sollte jeweils für ein Rechenzentrum durchgeführt werden.
Mehrere Rechenzentren, einige/alle Cassandra-Knoten des letzten Rechenzentrums werden aktualisiert
  • Rollback des letzten Rechenzentrums mithilfe von Sicherung
  • Führen Sie für die verbleibenden Rechenzentren ein Rollback entweder mit Sicherung oder Neuaufbau durch, jeweils für ein Rechenzentrum.
Mehrere Rechenzentren, alle Cassandra-Knoten, Verwaltungsserver und Laufzeitknoten in allen Rechenzentren werden aktualisiert

Dies sollte für jedes Rechenzentrum einzeln durchgeführt werden.

Beachten Sie beim Zurücksetzen von Cassandra im Allgemeinen Folgendes:

  1. Rollback von Laufzeit- oder Verwaltungskomponenten

    Wenn Sie Komponenten wie den Edge Management Server oder den Edge Message Processor in einem Rechenzentrum auf eine vorherige Version der Edge Private Cloud zurücksetzen müssen, achten Sie darauf, dass Cassandra in diesem Rechenzentrum gleichzeitig zurückgesetzt wird. Dies ist erforderlich, um Verwaltungs- und Laufzeitfehler zu vermeiden.

  2. Rollback mithilfe von Sicherungen

    Back-ups von Cassandra 3.11.x sind nicht mit Back-ups von Cassandra 2.1.x kompatibel. Wenn Sie ein Rollback mithilfe der Sicherungswiederherstellung durchführen möchten, müssen Sie vor dem Upgrade Sicherungen von Cassandra 2.1.x erstellen.

  3. Rechenzentrum für Rollback isolieren

    Um Ausfallzeiten zu vermeiden, muss der Traffic an vollständig funktionsfähige Rechenzentren weitergeleitet und für das Rechenzentrum, in dem das Rollback durchgeführt wird, blockiert werden.

Cassandra mithilfe von „Rebuild“ rückgängig machen

Vorbereitung

  1. Sie betreiben einen Edge for Private Cloud-Cluster der Version 4.51.00, 4.52.00 oder 4.52.01 über mehrere Rechenzentren.
  2. Sie führen ein Upgrade von Cassandra von 2.1.X auf 3.11.X durch und haben dabei Probleme festgestellt.
  3. Sie haben mindestens ein voll funktionsfähiges Rechenzentrum im Cluster, in dem noch die ältere Cassandra-Version (Cassandra 2.1.X) verwendet wird.

Allgemeine Schritte

  1. Wählen Sie ein Rechenzentrum aus, das Sie teilweise oder vollständig auf die vorherige Version zurücksetzen möchten. Leiten Sie den gesamten Anwendungsverkehr von diesem Rechenzentrum an ein anderes voll funktionsfähiges Rechenzentrum weiter.
  2. Wenn Router und Nachrichtenprozessor aktualisiert wurden, führen Sie für alle Router- und Nachrichtenprozessorknoten im Rechenzentrum einzeln ein Rollback durch.
  3. Beenden Sie Cassandra auf einem Knoten, deinstallieren Sie es und bereinigen Sie alle zugehörigen Daten.
  4. Installieren Sie das Bootstrap der vorherigen Version und richten Sie Cassandra-Version 2.1.x auf dem bereinigten Knoten ein.
  5. Erstellen Sie den Knoten neu aus dem vorhandenen funktionsfähigen Rechenzentrum, in dem noch Cassandra 2.1.x ausgeführt wird.
  6. Führen Sie die Schritte 3 bis 5 für jeden verbleibenden Cassandra-Knoten im Rechenzentrum einzeln aus.
  7. Führen Sie die Einrichtung des Verwaltungsservers im Rechenzentrum noch einmal aus.
  8. Führen Sie Tests durch, um das Rollback zu validieren. Leiten Sie den Anwendungsverkehr nach der Bestätigung wieder an das wiederhergestellte Rechenzentrum weiter.
  9. Wiederholen Sie die oben genannten Schritte für die anderen Rechenzentren, für die ein Rollback erforderlich ist.

Detaillierte Schritte zum Löschen vorhandener Knoten im Cluster und zum Wiederherstellen des Knotens:

Beginnen Sie mit dem Knoten, für den Sie ein Rollback ausführen möchten.

  1. Achten Sie darauf, dass der Traffic an voll funktionsfähige Rechenzentren weitergeleitet wird, bevor Sie mit den nächsten Schritten fortfahren.
  2. Wenn der Router und der Nachrichtenprozessor aktualisiert wurden, führen Sie im Rechenzentrum nacheinander ein Rollback für alle Router- und Nachrichtenprozessorknoten auf die vorherige Version aus.
  3. Beenden Sie Cassandra auf dem Knoten: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop
  4. Deinstallieren Sie die Cassandra-Software vom Knoten: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra uninstall
  5. Entfernen Sie das Datenverzeichnis vom Knoten: 
    rm -rf /opt/apigee/data/apigee-cassandra

  6. Laden Sie den Bootstrap der älteren Version von Edge for Private Cloud herunter und führen Sie ihn aus, zu der Sie ein Rollback ausführen möchten:

    Beispiel:Rollback auf 4.52.01

  7. Bootstrap für 4.52.01 herunterladen: 
    curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh -u ‘uName:pWord’
  8. Bootstrap von 4.52.01 ausführen: 
    sudo bash /tmp/bootstrap_4.52.01.sh apigeeuser=uName apigeepassword=pWord
  9. Installieren Sie die Cassandra-Software auf dem Knoten: 
    apigee-service apigee-cassandra install
  10. Fügen Sie der Datei /opt/apigee/apigee-cassandra/source/conf/cassandra-env.sh die folgende Property hinzu. 
    JVM_OPTS="$JVM_OPTS -Dcassandra.replace_address=<cass_ip-address>"

    Beispiel: 

    JVM_OPTS="$JVM_OPTS -Dcassandra.replace_address=10.0.0.1"

  11. Cassandra auf dem Knoten einrichten: 
    /opt/apigee/apigee-setup/bin/setup.sh -p c -f configFile
  12. Entfernen Sie nach dem Starten von Cassandra die oben genannte CWC aus der folgenden Datei:/opt/apigee/apigee-cassandra/source/conf/cassandra-env.sh.
  13. Cassandra-Knoten neu starten 
    apigee-service apigee-cassandra restart
  14. Führen Sie einen Neuaufbau auf dem Knoten aus, indem Sie den Namen des funktionsfähigen Rechenzentrums angeben: 
    /opt/apigee/apigee-cassandra/bin/nodetool rebuild -h <node-IP> <functional-dc>

    Beispiel: 

    /opt/apigee/apigee-cassandra/bin/nodetool rebuild -h 10.0.0.1 dc-2

  15. Wiederholen Sie die oben genannten Schritte für jeden Knoten, für den Sie im Rechenzentrum ein Rollback ausführen möchten.

Sobald alle Cassandra-Knoten im Rechenzentrum rückgängig gemacht und neu erstellt wurden

  1. Führen Sie die Einrichtung eines beliebigen Management-Serverknotens im Rechenzentrum aus, das zurückgesetzt werden soll. Der Verwaltungsserver muss der Version entsprechen, die Sie rückgängig gemacht haben. Falls nicht, führe auch ein Rollback für den Verwaltungsserver aus.

    2. Rollback des Verwaltungsservers auf eine ältere Version

  2. Halten Sie den Verwaltungsserver an: 
    /opt/apigee/apigee-service/bin/apigee-service edge-management-server stop
  3. Wenn Sie die Monetarisierung verwenden, deinstallieren Sie sie auch: 
    /opt/apigee/apigee-service/bin/apigee-service edge-mint-gateway uninstall
  4. Deinstallieren Sie das Edge-Gateway und den apigee-cassandra-Client: 
    /opt/apigee/apigee-service/bin/apigee-service edge-gateway uninstall
     
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra-client uninstall
  5. Laden Sie das Bootstrap der älteren Version herunter und führen Sie es aus. Führen Sie beispielsweise die folgenden Schritte aus, um das Bootstrap von Version 4.52.01 herunterzuladen und auszuführen: 
    curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh -u ‘uName:pWord’
     
    sudo bash /tmp/bootstrap_4.52.01.sh apigeeuser=uName apigeepassword=pWord

    6. Verwaltungsserver einrichten

  6. Führen Sie die Einrichtung eines Verwaltungsserverknotens aus: 
    /opt/apigee/apigee-setup/bin/setup.sh -p mt -f configFile
  7. Nachdem Sie die oben genannten Schritte ausgeführt haben, leiten Sie den Traffic wieder an das rückgängig gemachte Rechenzentrum weiter.

Optimierung nach dem Neuaufbau

Bei den oben genannten Schritten werden alle Daten im Knoten während des Neuaufbaus aus dem Remote-Rechenzentrum gestreamt. Sie können diesen Vorgang optimieren, indem Sie eine Reparatur verwenden, sobald alle Replikate an das lokale Rechenzentrum gestreamt wurden. Dadurch wird das Streaming zwischen Rechenzentren vermieden und es sollte schneller gehen, als alle Knoten aus einem Remote-Rechenzentrum neu zu erstellen.

Beispiel:Angenommen, Sie haben sechs Cassandra-Knoten im lokalen Rechenzentrum. Standardmäßig beträgt der Replikationsfaktor von Apigee 3. Jeder Knoten hat also 50% der Daten. In diesem Fall können Sie Knoten 1 und 4 wie oben beschrieben neu erstellen. Führen Sie für Knoten 2, 3, 5 und 6 die folgenden Schritte aus, um die Sicherung wiederherzustellen und eine Reparatur auszuführen.

  1. Führen Sie die Schritte oben aus, um Replikatdatenbanken im lokalen Rechenzentrum neu zu erstellen.
  2. Wiederholen Sie die folgenden Schritte für jeden verbleibenden Knoten.
  3. Stellen Sie die Sicherung wieder her, die Sie auf diesem Knoten erstellt haben. Hinweis: Diese Sicherung enthält wahrscheinlich veraltete Daten, da sie vor dem Start des Cassandra-Upgrades erstellt wurde: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restore backup_file

    Wenn Sie einen VM-Snapshot des Knotens haben, können Sie den Snapshot wiederherstellen, anstatt das Cassandra-Back-up wiederherzustellen.

  4. Starten Sie nach der Wiederherstellung der Sicherung den Cassandra-Dienst auf dem Knoten: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra start
  5. Führen Sie eine Reparatur am Knoten aus, damit die neuesten Daten aus einem vorhandenen Rechenzentrum gestreamt werden können: 
    /opt/apigee/apigee-cassandra/bin/nodetool -h <node-IP> repair -dc <local-dc-name>

    Beispiel: 

    /opt/apigee/apigee-cassandra/bin/nodetool -h 10.0.0.1 repair -dc dc-1

  6. Wiederholen Sie alle oben unter Schritt 2 genannten Schritte für jeden Knoten, den Sie reparieren möchten.

Cassandra mithilfe eines Back-ups / VM-Snapshots rückgängig machen

Dieser Vorgang ist die einzige Möglichkeit, wenn Sie den gesamten Cassandra-Cluster aktualisiert und ein Rollback ausführen möchten. Außerdem sind Apigee-Sicherungen knotenspezifisch. Es ist nicht möglich, eine Sicherung, die von einem Knoten erstellt wurde, auf einem anderen Knoten wiederherzustellen. Cassandra-Sicherungen enthalten Informationen zu Knotenmetadaten wie IP-Adresse und Ringposition.

Vorbereitung

  1. Sie führen im letzten Rechenzentrum ein Upgrade von Cassandra von 2.1.X auf 3.11.X durch und sind dabei auf Probleme gestoßen.
  2. Sie haben Sicherungen für den Knoten vor dem Upgrade, das Sie rückgängig machen möchten. Das Back-up wurde erstellt, bevor das Upgrade von 2.1.X auf 3.11.X versucht wurde.

Allgemeine Schritte

  1. Wählen Sie ein Rechenzentrum aus, das teilweise oder vollständig aktualisiert wurde, um es rückgängig zu machen. Leiten Sie den gesamten Laufzeitverkehr von diesem Rechenzentrum an ein anderes voll funktionsfähiges Rechenzentrum weiter.
  2. Wenn Router und Nachrichtenprozessor aktualisiert wurden, führen Sie für alle Router- und Nachrichtenprozessorknoten im Rechenzentrum einzeln ein Rollback durch.
  3. Beenden Sie Cassandra auf einem Knoten, deinstallieren Sie es und bereinigen Sie alle zugehörigen Daten.
  4. Installieren Sie das Bootstrap der vorherigen Version und richten Sie Cassandra-Version 2.1.x auf dem bereinigten Knoten ein.
  5. Beenden Sie den Cassandra-Knoten und bereinigen Sie alle zugehörigen Daten.
  6. Stellen Sie den Cassandra-Knoten aus der Sicherung wieder her, die vor dem Upgrade erstellt wurde.
  7. Wiederholen Sie die Schritte 3 bis 6 für jeden der verbleibenden Cassandra-Knoten im Rechenzentrum, jeweils einen Knoten nach dem anderen.
  8. Führen Sie die Einrichtung des Verwaltungsservers im Rechenzentrum noch einmal aus.
  9. Führen Sie Tests durch, um das Rollback zu validieren. Leiten Sie den Laufzeit-Traffic nach der Überprüfung wieder an das wiederhergestellte Rechenzentrum weiter.
  10. Wiederholen Sie die oben genannten Schritte für die anderen Rechenzentren, für die ein Rollback erforderlich ist.
  11. Optional: Führen Sie den Befehl „reparieren“ auf allen Cassandra-Knoten in allen Rechenzentren aus, wenn es Dateninkonsistenzen zwischen ihnen gibt.

Detaillierte Schritte zum Zurücksetzen von Cassandra mithilfe von Sicherungen/VM-Snapshots

Beginnen Sie mit einem Cassandra-Knoten im Cluster.

  1. Achten Sie darauf, dass der Traffic an voll funktionsfähige Rechenzentren weitergeleitet wird, bevor Sie mit den nächsten Schritten fortfahren.
  2. Wenn Router und Nachrichtenprozessor aktualisiert wurden, führen Sie im Rechenzentrum nacheinander ein Rollback aller Router- und Nachrichtenprozessorknoten auf die vorherige Version aus.
  3. Beenden Sie Cassandra auf dem Knoten: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop
  4. Deinstallieren Sie die Cassandra-Software vom Knoten: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra uninstall
  5. Entfernen Sie das Datenverzeichnis vom Knoten: 
    rm -rf /opt/apigee/data/apigee-cassandra

  6. Laden Sie den Bootstrap der älteren Version von Edge for Private Cloud herunter und führen Sie ihn aus, zu der Sie ein Rollback ausführen möchten:

    Beispiel: Rollback auf 4.52.01

  7. Bootstrap für 4.52.01 herunterladen: 
    curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh -u ‘uName:pWord’
  8. Bootstrap von 4.52.01 ausführen: 
    sudo bash /tmp/bootstrap_4.52.01.sh apigeeuser=uName apigeepassword=pWord
  9. Cassandra auf dem Knoten einrichten: 
    /opt/apigee/apigee-setup/bin/setup.sh -p c -f configFile
  10. Beenden Sie Cassandra auf dem Knoten: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop
  11. Löschen Sie das Datenverzeichnis auf dem Knoten: 
    rm -rf /opt/apigee/data/apigee-cassandra/data
  12. Sicherung wiederherstellen: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restore backup_file
  13. Cassandra-Dienst auf dem Knoten starten 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra start
  14. Wiederholen Sie die Schritte für jeden Cassandra-Knoten einzeln.
  15. Führen Sie die Einrichtung eines beliebigen Management-Serverknotens im Rechenzentrum aus, das zurückgesetzt werden soll. Der Verwaltungsserver muss der Version entsprechen, die Sie rückgängig gemacht haben. Falls nicht, führe auch ein Rollback für den Verwaltungsserver aus.
  16. Nachdem Sie die oben genannten Schritte ausgeführt haben, leiten Sie den Traffic wieder an das rückgängig gemachte Rechenzentrum weiter.
  17. Optional: Führen Sie den Befehl „reparieren“ auf allen Cassandra-Knoten in allen Rechenzentren aus, wenn es Dateninkonsistenzen zwischen ihnen gibt. 
    /opt/apigee/apigee-cassandra/bin/nodetool -h <node-IP> repair -pr

Rollback für das Zookeeper 3.8.3-Update ausführen

Wenn Sie zu den Versionen 4.52.00 oder 4.51.00 zurückkehren, müssen Sie einige spezielle Schritte ausführen, bevor Sie Zookeeper zurücksetzen. Diese Schritte sind unter Rollback aufgeführt.

Wenn Sie zu Version 4.52.01 zurückkehren, führen Sie ein Rollback von Zookeeper wie bei jeder anderen Software aus, wie unten im Abschnitt Rollback auf eine vorherige Haupt- oder Nebenversion durchführen beschrieben.

Rollback Qpid

Wenn Sie auf die Versionen 4.52.00 oder 4.51.00 zurückgehen, müssen Sie einige spezielle Schritte ausführen, bevor Sie Qpid zurücksetzen können. Diese Schritte sind unter Rollback aufgeführt.

Wenn Sie ein Rollback auf Version 4.52.01 durchführen, führen Sie ein Rollback von Qpid wie bei jeder anderen Software aus, wie unter Rollback auf eine vorherige Haupt- oder Minor-Version durchführen beschrieben.

Rollback für das Postgres 10.17-Update ausführen

Wenn Sie auf Version 4.51.00 zurückgehen, müssen Sie einige spezielle Schritte ausführen, bevor Sie Postgres zurücksetzen. Diese Schritte sind unter Rollback aufgeführt.

Wenn Sie auf Version 4.52.01 oder 4.52.00 zurückgehen, führen Sie ein Rollback von Postgres wie bei jeder anderen Software aus, wie unten im Abschnitt Rollback auf eine vorherige Haupt- oder Nebenversion beschrieben.

Rollback zu einem vorherigen Haupt- oder Nebenrelease durchführen

Wenn Sie zu einer früheren Haupt- oder Minor-Version zurückkehren möchten, führen Sie auf jedem Knoten, auf dem die Komponente gehostet wird, die folgenden Schritte aus:

  1. Laden Sie die bootstrap.sh-Datei für die Version herunter, auf die Sie ein Rollback durchführen möchten:

    • Wenn Sie zu Version 4.51.00 zurückkehren möchten, laden Sie bootstrap_4.51.00.sh herunter.
  2. Beenden Sie die Komponente, um ein Rollback durchzuführen:
    1. Wenn Sie eine der Komponenten mit gemeinsamem Code auf dem Knoten rückgängig machen möchten, müssen Sie alle anhalten, wie im folgenden Beispiel gezeigt: 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-server stop
/opt/apigee/apigee-service/bin/apigee-service edge-router stop
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor stop
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. Wenn Sie eine andere Komponente auf dem Knoten rückgängig machen möchten, beenden Sie nur diese Komponente: 
      /opt/apigee/apigee-service/bin/apigee-service component stop
  3. Wenn du die Monetarisierung rückgängig machen möchtest, deinstalliere sie auf allen Management-Servern und Message-Processor-Knoten: 
    /opt/apigee/apigee-service/bin/apigee-service edge-mint-gateway uninstall
  4. Deinstallieren Sie die Komponente, um den Knoten rückgängig zu machen:
    1. Wenn Sie eine der Komponenten mit gemeinsamem Code auf dem Knoten rückgängig machen möchten, müssen Sie alle Komponenten deinstallieren, indem Sie die Komponentengruppe edge-gateway und apigee-cassandra-client deinstallieren, wie im folgenden Beispiel gezeigt: 
      /opt/apigee/apigee-service/bin/apigee-service edge-gateway uninstall
       
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra-client uninstall
    2. Wenn Sie eine andere Komponente auf dem Knoten rückgängig machen möchten, deinstallieren Sie nur diese Komponente, wie im folgenden Beispiel gezeigt: 
      /opt/apigee/apigee-service/bin/apigee-service component uninstall

      Dabei ist component der Name der Komponente.

    3. Wenn Sie den Edge-Router rückgängig machen möchten, müssen Sie nicht nur die Komponente edge-gateway deinstallieren, sondern auch den Inhalt der Datei /opt/nginx/conf.d löschen: 
      cd /opt/nginx/conf.d
rm -rf *
  5. Deinstallieren Sie die Version 4.52.02 von apigee-setup: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall
  6. Installieren Sie die Version 4.51.00 des apigee-service-Dienstprogramms und die zugehörigen Abhängigkeiten. Im folgenden Beispiel wird die Version 4.51.00 der apigee-service installiert: 
    sudo bash /tmp/bootstrap_4.51.00.sh apigeeuser=uName apigeepassword=pWord

    Dabei sind uName und pWord der Nutzername und das Passwort, die Sie von Apigee erhalten haben. Wenn Sie pWord weglassen, werden Sie aufgefordert, sie einzugeben.

    Wenn ein Fehler auftritt, prüfen Sie, ob Sie die Datei bootstrap.sh in Schritt 1 heruntergeladen haben.

  7. Installieren Sie apigee-setup: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  8. Installieren Sie die ältere Version der Komponente: 
    /opt/apigee/apigee-setup/bin/setup.sh -p component -f configFile

    Dabei ist component die zu installierende Komponente und configFile die Konfigurationsdatei für die ältere Version.

  9. Wenn Sie Qpid rückgängig machen, leeren Sie iptables: 
    sudo iptables -F
  10. Wiederholen Sie diesen Vorgang für jeden Knoten, auf dem die Komponente gehostet wird, die Sie rückgängig machen möchten.

Rollback auf einen vorherigen Patch-Release durchführen

Wenn Sie eine Komponente auf einen bestimmten Patch-Release zurücksetzen möchten, gehen Sie auf jedem Knoten, auf dem die Komponente gehostet wird, so vor:

  1. Laden Sie die gewünschte Komponentenversion herunter: 
    /opt/apigee/apigee-service/bin/apigee-service component_version install

    Dabei ist component_version die zu installierende Komponente und Patch-Version. Beispiel:

    /opt/apigee/apigee-service/bin/apigee-service edge-ui-4.51.05-0.0.3749 install

    Wenn Sie das Apigee-Online-Repository verwenden, können Sie die verfügbaren Komponentenversionen mit dem folgenden Befehl ermitteln: 

    yum --showduplicates list component

    Beispiel:

    yum --showduplicates list edge-ui
  2. Verwenden Sie apigee-setup, um die Komponente zu installieren: 
    /opt/apigee/apigee-setup/bin/setup.sh -p component -f configFile

    Beispiel:

    /opt/apigee/apigee-setup/bin/setup.sh -p ui -f configFile

    Beachten Sie, dass Sie bei der Installation nur den Komponentennamen angeben, nicht die Version.

  3. Wiederholen Sie diesen Vorgang für jeden Knoten, auf dem die Komponente gehostet wird, die Sie rückgängig machen möchten.

mTLS rückgängig machen

Führen Sie die folgenden Schritte auf allen Hosts aus, um das mTLS-Update rückgängig zu machen:

  1. Apigee beenden: 
    apigee-all stop
  2. mTLS beenden: 
    apigee-service apigee-mtls uninstall
  3. mTLS neu installieren: 
    apigee-service apigee-mtls install
apigee-service apigee-mtls setup -f /opt/silent.conf