Apigee Edge 4.17.09 auf 4.19.01 aktualisieren

Edge for Private Cloud Version 4.19.01

In diesem Abschnitt wird beschrieben, wie Sie die folgenden Upgrades ausführen:

  • 17.04.bis 19.01.

Wer kann das Update durchführen?

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

Nachdem Sie die Edge-RPMs installiert haben, können sie von jedem Benutzer konfiguriert werden.

Welche Komponenten müssen aktualisiert werden?

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

Kompatibilität aufrechterhalten

Wenn Sie ein Upgrade von Apigee Edge for Private Cloud auf 4.19.01 durchführen, müssen Sie dafür sorgen, dass die resultierende Implementierung nur auf unterstützte Attribute in ihren Konfigurationsdateien verweist.

Property Standort Beschreibung
conf_load_balancing_load.balancing.
  driver.nginx.server.retry		 router.properties Entfernen Sie diese Eigenschaft aus der Datei router.properties. Verwenden Sie zum Festlegen von Wiederholungsoptionen in 4.19.01 die Eigenschaften der Konfiguration des virtuellen Hosts.

Automatische Weitergabe von Property-Einstellungen

Wenn Sie durch Bearbeiten von .properties-Dateien in /opt/apigee/customer/application Attribute festgelegt haben, werden diese Werte bei der Aktualisierung beibehalten.

Erforderliches Upgrade auf Postgres 9.6

Diese Version von Edge enthält ein Upgrade auf Postgres 9.6. Im Rahmen dieses Upgrades werden alle Postgres-Daten zu Postgres 9.6 migriert.

Die meisten Edge-Produktionssysteme verwenden zwei Postgres-Knoten, die für die Master-Standby-Replikation konfiguriert sind. Während die Postgres-Knoten für die Aktualisierung ausgefallen sind, werden während des Aktualisierungsvorgangs weiterhin Analysedaten in die Qpid-Knoten geschrieben. Nachdem die Postgres-Knoten aktualisiert und wieder online sind, werden die Analysedaten an die Postgres-Knoten übertragen.

Wie Sie das Postgres-Update durchführen, hängt davon ab, wie Sie den Datenspeicher für Ihre Postgres-Knoten konfiguriert haben:

  • Wenn Sie lokalen Datenspeicher für Ihre Postgres-Knoten verwenden, müssen Sie für die Dauer des Upgrades einen neuen Postgres-Standby-Knoten installieren. Nach Abschluss des Upgrades können Sie den neuen Postgres-Standby-Knoten außer Betrieb nehmen.

    Der zusätzliche Postgres-Standby-Knoten ist erforderlich, wenn Sie aus irgendeinem Grund ein Rollback der Aktualisierung durchführen müssen. Wenn Sie das Update rückgängig machen müssen, wird der neue Postgres-Standby-Knoten nach dem Rollback zum Postgres-Masterknoten. Wenn Sie den neuen Postgres-Standby-Knoten daher installieren, sollte er sich auf einem Knoten befinden, der alle Hardwareanforderungen eines Postgres-Servers erfüllt, wie in den Edge-Installationsanforderungen definiert.

    In einer Konfiguration mit einem und zwei Knoten von Edge haben Topologien, die für Prototyping und Tests verwendet werden, nur einen Postgres-Knoten. Sie können diese Postgres-Knoten direkt aktualisieren, ohne einen neuen Postgres-Knoten erstellen zu müssen.

  • Wenn Sie für Ihre Postgres-Knoten einen Netzwerkspeicher verwenden, wie von Apigee empfohlen, müssen Sie keinen neuen Postgres-Knoten installieren. In den folgenden Verfahren können Sie die Schritte zum Installieren und späteren Außerbetriebnahme eines neuen Postgres-Standby-Knotens überspringen.

    Erstellen Sie vor dem Update einen Netzwerk-Snapshot des von Postgres verwendeten Datenspeichers. Wenn dann während der Aktualisierung Fehler auftreten und Sie ein Rollback durchführen müssen, können Sie den Postgres-Knoten aus diesem Snapshot wiederherstellen.

Neuen Postgres-Standby-Knoten installieren

Mit diesem Verfahren wird ein Postgres-Standby-Server auf einem neuen Knoten erstellt. Installieren Sie einen neuen Postgres-Standby-Server für die vorhandene Version von Edge (4.17.09) und nicht für Version 4.19.01.

Verwenden Sie zum Durchführen der Installation dieselbe Konfigurationsdatei, mit der Sie Ihre aktuelle Edge-Version installiert haben.

So erstellen Sie einen neuen Postgres-Standby-Knoten:

  1. Bearbeiten Sie auf dem aktuellen Postgres-Master die Datei /opt/apigee/customer/application/postgresql.properties, um das folgende Token festzulegen. Wenn die Datei nicht vorhanden ist, erstellen Sie sie: 
    conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust\ \nhost replication apigee new_standby_ip/32 trust

    Dabei ist existing_standby_ip die IP-Adresse des aktuellen Postgres-Standby-Servers und new_standby_ip die IP-Adresse des neuen Standby-Knotens.

  2. Starten Sie apigee-postgresql auf dem Postgres-Master neu: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
  3. Prüfen Sie, ob der neue Standby-Knoten hinzugefügt wurde. Sehen Sie sich dazu die Datei /opt/apigee/apigee-postgresql/conf/pg_hba.conf auf dem Master an. Die Datei sollte folgende Zeilen enthalten: 
    host replication apigee existing_standby_ip/32 trust
host replication apigee new_standby_ip/32 trust
  4. Installieren Sie den neuen Postgres-Standby-Server:
    1. Bearbeiten Sie die Konfigurationsdatei, mit der Sie Ihre aktuelle Version von Edge installiert haben, um Folgendes anzugeben: 
      # IP address of the current master:
PG_MASTER=192.168.56.103
# IP address of the new standby node
PG_STANDBY=192.168.56.102
    2. Deaktivieren Sie SELinux wie unter Das Edge-Dienstprogramm für die Apigee-Einrichtung installieren beschrieben.
    3. Laden Sie die Datei Edge bootstrap_4.17.09.sh in /tmp/bootstrap_4.17.09.sh herunter: 
      curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
    4. Installieren Sie das Edge-Dienstprogramm apigee-service und die Abhängigkeiten: 
      sudo bash /tmp/bootstrap_4.17.09.sh apigeeuser=uName apigeepassword=pWord
    5. Verwenden Sie apigee-service, um das apigee-setup-Dienstprogramm zu installieren: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    6. Postgres installieren: 
      /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
    7. Führen Sie auf dem neuen Standby-Knoten den folgenden Befehl aus: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      Prüfen Sie, ob es sich um den Standby-Modus handelt.

Postgres-Knoten außer Betrieb nehmen

Nach Abschluss des Updates können Sie den neuen Standby-Knoten außer Betrieb nehmen:

  1. Prüfen Sie, ob Postgres ausgeführt wird: 
    /opt/apigee/apigee-service/bin/apigee-all status

    Wenn Postgres nicht ausgeführt wird, starten Sie es: 

    /opt/apigee/apigee-service/bin/apigee-all start

  2. Rufen Sie die UUID des neuen Standby-Knotens ab. Führen Sie dazu auf dem neuen Standby-Knoten den folgenden curl-Befehl aus: 
    curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self

    Die UUID des Knotens sollte am Ende der Ausgabe in folgendem Format angezeigt werden: 

    "type" : [ "postgres-server" ],
"uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"

  3. Beenden Sie den neuen Standby-Knoten mit dem folgenden Befehl auf dem neuen Standby-Knoten: 
    /opt/apigee/apigee-service/bin/apigee-all stop
  4. Bearbeiten Sie auf dem Postgres-Masterknoten /opt/apigee/customer/application/postgresql.properties, um den neuen Stand-by-Knoten aus conf_pg_hba_replication.connection zu entfernen: 
    conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust
  5. Starten Sie apigee-postgresql auf dem Postgres-Master neu: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
  6. Prüfen Sie, ob der neue Standby-Knoten entfernt wurde. Sehen Sie sich dazu die Datei /opt/apigee/apigee-postgresql/conf/pg_hba.conf auf dem Master an. In dieser Datei sollte nur die folgende Zeile zu sehen sein: 
    host replication apigee existing_standby_ip/32 trust
  7. Löschen Sie die UUID des Standby-Knotens aus ZooKeeper. Dazu führen Sie den folgenden Edge Management API-Aufruf auf dem Verwaltungsserverknoten aus: 
    curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/new_standby_uuid

Voraussetzungen für Updates

Beachten Sie vor dem Upgrade von Apigee Edge die folgenden Voraussetzungen:

  • Alle Knoten sichern
    Vor der Aktualisierung wird aus Sicherheitsgründen empfohlen, eine vollständige Sicherung aller Knoten durchzuführen. Führen Sie die Sicherung anhand des Verfahrens für Ihre aktuelle Edge-Version aus.

    So haben Sie einen Sicherungsplan für den Fall, dass die Aktualisierung auf eine neue Version nicht ordnungsgemäß funktioniert. Weitere Informationen zur Sicherung finden Sie unter Sichern und Wiederherstellen.

  • Überprüfen Sie, ob Edge ausgeführt wird
    Prüfen Sie mit dem folgenden Befehl, ob Edge während des Aktualisierungsprozesses aktiv ist: 
    /opt/apigee/apigee-service/bin/apigee-all status

Umgang mit einer fehlgeschlagenen Aktualisierung

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

Wenn aufgrund des Fehlers ein Rollback auf die vorherige Version durchgeführt werden muss, finden Sie weitere Informationen unter Rollback auf Version 4.19.01.

Informationen zum Logging-Update

Standardmäßig schreibt das Dienstprogramm update.sh Loginformationen in:

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

Wenn der Nutzer, der das Dienstprogramm update.sh ausführt, keinen Zugriff auf dieses Verzeichnis hat, wird das Log in das Verzeichnis /tmp als Datei mit dem Namen update_username.log geschrieben.

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

Update ohne Ausfallzeiten

Mit einem Update ohne Ausfallzeiten oder einem Rolling Update können Sie Ihre Edge-Konfiguration aktualisieren, ohne Edge zu beenden.

Updates ohne Ausfallzeiten sind nur ab einer Konfiguration mit 5 Knoten möglich.

Der Schlüssel für ein Upgrade ohne Ausfallzeiten besteht darin, jeden Router einzeln aus dem Load-Balancer zu entfernen. Anschließend aktualisieren Sie den Router und alle anderen Komponenten auf demselben Computer wie der Router und fügen ihn dann wieder dem Load-Balancer hinzu.

  1. Aktualisieren Sie die Maschinen in der richtigen Reihenfolge für Ihre Konfiguration, wie unter Reihenfolge des Maschinenupdates 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 Erreichbarkeit des Servers (Message Processor/Router) aktivieren/deaktivieren 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. Machen Sie den Router wieder erreichbar.
  5. Wiederholen Sie die Schritte 2 bis 4 für die verbleibenden Router.
  6. Führen Sie das Update für alle in Ihrer Konfiguration verbleibenden Maschinen aus.

Beachten Sie vor/nach dem Update Folgendes:

  • Auf dem kombinierten Router- und Message Processor-Knoten:
    • Führen Sie vor der Aktualisierung die folgenden Schritte aus:
      1. Machen Sie den Router unerreichbar.
      2. Machen Sie den Message Processor unerreichbar.
    • Führen Sie nach der Aktualisierung Folgendes aus:
      1. Machen Sie den Message Processor erreichbar.
      2. Sorgen Sie dafür, dass der Router erreichbar ist.
  • Auf einem einzelnen Routerknoten:
    • Sorgen Sie dafür, dass der Router vor dem Update nicht erreichbar ist.
    • Sorgen Sie dafür, dass der Router nach dem Update erreichbar ist.
  • Auf einem einzelnen Message Processor-Knoten:
    • Machen Sie den Message Processor vor der Aktualisierung unerreichbar.
    • Machen Sie den Message Processor nach der Aktualisierung erreichbar.

Konfigurationsdatei im Hintergrund verwenden

Sie müssen eine unbeaufsichtigte Konfigurationsdatei an den Aktualisierungsbefehl übergeben. Die Konfigurationsdatei für die stille Konfiguration sollte mit der Datei identisch sein, die Sie bei der Installation von Edge 4.17.09 verwendet haben.

Aktualisierung auf 4.19.01 auf einem Knoten mit einer externen Internetverbindung

Aktualisieren Sie mit dem folgenden Verfahren die Edge-Komponenten auf einem Knoten:

  1. Wenn Sie derzeit die Postgres-Master-Standby-Replikation mit lokalem Speicher verwenden, installieren Sie einen neuen Postgres-Standby-Knoten wie unter Neuen Postgres-Standby-Knoten installieren beschrieben.

    Wenn Sie Netzwerkspeicher verwenden, müssen Sie den neuen Knoten nicht installieren. Erstellen Sie stattdessen einen Netzwerk-Snapshot des von Postgres verwendeten Datenspeichers. Weitere Informationen finden Sie unter Erforderliches Upgrade auf Postgres 9.6.

  2. Deaktivieren Sie gegebenenfalls alle CRON-Jobs, die für die Durchführung eines Reparaturvorgangs für Cassandra konfiguriert sind, bis die Aktualisierung abgeschlossen ist.
  3. Melden Sie sich bei Ihrem Knoten als Root an, um die Edge-RPMs zu installieren.
  4. Installieren Sie yum-utils und yum-plugin-priorities: 
    sudo yum install yum-utils
sudo yum install yum-plugin-priorities
  5. Deaktivieren Sie SELinux wie unter Das Edge-Dienstprogramm für die Apigee-Einrichtung installieren beschrieben.
  6. Wenn Sie die Installation auf Oracle 7.x ausführen, führen Sie den folgenden Befehl aus: 
    sudo yum-config-manager --enable ol7_optional_latest
  7. Wenn Sie die Installation auf AWS durchfü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
  8. Laden Sie die Datei bootstrap_4.19.01.sh von Edge 4.19.01 in /tmp/bootstrap_4.19.01.sh herunter: 
    curl https://software.apigee.com/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh
  9. Installieren Sie das apigee-service-Dienstprogramm von Edge 4.19.01 und die Abhängigkeiten: 
    sudo bash /tmp/bootstrap_4.19.01.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, ihn einzugeben.

    Das Installationsprogramm prüft standardmäßig, ob Java 1.8 installiert ist. Andernfalls wird die App automatisch installiert. Geben Sie mit der Option JAVA_FIX an, wie die Java-Installation zu behandeln ist. JAVA_FIX verwendet die folgenden Werte:

    • I = OpenJDK 1.8 installieren (Standard)
    • C = Ohne Installation von Java fortfahren
    • F = Beenden. Dazu müssen Sie Java selbst installieren.
  10. Verwenden Sie apigee-service, um das Dienstprogramm apigee-setup zu aktualisieren: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  11. Aktualisieren Sie das Dienstprogramm apigee-validate auf dem Verwaltungsserver: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  12. Aktualisieren Sie das Dienstprogramm apigee-provision: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  13. Führen Sie das Update-Dienstprogramm auf Ihren Knoten in der unter Reihenfolge des Maschinenupdates beschriebenen Reihenfolge aus: 
    /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

    Die einzige Anforderung an die Konfigurationsdatei besteht darin, dass die Konfigurationsdatei für den „apigee“-Benutzer zugänglich oder lesbar sein muss.

    Verwenden Sie die Option -c, um die zu aktualisierende Komponente anzugeben. Die Liste der möglichen Komponenten umfasst:

    • "cs" = Cassandra
    • "edge" =Alle Edge-Komponenten außer Edge-Benutzeroberfläche. Die Edge-Komponente umfasst Management Server, Message Processor, Router, QPID-Server und Edge Postgres Server.
    • "ldap" = OpenLDAP
    • "ps" = postgresql
    • "qpid" = qpidd
    • "sso" = Edge-SSO
    • "ui" = Edge-Benutzeroberfläche
    • "zk" = Zookeeper

    Sie können update.sh für alle Komponenten ausführen, indem Sie component auf „all“ setzen. Dies gilt jedoch nur, wenn Sie ein All-in-one-Konfigurationsprofil (All-in-one) für Edge haben. Beispiel:

    /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
  14. Starten Sie die Edge-UI-Komponente auf allen Computern neu, auf denen sie ausgeführt wird, falls Sie dies noch nicht getan haben: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
  15. Testen Sie das Update, indem Sie das Dienstprogramm apigee-validate auf dem Verwaltungsserver ausführen, wie unter Installation testen beschrieben.
  16. Wenn Sie einen neuen Postgres-Standby-Knoten installiert haben, außer Betrieb nehmen, wie unter Postgres-Knoten außer Betrieb nehmen beschrieben.

    Wenn Sie Netzwerkspeicher verwenden, müssen Sie den neuen Knoten nicht installieren. Weitere Informationen finden Sie unter Erforderliches Upgrade auf Postgres 9.6.

Wenn Sie später ein Rollback für die Aktualisierung durchführen möchten, gehen Sie wie unter Rollback 4.19.01 beschrieben vor.

Aktualisierung auf 4.19.01 von einem lokalen Repository

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 die Aktualisierung über ein lokales Repository oder einen Spiegel des Apigee-Repositorys durchführen.

Nachdem Sie ein lokales Edge-Repository erstellt haben, haben Sie zwei Möglichkeiten, Edge über das lokale Repository zu aktualisieren:

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

So führen Sie ein Update von einem lokalen 4.19.01-Repository aus:

  1. Wenn Sie derzeit die Master-Standby-Replikation von Postgres verwenden, installieren Sie einen neuen Postgres-Standby-Knoten wie unter Neuen Postgres-Standby-Knoten installieren beschrieben.

    Wenn Sie Netzwerkspeicher verwenden, müssen Sie den neuen Knoten nicht installieren. Erstellen Sie stattdessen einen Netzwerk-Snapshot des von Postgres verwendeten Datenspeichers. Weitere Informationen finden Sie unter Erforderliches Upgrade auf Postgres 9.6.

  2. Erstellen Sie ein lokales 4.19.01-Repository, wie in „Lokales Apigee-Repository erstellen“ unter Dienstprogramm für Edge-Apigee-Setup installieren beschrieben.
  3. So installieren Sie den Apigee-Dienst aus einer TAR-Datei:
    1. Verwenden Sie auf dem Knoten mit dem lokalen Repository den folgenden Befehl, um das lokale Repository in eine einzelne TAR-Datei namens /opt/apigee/data/apigee-mirror/apigee-4.19.01.tar.gz zu verpacken: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
    2. Kopieren Sie die TAR-Datei auf den Knoten, in dem Sie Edge aktualisieren möchten. Kopieren Sie ihn beispielsweise in das Verzeichnis /tmp auf dem neuen Knoten.
    3. Entpacken Sie die Datei auf dem neuen Knoten in das /tmp-Verzeichnis: 
      tar -xzf apigee-4.19.01tar.gz

      Mit diesem Befehl wird in dem Verzeichnis, das die TAR-Datei enthält, ein neues Verzeichnis namens repos erstellt. Beispiel: /tmp/repos.

    4. Installieren Sie das Dienstprogramm für den Edge-Apigee-Dienst und die Abhängigkeiten aus /tmp/repos: 
      sudo bash /tmp/repos/bootstrap_4.19.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

      Beachten Sie, dass Sie den Pfad zum Repository-Verzeichnis in diesen Befehl aufnehmen.

  4. So installieren Sie den Apigee-Dienst mit dem Nginx-Webserver:
    1. Konfigurieren Sie den Nginx-Webserver wie im Abschnitt „Mit dem Nginx-Webserver vom Repository installieren“ unter Edge-Dienstprogramm apigee-setup installieren beschrieben.
    2. Laden Sie auf dem Remote-Knoten die Edge-bootstrap_4.19.01.sh-Datei in /tmp/bootstrap_4.19.01.sh herunter: 
      /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.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-Dienstprogramm apigee-service und die Abhängigkeiten: 
      sudo bash /tmp/bootstrap_4.19.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

      Dabei sind uName:pWord der Nutzername und das Passwort des Repositorys.

  5. Verwenden Sie apigee-service, um das Dienstprogramm apigee-setup zu aktualisieren: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  6. Aktualisieren Sie das Dienstprogramm apigee-validate auf dem Verwaltungsserver: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  7. Aktualisieren Sie das Dienstprogramm apigee-provision: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  8. Führen Sie das Dienstprogramm update auf Ihren Knoten in der unter Reihenfolge des Maschinenupdates beschriebenen Reihenfolge aus: 
    /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

    Die einzige Anforderung an die Konfigurationsdatei besteht darin, dass die Konfigurationsdatei für den „apigee“-Benutzer zugänglich oder lesbar sein muss.

    Verwenden Sie die Option -c, um die zu aktualisierende Komponente anzugeben. Die Liste der möglichen Komponenten umfasst:

    • "cs" = Cassandra
    • "edge" =Alle Edge-Komponenten außer Edge-Benutzeroberfläche. Die Edge-Komponente umfasst Management Server, Message Processor, Router, QPID-Server und Edge Postgres Server.
    • "ldap" = OpenLDAP
    • "ps" = postgresql
    • "qpid" = qpidd
    • "sso" = Edge-SSO
    • "ui" = Edge-Benutzeroberfläche
    • "zk" = Zookeeper

    Sie können update.sh für alle Komponenten ausführen, indem Sie component auf „all“ setzen. Dies gilt jedoch nur, wenn Sie ein All-in-one-Konfigurationsprofil (All-in-one) für Edge haben. Beispiel:

    /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
  9. Starten Sie die Edge-UI-Komponente auf allen Computern neu, auf denen sie ausgeführt wird, falls Sie dies noch nicht getan haben: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
  10. Testen Sie das Update, indem Sie das Dienstprogramm apigee-validate auf dem Verwaltungsserver ausführen, wie unter Installation testen beschrieben.
  11. Wenn Sie einen neuen Postgres-Standby-Knoten installiert haben, außer Betrieb nehmen, wie unter Postgres-Knoten außer Betrieb nehmen beschrieben.

    Wenn Sie Netzwerkspeicher verwenden, müssen Sie den neuen Knoten nicht installieren. Weitere Informationen finden Sie unter Erforderliches Upgrade auf Postgres 9.6.

Wenn Sie später ein Rollback für das Update durchführen möchten, gehen Sie wie unter Rollback 4.19.01 beschrieben vor.

Reihenfolge des Maschinenupdates

Die Reihenfolge, in der Sie die Maschinen in einer Edge-Konfiguration aktualisieren, ist wichtig. Die wichtigsten Überlegungen bei einem Update sind:

  • Sie müssen alle Cassandra- und ZooKeeper-Knoten aktualisieren, bevor Sie andere Knoten aktualisieren.
  • Verwenden Sie für alle Maschinen mit mehreren Edge-Komponenten (Management Server, Message Processor, Router, QPID-Server, aber nicht Postgres-Server) die Option „-c Edge“, um alle gleichzeitig zu aktualisieren.
  • Wenn für einen Schritt festgelegt ist, dass er auf mehreren Computern ausgeführt werden soll, führen Sie ihn in der angegebenen Maschinenreihenfolge aus.
  • Für die Monetarisierung ist kein separater Schritt erforderlich. Sie wird aktualisiert, wenn Sie die Option „-c Edge“ angeben.

Eigenständiges Upgrade mit 1 Knoten

  1. Aktualisieren Sie Cassandra und ZooKeeper: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Qpid aktualisieren: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  3. LDAP aktualisieren: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  4. Stoppen Sie Postgres Server, Qpid-Server und PostgreSQL: 
    /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
  5. Aktualisieren Sie postgresql: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  6. Aktualisieren Sie die verbleibenden Edge-Komponenten: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. Aktualisieren Sie die Edge-Benutzeroberfläche: 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  8. (Wenn Sie apigee-adminapi installiert haben) Aktualisierung des Dienstprogramms apigee-adminapi: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  9. (Wenn Sie Edge-SSO installiert haben) Aktualisieren Sie Edge-SSO: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    Dabei ist sso_config_file die Konfigurationsdatei, die Sie bei der Installation von SSO erstellt haben.

  10. Starten Sie die Edge-UI-Komponente neu: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

Eigenständiges Upgrade mit 2 Knoten

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

  1. Cassandra und ZooKeeper auf Maschine 1 aktualisieren: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Aktualisieren Sie Qpid auf Gerät 2: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  3. LDAP auf Gerät 1 aktualisieren: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  4. Aktualisieren Sie Edge-Komponenten auf Maschine 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  5. UI auf Gerät 1 aktualisieren: 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  6. (Wenn Sie apigee-adminapi installiert haben) Aktualisierung des Dienstprogramms apigee-adminapi auf Computer 1: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  7. (Wenn Sie Edge-SSO installiert haben) Aktualisieren Sie Edge-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 bei der Installation von SSO erstellt haben.

  8. Aktualisieren Sie postgresql auf Computer 2:
    1. Beenden Sie Postgres Server, Qpid-Server und postgresql:
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    2. Aktualisieren Sie postgresql: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    3. Aktualisieren Sie Edge-Komponenten auf Gerät 2: 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  9. Starten Sie die Edge-UI-Komponente auf Computer 1 neu: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

Upgrade mit 5 Knoten

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

  1. Prüfen Sie, ob Sie einen neuen Postgres-Standby-Knoten installiert haben, wie unter Neuen Postgres-Standby-Knoten installieren beschrieben.

    Wenn Sie Netzwerkspeicher verwenden, müssen Sie den neuen Knoten nicht installieren. Erstellen Sie stattdessen einen Netzwerk-Snapshot des von Postgres verwendeten Datenspeichers. Weitere Informationen finden Sie unter Erforderliches Upgrade auf Postgres 9.6.

  2. Aktualisieren Sie Cassandra und ZooKeeper auf Maschinen 1, 2 und 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Aktualisieren Sie Qpid auf Maschinen 4 und 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  4. LDAP auf Gerät 1 aktualisieren: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Aktualisieren Sie Edge-Komponenten auf Maschinen 1, 2, 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. UI auf Gerät 1 aktualisieren: 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  7. (Wenn Sie apigee-adminapi installiert haben) Aktualisierung des Dienstprogramms apigee-adminapi auf Computer 1: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  8. (Wenn Sie Edge-SSO installiert haben) Aktualisieren Sie Edge-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 bei der Installation von SSO erstellt haben.

  9. Aktualisieren Sie die Maschinen 4 und 5:
    1. Beenden Sie den Postgres-Server und den Qpid-Server auf Computer 4:
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    2. Beenden Sie den Postgres-Server, den Qpid-Server und postgresql auf Computer 5: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. Beenden Sie falls installiert den Postgres-Server und postgresql auf dem neuen Stand-by-Knoten, den Sie für das Rollback hinzugefügt haben: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    4. Aktualisieren Sie postgresql auf Maschinen 4: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    5. Aktualisieren Sie postgresql auf Maschinen 5: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. Starten Sie den Postgres-Server und den Qpid-Server auf den Maschinen 4 und 5: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    7. Konfigurieren Sie Postgres als Stand-by-Knoten. Führen Sie dazu die folgenden Befehle auf Computer 5 aus: 
      cd /opt/apigee/data/apigee-postgresql/pgdata
rm -rf *
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
    8. Überprüfen Sie den Replikationsstatus, indem Sie die folgenden Skripts auf beiden Servern ausführen. Das System sollte auf beiden Servern identische Ergebnisse anzeigen, um eine erfolgreiche Replikation zu gewährleisten:
      • Führen Sie auf der Maschine 4, dem Masterknoten, den folgenden Befehl aus: 
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

        Prüfen Sie, ob es sich um den Master handelt.

      • Auf Maschine 5 für den Standby-Knoten: 
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

        Prüfen Sie, ob es sich um den Standby-Modus handelt.

  10. Aktualisieren Sie Edge-Komponenten auf Maschinen 4, 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  11. Stellen Sie sicher, dass Sie den neuen Stand-by-Knoten wie unter Postgres-Knoten außer Betrieb nehmen beschrieben außer Betrieb nehmen.

    Wenn Sie Netzwerkspeicher verwenden, müssen Sie den neuen Knoten nicht installieren. Weitere Informationen finden Sie unter Erforderliches Upgrade auf Postgres 9.6.

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

Geclustertes Upgrade mit 9 Knoten

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

  1. Prüfen Sie, ob Sie einen neuen Postgres-Standby-Knoten installiert haben, wie unter Neuen Postgres-Standby-Knoten installieren beschrieben.

    Wenn Sie Netzwerkspeicher verwenden, müssen Sie den neuen Knoten nicht installieren. Erstellen Sie stattdessen einen Netzwerk-Snapshot des von Postgres verwendeten Datenspeichers. Weitere Informationen finden Sie unter Erforderliches Upgrade auf Postgres 9.6.

  2. Aktualisieren Sie Cassandra und ZooKeeper auf Maschinen 1, 2 und 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Aktualisieren Sie Qpid auf Maschinen 6 und 7: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  4. LDAP auf Gerät 1 aktualisieren: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Aktualisieren Sie die Edge-Komponenten auf den Maschinen 6, 7, 1, 4 und 5 in dieser Reihenfolge: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. UI auf Gerät 1 aktualisieren: 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  7. (Wenn Sie apigee-adminapi installiert haben) Aktualisierung des Dienstprogramms apigee-adminapi auf Computer 1: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  8. (Wenn Sie Edge-SSO installiert haben) Aktualisieren Sie Edge-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 bei der Installation von SSO erstellt haben.

  9. Aktualisieren Sie die Maschinen 8 und 9:
    1. Beenden Sie den Postgres-Server auf Computer 8: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. Beenden Sie den Postgres-Server und postgresql auf Computer 9: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. Beenden Sie den Qpid-Server auf den Maschinen 6 und 7: 
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    4. Beenden Sie falls installiert den Postgres-Server und postgresql auf dem neuen Stand-by-Knoten, den Sie für das Rollback hinzugefügt haben: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    5. Aktualisieren Sie postgresql auf Maschinen 8: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. Aktualisieren Sie postgresql auf Maschinen 9: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    7. Starten Sie den Postgres-Server auf den Maschinen 8 und 9: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
    8. Starten Sie den Qpid-Serverserver auf den Maschinen 6 und 7: 
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    9. Konfigurieren Sie Postgres als Standby-Knoten. Führen Sie dazu die folgenden Befehle auf Computer 9 aus: 
      cd /opt/apigee/data/apigee-postgresql/pgdata
rm -rf *
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
    10. Überprüfen Sie den Replikationsstatus, indem Sie die folgenden Skripts auf beiden Servern ausführen. Das System sollte auf beiden Servern identische Ergebnisse anzeigen, um eine erfolgreiche Replikation zu gewährleisten:
      • Führen Sie auf der Maschine 8, dem Masterknoten, den folgenden Befehl aus: 
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

        Prüfen Sie, ob es sich um den Master handelt.

      • Auf Maschine 9 für den Standby-Knoten: 
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

        Prüfen Sie, ob es sich um den Standby-Modus handelt.

  10. Aktualisieren Sie Edge-Komponenten auf Maschinen 8 und 9: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  11. Achten Sie darauf, den neuen Stand-by-Knoten wie unter Postgres-Knoten außer Betrieb nehmen beschrieben außer Betrieb zu nehmen.

    Wenn Sie Netzwerkspeicher verwenden, müssen Sie den neuen Knoten nicht installieren. Weitere Informationen finden Sie unter Erforderliches Upgrade auf Postgres 9.6.

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

Geclustertes Upgrade mit 13 Knoten

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

  1. Prüfen Sie, ob Sie einen neuen Postgres-Standby-Knoten installiert haben, wie unter Neuen Postgres-Standby-Knoten installieren beschrieben.

    Wenn Sie Netzwerkspeicher verwenden, müssen Sie den neuen Knoten nicht installieren. Erstellen Sie stattdessen einen Netzwerk-Snapshot des von Postgres verwendeten Datenspeichers. Weitere Informationen finden Sie unter Erforderliches Upgrade auf Postgres 9.6.

  2. Aktualisieren Sie Cassandra und ZooKeeper auf Maschinen 1, 2 und 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Aktualisieren Sie Qpid auf Maschinen 12 und 13: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  4. Aktualisieren Sie LDAP auf Computer 4 und 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Aktualisieren Sie die Edge-Komponenten auf den Maschinen 12, 13, 6, 7, 10 und 11 in dieser Reihenfolge: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. Aktualisieren Sie die UI auf Maschinen 6 und 7: 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  7. (Wenn Sie apigee-adminapi installiert haben) Aktualisierung des Dienstprogramms apigee-adminapi auf Maschinen 6 und 7: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  8. (Wenn Sie Edge-SSO installiert haben) Aktualisieren Sie Edge-SSO auf Computer 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 bei der Installation von SSO erstellt haben.

  9. Aktualisieren Sie die Maschinen 8 und 9:
    1. Beenden Sie den Postgres-Server auf Computer 8: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. Beenden Sie den Postgres-Server und postgresql auf Computer 9: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. Beenden Sie den Qpid-Server auf den Maschinen 12 und 13: 
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    4. Beenden Sie falls installiert den Postgres-Server und postgresql auf dem neuen Stand-by-Knoten, den Sie für das Rollback hinzugefügt haben: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    5. Aktualisieren Sie postgresql auf Maschinen 8: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. Aktualisieren Sie postgresql auf Maschinen 9: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    7. Starten Sie den Postgres-Server auf den Maschinen 8 und 9: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
    8. Starten Sie den Qpid-Serverserver auf den Maschinen 12 und 13: 
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    9. Konfigurieren Sie Postgres als Standby-Knoten. Führen Sie dazu die folgenden Befehle auf Computer 9 aus: 
      cd /opt/apigee/data/apigee-postgresql/pgdata
rm -rf *
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
    10. Überprüfen Sie den Replikationsstatus, indem Sie die folgenden Skripts auf beiden Servern ausführen. Das System sollte auf beiden Servern identische Ergebnisse anzeigen, um eine erfolgreiche Replikation zu gewährleisten:
      • Führen Sie auf der Maschine 8, dem Masterknoten, den folgenden Befehl aus: 
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

        Prüfen Sie, ob es sich um den Master handelt.

      • Auf Maschine 9 für den Standby-Knoten: 
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

        Prüfen Sie, ob es sich um den Standby-Modus handelt.

  10. Aktualisieren Sie Edge-Komponenten auf Maschinen 8 und 9: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  11. Achten Sie darauf, den neuen Stand-by-Knoten wie unter Postgres-Knoten außer Betrieb nehmen beschrieben außer Betrieb zu nehmen.

    Wenn Sie Netzwerkspeicher verwenden, müssen Sie den neuen Knoten nicht installieren. Weitere Informationen finden Sie unter Erforderliches Upgrade auf Postgres 9.6.

  12. Starten Sie die Edge-UI-Komponente auf den Maschinen 6 und 7 neu: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

Geclustertes Upgrade mit 12 Knoten

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

  1. Prüfen Sie, ob Sie einen neuen Postgres-Standby-Knoten installiert haben, wie unter Neuen Postgres-Standby-Knoten installieren beschrieben.

    Wenn Sie Netzwerkspeicher verwenden, müssen Sie den neuen Knoten nicht installieren. Erstellen Sie stattdessen einen Netzwerk-Snapshot des von Postgres verwendeten Datenspeichers. Weitere Informationen finden Sie unter Erforderliches Upgrade auf Postgres 9.6.

  2. Aktualisieren Sie Cassandra und ZooKeeper:
    1. Auf Maschinen 1, 2 und 3 im Rechenzentrum 1: 
      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
    2. Auf den Maschinen 7, 8 und 9 im Rechenzentrum 2 
      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Aktualisieren Sie qpidd:
    1. Maschinen 4, 5 im Rechenzentrum 1
      1. Aktualisieren Sie qpidd auf Gerät 4: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. Wiederholen Sie Schritt 1 auf Gerät 5.
    2. Maschinen 10, 11 im Rechenzentrum 2
      1. Aktualisieren Sie qpidd auf Computer 10: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. Wiederholen Sie Schritt 1 auf Gerät 11.
  4. LDAP aktualisieren:
    1. Maschinen 1 im Rechenzentrum 1 
      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
    2. Maschinen 7 im Rechenzentrum 2 
      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Aktualisieren Sie Edge-Komponenten:
    1. Maschinen 4, 5, 1, 2, 3 im Rechenzentrum 1 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
    2. Maschinen 10, 11, 7, 8, 9 im Rechenzentrum 2 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. UI aktualisieren:
    1. Maschine 1 im Rechenzentrum 1: 
      /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
    2. Maschine 7 im Rechenzentrum 2: 
      /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  7. (Wenn Sie apigee-adminapi installiert haben) Aktualisierung des Dienstprogramms apigee-adminapi:
    1. Maschine 1 im Rechenzentrum 1: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
    2. Maschine 7 im Rechenzentrum 2: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  8. (Wenn Sie Edge-SSO installiert haben) Aktualisieren Sie Edge-SSO:
    1. Maschine 1 im Rechenzentrum 1: 
      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
    2. Maschine 7 im 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 bei der Installation von SSO erstellt haben.

  9. Maschine 6 in Rechenzentrum 1 und 12 im Rechenzentrum 2 aktualisieren:
    1. Beenden Sie den Postgres-Server auf Computer 6: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. Beenden Sie den Postgres-Server und postgresql auf Computer 12: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. Beenden Sie den Qpid-Server auf den Maschinen 4, 5, 10 und 11: 
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    4. Beenden Sie falls installiert den Postgres-Server und postgresql auf dem neuen Stand-by-Knoten, den Sie für das Rollback hinzugefügt haben: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    5. Aktualisieren Sie postgresql auf Maschinen 6: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. Aktualisieren Sie postgresql auf Maschinen 12: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    7. Starten Sie den Postgres-Serverserver auf den Maschinen 6 und 12: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
    8. Starten Sie den Qpid-Serverserver auf den Maschinen 4, 5, 10 und 11: 
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    9. Konfigurieren Sie Postgres als Stand-by-Knoten. Führen Sie dazu die folgenden Befehle auf Computer 12 aus: 
      cd /opt/apigee/data/apigee-postgresql/pgdata
rm -rf *
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
    10. Überprüfen Sie den Replikationsstatus, indem Sie die folgenden Skripts auf beiden Servern ausführen. Das System sollte auf beiden Servern identische Ergebnisse anzeigen, um eine erfolgreiche Replikation zu gewährleisten:

      Führen Sie auf der Maschine 6, dem Masterknoten, folgenden Befehl aus:

      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

      Prüfen Sie, ob es sich um den Master handelt.

      Auf Maschine 12 führt der Stand-by-Knoten folgende Schritte aus:

      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      Prüfen Sie, ob es sich um den Standby-Modus handelt.

  10. Aktualisieren Sie Edge-Komponenten auf Maschinen 6 und 12: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  11. Achten Sie darauf, den neuen Stand-by-Knoten wie unter Postgres-Knoten außer Betrieb nehmen beschrieben außer Betrieb zu nehmen.

    Wenn Sie Netzwerkspeicher verwenden, müssen Sie den neuen Knoten nicht installieren. Weitere Informationen finden Sie unter Erforderliches Upgrade auf Postgres 9.6.

  12. Starten Sie die Edge-UI-Komponente auf den Maschinen 1 und 7 neu: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

Für ein nicht standardmäßiges Upgrade

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" auf allen Knoten in der Reihenfolge: Knoten mit Qpid-Server, Edge Postgres Server, Management Server, Message Processor und Router.
  6. Edge-Benutzeroberfläche
  7. apigee-adminapi
  8. Edge-SSO

Nachdem Sie das Update abgeschlossen haben, müssen Sie die Edge-UI-Komponente auf allen Maschinen neu starten, auf denen sie ausgeführt wird.