Apigee Edge 4.17.05 oder 4.17.09 auf 4.18.05 aktualisieren

Edge for Private Cloud v4.18.05

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

  • Von 4.17.05 bis 4.18.05
  • Von 4.17.09 bis 4.18.05

Wer kann das Update durchführen?

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

Nachdem Sie die Edge-RPMs installiert haben, 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.

Für Kompatibilität sorgen

Wenn Sie Apigee Edge for Private Cloud auf 4.18.05 aktualisieren, müssen Sie darauf achten, dass die resultierende Implementierung nur auf unterstützte Attribute in den Konfigurationsdateien verweist.

Attribut Standort Beschreibung
conf_load_balancing_load.balancing.
  driver.nginx.server.retry		 router.properties Entfernen Sie dieses Attribut aus der router.properties-Datei. Verwenden Sie die Konfigurationsattribute für virtuelle Hosts, um Wiederholungsoptionen in 4.18.05 festzulegen.

Automatische Weitergabe von Property-Einstellungen

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

Erforderliche Hinzufügung des Konfigurationsparameters SMTPMAILFROM

In Edge 4.17.05 wurde der Konfigurationsdatei, die beim Aktivieren eines SMTP-Servers verwendet wird, ein neuer erforderlicher Parameter hinzugefügt.

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 des Aktualisierungsvorgangs, wenn die Postgres-Knoten für die Aktualisierung inaktiv sind, werden Analysedaten weiterhin auf die Qpid-Knoten geschrieben. Nachdem die Postgres-Knoten aktualisiert wurden und wieder online sind, werden Analysedaten an die Postgres-Knoten übertragen.

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

  • Wenn Sie einen 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 das Update aus irgendeinem Grund zurücksetzen müssen. Wenn Sie das Update rückgängig machen müssen, wird der neue Postgres-Standby-Knoten nach dem Rollback zum Master-Postgres-Knoten. Wenn Sie den neuen Postgres-Standby-Knoten installieren, sollte er sich daher auf einem Knoten befinden, der alle Hardwareanforderungen eines Postgres-Servers erfüllt, wie in den Installationsanforderungen für Edge definiert.

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

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

    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 ausfü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. Achten Sie darauf, dass Sie einen neuen Postgres-Standby-Server für Ihre vorhandene Version von Edge (4.17.05 oder 4.17.09) installieren, nicht für Version 4.18.05.

Verwenden Sie für die Installation dieselbe Konfigurationsdatei, die Sie für die Installation Ihrer aktuellen Edge-Version verwendet 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 diese Datei nicht vorhanden ist, erstellen Sie sie: 
    conf_pg_hba_replication.connection=host replication apigee existing_slave_ip/32 trust\ \nhost replication apigee new_slave_ip/32 trust

    Dabei ist existing_slave_ip die IP-Adresse des aktuellen Postgres-Standby-Servers und new_slave_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. Rufen Sie dazu die Datei /opt/apigee/apigee-postgresql/conf/pg_hba.conf auf dem Master auf. In dieser Datei sollten die folgenden Zeilen enthalten sein: 
    host replication apigee existing_slave_ip/32 trust
host replication apigee new_slave_ip/32 trust
  4. Installieren Sie den neuen Postgres-Standby-Server:
    1. Bearbeiten Sie die Konfigurationsdatei, die Sie zur Installation Ihrer aktuellen Edge-Version verwendet 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 Edge-Dienstprogramm „apigee-setup“ installieren beschrieben.
    3. Laden Sie die Edge-Datei bootstrap_4.17.0x.sh herunter, wobei x entweder 5 (für 4.17.05) oder 9 (für 4.17.09) ist, und speichern Sie sie in /tmp/bootstrap_4.17.0x.sh : 
      curl https://software.apigee.com/bootstrap_4.17.0x.sh -o /tmp/bootstrap_4.17.0x.sh
    4. Installieren Sie das Edge-apigee-service-Dienstprogramm und die Abhängigkeiten: 
      sudo bash /tmp/bootstrap_4.17.0x.sh apigeeuser=uName apigeepassword=pWord
    5. Verwenden Sie apigee-service, um das Dienstprogramm apigee-setup zu installieren: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    6. Installieren Sie Postgres: 
      /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 der Status „Standby“ lautet.

Postgres-Knoten außer Betrieb nehmen

Nehmen Sie nach Abschluss des Updates den neuen Standby-Knoten außer Betrieb:

  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 Stand-by-Knotens ab, indem Sie den folgenden cURL-Befehl auf dem neuen Stand-by-Knoten ausführen: 
    curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self

    Am Ende der Ausgabe sollte die UUID des Knotens in folgendem Format angezeigt werden: 

    "type" : [ "postgres-server" ],
"uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
  3. Beenden Sie den neuen Standby-Knoten, indem Sie den folgenden Befehl auf dem neuen Standby-Knoten ausführen: 
    /opt/apigee/apigee-service/bin/apigee-all stop
  4. Bearbeiten Sie auf dem Postgres-Masterknoten /opt/apigee/customer/application/postgresql.properties, um den neuen Standby-Knoten aus conf_pg_hba_replication.connection zu entfernen: 
    conf_pg_hba_replication.connection=host replication apigee existing_slave_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. Rufen Sie dazu die Datei /opt/apigee/apigee-postgresql/conf/pg_hba.conf auf dem Master auf. In dieser Datei sollte nur die folgende Zeile angezeigt werden: 
    host replication apigee existing_slave_ip/32 trust
  7. Löschen Sie die UUID des Stand-by-Knotens aus ZooKeeper. Führen Sie dazu den folgenden Edge Management API-Aufruf auf dem Management Server-Knoten aus: 
    curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/new_slave_uuid

Voraussetzungen aktualisieren

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

  • Alle Knoten sichern
    Vor dem Update wird aus Sicherheitsgründen empfohlen, eine vollständige Sicherung aller Knoten durchzuführen. Führen Sie die Sicherung gemäß dem Verfahren für Ihre aktuelle Edge-Version durch.

    So haben Sie einen Notfallplan, falls das Update auf eine neue Version nicht ordnungsgemäß funktioniert. Weitere Informationen zur Sicherung finden Sie unter Sichern und Wiederherstellen.

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

Umgang mit einem fehlgeschlagenen Update

Wenn die Aktualisierung 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. Es wird dann an der Stelle fortgesetzt, an der es zuletzt unterbrochen wurde.

Wenn Sie aufgrund des Fehlers ein Rollback des Updates auf die vorherige Version durchführen müssen, finden Sie weitere Informationen unter Rollback von 4.18.05 durchführen.

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 Dienstprogramm update.sh fehl.

Update ohne Ausfallzeiten

Mit einem Update ohne Ausfallzeiten oder einem Rolling Update können Sie Ihre Edge-Installation aktualisieren, ohne Edge herunterzufahren.

Ein Update ohne Ausfallzeiten ist nur mit einer Konfiguration mit mindestens 5 Knoten möglich.

Der Schlüssel zu einem 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 den Router und fügen den Router dann wieder dem Load Balancer hinzu.

  1. Aktualisieren Sie die Maschinen in der richtigen Reihenfolge für Ihre Installation, wie unter Reihenfolge der Maschinenaktualisierung beschrieben.
  2. Wenn die Router aktualisiert werden müssen, wählen Sie einen beliebigen Router aus und machen Sie ihn unerreichbar, wie unter Erreichbarkeit von Servern (Message Processor/Router) aktivieren/deaktivieren beschrieben.
  3. Aktualisieren Sie den ausgewählten Router und alle anderen Edge-Komponenten auf demselben Computer wie der Router. In allen Edge-Konfigurationen werden ein Router und ein Message Processor auf demselben Knoten angezeigt.
  4. Stelle die Erreichbarkeit des Routers wieder her.
  5. Wiederhole die Schritte 2 bis 4 für die verbleibenden Router.
  6. Fahren Sie mit dem Update für alle verbleibenden Maschinen in Ihrer Installation fort.

Beachten Sie vor und nach dem Update Folgendes:

  • Auf dem kombinierten Router- und Message Processor-Knoten:
    • Vor dem Update:
      1. Machen Sie den Router unerreichbar.
      2. Machen Sie den Message Processor unerreichbar.
    • Führen Sie nach dem Update die folgenden Schritte aus:
      1. Machen Sie den Message Processor erreichbar.
      2. Machen Sie den Router erreichbar.
  • Auf einem einzelnen Routerknoten:
    • Machen Sie den Router vor dem Update unerreichbar.
    • Nach dem Update muss der Router erreichbar sein.
  • Auf einem einzelnen Message Processor-Knoten:
    • Machen Sie den Message Processor vor dem Update nicht erreichbar.
    • Machen Sie den Message Processor nach dem Update erreichbar.

Konfigurationsdatei für die automatische Installation verwenden

Sie müssen eine Konfigurationsdatei für die unbeaufsichtigte Installation an den Aktualisierungsbefehl übergeben. Die Konfigurationsdatei für die unbeaufsichtigte Installation sollte dieselbe sein, die Sie für die Installation von Edge 4.17.0x verwendet haben.

Auf einem Knoten mit einer externen Internetverbindung auf 4.18.05 aktualisieren

Gehen Sie so vor, um die Edge-Komponenten auf einem Knoten zu aktualisieren:

  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 alle CRON-Jobs, die für die Ausführung eines Reparaturvorgangs für Cassandra konfiguriert sind, bis das Update abgeschlossen ist.
  3. Melden Sie sich als Root-Nutzer auf Ihrem Knoten 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 Edge-Dienstprogramm „apigee-setup“ installieren beschrieben.
  6. Wenn Sie die Installation auf Oracle 7.x durchführen, führen Sie den folgenden Befehl aus: 
    sudo yum-config-manager --enable ol7_optional_latest
  7. Wenn Sie auf AWS installieren, 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 Edge 4.18.05-Datei bootstrap_4.18.05.sh in /tmp/bootstrap_4.18.05.sh herunter: 
    curl https://software.apigee.com/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.sh
  9. Installieren Sie das Edge 4.18.05-Dienstprogramm apigee-service und die Abhängigkeiten: 
    sudo bash /tmp/bootstrap_4.18.05.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, es einzugeben.

    Das Installationsprogramm prüft standardmäßig, ob Java 1.8 installiert ist. Andernfalls wird es für Sie installiert. Verwenden Sie die Option JAVA_FIX, um anzugeben, wie die Java-Installation gehandhabt werden soll. JAVA_FIX kann folgende Werte haben:

    • I = OpenJDK 1.8 installieren (Standard)
    • C = Ohne Installation von Java fortfahren
    • Q = Beenden. Bei dieser Option 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 der Maschinenaktualisierung beschriebenen Reihenfolge aus: 
    /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

    Die einzige Anforderung an die Konfigurationsdatei ist, dass sie für den Nutzer „apigee“ 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
    • „e“ = ElasticSearch
    • „edge“ = Alle Edge-Komponenten außer Edge-UI. 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-UI
    • "zk" = Zookeeper

    Sie können update.sh für alle Komponenten ausführen, indem Sie component auf „all“ setzen, aber nur, wenn Sie ein Edge-All-in-One-Installationsprofil (aio) 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 Management Server ausführen, wie unter Installation testen beschrieben.
  16. Wenn Sie einen neuen Postgres-Standby-Knoten installiert haben, nehmen Sie den Knoten außer Betrieb, 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 das Update später rückgängig machen möchten, verwenden Sie das unter Rollback von 4.18.05 beschriebene Verfahren.

Update auf 4.18.05 aus 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 das Update über ein lokales Repository oder einen Spiegel des Apigee-Repositorys ausfü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 aus der 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, den Sie verwenden können. Sie können aber auch Ihren eigenen Webserver verwenden.

So aktualisieren Sie von einem lokalen 4.18.05-Repository:

  1. Wenn Sie derzeit die Postgres-Master-Standby-Replikation 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.18.05-Repository, wie unter Edge-Dienstprogramm „apigee-setup“ installieren im Abschnitt „Lokales Apigee-Repository erstellen“ beschrieben.
  3. So installieren Sie apigee-service aus einer TAR-Datei:
    1. Verwenden Sie auf dem Knoten mit dem lokalen Repository den folgenden Befehl, um das lokale Repository in einer einzelnen TAR-Datei mit dem Namen /opt/apigee/data/apigee-mirror/apigee-4.18.05.tar.gz zu verpacken: 
      /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 in das Verzeichnis „/tmp“: 
      tar -xzf apigee-4.18.05tar.gz

      Mit diesem Befehl wird im Verzeichnis, das die TAR-Datei enthält, ein neues Verzeichnis mit dem Namen „repos“ erstellt. Beispiel: /tmp/repos.

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

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

  4. So installieren Sie apigee-service mit dem Nginx-Webserver:
    1. Konfigurieren Sie den Nginx-Webserver wie unter Edge-apigee-setup-Dienstprogramm installieren im Abschnitt „Aus dem Repository mit dem Nginx-Webserver installieren“ beschrieben.
    2. Laden Sie auf dem Remote-Knoten die Edge-Datei bootstrap_4.18.05.sh in /tmp/bootstrap_4.18.05.sh herunter: 
      /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.sh

      Dabei sind uName:pWord der Nutzername und das Passwort, die Sie zuvor für das Repository festgelegt haben, und remoteRepo ist 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.18.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

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

  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 der Maschinenaktualisierung beschriebenen Reihenfolge aus: 
    /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

    Die einzige Anforderung an die Konfigurationsdatei ist, dass sie für den Nutzer „apigee“ 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
    • „e“ = ElasticSearch
    • „edge“ = Alle Edge-Komponenten außer Edge-UI. 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-UI
    • "zk" = Zookeeper

    Sie können update.sh für alle Komponenten ausführen, indem Sie component auf „all“ setzen, aber nur, wenn Sie ein Edge-All-in-One-Installationsprofil (aio) 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 Management Server ausführen, wie unter Installation testen beschrieben.
  11. Wenn Sie einen neuen Postgres-Standby-Knoten installiert haben, nehmen Sie den Knoten außer Betrieb, 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 das Update später rückgängig machen möchten, verwenden Sie das unter Rollback von 4.18.05 beschriebene Verfahren.

Reihenfolge der Maschinenaktualisierung

Die Reihenfolge, in der Sie die Maschinen in einer Edge-Installation aktualisieren, ist wichtig. Die wichtigsten Überlegungen für ein 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 ein Schritt auf mehreren Maschinen ausgeführt werden soll, führen Sie ihn in der angegebenen Reihenfolge aus.
  • Es gibt keinen separaten Schritt zum Aktualisieren der Monetarisierung. Sie wird aktualisiert, wenn Sie die Option „-c edge“ angeben.

Eigenständige Installation mit 1 Knoten

  1. Aktualisieren Sie Cassandra und ZooKeeper: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Aktualisieren Sie Qpid: 
    /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. Beenden Sie den Postgres-Server, den 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 Postgres-Datenbank: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
  7. Aktualisieren Sie die verbleibenden Edge-Komponenten: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  8. Edge-Benutzeroberfläche aktualisieren: 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  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ändige Installation mit 2 Knoten

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

  1. Aktualisieren Sie Cassandra und ZooKeeper auf Maschine 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Aktualisieren Sie Qpid auf Maschine 2: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  3. Aktualisieren Sie LDAP auf Maschine 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  4. Aktualisieren Sie die Edge-Komponenten auf Maschine 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  5. Aktualisieren Sie die Benutzeroberfläche auf Maschine 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  6. (Wenn Sie Edge SSO installiert haben) Aktualisieren Sie Edge SSO auf Maschine 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.

  7. Aktualisieren Sie PostgreSQL auf Maschine 2:
    1. Beenden Sie den Postgres-Server, den 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 die Postgres-Datenbank: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    4. Aktualisieren Sie die Edge-Komponenten auf Maschine 2: 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  8. Starten Sie die Edge-UI-Komponente auf Maschine 1 neu: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

Installation 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 den Computern 1, 2 und 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Aktualisieren Sie Qpid auf Maschine 4 und 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  4. Aktualisieren Sie LDAP auf Maschine 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Aktualisieren Sie die Edge-Komponenten auf Maschine 1, 2 und 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. Aktualisieren Sie die Benutzeroberfläche auf Maschine 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  7. (Wenn Sie Edge SSO installiert haben) Aktualisieren Sie Edge SSO auf Maschine 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 die Maschinen 4 und 5:
    1. Beenden Sie den Postgres-Server und den Qpid-Server auf Maschine 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 Maschine 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. Falls installiert, beenden Sie den Postgres-Server und postgresql auf dem neuen Standby-Knoten, den Sie für den 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. PostgreSQL auf Maschine 4 aktualisieren: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    5. Aktualisieren Sie die Postgres-Datenbank auf Maschine 4 (nur Postgres-Master): 
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    6. PostgreSQL auf Maschine 5 aktualisieren: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    7. 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
    8. Konfigurieren Sie Postgres als Standby-Knoten, indem Sie die folgenden Befehle auf Maschine 5 ausführen: 
      cd /opt/apigee/data/apigee-postgresql/pgdata
rm -rf *
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
    9. Prü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 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, dem Stand-by-Knoten: 
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

        Prüfen Sie, ob der Status „Standby“ lautet.

  9. Aktualisieren Sie die Edge-Komponenten auf den Computern 4 und 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  10. Achten Sie darauf, dass Sie den neuen Standby-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.

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

Clusterinstallation 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 den Computern 1, 2 und 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Aktualisieren Sie Qpid auf Maschine 6 und 7: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  4. Aktualisieren Sie LDAP auf Maschine 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Aktualisieren Sie die Edge-Komponenten auf den Computern 6, 7, 1, 4 und 5 in dieser Reihenfolge: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. Aktualisieren Sie die Benutzeroberfläche auf Maschine 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  7. (Wenn Sie Edge SSO installiert haben) Aktualisieren Sie Edge SSO auf Maschine 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 die Maschinen 8 und 9:
    1. Halten Sie den Postgres-Server auf Maschine 8 an: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. Beenden Sie den Postgres-Server und postgresql auf Maschine 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 Computern 6 und 7: 
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    4. Falls installiert, beenden Sie den Postgres-Server und postgresql auf dem neuen Standby-Knoten, den Sie für den 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. PostgreSQL auf Maschine 8 aktualisieren: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. Aktualisieren Sie die Postgres-Datenbank auf Maschine 8 (nur Postgres-Master): 
      /-->
opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. Aktualisieren Sie PostgreSQL auf Maschine 9: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    8. Starten Sie den Postgres-Server auf den Maschinen 8 und 9: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
    9. Starten Sie den Qpid-Server auf den Computern 6 und 7: 
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    10. Konfigurieren Sie Postgres als Standby-Knoten, indem Sie die folgenden Befehle auf Maschine 9 ausführen: 
      cd /opt/apigee/data/apigee-postgresql/pgdata
rm -rf *
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
    11. Prü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 Maschine 8, 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 9, dem Stand-by-Knoten: 
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

        Prüfen Sie, ob der Status „Standby“ lautet.

  9. Aktualisieren Sie die Edge-Komponenten auf den Computern 8 und 9: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  10. Achten Sie darauf, dass Sie den neuen Standby-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.

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

Clusterinstallation 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 den Computern 1, 2 und 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Aktualisieren Sie Qpid auf den Computern 12 und 13: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  4. Aktualisieren Sie LDAP auf Maschine 4 und 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Aktualisieren Sie die Edge-Komponenten auf den Computern 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 Benutzeroberfläche auf Maschine 6 und 7: 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  7. (Wenn Sie Edge SSO installiert haben) Aktualisieren Sie Edge SSO auf den Computern 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.

  8. Aktualisieren Sie die Maschinen 8 und 9:
    1. Halten Sie den Postgres-Server auf Maschine 8 an: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. Beenden Sie den Postgres-Server und postgresql auf Maschine 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 Computern 12 und 13: 
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    4. Falls installiert, beenden Sie den Postgres-Server und postgresql auf dem neuen Standby-Knoten, den Sie für den 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. PostgreSQL auf Maschine 8 aktualisieren: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. Aktualisieren Sie die Postgres-Datenbank auf Maschine 8 (nur Postgres-Master): 
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. Aktualisieren Sie PostgreSQL auf Maschine 9: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    8. Starten Sie den Postgres-Server auf den Maschinen 8 und 9: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
    9. Starten Sie den Qpid-Server auf den Computern 12 und 13: 
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    10. Konfigurieren Sie Postgres als Standby-Knoten, indem Sie die folgenden Befehle auf Maschine 9 ausführen: 
      cd /opt/apigee/data/apigee-postgresql/pgdata
rm -rf *
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
    11. Prü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 Maschine 8, 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 9, dem Stand-by-Knoten: 
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

        Prüfen Sie, ob der Status „Standby“ lautet.

  9. Aktualisieren Sie die Edge-Komponenten auf den Computern 8 und 9: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  10. Achten Sie darauf, dass Sie den neuen Standby-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.

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

Clusterinstallation 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 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
  3. Aktualisieren Sie qpidd:
    1. Maschinen 4 und 5 in Rechenzentrum 1
      1. Aktualisieren Sie qpidd auf Maschine 4: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. Wiederholen Sie Schritt 1 auf Maschine 5.
    2. Maschinen 10, 11 in Rechenzentrum 2
      1. Aktualisieren Sie qpidd auf Maschine 10: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. Wiederholen Sie Schritt 1 auf Maschine 11.
  4. LDAP aktualisieren:
    1. Maschinen 1 in Rechenzentrum 1 
      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
    2. Maschinen 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, 1, 2, 3 in Rechenzentrum 1 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
    2. Maschinen 10, 11, 7, 8, 9 in Rechenzentrum 2 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. Benutzeroberfläche aktualisieren:
    1. Maschine 1 in Rechenzentrum 1: 
      /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
    2. Maschine 7 in Rechenzentrum 2: 
      /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  7. (Wenn Sie Edge SSO installiert haben) Aktualisieren Sie Edge 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 bei der Installation von SSO erstellt haben.

  8. Aktualisieren Sie Maschine 6 in Rechenzentrum 1 und Maschine 12 in Rechenzentrum 2:
    1. Halten Sie den Postgres-Server auf Maschine 6 an: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. Beenden Sie den Postgres-Server und postgresql auf Maschine 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. Falls installiert, beenden Sie den Postgres-Server und postgresql auf dem neuen Standby-Knoten, den Sie für den 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. PostgreSQL auf Maschine 6 aktualisieren: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. Aktualisieren Sie die Postgres-Datenbank auf Maschine 6 (nur Postgres-Master): 
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. Aktualisieren Sie PostgreSQL auf den Maschinen 12: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    8. Starten Sie den Postgres-Server auf den Maschinen 6 und 12: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
    9. Starten Sie den Qpid-Server auf den Computern 4, 5, 10 und 11: 
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    10. Konfigurieren Sie Postgres als Standby-Knoten, indem Sie die folgenden Befehle auf Maschine 12 ausführen: 
      cd /opt/apigee/data/apigee-postgresql/pgdata
rm -rf *
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
    11. Prü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 Maschine 6, 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 12, dem Stand-by-Knoten:

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

      Prüfen Sie, ob der Status „Standby“ lautet.

  9. Aktualisieren Sie die Edge-Komponenten auf den Computern 6 und 12: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  10. Achten Sie darauf, dass Sie den neuen Standby-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.

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

Für eine nicht standardmäßige Installation

Wenn Sie eine nicht standardmäßige Installation 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, Management Server, Message Processor und Router.
  6. Edge-UI
  7. Edge-SSO

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