Apigee Edge 4.19.01 oder 4.19.06 auf 4.51.00 aktualisieren

In diesem Abschnitt wird beschrieben, wie Sie das folgende Upgrade durchführen:

  • 4.19.01 bis 4.51.00
  • 4.19.06 bis 4.51.00

Wer kann das Update ausführen?

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

Nach der Installation der Edge-RPMs kann jeder Nutzer sie konfigurieren.

Welche Komponenten müssen Sie aktualisieren?

Sie müssen alle Edge-Komponenten aktualisieren. Edge unterstützt keine Einrichtung, die Komponenten aus mehreren Versionen enthält.

Automatische Übernahme von Hoteleigenschaften

Wenn Sie Eigenschaften festgelegt haben, indem Sie .properties-Dateien in /opt/apigee/customer/application bearbeitet haben, bleiben diese Werte nach der Aktualisierung erhalten.

Voraussetzungen für die Aktualisierung

Beachten Sie die folgenden Voraussetzungen, bevor Sie Apigee Edge aktualisieren:

  • Alle Knoten sichern
    Aus Sicherheitsgründen empfehlen wir, vor dem Aktualisieren ein vollständiges Back-up aller Knoten durchzuführen. Führen Sie die Sicherung mit der Anleitung für Ihre aktuelle Version von Edge durch.

    So haben Sie einen Notfallplan, falls das Update auf eine neue Version nicht richtig funktioniert. Weitere Informationen zur Sicherung finden Sie unter Sicherungen und Wiederherstellung.

  • Prüfen, ob Edge ausgeführt wird
    Prüfen Sie mit dem Befehl, ob Edge während des Aktualisierungsvorgangs ausgeführt wird: 
    /opt/apigee/apigee-service/bin/apigee-all status

Neue Edge-Benutzeroberfläche

In diesem Abschnitt werden Aspekte zur Edge-Benutzeroberfläche aufgeführt. Weitere Informationen finden Sie unter Die neue Edge-Benutzeroberfläche für die Private Cloud.

Edge-Benutzeroberfläche installieren

Nach der Erstinstallation empfiehlt Apigee, die Edge-Benutzeroberfläche zu installieren. Das ist eine erweiterte Benutzeroberfläche für Entwickler und Administratoren von Apigee Edge for Private Cloud.

Für die Edge-Benutzeroberfläche müssen Sie die Standardauthentifizierung deaktivieren und einen IDP wie SAML oder LDAP verwenden.

Weitere Informationen finden Sie unter Neue Edge-Benutzeroberfläche installieren.

Edge-Benutzeroberfläche aktualisieren

Berücksichtigen Sie beim Aktualisieren der Edge-UI-Komponente die Version von Edge für die Private Cloud, von der Sie ein Upgrade durchführen:

  • Ab Version 4.18.0x:Wenn Sie die Betaversion der Edge-Benutzeroberfläche (früher New Edge Experience oder New UE) in Version 4.18.0x installiert haben, müssen Sie sie deinstallieren und die Version 4.19.06 der Edge-Benutzeroberfläche wie unter Die neue Edge-Benutzeroberfläche installieren beschrieben neu installieren.
  • Ab Version 4.19.01 (die neue Edge-Benutzeroberfläche ist bereits installiert): Folgen Sie der Anleitung in diesem Abschnitt für die edge-management-ui-Komponente.
  • Ab Version 4.19.01 (mit der klassischen Benutzeroberfläche): Führen Sie ein Upgrade Ihrer Edge for Private Cloud-Installation wie in diesem Abschnitt beschrieben durch und installieren Sie dann die Edge-Benutzeroberfläche wie unter Neue Edge-Benutzeroberfläche installieren beschrieben.
  • Ab Version 4.19.06 (die neue Edge-Benutzeroberfläche ist bereits installiert): Folgen Sie der Anleitung in diesem Abschnitt zum Upgrade der edge-management-ui-Komponente.

Mit Apigee mTLS aktualisieren

Apigee mTLS wird nur von Apigee Edge for Private Cloud-Versionen 4.19.01 bis 4.19.06 unterstützt. Für Versionen 4.18.* oder niedriger ist kein Upgrade auf apigee-mtls möglich. Siehe Apigee mTLS aktualisieren.

Umgang mit einem fehlgeschlagenen Update

Wenn die Aktualisierung fehlschlägt, können Sie versuchen, das Problem zu beheben und update.sh dann noch einmal auszuführen. Sie können das Update mehrmals ausführen. Es wird dann an der Stelle fortgesetzt, an der es zuletzt unterbrochen wurde.

Wenn Sie aufgrund des Fehlers das Update auf die vorherige Version zurücksetzen müssen, finden Sie weitere Informationen unter 4.50.00 rückgängig machen.

Informationen zum Logging von Updates

Standardmäßig schreibt das update.sh-Dienstprogramm Loginformationen an folgende Stellen:

/opt/apigee/var/log/apigee-setup/update.log

Wenn der Nutzer, der das update.sh-Dienstprogramm ausführt, keinen Zugriff auf dieses Verzeichnis hat, wird das Protokoll als Datei namens update_username.log in das Verzeichnis /tmp geschrieben.

Wenn der Nutzer keinen Zugriff auf /tmp hat, schlägt das update.sh-Dienstprogramm fehl.

Aktualisierung ohne Ausfallzeiten

Mit einem Update ohne Ausfallzeit oder einem Rolling Update können Sie Ihre Edge-Installation aktualisieren, ohne dass Edge heruntergefahren werden muss.

Aktualisierungen ohne Ausfallzeit sind nur mit einer Konfiguration mit mindestens fünf Knoten möglich.

Der Schlüssel zu einem Upgrade ohne Ausfallzeit besteht darin, jeden Router einzeln aus dem Load Balancer zu entfernen. Aktualisieren Sie dann den Router und alle anderen Komponenten auf demselben Computer wie den Router und fügen Sie den Router dem Load Balancer wieder hinzu.

  1. Aktualisieren Sie die Maschinen in der richtigen Reihenfolge für Ihre Installation, wie unter Reihenfolge der Maschinenaktualisierung beschrieben.
  2. Wenn es an der Zeit ist, die Router zu aktualisieren, wählen Sie einen beliebigen Router aus und machen Sie ihn unerreichbar, wie unter Aktivieren/Deaktivieren der Verfügbarkeit des Servers (Nachrichtenprozessors/Routers) beschrieben.
  3. Aktualisieren Sie den ausgewählten Router und alle anderen Edge-Komponenten auf demselben Computer wie der Router. Alle Edge-Konfigurationen zeigen einen Router und einen Message Processor auf demselben Knoten an.
  4. Sorgen Sie dafür, dass der Router wieder erreichbar ist.
  5. Wiederholen Sie die Schritte 2 bis 4 für die übrigen Router.
  6. Fahren Sie mit dem Update für alle verbleibenden Computer in Ihrer Installation fort.

Beachten Sie vor und nach dem Update Folgendes:

Silent-Konfigurationsdatei verwenden

Sie müssen dem Befehl „update“ eine Konfigurationsdatei für die Installation ohne Benutzerinteraktion übergeben. Die Silent-Konfigurationsdatei muss dieselbe sein, mit der Sie Edge 4.19.01 installiert haben.

Auf einem Knoten mit einer externen Internetverbindung auf Version 4.50.00 aktualisieren

So aktualisieren Sie die Edge-Komponenten auf einem Knoten:

  1. Deaktivieren Sie gegebenenfalls alle cron-Jobs, die für die Durchführung eines Reparaturvorgangs auf Cassandra konfiguriert sind, bis das Update abgeschlossen ist.
  2. Melden Sie sich als Root auf Ihrem Knoten an, um die Edge-RPMs zu installieren.
  3. Installieren Sie yum-utils und yum-plugin-priorities: 
    sudo yum install yum-utils
sudo yum install yum-plugin-priorities
  4. Deaktivieren Sie SELinux wie unter Installieren Sie das Hilfsprogramm für das Edge-Apigee-Setup beschrieben.
  5. Wenn Sie die Installation unter Oracle 7.x ausführen, führen Sie den folgenden Befehl aus: 
    sudo yum-config-manager --enable ol7_optional_latest
  6. Wenn Sie die Installation in AWS ausführen, führen Sie die folgenden yum-configure-manager Befehle aus: 
    yum update rh-amazon-rhui-client.noarch
sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
  7. Laden Sie die bootstrap_4.50.00.sh-Datei von Edge 4.50.00 auf /tmp/bootstrap_4.50.00.sh herunter: 
    curl https://software.apigee.com/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.00.sh
  8. Installieren Sie das Dienstprogramm apigee-service und die Abhängigkeiten für Edge 4.50.00 mit dem folgenden Befehl: 
    sudo bash /tmp/bootstrap_4.50.00.sh apigeeuser=uName apigeepassword=pWord

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

    Standardmäßig prüft das Installationsprogramm, ob Java 1.8 installiert ist. Andernfalls wird es vom Installationsprogramm für Sie installiert.

    Verwenden Sie die Option JAVA_FIX, um anzugeben, wie die Java-Installation erfolgen soll. JAVA_FIX kann folgende Werte haben:

    • I: OpenJDK 1.8 installieren (Standard).
    • C: Ohne Java-Installation fortfahren.
    • Q: Beenden Bei dieser Option müssen Sie Java selbst installieren.
  9. Verwenden Sie apigee-service, um das Dienstprogramm apigee-setup zu aktualisieren, wie im folgenden Beispiel gezeigt: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  10. Aktualisieren Sie das apigee-validate-Dienstprogramm auf dem Verwaltungsserver, wie im folgenden Beispiel gezeigt: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  11. Aktualisieren Sie das apigee-provision-Dienstprogramm auf dem Verwaltungsserver, wie im folgenden Beispiel gezeigt: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  12. Führen Sie das Dienstprogramm update auf Ihren Knoten mit dem folgenden Befehl aus: 
    /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

    Gehen Sie dabei in der unter Reihenfolge der Maschinenaktualisierung beschriebenen Reihenfolge vor.

    Wobei:

    • component ist die Edge-Komponente, die aktualisiert werden soll. Mögliche Werte:
      • cs: Cassandra
      • edge: Alle Edge-Komponenten mit Ausnahme der Edge-Benutzeroberfläche: Management-Server, Nachrichtenprozessor, Router, QPID-Server, Postgres-Server
      • ldap: OpenLDAP
      • ps: postgresql
      • qpid: qpidd
      • sso: Apigee SSO (falls Sie SSO installiert haben)
      • ue: Neue Edge-Benutzeroberfläche
      • ui: Klassische Edge-Benutzeroberfläche
      • zk: Zookeeper
    • configFile ist dieselbe Konfigurationsdatei, mit der Sie bei der Installation von 4.19.01 oder 4.19.06 Ihre Edge-Komponenten definiert haben.

    Sie können update.sh auf alle Komponenten anwenden, indem Sie component auf „alle“ festlegen. Das ist aber nur möglich, wenn Sie ein Edge-AIO-Installationsprofil (All-in-One) haben. Beispiel:

    /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
  13. Starten Sie die Edge-UI-Komponente auf allen Knoten neu, auf denen sie ausgeführt wird, falls noch nicht geschehen: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
  14. Testen Sie das Update, indem Sie das apigee-validate-Dienstprogramm auf dem Verwaltungsserver ausführen, wie unter Installation testen beschrieben.

Wenn Sie das Update später rückgängig machen möchten, folgen Sie der Anleitung unter 4.50.00 rückgängig machen.

Über ein lokales Repository auf Version 4.50.00 aktualisieren

Wenn sich Ihre Edge-Knoten hinter einer Firewall befinden oder auf andere Weise nicht über das Internet auf das Apigee-Repository zugreifen können, können Sie das Update über ein lokales Repository oder einen Mirror des Apigee-Repositories ausführen.

Nachdem Sie ein lokales Edge-Repository erstellt haben, haben Sie zwei Möglichkeiten, Edge aus dem lokalen Repository zu aktualisieren:

  • Erstellen Sie eine TAR-Datei des Repositorys, kopieren Sie die TAR-Datei auf einen Knoten und aktualisieren Sie Edge dann über die TAR-Datei.
  • Installieren Sie einen Webserver auf dem Knoten mit dem lokalen Repository, damit andere Knoten darauf zugreifen können. Apigee stellt den NGINX-Webserver zur Verfügung. Sie können aber auch Ihren eigenen Webserver verwenden.

So aktualisieren Sie über ein lokales 4.50.00-Repository:

  1. Erstellen Sie ein lokales 4.50.00-Repository wie unter „Create a local Apigee repository“ (Ein lokales Apigee-Repository erstellen) im Artikel Installieren Sie das Hilfsprogramm für das Edge-Apigee-Setup beschrieben.
  2. So installieren Sie apigee-service aus einer .tar-Datei:
    1. Verpacken Sie das lokale Repository auf dem Knoten mit dem lokalen Repository mit dem folgenden Befehl in einer einzelnen TAR-Datei mit dem Namen /opt/apigee/data/apigee-mirror/apigee-4.50.00.tar.gz: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
    2. Kopieren Sie die .tar-Datei auf den Knoten, auf dem Sie Edge aktualisieren möchten. Kopieren Sie sie beispielsweise in das Verzeichnis /tmp auf dem neuen Knoten.
    3. Entpacken Sie die Datei auf dem neuen Knoten im Verzeichnis /tmp: 
      tar -xzf apigee-4.50.00.tar.gz

      Mit diesem Befehl wird im Verzeichnis mit der .tar-Datei ein neues Verzeichnis mit dem Namen repos erstellt. z. B. /tmp/repos.

    4. Installieren Sie das Edge-Dienstprogramm apigee-service und die Abhängigkeiten aus /tmp/repos: 
      sudo bash /tmp/repos/bootstrap_4.50.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

      Beachten Sie, dass Sie in diesem Befehl den Pfad zum Verzeichnis „repos“ angeben.

  3. So installieren Sie den Apigee-Dienst mit dem NGINX-Webserver:
    1. Konfigurieren Sie den NGINX-Webserver wie unter Installieren Sie das Hilfsprogramm für das Edge-Apigee-Setup unter „Über den NGINX-Webserver aus dem Repository installieren“ beschrieben.
    2. Laden Sie die Edge-bootstrap_4.50.00.sh-Datei auf dem Remote-Knoten auf /tmp/bootstrap_4.50.00.sh herunter: 
      /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.00.sh

      Dabei sind uName:pWord der Nutzername und das Passwort, die Sie zuvor für das Repository festgelegt haben, und remoteRepo die IP-Adresse oder der DNS-Name des Repository-Knotens.

    3. Installieren Sie auf dem Remote-Knoten das Edge-Hilfsprogramm apigee-setup und die Abhängigkeiten: 
      sudo bash /tmp/bootstrap_4.50.00.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

      Dabei sind uName:pWord der Nutzername und das Passwort für das Repository.

  4. Verwenden Sie apigee-service, um das Dienstprogramm apigee-setup zu aktualisieren, wie im folgenden Beispiel gezeigt: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  5. Aktualisieren Sie das apigee-validate-Dienstprogramm auf dem Verwaltungsserver, wie im folgenden Beispiel gezeigt: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  6. Aktualisieren Sie das apigee-provision-Dienstprogramm auf dem Verwaltungsserver, wie im folgenden Beispiel gezeigt: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  7. Führen Sie das update-Dienstprogramm auf Ihren Knoten in der in Reihenfolge der Aktualisierung von Computern beschriebenen Reihenfolge aus: 
    /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

    Wobei:

    • component ist die Edge-Komponente, die aktualisiert werden soll. Normalerweise aktualisieren Sie die folgenden Komponenten:
      • cs: Cassandra
      • edge: Alle Edge-Komponenten mit Ausnahme der Edge-Benutzeroberfläche: Management-Server, Nachrichtenprozessor, Router, QPID-Server, Postgres-Server
      • ldap: OpenLDAP
      • ps: postgresql
      • qpid: qpidd
      • sso: Apigee SSO (falls Sie SSO installiert haben)
      • ue Neue Edge-Benutzeroberfläche
      • ui: Klassische Edge-Benutzeroberfläche
      • zk: Zookeeper
    • configFile ist dieselbe Konfigurationsdatei, mit der Sie bei der Installation von 4.19.01 oder 4.19.06 Ihre Edge-Komponenten definiert haben.

    Sie können update.sh auf alle Komponenten anwenden, indem Sie component auf „alle“ festlegen. Das ist aber nur möglich, wenn Sie ein Edge-AIO-Installationsprofil (All-in-One) haben. Beispiel:

    /opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config
  8. Starten Sie die UI-Komponenten auf allen Knoten neu, auf denen sie ausgeführt werden, falls noch nicht geschehen: 
    /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
  9. Testen Sie das Update, indem Sie das apigee-validate-Dienstprogramm auf dem Verwaltungsserver ausführen, wie unter Installation testen beschrieben.

Wenn Sie das Update später rückgängig machen möchten, folgen Sie der Anleitung unter 4.50.00 rückgängig machen.

Reihenfolge der Maschinenaktualisierung

Die Reihenfolge, in der Sie die Maschinen in einer Edge-Installation aktualisieren, ist wichtig:

  • Sie müssen alle Cassandra- und ZooKeeper-Knoten aktualisieren, bevor Sie andere Knoten aktualisieren.
  • Verwenden Sie die Option -c edge, um alle Edge-Komponenten (Management-Server, Nachrichtenprozessor, Router, QPID-Server, aber nicht Postgres-Server) auf einem Computer gleichzeitig zu aktualisieren.
  • Wenn für einen Schritt angegeben ist, dass er auf mehreren Maschinen ausgeführt werden soll, führen Sie ihn in der angegebenen Maschinenreihenfolge aus.
  • Es gibt keinen separaten Schritt, um die Monetarisierung zu aktualisieren. Sie wird aktualisiert, wenn Sie die Option -c edge angeben.

Eigenständiges Upgrade für 1 Knoten

So führen Sie ein Upgrade einer eigenständigen Konfiguration mit einem Knoten auf Version 4.50.00 durch:

  1. Alle Komponenten aktualisieren: 
    /opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
  2. (Wenn Sie apigee-adminapi installiert haben) apigee-adminapi-Dienstprogramm aktualisiert: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

Eigenständiges Upgrade für 2 Knoten

Aktualisieren Sie die folgenden Komponenten für eine eigenständige Installation mit zwei Knoten:

Eine Liste der Edge-Topologien und Knotennummern finden Sie unter Installationstopologien.

  1. Aktualisieren Sie Cassandra und ZooKeeper auf Computer 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Aktualisieren Sie Qpid und Postgres auf Computer 2: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
  3. LDAP auf Computer 1 aktualisieren: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  4. Aktualisieren Sie die Edge-Komponenten auf Computer 2 und 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  5. Aktualisieren Sie die Benutzeroberfläche auf Computer 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  6. (Wenn Sie apigee-adminapi installiert haben) apigee-adminapi-Dienstprogramm auf Computer 1 aktualisiert: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  7. (Wenn Sie Apigee SSO installiert haben) Aktualisieren Sie Apigee SSO auf Computer 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    Dabei ist sso_config_file die Konfigurationsdatei, die Sie beim Installieren von SSO erstellt haben.

  8. Starten Sie die Edge-UI-Komponente auf Computer 1 neu: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

Upgrade mit 5 Knoten

Aktualisieren Sie die folgenden Komponenten für eine Installation mit 5 Knoten:

Eine Liste der Edge-Topologien und Knotennummern finden Sie unter Installationstopologien.

  1. Aktualisieren Sie Cassandra und ZooKeeper auf den Maschinen 1, 2 und 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Aktualisieren Sie Qpid und Postgres auf Computer 4: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile
  3. Aktualisieren Sie Qpid und Postgres auf Computer 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile
  4. LDAP auf Computer 1 aktualisieren: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Edge-Komponenten auf den Maschinen 4, 5, 1, 2 und 3 aktualisieren: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. Edge-Benutzeroberfläche aktualisieren:
    • Klassische Benutzeroberfläche:Wenn Sie die klassische Benutzeroberfläche verwenden, aktualisieren Sie die ui-Komponente auf Computer 1, wie im folgenden Beispiel gezeigt: 
      /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
    • Neue Edge-Benutzeroberfläche:Wenn Sie die neue Edge-Benutzeroberfläche installiert haben, aktualisieren Sie die ue-Komponente auf dem entsprechenden Computer (muss nicht Computer 1 sein): 
      /opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
  7. (Wenn Sie apigee-adminapi installiert haben) apigee-adminapi-Dienstprogramm auf Computer 1 aktualisiert: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  8. (Wenn Sie Apigee SSO installiert haben) Aktualisieren Sie Apigee SSO auf Computer 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    Dabei ist sso_config_file die Konfigurationsdatei, die Sie beim Installieren von SSO erstellt haben.

  9. Starte die UI-Komponente neu:
    • Klassische Benutzeroberfläche:Wenn Sie die klassische Benutzeroberfläche verwenden, starten Sie die edge-ui-Komponente auf Computer 1 neu, wie im folgenden Beispiel gezeigt: 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • Neue Edge-Benutzeroberfläche:Wenn Sie die neue Edge-Benutzeroberfläche installiert haben, starten Sie die edge-management-ui-Komponente auf dem entsprechenden Computer neu (muss nicht Computer 1 sein): 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

Upgrade eines Clusters mit 9 Knoten

Aktualisieren Sie die folgenden Komponenten für eine Clusterinstallation mit 9 Knoten:

Eine Liste der Edge-Topologien und Knotennummern finden Sie unter Installationstopologien.

  1. Aktualisieren Sie Cassandra und ZooKeeper auf den Maschinen 1, 2 und 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Qpid auf den Maschinen 6 und 7 aktualisieren: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  3. Aktualisieren Sie Postgres auf Computer 8: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. Aktualisieren Sie Postgres auf Computer 9: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  5. LDAP auf Computer 1 aktualisieren: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. Aktualisieren Sie die Edge-Komponenten auf den Maschinen 6, 7, 8, 9, 1, 4 und 5 in dieser Reihenfolge: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. Aktualisieren Sie entweder die neue Benutzeroberfläche (ue) oder die klassische Benutzeroberfläche (ui) auf Computer 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  8. (Wenn Sie apigee-adminapi installiert haben) Aktualisieren Sie das apigee-adminapi-Dienstprogramm auf Computer 1: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  9. (Wenn Sie Apigee SSO installiert haben) Aktualisieren Sie Apigee SSO auf Computer 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    Dabei ist sso_config_file die Konfigurationsdatei, die Sie beim Installieren von SSO erstellt haben.

  10. Starte die UI-Komponente neu:
    • Klassische Benutzeroberfläche:Wenn Sie die klassische Benutzeroberfläche verwenden, starten Sie die edge-ui-Komponente auf Computer 1 neu, wie im folgenden Beispiel gezeigt: 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • Neue Edge-Benutzeroberfläche:Wenn Sie die neue Edge-Benutzeroberfläche installiert haben, starten Sie die edge-management-ui-Komponente auf dem entsprechenden Computer neu (muss nicht Computer 1 sein): 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

Clusterupgrade mit 13 Knoten

Aktualisieren Sie die folgenden Komponenten für eine Clusterinstallation mit 13 Knoten:

Eine Liste der Edge-Topologien und Knotennummern finden Sie unter Installationstopologien.

  1. Aktualisieren Sie Cassandra und ZooKeeper auf den Maschinen 1, 2 und 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Qpid auf den Maschinen 12 und 13 aktualisieren: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  3. Aktualisieren Sie Postgres auf Computer 8: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. Aktualisieren Sie Postgres auf Computer 9: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  5. Aktualisieren Sie LDAP auf den Computern 4 und 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. Aktualisieren Sie die Edge-Komponenten auf den Maschinen 12, 13, 8, 9, 6, 7, 10 und 11 in dieser Reihenfolge: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. Aktualisieren Sie entweder die neue Benutzeroberfläche (ue) oder die klassische Benutzeroberfläche (ui) auf den Maschinen 6 und 7: 
    /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  8. (Wenn Sie apigee-adminapi installiert haben) apigee-adminapi-Dienstprogramm auf den Maschinen 6 und 7 aktualisiert: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  9. (Wenn Sie Apigee SSO installiert haben) Aktualisieren Sie Apigee SSO auf den Maschinen 6 und 7: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    Dabei ist sso_config_file die Konfigurationsdatei, die Sie beim Installieren von SSO erstellt haben.

  10. Starte die UI-Komponente neu:
    • Klassische Benutzeroberfläche:Wenn Sie die klassische Benutzeroberfläche verwenden, starten Sie die edge-ui-Komponente auf den Maschinen 6 und 7 neu, wie im folgenden Beispiel gezeigt: 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • Neue Edge-Benutzeroberfläche:Wenn Sie die neue Edge-Benutzeroberfläche installiert haben, starten Sie die edge-management-ui-Komponente auf den Computern 6 und 7 neu: 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

Cluster mit 12 Knoten upgraden

Aktualisieren Sie die folgenden Komponenten für eine Clusterinstallation mit 12 Knoten:

Eine Liste der Edge-Topologien und Knotennummern finden Sie unter Installationstopologien.

  1. Aktualisieren Sie Cassandra und ZooKeeper:
    1. Auf den Maschinen 1, 2 und 3 in Rechenzentrum 1: 
      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
    2. Auf den Maschinen 7, 8 und 9 in Rechenzentrum 2 
      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Aktualisieren Sie qpidd:
    1. Maschinen 4 und 5 in Rechenzentrum 1
      1. qpidd auf Computer 4 aktualisieren: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. qpidd auf Maschine 5 aktualisieren: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
    2. Maschinen 10 und 11 in Rechenzentrum 2
      1. qpidd auf Computer 10 aktualisieren: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. qpidd auf Computer 11 aktualisieren: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  3. Aktualisiere Postgres:
    1. Maschine 6 in Rechenzentrum 1 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    2. Maschine 12 im Rechenzentrum 2 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. LDAP aktualisieren:
    1. Maschine 1 in Rechenzentrum 1 
      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
    2. Maschine 7 in Rechenzentrum 2 
      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Aktualisieren Sie die Edge-Komponenten:
    1. Maschinen 4, 5, 6, 1, 2 und 3 im Rechenzentrum 1 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
    2. Maschinen 10, 11, 12, 7, 8 und 9 im Rechenzentrum 2 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. Aktualisieren Sie entweder die neue Benutzeroberfläche (ue) oder die klassische Benutzeroberfläche (ui):
    1. Maschine 1 in Rechenzentrum 1: 
      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
    2. Maschine 7 in Rechenzentrum 2: 
      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  7. (Wenn Sie apigee-adminapi installiert haben) apigee-adminapi-Dienstprogramm aktualisiert:
    1. Maschine 1 in Rechenzentrum 1: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
    2. Maschine 7 in Rechenzentrum 2: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  8. (Wenn Sie Apigee SSO installiert haben) Aktualisieren Sie Apigee SSO:
    1. Maschine 1 in Rechenzentrum 1: 
      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
    2. Maschine 7 in Rechenzentrum 2: 
      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

      3. Dabei ist sso_config_file die Konfigurationsdatei, die Sie beim Installieren von SSO erstellt haben.

  9. Starten Sie die neue Edge-Benutzeroberfläche (edge-management-ui) oder die klassische Edge-Benutzeroberfläche (edge-ui) auf den Computern 1 und 7 neu: 
    /opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart

Für eine nicht standardmäßige Konfiguration

Wenn Sie eine nicht standardmäßige Konfiguration haben, aktualisieren Sie die Edge-Komponenten in der folgenden Reihenfolge:

  1. ZooKeeper
  2. Cassandra
  3. qpidd, ps
  4. LDAP
  5. Edge, d. h. das Profil „-c edge“ auf allen Knoten in der Reihenfolge: Knoten mit Qpid-Server, Edge-Postgres-Server, Verwaltungsserver, Nachrichtenprozessor und Router.
  6. Edge-Benutzeroberfläche (klassisch oder neu)
  7. apigee-adminapi
  8. Apigee SSO

Nach Abschluss der Aktualisierung müssen Sie die Edge-UI-Komponente auf allen Computern neu starten, auf denen sie ausgeführt wird.