Apigee Edge auf 4.16.09 aktualisieren

Edge for Private Cloud Version 4.16.09

Welche Edge-Versionen können auf 4.16.09 aktualisiert werden?

Sie können die Apigee Edge-Version 4.16.01.0x und 4.16.05.x auf 4.16.09 aktualisieren.

Wenn Sie eine Version von Edge vor Version 4.16.01 verwenden, müssen Sie zuerst zu Version 4.16.01.x migrieren und dann auf Version 4.16.09 aktualisieren.

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.

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. Eine vollständige Liste finden Sie im Abschnitt „Standardmäßig deaktivierte Chiffrenfolgen“ unter http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html.

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.

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 haben Sie einen Notfallplan, falls das Update auf eine neue Version nicht richtig 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:

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

Wenn Sie aufgrund des Fehlers das Update auf die vorherige Version zurücksetzen müssen, finden Sie weitere Informationen unter 4.16.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 Postgres 9.4

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

Während die Postgres-Knoten während des Aktualisierungsvorgangs nicht erreichbar sind, werden Analysedaten weiterhin auf 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 Sie das Update rückgängig machen müssen, wird der neue Postgres-Standbyknoten nach dem Rollback zum Postgres-Masterknoten. 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-Standbyknoten installieren

Mit diesem Verfahren wird ein Postgres-Standby-Server auf einem neuen Knoten erstellt. Achten Sie darauf, einen neuen Postgres-Standby-Server für Ihre vorhandene Version von Edge (4.16.01 oder 4.16.05) und nicht für Version 4.16.09 zu installieren.

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. Überprüfen Sie, ob der neue Standby-Knoten hinzugefügt wurde. Rufen Sie dazu die Datei /opt/apigee/apigee-postgresql/conf/pg_hba.conf auf dem Master auf. In dieser Datei sollten die folgenden Zeilen 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 Edge-Datei „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

      Hinweis: Wenn Sie von 4.16.01 aktualisieren, laden Sie die Edge-Datei bootstrap.sh herunter.
    4. Installieren Sie das Edge-Apigee-Dienst-Hilfsprogramm und die Abhängigkeiten:
      > sudo bash /tmp/bootstrap_4.16.05.sh apigeeuser=uName apigeepassword=pWord
    5. Verwenden Sie „apigee-service“, um das Hilfsprogramm „apigee-setup“ zu installieren:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    6. Installieren Sie Postgres:
      > /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
    7. Führen Sie auf dem neuen Standby-Knoten den folgenden Befehl aus:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      Prüfen Sie, ob der Knoten als Standby-Knoten angezeigt wird.

Postgres-Knoten außer Betrieb setzen

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-Master-Knoten /opt/apigee/customer/application/postgresql.properties, um den neuen Standby-Knoten aus conf_pg_hba_replication.connection zu entfernen:
    conf_pg_hba_replication.connection=hostreplikation 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. Überprüfen Sie, ob der neue Standby-Knoten entfernt wurde, indem Sie die Datei /opt/apigee/apigee-postgresql/conf/pg_hba.conf auf dem Master anzeigen. 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.

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

Der Schlüssel zu Upgrades ohne Ausfallzeiten 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 verbleibenden Router.
  6. Setzen Sie das Update für alle verbleibenden Maschinen 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:
    • Stellen Sie vor dem Update sicher, dass der Nachrichten-Prozessor nicht erreichbar ist.
    • Sorgen Sie nach der Aktualisierung 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.

Aktualisierung auf 4.16.09 auf einem Knoten mit externer 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 in Cassandra konfiguriert sind, bis die Aktualisierung abgeschlossen ist.
  3. Melden Sie sich als Root beim 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. Deaktivieren Sie SELinux wie unter Installieren Sie das Hilfsprogramm für das Edge-Apigee-Setup beschrieben.
  5. Laden Sie die Datei bootstrap_4.16.09.sh für Edge 4.16.09 in /tmp/bootstrap_4.16.09.sh herunter:
    > curl https://software.apigee.com/bootstrap_4.16.09.sh -o /tmp/bootstrap_4.16.09.sh
  6. Installieren Sie das Dienstprogramm apigee-service und die Abhängigkeiten für Edge 4.16.09:
    > sudo bash /tmp/bootstrap_4.16.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 wird beim Installationsvorgang geprüft, ob Java 1.8 installiert ist. Andernfalls wird es automatisch installiert. Mit der Option JAVA_FIX können Sie angeben, 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.
  7. 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 <inst_dir>/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 <inst_dir>/apigee/apigee-setup/bin installiert.
    3. Wenn Sie 4.16.05 direkt oder per Update installiert 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 <inst_dir>/apigee/apigee-setup/bin installiert.
  8. 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 Version 4.16.01 ausführen: Bearbeiten Sie die Konfigurationsdatei, die an das Dienstprogramm apigee-valid übergeben wurde. In der Edge-Version 4.16.01 waren für die Konfigurationsdatei, die von apigee-validate verwendet wird, die folgenden Eigenschaften erforderlich:
      APIGEE_ADMINPW=sysAdminPword
      MP_POD=gateway
      REGION=dc-1

      In dieser Version ist für die Konfigurationsdatei nur die Eigenschaft APIGEE_ADMINPW erforderlich. Sie können die anderen beiden Attribute aus der Datei entfernen.
  9. Aktualisieren Sie das Dienstprogramm apigee-provision:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  10. 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.

    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 =Alle Edge-Komponenten mit Ausnahme der Edge-Benutzeroberfläche: Verwaltungsserver, Nachrichtenprozessor, Router, QPID-Server, Postgres-Server
    ui = Edge-Benutzeroberfläche
    all = Alle Komponenten auf dem Computer aktualisieren (nur für ein Edge-aio-Installationsprofil oder ein API BaaS-asa-Installationsprofil verwenden)
    e = ElasticSearch
    b = API BaaS-Stack
    p = API BaaS-Portal
    ebp = ElasticSearch, API BaaS-Stack und API BaaS-Portal auf demselben Knoten
  11. Testen Sie das Update, indem Sie das Dienstprogramm „apigee-validate“ auf dem Verwaltungsserver ausführen, wie unter Installation testen beschrieben.
  12. 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.16.09 Rollback-Vorgang.

Aktualisierung auf 4.16.09 über ein lokales Repository

Wenn sich Ihre Edge-Knoten hinter einer Firewall befinden oder aus einem anderen Grund nicht über das Internet auf das Apigee-Repository zugegriffen werden kann, können Sie die Aktualisierung von einem lokalen Repository oder einem Spiegel des Apigee-Repositorys durchfü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 einen Webserver auf dem Knoten mit dem lokalen Repository, damit andere Knoten darauf zugreifen können. Apigee stellt den Nginx-Webserver zur Verfügung. Sie können aber auch Ihren eigenen Webserver verwenden.

So aktualisieren Sie über ein lokales 4.16.09-Repository:

  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.16.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 vorhandenes 4.16.01- oder 4.16.05-Repository haben, können Sie das 4.16.09-Repository hinzufügen, wie unter „Lokales Apigee-Repository aktualisieren“ unter Edge-Apigee-Setup-Dienstprogramm installieren beschrieben.
  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.16.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.16.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.16.09.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

      Beachten Sie, dass Sie in diesem Befehl den Pfad zum Verzeichnis „repos“ angeben.
  4. So installieren Sie apigee-service mit dem Nginx-Webserver:
    1. Konfigurieren Sie den Nginx-Webserver wie unter 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.16.09.sh“ in /tmp/bootstrap_4.16.09.sh herunter:
      > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.16.09.sh -o /tmp/bootstrap_4.16.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.16.09.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

      Word: apigeeprotocol=http://

  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 <inst_dir>/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 unter <inst_dir>/apigee/apigee-setup/bin installiert.
    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

      Dieses Update von apigee-service installiert das Dienstprogramm update.sh in <inst_dir>/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. In der Edge-Version 4.16.01 waren für die Konfigurationsdatei, die von apigee-validate verwendet wird, die folgenden Eigenschaften erforderlich:
      APIGEE_ADMINPW=sysAdminPword
      MP_POD=gateway
      REGION=dc-1

      In dieser Version ist für die Konfigurationsdatei nur die Eigenschaft APIGEE_ADMINPW erforderlich. 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. Die Liste der möglichen Komponenten umfasst:
    ldap = OpenLDAP
    cs = Cassandra
    zk = Zookeeper
    qpid = qpidd
    ps = postgresql
    edge =Alle Edge-Komponenten mit Ausnahme der Edge-Benutzeroberfläche: Verwaltungsserver, Nachrichtenprozessor, Router, QPID-Server, Postgres-Server
    ui = Edge-Benutzeroberfläche
    all = Alle Komponenten auf dem Computer aktualisieren (nur für ein Edge-aio-Installationsprofil oder ein API BaaS asa-Installationsprofil verwenden)
    e = ElasticSearch
    b = API BaaS-Stack
    p = API BaaS-Portal
    ebp = ElasticSearch, API BaaS-Stack und API BaaS-Portal auf demselben Knoten
  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.16.09 Rollback-Vorgang.

Reihenfolge des Maschinenupdates

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. Wenn Sie von 4.16.01 aktualisieren, führen Sie ein Downgrade von Zookeeper durch:
    > yum-Downgrade apigee-zookeeper
  2. Cassandra und ZooKeeper aktualisieren:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Aktualisieren Sie qpidd:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  4. LDAP aktualisieren:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Postgres Server, Qpid-Server und PostgreSQL beenden:
    > /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
  6. Postgresql aktualisieren:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  7. Aktualisieren Sie die Postgres-Datenbank:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
  8. Aktualisieren Sie die verbleibenden Edge-Komponenten:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  9. Aktualisieren Sie die 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 ausführen, führen Sie ein Downgrade von Zookeeper auf Computer 1 aus:
    > yum downgrade apigee-zookeeper
  2. Cassandra und ZooKeeper auf Computer 1 aktualisieren:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. qpidd auf Computer 2 aktualisieren:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  4. LDAP auf Computer 1 aktualisieren:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Edge-Komponenten auf Computer 1 aktualisieren:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. UI auf Computer 1 aktualisieren:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  7. PostgreSQL auf Computer 2 aktualisieren:
    1. Postgres Server, Qpid-Server und postgresql beenden:
      > /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       apigee-postgresql
    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. Aktualisieren Sie die Edge-Komponenten auf Maschine 2 und Maschine 1:
      > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  8. Aktualisieren Sie die Edge-Komponenten auf Maschine 2:
    > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile

Für eine Clusterinstallation mit 5 Hosts

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

  1. Sie müssen einen neuen Postgres-Standbyknoten wie oben unter Neuen Postgres-Standbyknoten installieren beschrieben installiert haben.
  2. Wenn Sie von 4.16.01 aktualisieren, führen Sie ein Downgrade von Zookeeper auf Computer 1, 2 und 3 aus:
    > yum downgrade apigee-zookeeper
  3. Aktualisieren Sie Cassandra und ZooKeeper auf den Maschinen 1, 2 und 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  4. Aktualisieren Sie qpidd auf Rechner 4 und 5:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. LDAP auf Computer 1 aktualisieren:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. Edge-Komponenten auf Computer 1, 2 und 3 aktualisieren:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. UI auf Computer 1 aktualisieren:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  8. Aktualisieren Sie die 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. Beenden Sie den Postgres-Server, den Qpid-Server und postgresql auf Computer 5:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. Stoppen Sie den Postgres-Server und postgresql auf dem neuen Standby-Knoten, den Sie für Rollback hinzugefügt haben:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    4. PostgreSQL auf Computern 4 aktualisieren:
      > /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. PostgreSQL auf Maschinen 5 aktualisieren:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    7. Starten Sie den Postgres-Server und den Qpid-Server auf den Maschinen 4 und 5:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    8. Konfigurieren Sie Postgres als Standby-Knoten, indem Sie die folgenden Befehle auf Maschine 5 ausführen:
      > cd /opt/apigee/data/apigee-postgresql/pgdata
      > rm -rf *
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f       configFile
    9. Prüfen Sie den Replikationsstatus, indem Sie die folgenden Scripts auf beiden Servern ausführen. Das System sollte auf beiden Servern identische Ergebnisse anzeigen, um eine erfolgreiche Replikation zu ermöglichen:

      Führen Sie auf Computer 4, dem Masterknoten, Folgendes aus:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

      Prüfen Sie, ob der Masterknoten angezeigt wird.

      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.
  9. Edge-Komponenten auf Computer 4 und 5 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 Cluster-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 installiert haben, wie oben unter Neuen Postgres-Standby-Knoten installieren beschrieben.
  2. Wenn Sie von 4.16.01 aktualisieren, führen Sie ein Downgrade von Zookeeper auf Computer 1, 2 und 3 aus:
    > yum downgrade apigee-zookeeper
  3. Aktualisieren Sie Cassandra und ZooKeeper auf den Maschinen 1, 2 und 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  4. Aktualisieren Sie qpidd auf den Maschinen 6 und 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. LDAP auf Computer 1 aktualisieren:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. Aktualisieren Sie die Edge-Komponenten auf den Maschinen 6, 7, 1, 4 und 5 in dieser Reihenfolge:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. UI auf Maschine 1 aktualisieren:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  8. Computer 8 und 9 aktualisieren:
    1. Stoppen Sie den Postgres-Server auf Maschine 8:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
    2. Beenden Sie den Postgres-Server und postgresql auf Computer 9:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. Beenden Sie den Qpid-Server auf den Maschinen 6 und 7:
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    4. 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 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. 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 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.
  9. Edge-Komponenten auf Computer 8 und 9 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 Clusterinstallation mit 13 Hosts

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

  1. Sie müssen einen neuen Postgres-Standbyknoten wie oben unter Neuen Postgres-Standbyknoten installieren beschrieben installiert haben.
  2. Wenn Sie von 4.16.01 aktualisieren, führen Sie ein Downgrade von Zookeeper auf Computer 1, 2 und 3 aus:
    > yum downgrade apigee-zookeeper
  3. Aktualisieren Sie Cassandra und ZooKeeper auf den Maschinen 1, 2 und 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  4. qpidd auf Computer 12 und 13 aktualisieren:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. LDAP auf Computer 4 und 5 aktualisieren:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. 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
  7. Aktualisieren Sie die Benutzeroberfläche auf Rechnern 6 und 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  8. Computer 8 und 9 aktualisieren:
    1. Stoppen Sie den Postgres-Server auf Maschine 8:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
    2. Stoppen Sie den Postgres-Server und postgresql auf Maschine 9:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. Beenden Sie den Qpid-Server auf den 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 den Rollback hinzugefügt haben:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    5. PostgreSQL auf 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. 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 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.
  9. Edge-Komponenten auf Computer 8 und 9 aktualisieren:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  10. 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 12 Hosts

Unter Installationstopologien finden Sie eine Liste der Edge-Topologien und Knotennummern.

  1. Prüfen Sie, ob Sie einen neuen Postgres-Standby-Knoten installiert haben, wie oben unter Neuen Postgres-Standby-Knoten installieren beschrieben.
  2. Aktualisieren Sie Cassandra und ZooKeeper:
    1. Wenn Sie von 4.16.01 aktualisieren, 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. Wenn Sie ein Update von 4.16.01 ausführen, führen Sie ein Downgrade von Zookeeper auf den Maschinen 7, 8 und 9 im Rechenzentrum 2 aus:
      > 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
  3. Aktualisieren Sie qpidd:
    1. Maschinen 4 und 5 im Rechenzentrum 1
      > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
    2. Maschinen 10 und 11 im Rechenzentrum 2
      > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  4. LDAP aktualisieren:
    1. Maschinen 1 im Rechenzentrum 1
      > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
    2. Maschinen 7 im Rechenzentrum 2
      > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Aktualisieren Sie die Edge-Komponenten:
    1. Maschinen 4, 5, 1, 2, 3 in Rechenzentrum 1
      > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
    2. Maschinen 10, 11, 7, 8, 9 in Rechenzentrum 2
      > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  6. Aktualisieren Sie die UI:
    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. Postgres-Server auf Computer 6 beenden:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. Stoppen Sie den Postgres-Server und postgresql auf Maschine 12:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. Qpid-Server auf den Maschinen 4, 5, 10 und 11 beenden:
      > /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. 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. 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 Computer 12 ausführen:
      > cd /opt/apigee/data/apigee-postgresql/pgdata
      > rm -rf *
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f       configFile
    11. Überprüfen Sie den Replikationsstatus, indem Sie die folgenden Skripts auf beiden Servern ausgeben. Das System sollte auf beiden Servern identische Ergebnisse anzeigen, um eine erfolgreiche Replikation zu ermöglichen:
      Führen Sie auf Computer 6, dem Masterknoten, Folgendes aus:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

      Prüfen Sie, ob der Master angezeigt wird.

      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.
  8. Edge-Komponenten auf Computer 6 und 12 aktualisieren:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  9. 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 Hosts

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

  1. Cassandra auf den Maschinen 5, 6 und 7 aktualisieren:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  2. ElasticSearch und API BaaS-Stack auf Computer 1, 2 und 3 aktualisieren:
    > /opt/apigee/apigee-setup/bin/update.sh -c e,b -f configFile
  3. API BaaS-Portal auf Computer 4 aktualisieren:
    > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

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

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

  1. Cassandra auf den Maschinen 8, 9 und 10 aktualisieren:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  2. Aktualisieren Sie ElasticSearch auf Rechner 1, 2 und 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
  3. API BaaS-Stack auf Computer 4, 5 und 6 aktualisieren:
    > /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
  4. Aktualisieren Sie das API-BaaS-Portal auf Maschine 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

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.