Rollback für Apigee Edge 4.50.00 durchführen

Wenn während einer Aktualisierung auf Edge 4.50.00 ein Fehler auftritt, können Sie ein Rollback der Komponente, die den Fehler verursacht hat, durchführen und dann die Aktualisierung wiederholen.

Sie können für Edge 4.50.00 ein Rollback auf die folgenden Feature Release-Versionen durchführen:

  • Version
  • Version
  • Version

Es gibt zwei Szenarien, in denen Sie möglicherweise ein Rollback durchführen möchten:

  1. Führen Sie ein Rollback auf einen früheren Funktionsrelease durch. Beispiel: von 4.50.00 bis 4.18.05.
  2. Führen Sie ein Rollback auf eine frühere Updateversion im selben Release durch. Beispiel: von 4.19.01.02 bis 4.19.01.01.

Weitere Informationen finden Sie unter Apigee Edge-Release-Prozess.

Wer kann ein Rollback durchführen?

Der Nutzer, der ein Rollback durchführt, sollte der Nutzer sein, 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 Benutzer aus. Wenn der Router beispielsweise auf privilegierte Ports zugreifen muss, z. B. auf Ports unter 1.000, muss er als Root oder als Nutzer mit Zugriff auf diese Ports ausgeführt werden. Oder Sie führen eine Komponente als ein Nutzer und eine andere als einen anderen Nutzer aus.

Komponenten mit gemeinsam genutztem Code

Die folgenden Edge-Komponenten verwenden denselben Code. Wenn Sie also für eine der Komponenten auf einem Knoten ein Rollback durchführen möchten, müssen Sie das Rollback für alle Komponenten auf diesem Knoten durchführen.

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

Wenn beispielsweise der Verwaltungsserver, der Router und der Message Processor auf dem Knoten installiert sind, müssen Sie für alle drei ein Rollback durchführen, um ein Rollback durchzuführen.

Rollback auf einen früheren Funktionsrelease durchführen

Wenn Sie zu einem vorherigen Feature-Release zurückkehren möchten, führen Sie auf jedem Knoten, auf dem die Komponente gehostet wird, folgende Schritte aus:

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

    • Für ein Rollback auf 4.19.06 laden Sie bootstrap_4.19.06.sh herunter:
      curl https://software.apigee.com/bootstrap_4.19.06.sh -o /tmp/bootstrap_4.19.06.sh 
    • Für ein Rollback auf 4.19.01 laden Sie bootstrap_4.19.01.sh herunter:
      curl https://software.apigee.com/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh 
    • Für ein Rollback auf 4.18.05 laden Sie bootstrap_4.18.05.sh herunter:
      curl https://software.apigee.com/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.sh 
  2. Beenden Sie die Komponente für das Rollback:
    1. Wenn Sie für eine der Komponenten mit gemeinsamem Code auf dem Knoten ein Rollback durchführen möchten, müssen Sie sie alle beenden, 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 für eine andere Komponente auf dem Knoten ein Rollback durchführen möchten, beenden Sie nur diese Komponente:
      • /opt/apigee/apigee-service/bin/apigee-service component stop
  3. Wenn Sie die Monetarisierung zurücksetzen möchten, deinstallieren Sie sie auf allen Verwaltungsserver- und Nachrichtenprozessor-Knoten:
    /opt/apigee/apigee-service/bin/apigee-service edge-mint-gateway uninstall
  4. Deinstallieren Sie die Komponente, um ein Rollback auf den Knoten durchzuführen:
    1. Wenn Sie für eine der Komponenten mit gemeinsamem Code auf dem Knoten ein Rollback durchführen möchten, müssen Sie sie alle deinstallieren. Dazu deinstallieren Sie die Komponentengruppe edge-gateway wie im folgenden Beispiel gezeigt:
      /opt/apigee/apigee-service/bin/apigee-service edge-gateway uninstall
    2. Um ein Rollback einer anderen Komponente auf dem Knoten durchzuführen, deinstallieren Sie nur diese Komponente, wie im folgenden Beispiel gezeigt:
      /opt/apigee/apigee-service/bin/apigee-service component uninstall

      Dabei ist component der Komponentenname.

    3. Für das Rollback von Edge Router müssen Sie nicht nur die Komponentengruppe 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 4.50.00-Version von apigee-setup:
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall
  6. Installieren Sie die Version 4.19.01 oder 4.18.05 des Dienstprogramms apigee-service und die zugehörigen Abhängigkeiten. Im folgenden Beispiel wird Version 4.18.05 von apigee-service installiert:
    sudo bash /tmp/bootstrap_4.18.05.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, ihn einzugeben.

    Wenn Sie eine Fehlermeldung erhalten, prüfen Sie, ob Sie die Datei bootstrap.sh in Schritt 1 heruntergeladen haben.

  7. apigee-setup installieren:
    /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 ein Rollback von Qpid durchführen, leeren Sie iptables:
    sudo iptables -F
  10. Wiederholen Sie diesen Vorgang für jeden Knoten, auf dem die Komponente gehostet wird, für die Sie ein Rollback durchführen möchten.

Rollback auf eine vorherige Updateversion durchführen

Wenn Sie für eine Komponente ein Rollback auf eine bestimmte Version eines Release durchführen möchten, führen Sie auf jedem Knoten, auf dem die Komponente gehostet wird, folgende Schritte aus:

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

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

    /opt/apigee/apigee-service/bin/apigee-service edge-ui-4.18.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 comp

    Beispiel:

    yum --showduplicates list edge-ui
  2. Verwende apigee-setup, um die Komponente zu installieren:
    /opt/apigee/apigee-setup/bin/setup.sh -p comp -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, für die Sie ein Rollback durchführen möchten.