Apigee Edge 4.17.0x auf 4.18.01 aktualisieren

Edge for Private Cloud Version 4.18.01

Welche Edge-Versionen können Sie auf 4.18.01 aktualisieren

Mit diesem Verfahren können Sie die Apigee Edge-Version 4.17.0x aktualisieren.

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

Wer kann das Update durchführen?

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

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

Welche Komponenten müssen aktualisiert werden?

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

Kompatibilität aufrechterhalten

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

Property Standort Beschreibung
conf_load_balancing_load.balancing.
  driver.nginx.server.retry		 router.properties Entfernen Sie diese Eigenschaft aus der Datei router.properties. Verwenden Sie zum Festlegen von Wiederholungsoptionen in 4.18.01 die Attribute für die Konfiguration virtueller Hosts.

Automatische Weitergabe von Property-Einstellungen

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

Erforderliches Hinzufügen des Konfigurationsparameters SMTPMAILFROM

Edge 4.17.05 hat der Konfigurationsdatei, die beim Aktivieren eines SMTP-Servers verwendet wird, einen neuen erforderlichen Parameter hinzugefügt. Wenn Sie ein Update von Version 4.17.01 durchführen, müssen Sie beim Aktivieren des SMTP-Servers SMTPMAILFROM in der Konfigurationsdatei festlegen.

In der API-BaaS-Version 4.17.09 wird jetzt auch die Property SMTPMAILFROM unterstützt. Wenn Sie API BaaS von Version 4.17.01 oder 4.17.05 aktualisieren, müssen Sie in der Konfigurationsdatei SMTPMAILFROM festlegen.

Dieser Parameter hat das folgende Format:

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

Erforderliches Upgrade auf Postgres 9.6

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

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

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

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

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

    In einer Installation mit einem und zwei Knoten von Edge haben Topologien, die für Prototyping und Tests verwendet werden, nur einen Postgres-Knoten. Sie können diese Postgres-Knoten direkt aktualisieren, ohne einen neuen Postgres-Knoten erstellen zu müssen.
  • Wenn Sie für Ihre Postgres-Knoten einen Netzwerkspeicher verwenden, wie von Apigee empfohlen, müssen Sie keinen neuen Postgres-Knoten installieren. In den folgenden Verfahren können Sie die Schritte zum Installieren und späteren Außerbetriebnahme eines neuen Postgres-Standby-Knotens überspringen.

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

Neuen Postgres-Standby-Knoten installieren

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

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

So erstellen Sie einen neuen Postgres-Standby-Knoten:

  1. Bearbeiten Sie auf dem aktuellen Postgres-Master die Datei /opt/apigee/customer/application/postgresql.properties, um das folgende Token festzulegen: 
    conf_pg_hba_replication.connection=host replication apigee existing_slave_ip/32
trust\ \nhost replication apigee new_slave_ip/32 trust

    Dabei ist existing_slave_ip die IP-Adresse des aktuellen Postgres-Standby-Servers und new_slave_ip die IP-Adresse des neuen Standby-Knotens.

    Wenn die Datei postgresql.properties nicht vorhanden ist, erstellen Sie sie und verwenden Sie chown, um dem Nutzer apigee wie im folgenden Beispiel Zugriff darauf zu gewähren:

    chown apigee:apigee /opt/apigee/customer/application/postgresql.properties
  2. Starten Sie apigee-postgresql auf dem Postgres-Master neu: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
  3. Prüfen Sie, ob der neue Standby-Knoten hinzugefügt wurde. Sehen Sie sich dazu die Datei /opt/apigee/apigee-postgresql/conf/pg_hba.conf auf dem Master an. Die Datei sollte folgende Zeilen enthalten: 
    host replication apigee existing_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 Ihre aktuelle Version von Edge installiert haben, um Folgendes anzugeben: 
      # IP address of the current master:
PG_MASTER=192.168.56.103
# IP address of the new standby node
PG_STANDBY=192.168.56.102
    2. Deaktivieren Sie SELinux wie unter Edge-Dienstprogramm für Apigee-Einrichtung installieren beschrieben.
    3. Laden Sie die Datei Edge bootstrap_4.17.0x.sh (wobei 4.17.0x 4.17.01, 4.17.05 oder 4.17.09 ist) in /tmp/bootstrap_4.17.0x.sh herunter: 
      curl https://software.apigee.com/bootstrap_4.17.0x.sh -o /tmp/bootstrap_4.17.0x.sh
    4. Installieren Sie das Edge-Dienstprogramm apigee-service und die Abhängigkeiten: 
      sudo bash /tmp/bootstrap_4.17.0x.sh apigeeuser=uName
  apigeepassword=pWord
    5. Verwenden Sie apigee-service, um das apigee-setup-Dienstprogramm zu installieren: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    6. Postgres installieren: 
      /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
    7. Führen Sie auf dem neuen Standby-Server den folgenden Befehl aus: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

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

Postgres-Knoten außer Betrieb nehmen

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

  1. Achten Sie darauf, dass Postgres ausgeführt wird:
    > /opt/apigee/apigee-service/bin/apigee-all-Status

    Wenn Postgres nicht ausgeführt wird, starten Sie es:
    > /opt/apigee/apigee-service/bin/apigee-all start
  2. Rufen Sie die UUID des neuen Standby-Knotens ab. Führen Sie dazu den folgenden cURL-Befehl auf dem neuen Standby-Knoten aus:
    > curl -u sysAdminEmail:password http://<node_IP>:8084/v1/servers/self

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

  3. Beenden Sie den neuen Standby-Knoten, indem Sie den folgenden Befehl auf dem neuen Standby-Knoten ausführen:
    > /opt/apigee/apigee-service/bin/apigee-all stop
  4. Bearbeiten Sie auf dem Postgres-Master-Knoten /opt/apigee/customer/application/postgresql.properties, um den neuen Standby-Knoten aus /opt/apigee/customer/application/postgresql.properties zu entfernen:
    /opt/apigee/customer/application/postgresql.properties
  5. Starten Sie apigee-postgresql auf dem Postgres-Master neu:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql Neustart
  6. Prüfen Sie, ob der neue Standby-Knoten entfernt wurde. Rufen Sie dazu die Datei /opt/apigee/apigee-postgresql/conf/pg_hba.conf auf dem Master auf. In dieser Datei sollte nur die folgende Zeile angezeigt werden:
    Hostreplikation Apigee existing_slave_ip/32 trust
  7. Löschen Sie die UUID des Standby-Knotens aus ZooKeeper. Dazu führen Sie den folgenden Edge-Management-API-Aufruf auf dem Management Server-Knoten aus:
    > curl -u sysAdminEmail:password -X DELETE http://<ms_IP>:8080/v1/servers/<new_slave_uuid>

Voraussetzungen für Updates

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

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

    So haben Sie einen Sicherungsplan für den Fall, dass das Update auf eine neue Version nicht ordnungsgemäß funktioniert. Weitere Informationen zur Sicherung finden Sie unter Sichern und Wiederherstellen.
  • Achten Sie darauf, dass Edge ausgeführt wird
    Stellen Sie sicher, dass Edge während des Aktualisierungsprozesses ausgeführt wird. Verwenden Sie dazu den folgenden Befehl:

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

Umgang mit einer fehlgeschlagenen Aktualisierung

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

Wenn der Fehler ein Rollback des Updates auf die vorherige Version erfordert, finden Sie weitere Informationen unter 4.18.01 Rollback-Prozess.

Informationen zum Logging-Update

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

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

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

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

Update ohne Ausfallzeiten

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

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

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

  1. Aktualisieren Sie die Maschinen in der richtigen Reihenfolge für Ihre Installation, wie unten unter „Reihenfolge des Maschinenupdates“ beschrieben.
  2. Wenn es an der Zeit ist, die Router zu aktualisieren, wählen Sie einen beliebigen Router aus und machen Sie ihn unerreichbar, wie unter Erreichbarkeit des Servers (Message Processor/Router) aktivieren/deaktivieren beschrieben.
  3. Aktualisieren Sie den ausgewählten Router und alle anderen Edge-Komponenten auf demselben Computer wie der Router. Alle Edge-Konfigurationen zeigen einen Router und einen Message Processor auf demselben Knoten an.
  4. Machen Sie den Router wieder erreichbar.
  5. Wiederholen Sie die Schritte 2 bis 4 für die verbleibenden Router.
  6. Fahren Sie für alle in Ihrer Installation verbleibenden Maschinen fort.

Beachten Sie vor/nach dem Update Folgendes:

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

Konfigurationsdatei im Hintergrund verwenden

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

Verfahren zum Aktualisieren auf 4.18.01 auf einem Knoten mit einer externen Internetverbindung

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

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

    Wenn Sie Netzwerkspeicher verwenden, müssen Sie den neuen Knoten nicht installieren. Erstellen Sie stattdessen einen Netzwerk-Snapshot des von Postgres verwendeten Datenspeichers. Weitere Informationen finden Sie unter Erforderliches Upgrade auf Postgres 9.6.
  2. Deaktivieren Sie gegebenenfalls alle CRON-Jobs, die für die Durchführung eines Reparaturvorgangs für Cassandra konfiguriert sind, bis die Aktualisierung abgeschlossen ist.
  3. Melden Sie sich bei Ihrem Knoten als Root an, um die Edge-RPMs zu installieren.
    Hinweis: Für die RPM-Installation ist Root-Zugriff erforderlich. Sie können die Edge-Konfiguration aber auch ohne Root-Zugriff durchführen.
  4. Installieren Sie yum-utils und yum-plugin-priorities:
    > sudo yum install yum-utils
    > sudo yum install yum-plugin-priorities
  5. Deaktivieren Sie SELinux wie unter Das Edge-Dienstprogramm für die Apigee-Einrichtung installieren beschrieben.
  6. Wenn Sie die Installation auf Oracle 7.x ausführen, führen Sie den folgenden Befehl aus:
    > sudo yum-config-manager --enable ol7_optional_latest
  7. Bei der Installation auf AWS führen Sie die folgenden yum-configure-manager-Befehle aus:
    > yum update rh-amazon-rhui-client.noarch
    > sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
  8. Laden Sie die Edge 4.18.01-Datei bootstrap_4.18.01.sh in /tmp/bootstrap_4.18.01.sh herunter:
    > curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
  9. Installieren Sie das Edge 4.18.01-Dienstprogramm apigee-service und Abhängigkeiten:
    > sudo bash /tmp/bootstrap_4.18.01.sh apigeeuser=uName apigeepassword=pWord


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

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

    I = Install OpenJDK 1.8 (Standard)
    C = Weiter ohne Java-Installation
    Q = Beenden. Dazu müssen Sie Java selbst installieren.
  10. Verwenden Sie apigee-service, um das Dienstprogramm apigee-setup zu aktualisieren:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  11. Aktualisieren Sie das Dienstprogramm apigee-validate auf dem Management Server:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  12. Aktualisieren Sie das Dienstprogramm apigee-provision:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  13. Führen Sie das Update-Dienstprogramm auf Ihren Knoten in der unten unter Reihenfolge der Maschinenaktualisierung beschriebenen Reihenfolge aus:
    > /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

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

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





  14. Testen Sie die Aktualisierung, indem Sie das Dienstprogramm apigee-validate auf dem Verwaltungsserver ausführen, wie unter Installation testen beschrieben.
  15. Wenn Sie einen neuen Postgres-Standby-Knoten installiert haben, außer Betrieb nehmen, wie oben unter Postgres-Knoten außer Betrieb nehmen beschrieben.

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

Für ein späteres Rollback der Aktualisierung folgen Sie dem unter 4.18.01 Rollback-Prozess beschriebenen Verfahren.

Verfahren zur Aktualisierung auf 4.18.01 von einem lokalen Repository

Wenn sich Ihre Edge-Knoten hinter einer Firewall befinden oder auf andere Weise nicht über das Internet auf das Apigee-Repository zugreifen können, können Sie die Aktualisierung über ein lokales Repository oder einen Spiegel des Apigee-Repositorys durchführen.

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

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

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

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

    Wenn Sie Netzwerkspeicher verwenden, müssen Sie den neuen Knoten nicht installieren. Erstellen Sie stattdessen einen Netzwerk-Snapshot des von Postgres verwendeten Datenspeichers. Weitere Informationen finden Sie unter Erforderliches Upgrade auf Postgres 9.6.
  2. Erstellen Sie ein lokales 4.18.01-Repository, wie in „Lokales Apigee-Repository erstellen“ unter Dienstprogramm für Edge-Apigee-Setup installieren beschrieben.
    Hinweis: Wenn Sie bereits ein 4.17.0x-Repository haben, können Sie das 4.18.01-Repository hinzufügen, wie unter „Lokales Apigee-Repository aktualisieren“ unter Das Edge-Dienstprogramm für Apigee-Einrichtung installieren beschrieben.
  3. So installieren Sie den Apigee-Dienst aus einer TAR-Datei:
    1. Verwenden Sie auf dem Knoten mit dem lokalen Repository den folgenden Befehl, um das lokale Repository in eine einzelne TAR-Datei mit dem Namen /opt/apigee/data/apigee-mirror/apigee-4.18.01.tar.gz zu verpacken:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror-Paket
    2. Kopieren Sie die TAR-Datei auf den Knoten, in dem Sie Edge aktualisieren möchten. Kopieren Sie ihn beispielsweise in das Verzeichnis /tmp auf dem neuen Knoten.
    3. Entpacken Sie die Datei auf dem neuen Knoten im Verzeichnis /tmp:
      > tar -xzf apigee-4.18.01.tar.gz

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

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

    3. Installieren Sie auf dem Remote-Knoten das Dienstprogramm Edge Apigee-Dienst und die Abhängigkeiten:
      > sudo bash /tmp/bootstrap_4.18.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeepassword=pWord apigeeprotocol=http://
      sind
      . Dabei sind ApigeeuName:
      .
  5. Verwenden Sie apigee-service, um das Dienstprogramm apigee-setup zu aktualisieren:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  6. Aktualisieren Sie das Dienstprogramm apigee-validate auf dem Management Server.
    > /opt/apigee/apigee-service/bin/apigee-service, apigee-validate, Update
  7. Aktualisieren Sie das Dienstprogramm apigee-provision:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  8. Führen Sie das Aktualisierungsdienstprogramm auf Ihren Knoten in der unten unter „Reihenfolge der Maschinenaktualisierung“ beschriebenen Reihenfolge aus:
    > /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

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

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





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

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

Für ein späteres Rollback der Aktualisierung folgen Sie dem unter 4.18.01 Rollback-Prozess beschriebenen Verfahren.

Reihenfolge des Maschinenupdates

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

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

Für eine eigenständige Installation mit einem Host

  1. Wenn Sie ein Update von Version 4.17.01 durchführen, legen Sie SMTPMAILFROM in Ihrer Konfigurationsdatei fest, wenn Sie SMTP on Edge aktiviert haben. Dieser Parameter hat das Format:
    SMTPMAILFROM="Mein Unternehmen <myco@company.com>"
  2. Aktualisieren Sie Cassandra und ZooKeeper:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Qpid aktualisieren:
    > /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. Beenden Sie Postgres Server, Qpid-Server und PostgreSQL:
    > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
    > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server stop
    > /opt/apigee/apigee-service/bin/apigee-service, apigee-postgresql stop, anhalten
  6. Aktualisieren Sie postgresql:
    > /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 -cedge -f configFile
  9. Aktualisieren der Edge-Benutzeroberfläche:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

Für eine eigenständige Installation mit zwei Hosts

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

  1. Wenn Sie ein Update von Version 4.17.01 durchführen, legen Sie SMTPMAILFROM in Ihrer Konfigurationsdatei fest, wenn Sie SMTP on Edge aktiviert haben. Dieser Parameter hat das Format:
    SMTPMAILFROM="Mein Unternehmen <myco@company.com>"
  2. Aktualisieren Sie Cassandra und ZooKeeper auf Maschine 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Aktualisieren Sie Qpid auf Maschine 2:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  4. Aktualisieren Sie LDAP auf Maschine 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Aktualisieren Sie Edge-Komponenten auf Maschine 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  6. Aktualisieren der UI auf Maschine 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  7. Aktualisieren Sie postgresql auf Computer 2:
    1. Beenden Sie Postgres Server, Qpid Server und postgresql:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server stop
      > /opt/apigee/apigee-service/bin/apigee-service, apigee/apigee-service/bin/apigee-service, apigee-postgre stop, angehalten
    2. Aktualisieren Sie postgresql:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    3. Aktualisieren Sie die Postgres-Datenbank:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    4. Aktualisieren Sie Edge-Komponenten auf Maschine 2:
      > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile

Für eine geclusterte Installation mit 5 Hosts

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

  1. Wenn Sie ein Update von Version 4.17.01 durchführen, legen Sie SMTPMAILFROM in Ihrer Konfigurationsdatei fest, wenn Sie SMTP on Edge aktiviert haben. Dieser Parameter hat das 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.

    Wenn Sie Netzwerkspeicher verwenden, müssen Sie den neuen Knoten nicht installieren. Erstellen Sie stattdessen einen Netzwerk-Snapshot des von Postgres verwendeten Datenspeichers. Weitere Informationen finden Sie unter Erforderliches Upgrade auf Postgres 9.6.
  3. Aktualisieren Sie Cassandra und ZooKeeper auf Maschinen 1, 2 und 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  4. Aktualisieren Sie Qpid auf Maschine 4 und 5:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. Aktualisieren Sie LDAP auf Maschine 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. Aktualisieren Sie Edge-Komponenten auf Maschine 1, 2, 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  7. Aktualisieren der UI auf Maschine 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  8. ??Aktualisieren Sie Maschinen 4 und 5:
    1. Beenden Sie den Postgres-Server und den Qpid-Server auf Maschine 4:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-Postgres-Server stop
      > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server stopp
    2. Beenden Sie Postgres-Server, Qpid-Server und Postgresql auf Maschine 5:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server stop
      > /opt/apigee/apigee-service/bin/apigee-service stop-sql-Dienst stoppen
    3. Wenn installiert, beenden Sie den Postgres-Server und postgresql auf dem neuen Stand-by-Knoten, den Sie für das Rollback hinzugefügt haben:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service, apigee-postgresql stop, beendet
    4. Aktualisieren Sie postgresql auf Maschinen 4:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    5. Aktualisieren Sie die Postgres-Datenbank auf Maschine 4 (nur Postgres-Master):
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    6. Aktualisieren Sie postgresql auf Maschinen 5:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    7. Starten Sie den Postgres-Server und den Qpid-Server auf den Maschinen 4 und 5:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-Postgres-server start
      > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server start, start
    8. Konfigurieren Sie Postgres als Standby-Knoten, indem Sie die folgenden Befehle auf Maschine 5 ausführen:
      > cd /opt/apigee/data/apigee-postgresql/pgdata
      > rm -rf *
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql-setup-replication-on-standby -f       configFile
    9. Überprüfen Sie den Replikationsstatus, indem Sie die folgenden Skripts auf beiden Servern ausführen. Das System sollte auf beiden Servern identische Ergebnisse anzeigen, um eine erfolgreiche Replikation zu gewährleisten:

      Führen Sie auf der Maschine 4 den Masterknoten aus:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

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

      Auf Maschine 5:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      Prüfen Sie, ob es sich um den Standby-Knoten handelt.
  9. Aktualisieren Sie Edge-Komponenten auf Maschine 4, 5:
    > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  10. Achten Sie darauf, den neuen Stand-by-Knoten wie oben unter Postgres-Knoten außer Betrieb nehmen beschrieben außer Betrieb zu nehmen.

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

Für eine geclusterte Installation mit 9 Hosts

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

  1. Wenn Sie ein Update von Version 4.17.01 durchführen, legen Sie SMTPMAILFROM in Ihrer Konfigurationsdatei fest, wenn Sie SMTP on Edge aktiviert haben. Dieser Parameter hat das 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.

    Wenn Sie Netzwerkspeicher verwenden, müssen Sie den neuen Knoten nicht installieren. Erstellen Sie stattdessen einen Netzwerk-Snapshot des von Postgres verwendeten Datenspeichers. Weitere Informationen finden Sie unter Erforderliches Upgrade auf Postgres 9.6.
  3. Aktualisieren Sie Cassandra und ZooKeeper auf Maschinen 1, 2 und 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  4. Aktualisieren Sie Qpid auf Maschine 6 und 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. Aktualisieren Sie LDAP auf Maschine 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. Aktualisieren Sie Edge-Komponenten auf den Maschinen 6, 7, 1, 4 und 5 in dieser Reihenfolge:
    > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  7. Aktualisieren Sie die UI auf Maschine 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile?
  8. Aktualisieren Sie die Maschinen 8 und 9:
    1. Beenden Sie den Postgres-Server auf Maschine 8:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
    2. Beenden Sie Postgres-Server und postgresql auf Maschine 9:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql-Stopp
    3. Beenden Sie den Qpid-Server auf den Maschinen 6 und 7:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server stop
    4. Wenn installiert, beenden Sie den Postgres-Server und postgresql auf dem neuen Stand-by-Knoten, den Sie für das Rollback hinzugefügt haben:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service, apigee-postgresql stop, beendet
    5. Aktualisieren Sie postgresql auf Maschinen 8:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. Aktualisieren Sie die Postgres-Datenbank auf Maschine 8 (nur Postgres-Master):
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. Aktualisieren Sie postgresql auf Maschinen 9:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    8. Starten Sie den Postgres-Server auf den Maschinen 8 und 9:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-Postgres-server start
    9. Starten Sie den Qpid-Serverserver auf den Maschinen 6 und 7:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server start
    10. Konfigurieren Sie Postgres als Standby-Knoten. Dazu führen Sie die folgenden Befehle auf Maschine 9 aus:
      > cd /opt/apigee/data/apigee-postgresql/pgdata
      > rm -rf *
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql-setup-replication-on-standby -f       configFile
    11. Überprüfen Sie den Replikationsstatus, indem Sie die folgenden Skripts auf beiden Servern ausführen. Das System sollte auf beiden Servern identische Ergebnisse anzeigen, um eine erfolgreiche Replikation zu gewährleisten:
      Führen Sie auf der Maschine 8 den Masterknoten aus:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

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

      Auf Maschine 9:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      Prüfen Sie, ob es sich um den Standby-Knoten handelt.
  9. Aktualisieren Sie Edge-Komponenten auf Maschine 8 und 9:
    > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  10. Achten Sie darauf, den neuen Stand-by-Knoten wie oben unter Postgres-Knoten außer Betrieb nehmen beschrieben außer Betrieb zu nehmen.

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

Für eine geclusterte Installation mit 13 Hosts

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

  1. Wenn Sie ein Update von Version 4.17.01 durchführen, legen Sie SMTPMAILFROM in Ihrer Konfigurationsdatei fest, wenn Sie SMTP on Edge aktiviert haben. Dieser Parameter hat das 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.

    Wenn Sie Netzwerkspeicher verwenden, müssen Sie den neuen Knoten nicht installieren. Erstellen Sie stattdessen einen Netzwerk-Snapshot des von Postgres verwendeten Datenspeichers. Weitere Informationen finden Sie unter Erforderliches Upgrade auf Postgres 9.6.
  3. Aktualisieren Sie Cassandra und ZooKeeper auf Maschinen 1, 2 und 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  4. Aktualisieren Sie Qpid auf Maschinen 12 und 13:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. Aktualisieren Sie LDAP auf Computer 4 und 5:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. Aktualisieren Sie Edge-Komponenten auf den Maschinen 12, 13, 6, 7, 10 und 11 in dieser Reihenfolge:
    > /opt/apigee/apigee-setup/bin/update.sh -cedge -f configFile
  7. Aktualisieren Sie die UI auf Maschine 6 und 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile??
  8. Aktualisieren Sie die Maschinen 8 und 9:
    1. Beenden Sie den Postgres-Server auf Maschine 8:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
    2. Beenden Sie Postgres-Server und postgresql auf Maschine 9:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql-Stopp
    3. Beenden Sie den Qpid-Server auf den Maschinen 12 und 13:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server stop
    4. Wenn installiert, beenden Sie den Postgres-Server und postgresql auf dem neuen Stand-by-Knoten, den Sie für das Rollback hinzugefügt haben:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service, apigee-postgresql stop, beendet
    5. Aktualisieren Sie postgresql auf Maschinen 8:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. Aktualisieren Sie die Postgres-Datenbank auf Maschine 8 (nur Postgres-Master):
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. Aktualisieren Sie postgresql auf Maschinen 9:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    8. Starten Sie den Postgres-Server auf den Maschinen 8 und 9:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-Postgres-server start
    9. Starten Sie den Qpid-Serverserver auf den Maschinen 12 und 13:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server start
    10. Konfigurieren Sie Postgres als Standby-Knoten. Dazu führen Sie die folgenden Befehle auf Maschine 9 aus:
      > cd /opt/apigee/data/apigee-postgresql/pgdata
      > rm -rf *
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql-setup-replication-on-standby -f       configFile
    11. Überprüfen Sie den Replikationsstatus, indem Sie die folgenden Skripts auf beiden Servern ausführen. Das System sollte auf beiden Servern identische Ergebnisse anzeigen, um eine erfolgreiche Replikation zu gewährleisten:
      Führen Sie auf der Maschine 8 den Masterknoten aus:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

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

      Auf Maschine 9:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      Prüfen Sie, ob es sich um den Standby-Knoten handelt.
  9. Aktualisieren Sie Edge-Komponenten auf Maschine 8 und 9:
    > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile??
  10. Achten Sie darauf, den neuen Stand-by-Knoten wie oben unter Postgres-Knoten außer Betrieb nehmen beschrieben außer Betrieb zu nehmen.

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

Für eine geclusterte Installation mit 12 Hosts

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

  1. Wenn Sie ein Update von Version 4.17.01 durchführen, legen Sie SMTPMAILFROM in Ihrer Konfigurationsdatei fest, wenn Sie SMTP on Edge aktiviert haben. Dieser Parameter hat das 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.

    Wenn Sie Netzwerkspeicher verwenden, müssen Sie den neuen Knoten nicht installieren. Erstellen Sie stattdessen einen Netzwerk-Snapshot des von Postgres verwendeten Datenspeichers. Weitere Informationen finden Sie unter Erforderliches Upgrade auf Postgres 9.6.
  3. Aktualisieren Sie Cassandra und ZooKeeper:
    1. Auf Maschinen 1, 2 und 3 im Rechenzentrum 1:
      > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
    2. Auf den Maschinen 7, 8 und 9 im Rechenzentrum 2
      > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  4. Aktualisieren Sie qpidd:
    1. Maschinen 4, 5 im Rechenzentrum 1
      1. Aktualisieren Sie qpidd auf Maschine 4:
        > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. Wiederholen Sie Schritt 1 auf Gerät 5.
    2. Maschinen 10, 11 im Rechenzentrum 2
      1. Aktualisieren Sie qpidd auf Maschine 10:
        > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. Wiederholen Sie Schritt 1 auf Gerät 11.
  5. LDAP aktualisieren:
    1. Maschinen 1 in Rechenzentrum 1
      > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
    2. Maschinen 7 im Rechenzentrum 2
      > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. Aktualisieren Sie Edge-Komponenten:
    1. Maschinen 4, 5, 1, 2, 3 im Rechenzentrum 1
      > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
    2. Maschinen 10, 11, 7, 8, 9 im Rechenzentrum 2
      > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  7. UI aktualisieren:
    1. Maschine 1 im Rechenzentrum 1:
      > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
    2. Maschine 7 im Rechenzentrum 2:
      > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  8. ?Aktualisieren Sie Maschine 6 in Rechenzentrum 1 und 12 im Rechenzentrum 2:
    1. Beenden Sie den Postgres-Server auf Maschine 6:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stopp
    2. Beenden Sie Postgres-Server und postgresql auf Maschine 12:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql-Stopp
    3. Beenden Sie den Qpid-Server auf den Maschinen 4, 5, 10 und 11:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server stop
    4. Wenn installiert, beenden Sie den Postgres-Server und postgresql auf dem neuen Stand-by-Knoten, den Sie für das Rollback hinzugefügt haben:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service, apigee-postgresql stop, beendet
    5. Aktualisieren Sie postgresql auf Maschinen 6:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. Aktualisieren Sie die Postgres-Datenbank auf Maschine 6 (nur Postgres-Master):
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. Aktualisieren Sie postgresql auf Maschinen 12:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    8. Starten Sie den Postgres-Serverserver auf den Maschinen 6 und 12:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-Postgres-server start
    9. Starten Sie den Qpid-Serverserver auf den Maschinen 4, 5, 10 und 11:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server start
    10. Konfigurieren Sie Postgres als Standby-Knoten. Dazu führen Sie die folgenden Befehle auf Maschine 12 aus:
      > cd /opt/apigee/data/apigee-postgresql/pgdata
      > rm -rf *
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql-setup-replication-on-standby -f       configFile
    11. Überprüfen Sie den Replikationsstatus, indem Sie die folgenden Skripts auf beiden Servern ausführen. Das System sollte auf beiden Servern identische Ergebnisse anzeigen, um eine erfolgreiche Replikation zu gewährleisten:
      Führen Sie auf der Maschine 6 den Masterknoten aus:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

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

      Auf Maschine 12:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      Prüfen Sie, ob er angibt, dass es sich um den Standby-Knoten handelt.
  9. Aktualisieren Sie Edge-Komponenten auf Maschine 6 und 12:
    > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  10. Achten Sie darauf, den neuen Stand-by-Knoten wie oben unter Postgres-Knoten außer Betrieb nehmen beschrieben außer Betrieb zu nehmen.

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

Für eine API-Installation mit 7 Hosts

  1. Legen Sie SMTPMAILFROM in Ihrer Konfigurationsdatei fest. Dieser Parameter hat das Format:
    SMTPMAILFROM="Mein Unternehmen <myco@company.com>"
  2. Aktualisieren Sie Cassandra auf Maschinen 5, 6 und 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile

  3. Aktualisieren Sie den ElasticSearch- und API-BaaS-Stack auf Maschinen 1, 2 und 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c e,b -f configFile

  4. Aktualisieren Sie das API-BaaS-Portal auf Maschine 4:
    > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

Für eine API-Installation mit 10 Hosts

  1. Legen Sie SMTPMAILFROM in Ihrer Konfigurationsdatei fest. Dieser Parameter hat das Format:
    SMTPMAILFROM="Mein Unternehmen <myco@company.com>"
  2. Aktualisieren Sie Cassandra auf Maschinen 8, 9 und 10:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  3. Aktualisieren Sie ElasticSearch auf Maschinen 1, 2 und 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
  4. Aktualisieren Sie den API-BaaS-Stack auf Maschinen 4, 5 und 6:
    > /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
  5. Aktualisieren Sie das API-BaaS-Portal auf Maschine 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

Für eine API-Baas-Installation in zwei Rechenzentren

Für dieses Verfahren müssen die Cassandra-Knoten in beiden Rechenzentren aktualisiert werden. Wenn Sie diese Cassandra-Knoten mit Edge teilen, aktualisieren Sie diese Knoten in der Regel im Rahmen des Edge-Updates.

  1. Legen Sie SMTPMAILFROM in Ihren Konfigurationsdateien fest. Dieser Parameter hat das Format:
    SMTPMAILFROM="Mein Unternehmen <myco@company.com>"
  2. Aktualisieren Sie die Cassandra-Schlüsselbereiche mit dem korrekten Replikationsfaktor für die beiden Rechenzentren. Sie müssen diesen Schritt nur einmal auf einem Cassandra-Server in einem der beiden Rechenzentren ausführen:

    Hinweis: Die folgenden Befehle setzen den Replikationsfaktor auf „3“, was drei Cassandra-Knoten im Cluster angibt. Ändern Sie diesen Wert bei Bedarf für Ihre Installation.
    1. Starten Sie das Dienstprogramm Cassandra cqlsh:
      > /opt/apigee/apigee-cassandra/bin/cqlsh cassandraIP
    2. Führen Sie die folgenden CQL-Befehle in der Eingabeaufforderung "cqlsh>" aus, um die Replikationsebenen für Cassandra-Schlüsselbereiche festzulegen:
      1. cqlsh> ALTER KEYSPACE "Apigee_Baas_dc_1" WITH Replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      2. cqlsh> ALTER KEYSPACE "Apigee_Baas" WITH Replikation = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      3. cqlsh> ALTER KEYSPACE "Apigee_Baas_Locks" WITH Replikation = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      4. cqlsh> ALTER KEYSPACE "system_traces" WITH Replikation = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      5. cqlsh> ALTER KEYSPACE "Apigee_Baas_dc_2" WITH Replikation = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      6. Rufen Sie die Schlüsselbereiche mit folgendem Befehl auf:
        cqlsh> select * from system.schema_keyspaces;.
      7. Beenden Sie „cqlsh“:
        cqlsh> exit
  3. (Nur, wenn Sie Cassandra nicht im Rahmen der Aktualisierung von Edge aktualisiert haben) Aktualisieren Sie Cassandra-Knoten in Rechenzentrum 1, jeweils eine Maschine:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  4. (Nur wenn Sie Cassandra nicht im Rahmen der Aktualisierung von Edge aktualisiert haben) Aktualisieren Sie Cassandra-Knoten in Rechenzentrum 2, jeweils eine Maschine:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  5. Aktualisieren Sie ElasticSearch auf Maschinen in Rechenzentrum 1, eine Maschine nach der anderen:
    > /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
  6. Aktualisieren Sie ElasticSearch auf Maschinen in Rechenzentrum 2, jeweils eine Maschine nach der anderen:
    > /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
  7. API-BaaS-Stack auf Maschinen in Rechenzentrum 1 aktualisieren, eine Maschine nach der anderen:
    > /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
  8. API-BaaS-Stack auf Maschinen in Rechenzentrum 2 aktualisieren, eine Maschine nach der anderen:
    > /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
  9. Aktualisieren Sie das API-BaaS-Portal auf Maschinen in Rechenzentrum 1, eine Maschine nach der anderen:
    > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile
  10. Aktualisieren Sie das API-BaaS-Portal auf Maschinen in Rechenzentrum 2, eine Maschine nach der anderen:
    > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile
  11. BaaS-Schlüsselraumwerte aktualisieren. Dieser Schlüsselbereich muss für die Replikation bei der Installation festgelegt werden, aber nicht während der Laufzeit. Durch das Entfernen der Replikation wird auch Cassandra-Arbeitsspeicher gespart.

    Sie müssen diesen Schritt nur einmal auf einem Cassandra-Server in einem der beiden Rechenzentren ausführen:
    1. Starten Sie das Cassandra-Dienstprogramm cqlsh:
      > /opt/apigee/apigee-cassandra/bin/cqlsh cassandraIP
    2. Führen Sie die folgenden CQL-Befehle aus, um die Replikationsebenen für Cassandra-Schlüsselbereiche festzulegen:
      1. cqlsh> ALTER KEYSPACE "Apigee_Baas_dc_1" WITH Replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3' };
      2. cqlsh> ALTER KEYSPACE "Apigee_Baas_dc_2" WITH Replikation = { 'class': 'NetworkTopologyStrategy', 'dc-2': '3' };
      3. Rufen Sie mit folgendem Befehl die Schlüsselbereiche auf:
        cqlsh> select * from system.schema_keyspaces;
      4. cqlsh beenden:
        cqlsh> beenden

Für eine nicht standardmäßige Installation

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

  1. ZooKeeper
  2. Cassandra
  3. QPIdd, PS
  4. LDAP
  5. Edge, d. h. das Profil "-c" auf allen Knoten in der Reihenfolge: Knoten mit Qpid-Server, Postgres-Server, Management Server, Message Processor und Router.
    Hinweis: Wenn auf dem Knoten sowohl der Qpid-Server als auch der Postgres-Server installiert sind, führen Sie den Profilschritt „-c Edge“ aus.
  6. Edge-Benutzeroberfläche
Apigee Edge 4.17.01/4.17.05 auf 4.17.09 aktualisieren