Apigee Edge 4.16.01/4.16.05 auf 4.17.09 aktualisieren

Edge for Private Cloud Version 4.17.09

Auf welche Edge-Versionen können Sie auf 4.17.09 aktualisieren?

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

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

  • Sie können Apigee Edge-Version 4.15.07 auf Version 4.16.01 migrieren.
  • Wenn Sie eine Version von Edge vor Version 4.15.07 verwenden, müssen Sie zuerst auf Version 4.15.07 und dann auf 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: Sie müssen zuerst auf Version 4.14.04 und dann auf Version 4.15.07 migrieren.

Wer kann das Update ausführen?

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

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

Welche Komponenten müssen Sie aktualisieren?

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

Zookeeper-Downgrade 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. Dadurch wird verhindert, dass Yum Zookeeper von Version 4.16.01 auf eine neuere Version aktualisiert. Führen Sie yum downgrade apigee-zookeeper aus, bevor Sie Zookeeper aktualisieren, um dieses Problem zu beheben.

Sie können die Zookeeper-Version mit dem folgenden Befehl prüfen:

> rpm -qa |grep apigee-zookeeper

Wenn dieser Befehl die Zookeeper-Version zurückgibt:

apigee-zookeeper-3.4.5-1.0.905

Führen Sie dann ein Downgrade durch.

Automatische Übernahme von Hoteleigenschaften

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

Voraussetzungen für die Aktualisierung

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

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

    So erhalten Sie einen Sicherungsplan für den Fall, dass 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 Befehl, ob Edge während des Aktualisierungsvorgangs ausgeführt wird:

    > /opt/apigee/apigee-service/bin/apigee-all status

Umgang mit einem fehlgeschlagenen Update

Wenn das 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. Dabei wird es an der Stelle fortgesetzt, an der es zuletzt angehalten wurde.

Wenn Sie aufgrund des Fehlers das Update auf die vorherige Version zurücksetzen müssen, finden Sie weitere Informationen unter 4.17.09 Rollback-Vorgang.

Informationen zum Logging von Updates

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

/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 Protokoll 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.

Erforderliches Upgrade auf Java JDK Version 8

Für diese Version von Edge muss Java JDK Version 8 auf allen Edge-Verarbeitungsknoten installiert sein. Sie können Oracle JDK 8 oder OpenJDK 8 installieren. Wenn Java JDK 8 noch nicht installiert ist, kann das Update-Script es für Sie installieren.

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 "Default Disabled Cipher Suites" (Standard-Deaktivierte Cipher Suites) unter http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html.

Erforderlich, um das EPEL-Repository zu aktivieren

Sie müssen Zusätzliche Pakete für Enterprise Linux (EPEL) aktivieren, um Edge zu installieren oder zu aktualisieren. Welchen Befehl Sie verwenden, hängt von Ihrer RedHat-/CentOS-Version 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

Erforderliches Hinzufügen 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. Wenn Sie ein Update von Version 4.17.01 durchführen, müssen Sie beim Aktivieren des SMTP-Servers in der Konfigurationsdatei SMTPMAILFROM festlegen.

In der API BaaS-Version 4.17.09 wurde außerdem die Unterstützung für das Attribut SMTPMAILFROM hinzugefügt. Wenn Sie API BaaS aktualisieren, müssen Sie SMTPMAILFROM in der Konfigurationsdatei festlegen.

Dieser Parameter hat das folgende Format:

SMTPMAILFROM="My Company <myco@company.com>"

Erforderlich, wenn bei Verwendung der externen Authentifizierung aktualisiert wird

Sie können einen externen Verzeichnisdienst in eine vorhandene Apigee Edge Private Cloud-Installation einbinden. Diese Funktion funktioniert mit allen Verzeichnisdiensten, die LDAP unterstützen, z. B. Active Directory, OpenLDAP. Mit einer externen LDAP-Lösung können Systemadministratoren Nutzeranmeldedaten über einen zentralen Verzeichnisverwaltungsdienst verwalten, der sich außerhalb von Systemen wie Apigee Edge befindet, die sie verwenden.

Weitere Informationen finden Sie unter Externe Authentifizierungskonfiguration.

Wenn die externe Authentifizierung aktiviert ist, verwenden die meisten Kunden das SAM-Kontonamen-Feld von Active Directory als Nutzernamen für die Authentifizierung anstelle einer E-Mail-Adresse, die vom Edge OpenLDAP-Server verwendet wird.

Wenn Sie einen externen Verzeichnisdienst eingebunden haben, fügen Sie Ihrer Konfigurationsdatei beim Aktualisieren von Edge auf Version 4.17.09 die folgende Zeile hinzu:

IS_EXTERNAL_AUTH="true"

Diese Zeile konfiguriert Edge so, dass er einen Kontonamen anstelle einer E-Mail-Adresse als Benutzernamen unterstützt.

Erforderliches Upgrade auf Qpid 1.35

Diese Version enthält ein erforderliches Update auf Qpid 1.35. Wenn Sie einen Qpid-Knoten aktualisieren, müssen Sie Folgendes tun:

  • Verhindern Sie vorübergehend, dass Router und Message Processor auf 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 leer ist, damit der Qpid-Knoten alle Nachrichten vor dem Update verarbeitet hat. Verwenden Sie den folgenden Befehl, um sicherzustellen, 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 Processors 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 jeweilige Ä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 Vorgang wird unten für jede Edge-Topologie ausführlich 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 des Aktualisierungsprozesses, wenn die Postgres-Knoten wegen der Aktualisierung nicht verfügbar sind, werden Analytics-Daten weiterhin in die Qpid-Knoten geschrieben. Nachdem die Postgres-Knoten aktualisiert und wieder online sind, werden Analysedaten an die Postgres-Knoten gesendet.

Der zusätzliche Postgres-Standbyknoten ist erforderlich, wenn Sie das Update aus irgendeinem Grund rückgängig machen müssen. Wenn ein Rollback für das Update erforderlich ist, wird der neue Postgres-Standby-Knoten nach dem Rollback zum Master-Postgres-Knoten. Daher sollte der neue Postgres-Standbyknoten auf einem Knoten installiert werden, der alle Hardwareanforderungen eines Postgres-Servers erfüllt, wie in den Installationsanforderungen für Edge 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), nicht für Version 4.17.09.

Verwenden Sie für die Installation dieselbe Konfigurationsdatei, die Sie für die Installation der aktuellen Version von Edge 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

    wobei existing_slave_ip die IP-Adresse des aktuellen Postgres-Standby-Servers und new_slave_ip die IP-Adresse des neuen Standby-Knotens ist.
  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, indem Sie die Datei /opt/apigee/apigee-postgresql/conf/pg_hba.conf auf dem Master aufrufen. In dieser Datei sollten die folgenden Zeilen zu sehen 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, mit der Sie die aktuelle Version von Edge installiert haben, und geben Sie Folgendes an:

      # IP-Adresse des aktuellen Masterknotens:
      PG_MASTER=192.168.56.103
      # IP-Adresse des neuen Standby-Knotens
      PG_STANDBY=192.168.56.102
    2. Deaktivieren Sie SELinux wie unter Installieren Sie das Hilfsprogramm für das Edge-Apigee-Setup beschrieben.
    3. Laden Sie die Datei Edge bootstrap_4.16.05.sh nach /tmp/bootstrap_4.16.05.sh herunter:
      > curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh

      Hinweis:
    4. Installieren Sie das Dienstprogramm von Edge Apigee-Dienst und Abhängigkeiten:
      > sudo bash /tmp/bootstrap_4.16.05.sh apigeeuser=uName apigeepassword=pWord
    5. Verwenden Sie den Apigee-Service, um das Apigee-Setup-Dienstprogramm 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 Knoten als Standby-Knoten angezeigt wird.

Postgres-Knoten außer Betrieb nehmen

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

    Die UUID des Knotens sollte am Ende der Ausgabe in folgendem Format angezeigt werden:
    "type" : [ "postgres-server" ],
    "uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
  3. Stoppen Sie den neuen Standby-Knoten, indem Sie auf dem neuen Standby-Knoten den folgenden Befehl 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, indem Sie die Datei /opt/apigee/apigee-postgresql/conf/pg_hba.conf auf dem Master aufrufen. 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 Standby-Knotens aus ZooKeeper, indem Sie den folgenden Edge Management API-Aufruf auf dem Management-Server-Knoten ausführen:
    > curl -u sysAdminEmail:password -X DELETE http://<ms_IP>:8080/v1/servers/<new_slave_uuid>

Aktualisierung ohne Ausfallzeiten

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

Eine Aktualisierung ohne Ausfallzeiten ist nur bei einer Konfiguration mit fünf und mehr Knoten möglich.

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

  1. Aktualisieren Sie die Computer in der richtigen Reihenfolge für Ihre Installation, wie unten unter „Reihenfolge der Aktualisierung von Computern“ 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 Verfügbarkeit des Servers (Nachrichtenprozessors/Routers) 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. Sorgen Sie dafür, dass der Router wieder erreichbar ist.
  5. Wiederholen Sie die Schritte 2 bis 4 für die übrigen Router.
  6. Fahren Sie mit dem Update für alle verbleibenden Computer in Ihrer Installation fort.

Beachten Sie vor und nach dem Update Folgendes:

  • Auf einem kombinierten Router- und Message Processor-Knoten:
    • Führen Sie vor der Aktualisierung folgende Schritte aus:
      1. Den Router unerreichbar machen.
      2. Sorgen Sie dafür, dass der Nachrichtenverarbeiter nicht erreichbar ist.
    • Nach dem Update:
      1. Sorgen Sie dafür, dass der Message Processor erreichbar ist.
      2. Sorgen Sie dafür, dass der Router erreichbar ist.
  • Auf einem einzelnen Routerknoten:
    • Sorgen Sie vor dem Update dafür, dass der Router nicht erreichbar ist.
    • Sorgen Sie nach dem Update dafür, dass der Router erreichbar ist.
  • Auf einem einzelnen Message Processor-Knoten:
    • Sorgen Sie vor einem Update dafür, dass der Message Processor nicht erreichbar ist.
    • Sorgen Sie nach dem Update dafür, dass der Message Processor erreichbar ist.

Silent-Konfigurationsdatei verwenden

Sie müssen dem Befehl „update“ eine Konfigurationsdatei für die Installation ohne Benutzerinteraktion übergeben. Die stille Konfigurationsdatei muss dieselbe sein, die Sie für die Installation von Edge 4.16.01 oder 4.16.05 verwendet haben.

Verfahren für die Aktualisierung auf 4.17.09 auf einem Knoten mit einer externen Internetverbindung

So aktualisieren Sie die Edge-Komponenten auf einem Knoten:

  1. Wenn Sie derzeit die Postgres-Master-Standby-Replikation verwenden, installieren Sie einen neuen Postgres-Standbyknoten wie oben im Abschnitt Neuen Postgres-Standbyknoten installieren beschrieben.
  2. Deaktivieren Sie gegebenenfalls alle CRON-Jobs, die für die Ausführung eines Reparaturvorgangs auf Cassandra konfiguriert sind, bis das Update abgeschlossen ist.
  3. Melden Sie sich als Root auf Ihrem Knoten an, um die Edge-RPMs zu installieren.
    Hinweis: Für die RPM-Installation ist Root-Zugriff erforderlich. Die Edge-Konfiguration kann jedoch auch ohne Root-Zugriff durchgeführt werden.
  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 Installieren Sie das Hilfsprogramm für das Edge-Apigee-Setup beschrieben.
  6. Aktivieren Sie das EPEL-Repository wie oben beschrieben.
  7. Wenn Sie die Installation in AWS ausführen, führen Sie den folgenden Befehl yum-configure-manager aus:
    > sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
  8. Laden Sie die Datei bootstrap_4.17.09.sh für Edge 4.17.09 in /tmp/bootstrap_4.17.09.sh herunter:
    > curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
  9. Installieren Sie das Edge 4.17.09-Dienstprogramm apigee-service und die zugehörigen Abhängigkeiten:
    > sudo bash /tmp/bootstrap_4.17.09.sh apigeeuser=uName apigeepassword=pWord

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

    Standardmäßig prüft das Installationsprogramm, ob Java 1.8 installiert ist. Andernfalls wird es automatisch installiert. Verwenden Sie die Option JAVA_FIX, um anzugeben, wie die Java-Installation behandelt werden soll. Für JAVA_FIX sind folgende Werte zulässig:

    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:
    1. Wenn Sie 4.16.01 durch ein Upgrade der Edge-Version 4.15.07.0x installiert haben, müssen Sie das Hilfsprogramm „apigee-setup“ installieren:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install

      Mit diesem Befehl wird das Dienstprogramm update.sh unter /opt/apigee/apigee-setup/bin installiert.

      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, also kein Upgrade von 4.15.07.0x durchgeführt haben, müssen Sie das Dienstprogramm „apigee-setup“ aktualisieren:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

      Durch dieses Update von apigee-service wird das Dienstprogramm update.sh in /opt/apigee/apigee-setup/bin installiert.
    3. Wenn Sie 4.16.05 direkt oder durch ein Update installiert haben, 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 update.sh in /opt/apigee/apigee-setup/bin.
  11. Je nach aktueller Edge-Version müssen Sie das Dienstprogramm apigee-validate auf dem Verwaltungsserver entweder installieren oder aktualisieren.
    1. Wenn Sie derzeit Edge 4.16.05 verwenden: Aktualisieren Sie das Dienstprogramm apigee-valid auf dem Management Server:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
    2. Nutzung von Edge 4.16.011: Installieren Sie die SM Apigee-valid Dienst auf dem Management Server auf dem Management Server:
      > /opt/opt/opt/s/apigee/apigee/apigee-teams-service/bin/teams/apigee-teams-teams-teams-teams-teams-unternehmen nutzen; Edge 4.16.01.01: installieren die Nutzung s Apigee-valid Dienst auf dem Management Server auf dem Management Server:
      > /opt/opt/opt/apigee/apigee/apigees Apigee-service/bin/s/teams, gehen; / /opt/opt/opt/s/apigee/apigee/apigee-teams-service/bin/s/teams-teams-teams-teams-teams-teams-be- /opt/opt/s/apigee/apigee/apigee-teams-service/bin/s/teams-Mails- s s /opt/s/opt/s/s/apigee/s Apigee und Apigee sowie; bin/s, Musik, Musik, Apigees ApigeeTs, ApigeeTs, Apigee und Apigee und Apigee und Edge 4.16.01.

      Hinweis:: Wenn Sie das Dienst s s Apigee s

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

      In diesem Release erfordert die Konfigurationsdatei nur das Attribut APIGEE_ADMINPW. Sie können die anderen beiden Properties aus der Datei entfernen.
  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 unten unter Reihenfolge der Aktualisierung von Maschinen beschriebenen Reihenfolge aus:
    > /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

    Die einzige Anforderung an die Konfigurationsdatei ist, dass der Nutzer „apigee“ darauf zugreifen oder sie lesen kann.

    Mit der Option „-c“ können Sie die zu aktualisierende Komponente angeben.











    ldap
  14. Testen Sie das Update, indem Sie das Dienstprogramm „apigee-valid“ auf dem Verwaltungsserver ausführen, wie unter Installation testen beschrieben.
  15. Wenn Sie einen neuen Postgres-Standbyknoten installiert haben, stellen Sie ihn wie oben unter Postgres-Knoten außer Betrieb nehmen beschrieben außer Betrieb.

Wenn Sie das Update später rückgängig machen möchten, verwenden Sie das Verfahren unter 4.17.09 Rollback-Prozess.

Verfahren für die Aktualisierung auf 4.17.09 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 das Update über ein lokales Repository oder einen Mirror des Apigee-Repositories ausführen.

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

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

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

  1. Wenn Sie derzeit die Postgres-Master-Standby-Replikation verwenden, installieren Sie einen neuen Postgres-Standbyknoten wie oben im Abschnitt Neuen Postgres-Standbyknoten installieren beschrieben.
  2. Erstellen Sie ein lokales 4.17.09-Repository, wie unter Installieren Sie das Hilfsprogramm für das Edge-Apigee-Setup unter „Create a local Apigee repository“ (Lokales Apigee-Repository erstellen) beschrieben.
    Hinweis: Wenn Sie bereits ein Repository für 4.16.01 oder 4.16.05 haben, können Sie das Repository für 4.17.09 hinzufügen. Eine entsprechende Anleitung finden Sie unter Edge-Apigee-Setup-Dienstprogramm installieren im Abschnitt „Lokales Apigee-Repository aktualisieren“.
  3. So installieren Sie apigee-service aus einer .tar-Datei:
    1. Verpacken Sie das lokale Repository auf dem Knoten mit dem lokalen Repository mit dem folgenden Befehl in einer einzelnen TAR-Datei mit dem Namen /opt/apigee/data/apigee-mirror/apigee-4.17.09.tar.gz:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
    2. Kopieren Sie die .tar-Datei auf den Knoten, auf dem Sie Edge aktualisieren möchten. Kopieren Sie ihn beispielsweise in das Verzeichnis /tmp auf dem neuen Knoten.
    3. Entpacken Sie die Datei auf dem neuen Knoten im Verzeichnis „/tmp“:
      > tar -xzf apigee-4.17.09.tar.gz

      Mit diesem Befehl wird im Verzeichnis mit der .tar-Datei ein neues Verzeichnis mit dem Namen „repos“ erstellt. Beispiel: /tmp/repos.
    4. Installieren Sie das Edge-Apigee-Dienst-Dienstprogramm und die Abhängigkeiten unter /tmp/repos:
      > sudo bash /tmp/repos/bootstrap_4.17.09.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

      Beachten Sie, dass Sie in diesem Befehl den Pfad zum Verzeichnis „repos“ angeben.
  4. So installieren Sie den Apigee-Dienst mit dem Nginx-Webserver:
    1. Konfigurieren Sie den Nginx-Webserver wie unter Installieren Sie das Hilfsprogramm für das Edge-Apigee-Setup unter „Über den Nginx-Webserver aus dem Repository installieren“ beschrieben.
    2. Laden Sie auf dem Remote-Knoten die Edge-Datei bootstrap_4.17.09.sh in /tmp/bootstrap_4.17.09.sh herunter:
      > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh

      wobei uName:pWord der Nutzername und das Passwort sind, die Sie oben für das Repository festgelegt haben, und remoteRepo die IP-Adresse oder der DNS-Name des Repository-Knotens.
    3. Installieren Sie auf dem Remote-Knoten das Edge-Apigee-Service-Dienstprogramm und die Abhängigkeiten:
      > sudo bash /tmp/bootstrap_4.17.09.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

      Word:der Nutzername und das Passwort .
  5. Verwenden Sie apigee-service, um das Dienstprogramm „apigee-setup“ zu aktualisieren:
    1. Wenn Sie 4.16.01 durch ein Upgrade der Edge-Version 4.15.07.0x installiert haben, müssen Sie das Hilfsprogramm „apigee-setup“ installieren:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install

      Mit diesem Befehl wird das Dienstprogramm update.sh unter /opt/apigee/apigee-setup/bin installiert.

      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, also kein Upgrade von 4.15.07.0x durchgeführt haben, müssen Sie das Dienstprogramm „apigee-setup“ aktualisieren:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

      Durch dieses Update von apigee-service wird das Dienstprogramm update.sh in /opt/apigee/apigee-setup/bin installiert.
    3. Wenn Sie 4.16.05 direkt oder durch ein Update installiert haben, 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 update.sh in /opt/apigee/apigee-setup/bin.
  6. Je nach aktueller Edge-Version müssen Sie das Dienstprogramm apigee-validate auf dem Verwaltungsserver entweder installieren oder aktualisieren.
    1. Wenn Sie derzeit Edge 4.16.05 verwenden: Aktualisieren Sie das Dienstprogramm apigee-validate auf dem Verwaltungsserver:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
    2. Wenn Sie derzeit Edge 4.16.01 verwenden: Installieren Sie das Dienstprogramm „apigee-validate“ auf dem Verwaltungsserver:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-validate install

      Hinweis: Wenn Sie das Dienstprogramm apigee-validate bei der Installation von 4.16.01 auf einem Message Processor-Knoten installiert haben, können Sie es mit dem folgenden Befehl auf diesem Knoten aktualisieren:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update

      Ab Version 4.16.05 empfiehlt Apigee jedoch, das Dienstprogramm „apigee-validate“ auf dem Verwaltungsserver zu installieren und auszuführen.
    3. Wenn Sie ein Upgrade von 4.16.01 ausführen: Bearbeiten Sie die Konfigurationsdatei, die an das Dienstprogramm apigee-validate übergeben wird. Im Edge-Release 4.16.01 benötigte die von apigee-valid verwendete Konfigurationsdatei die folgenden Attribute:
      APIGEE_ADMINPW=sysAdminPword
      MP_POD=gateway
      REGION=dc-1

      In diesem Release erfordert die Konfigurationsdatei nur das Attribut APIGEE_ADMINPW. Sie können die anderen beiden Properties 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 Update-Dienstprogramm auf Ihren Knoten in der unten unter „Reihenfolge der Aktualisierung des Computers“ beschriebenen Reihenfolge aus:
    > /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

    Die einzige Anforderung an die Konfigurationsdatei ist, dass der Nutzer „apigee“ darauf zugreifen oder sie lesen kann.

    Mit der Option „-c“ können Sie die zu aktualisierende Komponente angeben.











    ldap
  9. Testen Sie das Update, indem Sie das Dienstprogramm „apigee-validate“ auf dem Verwaltungsserver ausführen, wie unter Installation testen beschrieben.
  10. Wenn Sie einen neuen Postgres-Standbyknoten installiert haben, stellen Sie ihn wie oben unter Postgres-Knoten außer Betrieb nehmen beschrieben außer Betrieb.

Wenn Sie das Update später rückgängig machen möchten, verwenden Sie das Verfahren unter 4.17.09 Rollback-Prozess.

Reihenfolge der Maschinenaktualisierung

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

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

Für eine eigenständige Installation mit einem Host

  1. Legen Sie SMTPMAILFROM in Ihrer Konfigurationsdatei fest, wenn Sie SMTP in Edge aktiviert haben. Dieser Parameter hat das folgende Format:
    SMTPMAILFROM="Mein Unternehmen<myco@company.com>"
  2. Wenn Sie von 4.16.01 aktualisieren, führen Sie ein Downgrade von Zookeeper aus:
    > yum-Downgrade apigee-zookeeper
  3. Aktualisieren Sie Cassandra und ZooKeeper:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  4. Legen Sie die folgende iptables-Regel fest:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
  5. Prüfen Sie die Qpid-Nachrichtenwarteschlange:
    > qpid-stat -q

    Prüfen Sie die Warteschlange so lange, bis die Anzahl in der Spalte „msg“ 0 ist. Sie können das Upgrade für Qpid erst durchführen, wenn alle Nachrichten verarbeitet wurden.
  6. qpidd aktualisieren:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. iptables löschen:
    > sudo iptables -F
  8. LDAP aktualisieren:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  9. 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
  10. Postgresql aktualisieren:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  11. Aktualisieren Sie die Postgres-Datenbank:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
  12. Aktualisieren Sie die verbleibenden Edge-Komponenten:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  13. Edge-Benutzeroberfläche aktualisieren:
    > /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. Legen Sie SMTPMAILFROM in Ihrer Konfigurationsdatei fest, wenn Sie SMTP in Edge aktiviert haben. Dieser Parameter hat das folgende Format:
    SMTPMAILFROM="Mein Unternehmen<myco@company.com>"
  2. Wenn Sie von 4.16.01 aktualisieren, führen Sie ein Downgrade von Zookeeper auf Computer 1 aus:
    > yum downgrade apigee-zookeeper
  3. Aktualisieren Sie Cassandra und ZooKeeper auf Computer 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  4. Legen Sie auf Computer 2 die folgende iptables-Regel 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 2:
    > qpid-stat -q

    Prüfen Sie die Warteschlange so lange, bis in der Spalte „msg“ der Wert 0 angezeigt wird. Sie können Qpid erst aktualisieren, wenn alle Nachrichten verarbeitet wurden.
  6. Aktualisieren Sie qpidd auf Maschine 2:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. Leeren Sie iptables auf Maschine 2:
    > sudo iptables -F
  8. Aktualisieren Sie LDAP auf Computer 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  9. Edge-Komponenten auf Computer 1 aktualisieren:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  10. UI auf Computer 1 aktualisieren:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  11. PostgreSQL auf Computer 2 aktualisieren:
    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. PostgreSQL aktualisieren:
      > /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. Edge-Komponenten auf Computer 2 und Computer 1 aktualisieren:
      > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  12. Edge-Komponenten auf Computer 2 aktualisieren:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

Für eine Cluster-Installation mit 5 Hosts

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

  1. Legen Sie SMTPMAILFROM in Ihrer Konfigurationsdatei fest, wenn Sie SMTP on Edge aktiviert haben. Dieser Parameter hat das folgende Format:
    SMTPMAILFROM="Mein Unternehmen<myco@company.com>"
  2. Prüfen Sie, ob Sie einen neuen Postgres-Standby-Knoten installiert haben, wie oben unter Neuen Postgres-Standby-Knoten installieren beschrieben.
  3. Wenn Sie von 4.16.01 aktualisieren, führen Sie ein Downgrade von Zookeeper auf den Maschinen 1, 2 und 3 aus:
    > yum downgrade apigee-zookeeper
  4. Aktualisieren Sie Cassandra und ZooKeeper auf Rechner 1, 2 und 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  5. Legen Sie auf Computer 4 die folgende iptables-Regel fest:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
  6. Prüfen Sie die Qpid-Nachrichtenwarteschlange auf Computer 4:
    > qpid-stat -q

    Prüfen Sie die Warteschlange so lange, bis die Anzahl in der Spalte „msg“ 0 ist. Sie können Qpid erst aktualisieren, wenn alle Nachrichten verarbeitet wurden.
  7. Aktualisieren Sie qpidd auf Maschine 4:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. iptables auf Computer 4 leeren:
    > sudo iptables -F
  9. Wiederholen Sie die Schritte 5 bis 8 auf Computer 5.
  10. Aktualisieren Sie LDAP auf Computer 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  11. Edge-Komponenten auf Computer 1, 2 und 3 aktualisieren:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  12. UI auf Computer 1 aktualisieren:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  13. Aktualisieren Sie Maschinen 4 und 5:
    1. Stoppen 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. Stoppen 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-resql
    3. Beenden Sie den Postgres-Server und postgresql auf dem neuen Standby-Knoten, den Sie für das Rollback hinzugefügt haben:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    4. Aktualisieren Sie Postgresql auf Maschinen 4:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    5. Aktualisieren Sie die PostgreSQL-Datenbank auf Maschine 4 (nur PostgreSQL-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
    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 Scripts 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 dem Computer 4, dem Masterknoten, Folgendes aus:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

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

      Auf Computer 5, dem Standby-Knoten:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      Prüfen Sie, ob der Standby-Knoten angezeigt wird.
  14. Aktualisieren Sie die Edge-Komponenten auf Maschine 4, 5:
    > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  15. Stellen Sie den neuen Standby-Knoten außer Betrieb. Folgen Sie dazu der Anleitung unter Knoten aus einem Postgres-Cluster entfernen.

Für eine Clusterinstallation mit 9 Hosts

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

  1. Legen Sie SMTPMAILFROM in Ihrer Konfigurationsdatei fest, wenn Sie SMTP on Edge aktiviert haben. Dieser Parameter hat das folgende Format:
    SMTPMAILFROM="Mein Unternehmen<myco@company.com>"
  2. Sie müssen einen neuen Postgres-Standbyknoten wie oben unter Neuen Postgres-Standbyknoten installieren beschrieben installiert haben.
  3. Wenn Sie von 4.16.01 aktualisieren, führen Sie ein Downgrade von Zookeeper auf Macine 1, 2 und 3 durch:
    > yum-Downgrade apigee-zookeeper
  4. Aktualisieren Sie Cassandra und ZooKeeper auf den Maschinen 1, 2 und 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  5. Legen Sie auf Computer 6 die folgende iptables-Regel fest:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
  6. Prüfen Sie die Qpid-Nachrichtenwarteschlange auf Computer 6:
    > qpid-stat -q

    Prüfen Sie die Warteschlange so lange, bis die Anzahl in der Spalte „msg“ 0 ist. Sie können Qpid erst aktualisieren, wenn alle Nachrichten verarbeitet wurden.
  7. Aktualisieren Sie qpidd auf Computer 6:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. Iptables auf Computer 6 leeren:
    > sudo iptables -F
  9. Wiederholen Sie die Schritte 5 bis 8 auf Computer 7.
  10. LDAP auf Computer 1 aktualisieren:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  11. Aktualisieren Sie die Edge-Komponenten auf den Maschinen 6, 7, 1, 4 und 5 in dieser Reihenfolge:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  12. UI auf Computer 1 aktualisieren:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  13. Computer 8 und 9 aktualisieren:
    1. Postgres-Server auf Computer 8 beenden:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. Beenden Sie den Postgres-Server und postgresql auf Computer 9:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. Beenden Sie den Qpid-Server auf den Maschinen 6 und 7:
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    4. Beenden Sie den Postgres-Server und postgresql auf dem neuen Standby-Knoten, den Sie für das Rollback hinzugefügt haben:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    5. PostgreSQL auf Maschinen 8 aktualisieren:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. Aktualisieren Sie die PostgreSQL-Datenbank auf Computer 8 (nur PostgreSQL-Master):
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. PostgreSQL auf Computer 9 aktualisieren:
      > /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 Maschinen 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 Computer 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. Überprüfen Sie den Replikationsstatus, indem Sie die folgenden Skripts auf beiden Servern ausgeben. Das System sollte identische Ergebnisse auf beiden Servern anzeigen, um eine erfolgreiche Replikation zu gewährleisten:
      Führen Sie auf dem Computer 8, dem Masterknoten, Folgendes aus:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

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

      Auf Computer 9, dem Standby-Knoten:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      Prüfen Sie, ob der Standby-Knoten angezeigt wird.
  14. Aktualisieren Sie die Edge-Komponenten auf Rechnern 8 und 9:
    > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  15. Achten Sie darauf, 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 Clusterinstallation mit 13 Hosts

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

  1. Legen Sie SMTPMAILFROM in Ihrer Konfigurationsdatei fest, wenn Sie SMTP in Edge aktiviert haben. Dieser Parameter hat das folgende Format:
    SMTPMAILFROM="Mein Unternehmen<myco@company.com>"
  2. Sie müssen einen neuen Postgres-Standbyknoten wie oben unter Neuen Postgres-Standbyknoten installieren beschrieben installiert haben.
  3. Wenn Sie von 4.16.01 aktualisieren, führen Sie ein Downgrade von Zookeeper auf den Maschinen 1, 2 und 3 aus:
    > yum downgrade apigee-zookeeper
  4. Aktualisieren Sie Cassandra und ZooKeeper auf den Maschinen 1, 2 und 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  5. Legen Sie auf Computer 12 die folgende iptables-Regel fest:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
  6. Prüfen Sie die Qpid-Nachrichtenwarteschlange auf Computer 12:
    > qpid-stat -q

    Prüfen Sie die Warteschlange so lange, bis in der Spalte „msg“ der Wert 0 angezeigt wird. Sie können das Upgrade für Qpid erst durchführen, wenn alle Nachrichten verarbeitet wurden.
  7. Aktualisieren Sie qpidd auf Maschine 12:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. Leeren Sie iptables auf Maschine 12:
    > sudo iptables -F
  9. Wiederholen Sie die Schritte 5 bis 8 auf Computer 13.
  10. Aktualisieren Sie LDAP auf Geräten 4 und 5:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  11. Aktualisieren Sie die Edge-Komponenten auf den Maschinen 12, 13, 6, 7, 10 und 11 in dieser Reihenfolge:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  12. Aktualisieren Sie die Benutzeroberfläche auf Rechnern 6 und 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  13. Computer 8 und 9 aktualisieren:
    1. Postgres-Server auf Computer 8 beenden:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. Beenden Sie den Postgres-Server und postgresql auf Computer 9:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. Beenden Sie den Qpid-Server auf den Maschinen 12 und 13:
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    4. Beenden Sie den Postgres-Server und postgresql auf dem neuen Standby-Knoten, den Sie für das Rollback hinzugefügt haben:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    5. PostgreSQL auf Maschinen 8 aktualisieren:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. Aktualisieren Sie die PostgreSQL-Datenbank auf Computer 8 (nur PostgreSQL-Master):
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. PostgreSQL auf Computer 9 aktualisieren:
      > /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 Maschinen 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 Computer 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. Überprüfen Sie den Replikationsstatus, indem Sie die folgenden Skripts auf beiden Servern ausgeben. Das System sollte identische Ergebnisse auf beiden Servern anzeigen, um eine erfolgreiche Replikation zu gewährleisten:
      Führen Sie auf dem Computer 8, dem Masterknoten, Folgendes aus:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

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

      Auf Computer 9, dem Standby-Knoten:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      Prüfen Sie, ob der Standby-Knoten angezeigt wird.
  14. Edge-Komponenten auf Computer 8 und 9 aktualisieren:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  15. Stellen Sie den neuen Standby-Knoten außer Betrieb. Folgen Sie dazu der Anleitung unter Knoten aus einem Postgres-Cluster entfernen.

Für eine Clusterinstallation mit 12 Hosts

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

  1. Legen Sie SMTPMAILFROM in Ihrer Konfigurationsdatei fest, wenn Sie SMTP in Edge aktiviert haben. Dieser Parameter hat das folgende Format:
    SMTPMAILFROM="Mein Unternehmen<myco@company.com>"
  2. Sie müssen einen neuen Postgres-Standbyknoten wie oben unter Neuen Postgres-Standbyknoten installieren beschrieben installiert haben.
  3. Aktualisieren Sie Cassandra und ZooKeeper:
    1. Bei der Aktualisierung von 4.16.01 führen Sie ein Downgrade von Zookeeper auf den Maschinen 1, 2 und 3 im Rechenzentrum 1 durch:
      > yum downgrade apigee-zookeeper
    2. Auf den Maschinen 1, 2 und 3 im Rechenzentrum 1:
      > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
    3. Bei der Aktualisierung von 4.16.01 führen Sie ein Downgrade von Zookeeper auf den Maschinen 7, 8 und 9 im Rechenzentrum 2 durch:
      > yum downgrade 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
  4. Aktualisieren Sie qpidd:
    1. Maschinen 4 und 5 in Rechenzentrum 1
      1. Legen Sie auf Computer 4 die folgende iptables-Regel 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 so lange, bis die Anzahl in der Spalte „msg“ 0 ist. Sie können Qpid erst aktualisieren, wenn alle Nachrichten verarbeitet wurden.
      3. Aktualisieren Sie qpidd auf Computer 4:
        > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      4. Leeren Sie iptables auf Maschine 4:
        > sudo iptables -F
      5. Wiederholen Sie die Schritte 1 bis 4 auf Computer 5.
    2. Maschinen 10 und 11 im Rechenzentrum 2
      1. Legen Sie auf Computer 10 die folgende iptables-Regel 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 so lange, bis die Anzahl in der Spalte „msg“ 0 ist. Sie können Qpid erst aktualisieren, wenn alle Nachrichten verarbeitet wurden.
      3. qpidd auf Computer 10 aktualisieren:
        > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      4. Leeren Sie iptables auf Maschine 10:
        > sudo iptables -F
      5. Wiederholen Sie die Schritte 1 bis 4 auf Computer 11.
  5. LDAP aktualisieren:
    1. Maschinen 1 im Rechenzentrum 1
      > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
    2. Maschinen 7 im Rechenzentrum 2
      > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. Aktualisieren Sie die Edge-Komponenten:
    1. Computer 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 und 9 im Rechenzentrum 2
      > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. Benutzeroberfläche aktualisieren:
    1. Maschine 1 in 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
  8. Aktualisieren Sie Maschine 6 in Rechenzentrum 1 und 12 in Rechenzentrum 2:
    1. Postgres-Server auf Computer 6 beenden:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. Postgres-Server und postgresql auf Computer 12 beenden:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. Stoppen Sie den Qpid-Server auf den Maschinen 4, 5, 10 und 11:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server stop
    4. Stoppen Sie den Postgres-Server und Postgresql auf dem neuen Standby-Knoten, den Sie für ein 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 Maschinen 6 aktualisieren:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. Aktualisieren Sie die PostgreSQL-Datenbank auf Computer 6 (nur PostgreSQL-Master):
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. PostgreSQL auf Maschinen 12 aktualisieren:
      > /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 Maschinen 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-Fileservice apigee-postgresql setup-replication-on-standby -f       configFile
    11. Prüfen Sie den Replikationsstatus, indem Sie die folgenden Scripts auf beiden Servern ausführen. Das System sollte identische Ergebnisse auf beiden Servern anzeigen, um eine erfolgreiche Replikation zu gewährleisten:
      Führen Sie auf dem Computer 6, dem Masterknoten, Folgendes aus:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

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

      Auf Computer 12, dem Standby-Knoten:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      Prüfen Sie, ob der Knoten als Standby-Knoten angezeigt wird.
  9. Edge-Komponenten auf Computer 6 und 12 aktualisieren:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  10. Stellen Sie den neuen Standby-Knoten außer Betrieb. Folgen Sie dazu der Anleitung unter Knoten aus einem Postgres-Cluster entfernen.

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

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
  4. LDAP
  5. Edge, d. h. das Profil „-c edge“ auf allen Knoten in der Reihenfolge: Knoten mit Qpid-Server, aber nicht mit Postgres-Server, Verwaltungsserver, Nachrichtenprozessor und Router.
    Hinweis: Wenn auf dem Knoten sowohl ein Qpid- als auch ein Postgres-Server installiert ist, führen Sie im Rahmen von Schritt 8 den Profilschritt „-c edge“ aus.
  6. Edge-Benutzeroberfläche
  7. postgresql auf dem Postgres-Master, einschließlich Upgrade.
  8. postgresql auf dem Postgres-Standby.
  9. Edge, d. h. das Profil „-c edge“ auf allen kombinierten Qpid- und Postgres-Knoten oder auf allen eigenständigen Postgres-Knoten.