Rollback für Apigee Edge 4.19.06 durchführen

Wenn bei einem Update auf Edge 4.19.06 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.19.06 auf die folgenden Versionen des Feature-Releases zurücksetzen:

  • Version 4.19.01
  • Version 4.18.05
  • Version 4.18.01

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

  1. Rollback auf einen vorherigen Feature-Release durchführen Beispiel: 4.19.06 bis 4.18.05.
  2. Führen Sie ein Rollback auf eine vorherige Updateversion im selben Release aus. Beispiel: 4.19.01.02 bis 4.19.01.01.

Weitere Informationen finden Sie im Apigee Edge-Releaseprozess.

Wer kann ein Rollback ausfü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 der Benutzer „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 mit weniger als 1.000, müssen Sie den Router 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 beispielsweise der Verwaltungsserver, der Router und der Message Processor auf dem Knoten installiert sind, müssen Sie für jeden von ihnen ein Rollback für alle drei durchführen.

Rollback auf einen vorherigen Feature-Release durchführen

Wenn Sie zu einem früheren Feature-Release zurückkehren möchten, gehen Sie auf jedem Knoten, auf dem die Komponente gehostet wird, so vor:

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

    • Lade bootstrap_4.19.01.sh herunter, um ein Rollback auf Version 4.19.01 durchzuführen:
      curl https://software.apigee.com/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh 
    • Lade bootstrap_4.18.05.sh herunter, um ein Rollback auf Version 4.18.05 durchzuführen:
      curl https://software.apigee.com/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.sh 
    • Wenn Sie zu Version 4.18.01 zurückkehren möchten, laden Sie bootstrap_4.18.01.sh herunter:
      curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh 
  2. Halten Sie die Komponente für ein Rollback an:
    1. Wenn Sie für eine der Komponenten mit gemeinsamem Code auf dem Knoten ein Rollback durchführen möchten, müssen Sie alle wie im folgenden Beispiel beenden:
      /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 Sie die Monetarisierung rückgängig machen möchten, deinstallieren Sie sie auf allen Management-Server- 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 entfernen, indem Sie die edge-gateway-Komponentengruppe deinstallieren, wie im folgenden Beispiel gezeigt:
      /opt/apigee/apigee-service/bin/apigee-service edge-gateway 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 edge-gateway-Komponentengruppe deinstallieren, sondern auch den Inhalt der Datei /opt/nginx/conf.d löschen:
      cd /opt/nginx/conf.d
      rm -rf *
  5. Deinstallieren Sie Version 4.19.06 von apigee-setup:
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall
  6. Installieren Sie die Version 4.19.01, 4.18.05 oder 4.18.01 des apigee-service-Dienstprogramms und die zugehörigen Abhängigkeiten. Im folgenden Beispiel wird die Version 4.18.01 der apigee-service installiert:
    sudo bash /tmp/bootstrap_4.18.01.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. 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 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 eine vorherige Updateversion durchführen

Wenn Sie eine Komponente auf eine bestimmte Version eines Release zurücksetzen möchten, führen Sie auf jedem Knoten, auf dem die Komponente gehostet wird, die folgenden Schritte aus:

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

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

    /opt/apigee/apigee-service/bin/apigee-service edge-ui-4.18.01-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. Verwenden Sie 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 und nicht die Version angeben.

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