Apigee Edge 4.16.01/4.16.05 auf 4.17.01 aktualisieren

Edge for Private Cloud Version 4.17.01

Welche Edge-Versionen können Sie auf 4.17.01 aktualisieren

Mit diesem Verfahren können Sie die Apigee Edge-Version 4.16.01.0x und 4.16.05.x auf 4.17.01 aktualisieren.

Wenn Sie eine frühere Edge-Version als 4.16.01 haben, müssen Sie zuerst zu Version 4.16.01 migrieren und dann auf Version 4.17.01 aktualisieren.

  • Sie können die Apigee Edge-Version 4.15.07 zu 4.16.01 migrieren.
  • Wenn Sie eine frühere Edge-Version als 4.15.07 haben, müssen Sie zuerst zu Version 4.15.07 und dann zu Version 4.16.01 migrieren.
    • Wenn Sie von Edge-Version 4.14.04 oder höher migrieren: Migrieren Sie direkt zu Version 4.15.07.
    • Wenn Sie von Edge-Version 4.14.01 migrieren, müssen Sie zuerst zu Version 4.14.04 migrieren und dann zu Version 4.15.07 migrieren.

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.

Downgrade von Zookeeper bei Aktualisierung von 4.16.01

Die Version des Zookeeper-RPM in Edge for Private Cloud 4.16.01 lautet apigee-zookeeper-3.4.5-1.0.905.noarch.rpm. In nachfolgenden Versionen von Edge wurde die Zookeeper-Version wieder in apigee-zookeeper-3.4.5-0.0.94x geändert. Daher kann yum kein Upgrade von Zookeeper auf eine höhere Version von 4.16.01 auf eine höhere Version durchführen. Sie können dieses Problem beheben, indem Sie yum-Downgrade von apigee-zookeeper vor der Aktualisierung von Zookeeper ausführen.

Mit dem folgenden Befehl können Sie Ihre Zookeeper-Version prüfen:

> rpm -qa |grep apigee-zookeeper

Wenn dieser Befehl die Zookeeper-Version zurückgibt:

apigee-zookeeper-3.4.5-1.0.905

Dann müssen Sie das Downgrade durchführen.

Automatische Weitergabe von Property-Einstellungen

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

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 das Update auf eine neue Version nicht ordnungsgemäß funktioniert. Weitere Informationen zur Sicherung finden Sie unter Sicherung und Wiederherstellung.
  • Achten Sie darauf, dass Edge ausgeführt wird
    Stellen Sie sicher, dass Edge während des Aktualisierungsprozesses ausgeführt wird. Verwenden Sie dazu den folgenden Befehl:

    > /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 der Fehler ein Rollback des Updates auf die vorherige Version erfordert, finden Sie weitere Informationen unter 4.17.01 Rollback-Prozess.

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 namens update_username.log geschrieben.

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

Erforderliches Upgrade auf Java JDK Version 8

Für diesen Release von Edge müssen Sie Java JDK Version 8 auf allen Edge-Verarbeitungsknoten installiert haben. Sie können Oracle JDK 8 oder OpenJDK 8 installieren. Wenn Java JDK 8 noch nicht installiert ist, kann die Installation durch das Update-Skript erfolgen.

Im Rahmen des Updates auf Java 8 sind einige TLS-Chiffren in Oracle JDK 8 nicht mehr verfügbar. Die vollständige Liste finden Sie im Abschnitt „Standardmäßig deaktivierte Chiffrensammlungen“ unter http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html.

Zum Aktivieren des EPEL-Repositorys erforderlich

Sie müssen Extra Packages for Enterprise Linux (oder EPEL) aktivieren, um Edge zu installieren oder zu aktualisieren. Welchen Befehl Sie verwenden, hängt von Ihrer Version von RedHat/CentOS ab:

  • Für RedHat/CentOS 7.x:
    > wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm; rpm -ivh epel-release-latest-7.noarch.rpm
  • Für RedHat/CentOS 6.x:
    wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm; rpm -ivh epel-release-latest-6.noarch.rpm

Erforderlich, wenn bei Verwendung einer externen Authentifizierung ein Update durchgeführt wird

Sie können einen externen Verzeichnisdienst in eine vorhandene Apigee Edge Private Cloud-Installation einbinden. Dieses Feature ist für jeden Verzeichnisdienst geeignet, der LDAP unterstützt, z. B. Active Directory oder OpenLDAP. Mit einer externen LDAP-Lösung können Systemadministratoren Nutzeranmeldedaten über einen zentralen Verzeichnisverwaltungsdienst außerhalb von Systemen wie Apigee Edge verwalten, die sie verwenden.

Weitere Informationen finden Sie unter Externe Authentifizierungskonfiguration.

Wenn die externe Authentifizierung aktiviert ist, verwenden die meisten Kunden das Feld für den Namen des Active Directory-SAM-Kontonamens als Nutzernamen für die Authentifizierung und nicht eine E-Mail-Adresse, die vom Edge-OpenLDAP-Server verwendet wird.

Wenn Sie einen externen Verzeichnisdienst integriert haben, fügen Sie Ihrer Konfigurationsdatei die folgende Zeile hinzu, wenn Sie Edge auf 4.17.01 aktualisieren:

IS_EXTERNAL_AUTH="true"

Mit dieser Zeile wird Edge so konfiguriert, dass ein Kontoname anstelle einer E-Mail-Adresse als Nutzername unterstützt wird.

Erforderliches Upgrade auf Qpid 1.35

Diese Version enthält ein erforderliches Update für Qpid 1.35. Zum Aktualisieren eines Qpid-Knotens müssen Sie:

  • Verhindern Sie vorübergehend, dass Router und Nachrichtenprozessoren in den Qpid-Knoten schreiben, indem Sie Port 5672 auf dem Qpid-Knoten blockieren. Mit dem folgenden Befehl können Sie diesen Port auf dem Qpid-Knoten blockieren:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s "Hostname" -i eth0 -j DROP
  • Warten Sie, bis die Qpid-Warteschlange keine Nachrichten mehr enthält, um sicherzustellen, dass der Qpid-Knoten vor der Aktualisierung alle Nachrichten verarbeitet hat. Sorgen Sie mit dem folgenden Befehl dafür, dass die Qpid-Nachrichtenwarteschlange leer ist:
    > qpid-stat -q
  • Aktualisieren Sie den Qpid-Knoten.
  • Heben Sie die Blockierung von Port 5672 auf dem Qpid-Knoten auf, um den Zugriff von Routern und Message Processorn zu ermöglichen. Mit dem folgenden Befehl können Sie die Blockierung dieses Ports aufheben:
    > sudo iptables -F

    Wenn Sie iptables für andere Regeln verwenden, können Sie die entsprechende Änderung mit der Option „-D“ rückgängig machen:
    > sudo iptables -D INPUT -p tcp --destination-port 5672 ! -s "Hostname" -i eth0 -j DROP

Dieser Prozess wird unten für jede Edge-Topologie detailliert beschrieben.

Erforderliches Upgrade auf Postgres 9.4

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

Während die Postgres-Knoten für die Aktualisierung nicht verfügbar 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.

Der zusätzliche Postgres-Standby-Knoten ist erforderlich, wenn Sie aus irgendeinem Grund ein Rollback des Updates durchführen müssen. Wenn Sie für das Update ein Rollback durchführen 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.

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 Ihre vorhandene Edge-Version (4.16.01 oder 4.16.05) und nicht für Version 4.17.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 diese Datei nicht vorhanden ist, erstellen Sie sie:

    conf_pg_hba_replication.connection=host Replikation apigee existing_slave_ip/32 trust\ \nHostreplikation apigee new_slave_ip/32 trust

    Dabei ist existing_slave_ip die IP-Adresse des aktuellen Standby-Servers und new_slave_ip_slave der neue Standby-Server .
  2. Starten Sie apigee-postgresql auf dem Postgres-Master neu:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql Neustart
  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. Die Datei sollte folgende Zeilen enthalten:
    Hostreplikation apigee vorhanden_slave_ip/32 trust
    Hostreplikation Apigee new_slave_ip/32 trust
  4. Installieren Sie den neuen Postgres-Standby-Server:
    1. Geben Sie in der Konfigurationsdatei, mit der Sie Ihre aktuelle Version von Edge installiert haben, Folgendes an:

      # IP-Adresse des aktuellen Masters:
      PG_MASTER=192.168.56.103
      # IP-Adresse des neuen Standby-Knotens
      PG_STANDBY=192.168.56.102
    2. Deaktivieren Sie SELinux wie unter Edge-Dienstprogramm für Apigee-Einrichtung installieren beschrieben.
    3. Laden Sie die Datei Edge bootstrap_4.16.05.sh in /tmp/bootstrap_4.16.05.sh herunter:
      > curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh: laden Sie die Edge-Datei herunter: /tmp/bootstrap_4.16.05.sh Aktualisieren Sie die Edge-Datei:/tmp/bootstrap_4.16.05.sh.

    4. Installieren Sie das Edge-Apigee-Dienst-Dienstprogramm und die Abhängigkeiten:
      > sudo bash /tmp/bootstrap_4.16.05.sh apigeeuser=uName apigeepassword=pWord
    5. Verwenden Sie apigee-service zur Installation des Dienstprogramms apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup installieren
    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 es sich um den Standby-Knoten handelt.

Postgres-Knoten außer Betrieb nehmen

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

  1. Achten Sie darauf, dass 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 den folgenden cURL-Befehl auf dem neuen Standby-Knoten aus:
    > curl -u sysAdminEmail:password http://<node_IP>:8084/v1/servers/self

    Die UUID des Knotens sollte am Ende der Ausgabe angezeigt werden, im folgenden Format:

  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-Master-Knoten /opt/apigee/customer/application/postgresql.properties, um den neuen Standby-Knoten aus /opt/apigee/customer/application/postgresql.properties zu entfernen:
    /opt/apigee/customer/application/postgresql.properties
  5. Starten Sie apigee-postgresql auf dem Postgres-Master neu:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql Neustart
  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:
    Hostreplikation Apigee existing_slave_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 Management Server-Knoten aus:
    > curl -u sysAdminEmail:password -X DELETE http://<ms_IP>:8080/v1/servers/<new_slave_uuid>

Update ohne Ausfallzeiten

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

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 Installation, wie unten 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. Fahren Sie für alle in Ihrer Installation verbleibenden Maschinen fort.

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 stille Konfigurationsdatei sollte mit der Datei identisch sein, die Sie zum Installieren von Edge 4.16.01 oder 4.16.05 verwendet haben.

Verfahren zum Aktualisieren auf 4.17.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 Master-Standby-Replikation von Postgres verwenden, installieren Sie einen neuen Postgres-Standby-Knoten wie oben unter Neuen Postgres-Standby-Knoten installieren beschrieben.
  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.
    Hinweis: Für die RPM-Installation ist Root-Zugriff erforderlich. Sie können die Edge-Konfiguration aber auch ohne Root-Zugriff durchführen.
  4. Deaktivieren Sie SELinux wie unter Das Edge-Dienstprogramm für die Apigee-Einrichtung installieren beschrieben.
  5. Laden Sie die Datei Edge 4.17.01 bootstrap_4.17.01.sh in /tmp/bootstrap_4.17.01.sh herunter:
    > curl https://software.apigee.com/bootstrap_4.17.01.sh -o /tmp/bootstrap_4.17.01.sh
  6. Installieren Sie das Edge 4.17.01-Dienstprogramm apigee-service und Abhängigkeiten:
    > sudo bash /tmp/bootstrap_4.17.01.sh apigeeuser=uName apigeepassword=pWord

    Dabei sind uName:pWord der Benutzername und das Passwort, die Sie von Apigee erhalten haben. Wenn Sie pWord auslassen, werden Sie aufgefordert, ihn einzugeben.

    Das Installationsprogramm prüft standardmäßig, ob Java 1.8 installiert ist. Andernfalls wird die App automatisch installiert. Verwenden Sie die Option JAVA_FIX, um anzugeben, wie die Java-Installation zu behandeln ist. Für JAVA_FIX werden folgende Werte verwendet:

    I = Install OpenJDK 1.8 (Standard)
    C = Weiter ohne Java-Installation
    Q = Beenden. Dazu müssen Sie Java selbst installieren.
  7. (Nur CentOS-6.x und RedHat-6.x) Führen Sie auf allen Qpid-Knoten den folgenden Befehl aus, damit Sie die richtige Qpid-Version herunterladen:
    > yum install apigee-qpidd --disablerepo=epel
  8. Verwenden Sie apigee-service, um das Dienstprogramm „apigee-setup“ zu aktualisieren:
    1. Wenn Sie 4.16.01 durch ein Upgrade von Edge Version 4.15.07.0x installiert haben, müssen Sie das Dienstprogramm apigee-setup installieren:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install

      Dieser Befehl installiert das Dienstprogramm update.sh in /opt/apigee/apigee-setup/bin.

      Wenn Sie das Dienstprogramm apigee-setup bereits installiert haben, aktualisieren Sie es:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
    2. Wenn Sie 4.16.01 direkt installiert haben, d. h., Sie haben kein Upgrade von Version 4.15.07.0x durchgeführt, müssen Sie das Dienstprogramm apigee-setup aktualisieren:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup Update aktualisiert

      Dieses Update für apigee-service installiert das Dienstprogramm apigee-.apigee-setup/-dienstprogramm in /apigee-setup/-dienstprogramm.
    3. Wenn Sie 4.16.05 direkt oder im Rahmen einer Aktualisierung installiert haben, müssen Sie das Dienstprogramm apigee-setup aktualisieren:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup aktualisieren

      Diese Aktualisierung von apigee-service installiert das Dienstprogramm update.sh in /opt/apigee/apigee-setup/bin.
  9. Abhängig von Ihrer aktuellen Edge-Version müssen Sie das Dienstprogramm apigee-validate auf dem Management Server installieren oder aktualisieren.
    1. Wenn Sie derzeit Edge 4.16.05 verwenden: Aktualisieren Sie das Dienstprogramm apigee-validate auf dem Management Server:
      apigee-validate
    2. Wenn Sie aktuell Edge 4.16.01 verwenden: Installieren Sie das Dienstprogramm apigee-validate auf dem Management Server installieren:
      apigee-validate

      Hinweis: Wenn Sie das Dienstprogramm apigee-validate auf einem Message Processor-Knoten installiert haben, installieren Sie das Dienstprogramm apigee-validate


    3. Wenn Sie ein Upgrade von 4.16.01 durchführen: Bearbeiten Sie die Konfigurationsdatei, die an das Dienstprogramm apigee-validate übergeben wurde. Im Edge-Release 4.16.01 erforderte die von apigee-validate verwendete Konfigurationsdatei die folgenden Attribute:
      APIGEE_ADMINPW=sysAdminPword
      MP_POD=gateway
      REGION=dc-1

      In diesem Release benötigt die Konfigurationsdatei nur das Attribut APIGEE_ADMINPW. Sie können die anderen beiden Attribute aus der Datei entfernen.
  10. Aktualisieren Sie das Dienstprogramm apigee-provision:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  11. Führen Sie das Update-Dienstprogramm auf Ihren Knoten in der unten 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 die Konfigurationsdatei für den Benutzer „apigee“ zugänglich sein oder gelesen werden muss.

    Verwenden Sie die Option „-c“, um die zu aktualisierende Komponente anzugeben. Die Liste der möglichen Komponenten umfasst:
    ldap = OpenLDAP
    cs = Cassandra
    zk = Zookeeper
    qpid = qpidd
    ps = postgresql
    edge = All Edge-Komponenten außer Edge UI: Management Server, Message Processor, Router, QPID = Elastic API, Message Processor, Router und QPID = Edge API auf einem Elastic API als Basis-API auf Basis von Elastic = Stacks = E-Book „Message Processor , Message Processor“, „Router, QPID-Server und Postui-Portal für alle Stacks API auf dem Edge-Server und Postui-Portal





  12. Testen Sie die Aktualisierung, indem Sie das Dienstprogramm Apigee-validierung auf dem Management Server ausführen, wie unter Installation testen beschrieben.
  13. Wenn Sie einen neuen Postgres-Standby-Knoten installiert haben, außer Betrieb nehmen, wie oben unter Postgres-Knoten außer Betrieb nehmen beschrieben.

Für ein späteres Rollback der Aktualisierung folgen Sie der Anleitung unter 4.16.09 Rollback-Prozess.

Verfahren zur Aktualisierung auf 4.17.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.17.01-Repository aus:

  1. Wenn Sie derzeit die Master-Standby-Replikation von Postgres verwenden, installieren Sie einen neuen Postgres-Standby-Knoten wie oben unter Neuen Postgres-Standby-Knoten installieren beschrieben.
  2. Erstellen Sie ein lokales 4.17.01-Repository, wie in „Lokales Apigee-Repository erstellen“ unter Dienstprogramm für Edge Apigee-Setup installieren beschrieben.
    Hinweis: Wenn Sie bereits ein Repository der Version 4.16.01 oder 4.16.05 haben, können Sie das Repository 4.17.01 hinzufügen, wie unter „Lokales Apigee-Repository aktualisieren“ unter Edge-Dienstprogramm für Apigee-Einrichtung 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.17.01.tar.gz zu verpacken:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror-Paket
    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.17.01.tar.gz

      Dieser Befehl erstellt ein neues Verzeichnis namens repos in dem Verzeichnis, das die .tar-Datei enthält. Beispiel: /tmp/repos.
    4. Installieren Sie das Edge Apigee-Dienstprogramm und die Abhängigkeiten aus /tmp/repos:
      > sudo bash /tmp/repos/bootstrap_4.17.01.sh apigee="file://" apigeerepobasepath=/tmp/repos

      Beachten Sie, dass Sie in diesem Befehl den Pfad zum Repository-Verzeichnis angeben.
  4. So installieren Sie den Apigee-Dienst mit dem Nginx-Webserver:
    1. Konfigurieren Sie den Nginx-Webserver wie unter „Vom Repository mithilfe des Nginx-Webservers installieren“ unter Das Edge-Dienstprogramm Apigee-Setup installieren beschrieben.
    2. Laden Sie auf dem Remote-Knoten die Edge-Datei bootstrap_4.17.01.sh in /tmp/bootstrap_4.17.01.sh herunter:
      > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.01.sh.-name ist remoteRepo:3939/bootstrap_4.17.

    3. Installieren Sie auf dem Remote-Knoten das Dienstprogramm Edge Apigee-Dienst und die Abhängigkeiten:
      > sudo bash /tmp/bootstrap_4.17.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeepassword=pWord apigeeprotocol=http://
      sind
      , wobei ApigeeuName:der Benutzername ist
      .
  5. Verwenden Sie apigee-service, um das Dienstprogramm „apigee-setup“ zu aktualisieren:
    1. Wenn Sie 4.16.01 durch ein Upgrade von Edge Version 4.15.07.0x installiert haben, müssen Sie das Dienstprogramm apigee-setup installieren:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install

      Dieser Befehl installiert das Dienstprogramm update.sh in /opt/apigee/apigee-setup/bin.

      Wenn Sie das Dienstprogramm apigee-setup bereits installiert haben, aktualisieren Sie es:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
    2. Wenn Sie 4.16.01 direkt installiert haben, d.h., Sie haben kein Upgrade von Version 4.15.07.0x durchgeführt, müssen Sie das Dienstprogramm apigee-setup aktualisieren:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

      Dieses Update für apigee-service installiert das Dienstprogramm apigee-/apigee-setup/-dienstprogramm
    3. Wenn Sie 4.16.05 direkt oder durch eine Aktualisierung installiert haben, müssen Sie das Dienstprogramm apigee-setup aktualisieren:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

      Diese Aktualisierung von apigee-service installiert das Dienstprogramm update.sh in /opt/apigee/apigee-setup/bin.
  6. Abhängig von Ihrer aktuellen Edge-Version müssen Sie das Dienstprogramm apigee-validate auf dem Management Server installieren oder aktualisieren.
    1. Wenn Sie derzeit Edge 4.16.05 verwenden: Aktualisieren Sie das Dienstprogramm apigee-validate auf dem Management Server:
      apigee-validate
    2. Wenn Sie aktuell Edge 4.16.01 verwenden: Installieren Sie das Dienstprogramm apigee-valid / apigee-valid auf dem Management Server installieren:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-validate install

      Hinweis: Wenn Sie das Dienstprogramm apigee-valid auf einem Message Processor-Knoten bei der Installation von 4.16.01 installiert haben, installieren Sie das Dienstprogramm apigee-valid / appengine auf dem Management Server.


    3. Wenn Sie ein Upgrade von 4.16.01 durchführen: Bearbeiten Sie die Konfigurationsdatei, die an das Dienstprogramm apigee-validate übergeben wurde. Im Edge-Release 4.16.01 erforderte die von apigee-validate verwendete Konfigurationsdatei die folgenden Attribute:
      APIGEE_ADMINPW=sysAdminPword
      MP_POD=gateway
      REGION=dc-1

      In diesem Release benötigt die Konfigurationsdatei nur das Attribut APIGEE_ADMINPW. Sie können die anderen beiden Attribute aus der Datei entfernen.
  7. Aktualisieren Sie das Dienstprogramm apigee-provision:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  8. Führen Sie das Aktualisierungsdienstprogramm auf Ihren Knoten in der unten unter „Reihenfolge der Maschinenaktualisierung“ beschriebenen Reihenfolge aus:
    > /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

    Die einzige Anforderung für die Konfigurationsdatei ist, dass die Konfigurationsdatei für den Benutzer „apigee“ zugänglich sein oder gelesen werden muss.

    Verwenden Sie die Option „-c“, um die zu aktualisierende Komponente anzugeben. Die Liste der möglichen Komponenten umfasst:
    ldap = OpenLDAP
    cs = Cassandra
    zk = Zookeeper
    qpid = qpidd
    ps = postgresql
    edge = All Edge-Komponenten außer Edge UI: Management Server, Message Processor, Router, QPID = Elastic API, Message Processor, Router und QPID = Edge API auf einem Elastic API als Basis-API auf Basis von Elastic = Stacks = E-Book „Message Processor , Message Processor“, „Router, QPID-Server und Postui-Portal für alle Stacks API auf dem Edge-Server und Postui-Portal





  9. Testen Sie die Aktualisierung, indem Sie das Dienstprogramm Apigee-validierung auf dem Management Server ausführen, wie unter Installation testen beschrieben.
  10. Wenn Sie einen neuen Postgres-Standby-Knoten installiert haben, außer Betrieb nehmen, wie oben unter Postgres-Knoten außer Betrieb nehmen beschrieben.

Für ein späteres Rollback der Aktualisierung folgen Sie der Anleitung unter 4.16.09 Rollback-Prozess.

Reihenfolge des Maschinenupdates

Die Reihenfolge, in der Sie die Maschinen in einer Edge-Installation 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.
  • (Nur CentOS-6.x und RedHat-6.x) Achten Sie auf allen Qpid-Knoten mit einer externen Internetverbindung darauf, dass Sie den folgenden Befehl zum Herunterladen der richtigen Qpid-Version wie oben gezeigt ausgeführt haben:
    > yum install apigee-qpidd --disablerepo=epel

Für eine eigenständige Installation mit einem Host

  1. Wenn Sie ein Update von 4.16.01 durchführen, führen Sie ein Downgrade von Zookeeper durch:
    > yum-Downgrade von apigee-zookeeper
  2. Aktualisieren Sie Cassandra und ZooKeeper:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Legen Sie die folgende iptables-Regel fest:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s "Hostname" -i eth0 -j DROP
  4. Prüfen Sie die Qpid-Nachrichtenwarteschlange:
    > qpid-stat -q

    Prüfen Sie die Warteschlange weiter, bis der Wert in der Spalte „msg“ 0 beträgt. Sie können Qpid erst aktualisieren, wenn alle Nachrichten verarbeitet wurden.
  5. Aktualisieren Sie qpidd:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  6. iptables leeren:
    > sudo iptables -F
  7. LDAP aktualisieren:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  8. 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, anhalten
  9. Aktualisieren Sie postgresql:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  10. Aktualisieren Sie die Postgres-Datenbank:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
  11. Aktualisieren Sie die verbleibenden Edge-Komponenten:
    > /opt/apigee/apigee-setup/bin/update.sh -cedge -f configFile
  12. Aktualisieren der Edge-Benutzeroberfläche:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

Für eine eigenständige Installation mit zwei Hosts

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

  1. Wenn Sie ein Update von 4.16.01 durchführen, führen Sie ein Downgrade von Zookeeper auf Maschine 1 aus:
    > yum-Downgrade von apigee-zookeeper
  2. Aktualisieren Sie Cassandra und ZooKeeper auf Maschine 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Legen Sie die folgende iptables-Regel auf Computer 2 fest:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s "Hostname" -i eth0 -j DROP
  4. Prüfen Sie die Qpid-Nachrichtenwarteschlange auf Computer 2:
    > qpid-stat -q

    Prüfen Sie die Warteschlange weiter, bis die Anzahl in der Spalte „msg“ 0 beträgt. Sie können Qpid erst aktualisieren, wenn alle Nachrichten verarbeitet wurden.
  5. Aktualisieren Sie qpidd auf Maschine 2:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  6. iptables auf Maschine 2 leeren:
    > sudo iptables -F
  7. Aktualisieren Sie LDAP auf Maschine 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  8. Aktualisieren Sie Edge-Komponenten auf Maschine 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  9. Aktualisieren der UI auf Maschine 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  10. 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/apigee-service/bin/apigee-service, apigee-postgre stop, angehalten
    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 Edge-Komponenten auf Maschine 2 und Maschine 1:
      > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  11. Aktualisieren Sie Edge-Komponenten auf Maschine 2:
    > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile

Für eine geclusterte Installation mit 5 Hosts

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

  1. Prüfen Sie, ob Sie einen neuen Postgres-Standby-Knoten wie oben unter Neuen Postgres-Standby-Knoten installieren beschrieben installiert haben.
  2. Wenn Sie ein Update von Version 4.16.01 durchführen, führen Sie ein Downgrade von Zookeeper auf Maschinen 1, 2 und 3 aus:
    > yum-Downgrade von apigee-zookeeper
  3. Aktualisieren Sie Cassandra und ZooKeeper auf Maschinen 1, 2 und 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  4. Legen Sie die folgende iptables-Regel auf Computer 4 fest:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s "Hostname" -i eth0 -j DROP
  5. Prüfen Sie die Qpid-Nachrichtenwarteschlange auf Computer 4:
    > qpid-stat -q

    Prüfen Sie die Warteschlange weiter, bis die Anzahl in der Spalte „msg“ 0 beträgt. Sie können Qpid erst aktualisieren, wenn alle Nachrichten verarbeitet wurden.
  6. Aktualisieren Sie qpidd auf Maschine 4:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. iptables auf Maschine 4 leeren:
    > sudo iptables -F
  8. Wiederholen Sie die Schritte 3 bis 6 auf Gerät 5.
  9. Aktualisieren Sie LDAP auf Maschine 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  10. Aktualisieren Sie Edge-Komponenten auf Maschine 1, 2, 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  11. Aktualisieren der UI auf Maschine 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  12. 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 stopp
    2. Beenden Sie Postgres-Server, 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 stop-sql-Dienst stoppen
    3. Beenden Sie 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, beendet
    4. Aktualisieren Sie postgresql auf Maschinen 4:
      > /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. Aktualisieren Sie postgresql auf Maschinen 5:
      > /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, 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. Ü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 den Masterknoten 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:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      Prüfen Sie, ob es sich um den Standby-Knoten handelt.
  13. Aktualisieren Sie Edge-Komponenten auf Maschine 4, 5:
    > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  14. Stellen Sie sicher, dass Sie den neuen Standby-Knoten außer Betrieb nehmen. Folgen Sie dazu der Anleitung unter Postgres-Knoten außer Betrieb nehmen.

Für eine geclusterte Installation mit 9 Hosts

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

  1. Prüfen Sie, ob Sie einen neuen Postgres-Standby-Knoten wie oben unter Neuen Postgres-Standby-Knoten installieren beschrieben installiert haben.
  2. Wenn Sie ein Update von Version 4.16.01 durchführen, führen Sie ein Downgrade von Zookeeper auf Maschinen 1, 2 und 3 aus:
    > yum-Downgrade von apigee-zookeeper
  3. Aktualisieren Sie Cassandra und ZooKeeper auf Maschinen 1, 2 und 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  4. Legen Sie die folgende iptables-Regel auf Computer 6 fest:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s "Hostname" -i eth0 -j DROP
  5. Prüfen Sie die Qpid-Nachrichtenwarteschlange auf Computer 6:
    > qpid-stat -q

    Prüfen Sie die Warteschlange weiter, bis die Anzahl in der Spalte „msg“ 0 beträgt. Sie können Qpid erst aktualisieren, wenn alle Nachrichten verarbeitet wurden.
  6. Aktualisieren Sie qpidd auf Maschine 6:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. iptables auf Maschine 6 leeren:
    > sudo iptables -F
  8. Wiederholen Sie die Schritte 3 bis 6 auf Maschine 7.
  9. Aktualisieren Sie LDAP auf Maschine 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  10. Aktualisieren Sie 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
  11. Aktualisieren der UI auf Maschine 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  12. Aktualisieren Sie die Maschinen 8 und 9:
    1. Beenden Sie den Postgres-Server auf Maschine 8:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
    2. Beenden Sie 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-Stopp
    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 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, beendet
    5. Aktualisieren Sie postgresql auf Maschinen 8:
      > /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 Maschinen 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-Serverserver auf den Maschinen 6 und 7:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server start
    10. Konfigurieren Sie Postgres als Standby-Knoten. Dazu führen Sie die folgenden Befehle auf Maschine 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
    11. Ü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 den Masterknoten 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:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      Prüfen Sie, ob es sich um den Standby-Knoten handelt.
  13. Aktualisieren Sie Edge-Komponenten auf Maschine 8 und 9:
    > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  14. Stellen Sie sicher, dass Sie den neuen Standby-Knoten außer Betrieb nehmen. Folgen Sie dazu der Anleitung unter Postgres-Knoten außer Betrieb nehmen.

Für eine geclusterte Installation mit 13 Hosts

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

  1. Prüfen Sie, ob Sie einen neuen Postgres-Standby-Knoten wie oben unter Neuen Postgres-Standby-Knoten installieren beschrieben installiert haben.
  2. Wenn Sie ein Update von Version 4.16.01 durchführen, führen Sie ein Downgrade von Zookeeper auf Maschinen 1, 2 und 3 aus:
    > yum-Downgrade von apigee-zookeeper
  3. Aktualisieren Sie Cassandra und ZooKeeper auf Maschinen 1, 2 und 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  4. Legen Sie die folgende iptables-Regel auf Computer 12 fest:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s "Hostname" -i eth0 -j DROP
  5. Prüfen Sie die Qpid-Nachrichtenwarteschlange auf Computer 12:
    > qpid-stat -q

    Prüfen Sie die Warteschlange weiter, bis die Anzahl in der Spalte „msg“ 0 beträgt. Sie können Qpid erst aktualisieren, wenn alle Nachrichten verarbeitet wurden.
  6. Aktualisieren Sie qpidd auf Maschine 12:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. iptables auf Maschine 12 leeren:
    > sudo iptables -F
  8. Wiederholen Sie die Schritte 3 bis 6 auf Maschine 13.
  9. Aktualisieren Sie LDAP auf Computer 4 und 5:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  10. Aktualisieren Sie Edge-Komponenten auf den Maschinen 12, 13, 6, 7, 10 und 11 in dieser Reihenfolge:
    > /opt/apigee/apigee-setup/bin/update.sh -cedge -f configFile
  11. Aktualisieren Sie die UI auf Maschine 6 und 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  12. Aktualisieren Sie die Maschinen 8 und 9:
    1. Beenden Sie den Postgres-Server auf Maschine 8:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
    2. Beenden Sie 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-Stopp
    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 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, beendet
    5. Aktualisieren Sie postgresql auf Maschinen 8:
      > /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 Maschinen 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-Serverserver auf den Maschinen 12 und 13:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server start
    10. Konfigurieren Sie Postgres als Standby-Knoten. Dazu führen Sie die folgenden Befehle auf Maschine 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
    11. Ü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 den Masterknoten 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:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      Prüfen Sie, ob es sich um den Standby-Knoten handelt.
  13. Aktualisieren Sie Edge-Komponenten auf Maschine 8 und 9:
    > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  14. Stellen Sie sicher, dass Sie den neuen Standby-Knoten außer Betrieb nehmen. Folgen Sie dazu der Anleitung unter Postgres-Knoten außer Betrieb nehmen.

Für eine geclusterte Installation mit 12 Hosts

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

  1. Prüfen Sie, ob Sie einen neuen Postgres-Standby-Knoten wie oben unter Neuen Postgres-Standby-Knoten installieren beschrieben installiert haben.
  2. Aktualisieren Sie Cassandra und ZooKeeper:
    1. Bei einem Update von 4.16.01 führen Sie ein Downgrade von Zookeeper auf Maschinen 1, 2 und 3 in Rechenzentrum 1 aus:
      > yum Downgrade von apigee-zookeeper
    2. Auf Maschinen 1, 2 und 3 im Rechenzentrum 1:
      > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
    3. Wenn Sie ein Update von 4.16.01 durchführen, führen Sie in Rechenzentrum 2 ein Downgrade von Zookeeper auf Maschinen 7, 8 und 9 aus:
      > yum Downgrade von apigee-zookeeper
    4. 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. Legen Sie die folgende iptables-Regel auf Computer 4 fest:
        > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s "Hostname" -i eth0 -j DROP
      2. Prüfen Sie die Qpid-Nachrichtenwarteschlange auf Computer 4:
        > qpid-stat -q

        Prüfen Sie die Warteschlange weiter, bis die Anzahl in der Spalte „msg“ 0 beträgt. Sie können Qpid erst aktualisieren, wenn alle Nachrichten verarbeitet wurden.
      3. Aktualisieren Sie qpidd auf Maschine 4:
        > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      4. iptables auf Maschine 4 leeren:
        > sudo iptables -F
      5. Wiederholen Sie die Schritte 1 bis 4 auf Gerät 5.
    2. Maschinen 10, 11 im Rechenzentrum 2
      1. Legen Sie die folgende iptables-Regel auf Computer 10 fest:
        > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s "Hostname" -i eth0 -j DROP
      2. Prüfen Sie die Qpid-Nachrichtenwarteschlange auf Computer 10:
        > qpid-stat -q

        Prüfen Sie die Warteschlange weiterhin, bis die Anzahl in der Spalte „msg“ 0 beträgt. Sie können Qpid erst aktualisieren, wenn alle Nachrichten verarbeitet wurden.
      3. Aktualisieren Sie qpidd auf Maschine 10:
        > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      4. iptables auf Maschine 10 leeren:
        > sudo iptables -F
      5. Wiederholen Sie die Schritte 1 bis 4 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 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. Aktualisieren Sie Maschine 6 in Rechenzentrum 1 und 12 in Rechenzentrum 2:
    1. Beenden Sie den Postgres-Server auf Maschine 6:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stopp
    2. Beenden Sie 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-Stopp
    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 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, beendet
    5. Aktualisieren Sie postgresql auf Maschinen 6:
      > /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 Maschinen 12:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    8. Starten Sie den Postgres-Serverserver auf den Maschinen 6 und 12:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-Postgres-server start
    9. Starten Sie den Qpid-Serverserver auf den Maschinen 4, 5, 10 und 11:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server start
    10. Konfigurieren Sie Postgres als Standby-Knoten. Dazu führen Sie die folgenden Befehle auf Maschine 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
    11. Ü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 den Masterknoten 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:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      Prüfen Sie, ob er angibt, dass es sich um den Standby-Knoten handelt.
  8. Aktualisieren Sie Edge-Komponenten auf Maschine 6 und 12:
    > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  9. Stellen Sie sicher, dass Sie den neuen Standby-Knoten außer Betrieb nehmen. Folgen Sie dazu der Anleitung unter Postgres-Knoten außer Betrieb nehmen.

Für eine BaaS-Installation einer API mit 7 oder 10 Hosts

Für eine nicht standardmäßige Installation

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

  1. ZooKeeper
  2. Cassandra
  3. QPIdd
  4. LDAP
  5. Edge, d. h. das Profil „-c Edge“ auf allen Knoten in der Reihenfolge: Knoten mit dem Qpid-Server, aber nicht dem Postgres-Server, dem Verwaltungsserver, dem Nachrichtenprozessor und dem Router.
    Hinweis: Wenn auf dem Knoten sowohl der Qpid-Server als auch der Postgres-Server installiert sind, führen Sie den Profilschritt „-c Edge“ im Rahmen von Schritt 8 aus.
  6. Edge-Benutzeroberfläche
  7. postgresql auf dem Postgres-Master, einschließlich Upgrade.
  8. postgresql im Postgres-Standby-Modus.
  9. Edge, d. h. das Profil „-c“ auf allen kombinierten Qpid- und Postgres-Knoten oder auf jedem eigenständigen Postgres-Knoten.