Google verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.

Apigee Edge auf 4.16.09 aktualisieren

Edge for Private Cloud v. 4.16.09

Welche Edge-Versionen können Sie auf 4.16.09 aktualisieren?

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

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

Wer kann das Update durchführen?

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

Nachdem Sie die Edge-RPMs installiert haben, kann jeder Nutzer sie konfigurieren.

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-Skript 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 „Default Disabled Cipher Suites“ unter http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html.

Downgrade von ZooKeeper bei Aktualisierung von 4.16.01

Die Version des Zookeeper-RPM in Edge for Private Cloud 4.16.01 ist 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 auf eine neuere Version als 4.16.01 aktualisiert. Um dieses Problem zu beheben, führen Sie yum downgrade apigee-zookeeper aus, bevor Sie Zookeeper aktualisieren.

Sie können Ihre 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

Anschließend müssen Sie das Downgrade durchführen.

Automatische Weitergabe von Property-Einstellungen

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

Voraussetzungen aktualisieren

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

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

So haben Sie einen Plan B, 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 folgenden 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 die Aktualisierung fehlschlägt, können Sie versuchen, das Problem zu beheben, und dann „update.sh“ noch einmal ausführen. Sie können das Update mehrmals ausführen. Es wird dann an der Stelle fortgesetzt, an der es zuletzt unterbrochen wurde.

Wenn Sie aufgrund des Fehlers ein Rollback des Updates auf die vorherige Version durchführen müssen, finden Sie weitere Informationen unter Rollback-Prozess für 4.16.09.

Informationen zum Logging-Update

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

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

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

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

Erforderliches Upgrade auf Postgres 9.4

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

Während des Aktualisierungsvorgangs, wenn die Postgres-Knoten für die Aktualisierung inaktiv sind, werden Analysedaten weiterhin auf die Qpid-Knoten geschrieben. Nachdem die Postgres-Knoten aktualisiert wurden und wieder online sind, werden Analysedaten an die Postgres-Knoten übertragen.

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

Neuen Postgres-Standby-Knoten installieren

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

Verwenden Sie für die Installation dieselbe Konfigurationsdatei, die Sie für die Installation Ihrer aktuellen Edge-Version verwendet haben.

So erstellen Sie einen neuen Postgres-Standby-Knoten:

Bearbeiten Sie auf dem aktuellen Postgres-Master die Datei /opt/apigee/customer/application/postgresql.properties, um das folgende Token festzulegen. Wenn diese Datei nicht vorhanden ist, erstellen Sie sie:

conf_pg_hba_replication.connection=host replication apigee existing_slave_ip/32 trust\ \nhost replication apigee new_slave_ip/32 trust

Dabei ist existing_slave_ip die IP-Adresse des aktuellen Postgres-Standby-Servers und new_slave_ip die IP-Adresse des neuen Standby-Knotens.
Starten Sie apigee-postgresql auf dem Postgres-Master neu:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
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. In dieser Datei sollten die folgenden Zeilen enthalten sein:
host replication apigee existing_slave_ip/32 trust
host replication apigee new_slave_ip/32 trust
Installieren Sie den neuen Postgres-Standby-Server:
1. Bearbeiten Sie die Konfigurationsdatei, die Sie zur Installation Ihrer aktuellen Edge-Version verwendet haben, um Folgendes anzugeben:
  
  # IP address of the current master:
  PG_MASTER=192.168.56.103
  # IP address of the new standby node
  PG_STANDBY=192.168.56.102
2. Deaktivieren Sie SELinux, wie unter Edge-Dienstprogramm „apigee-setup“ installieren beschrieben.
3. Laden Sie die Edge-Datei „bootstrap_4.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-Dienstprogramm „apigee-service“ und die Abhängigkeiten:
  > sudo bash /tmp/bootstrap_4.16.05.sh apigeeuser=uName apigeepassword=pWord
5. Verwenden Sie „apigee-service“, um das Dienstprogramm „apigee-setup“ zu installieren:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
6. Installieren Sie Postgres:
  > /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
7. Führen Sie auf dem neuen Standby-Knoten den folgenden Befehl aus:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
  
  Prüfen Sie, ob er als Standby-Knoten angezeigt wird.

Postgres-Knoten außer Betrieb nehmen

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

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

Die UUID des Knotens sollte am Ende der Ausgabe in folgendem Format angezeigt werden:
"type" : [ "postgres-server" ],
"uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
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
Bearbeiten Sie auf dem Postgres-Masterknoten /opt/apigee/customer/application/postgresql.properties, um den neuen Standby-Knoten aus conf_pg_hba_replication.connection zu entfernen:
conf_pg_hba_replication.connection=host replication apigee existing_slave_ip/32 trust
Starten Sie apigee-postgresql auf dem Postgres-Master neu:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
Prüfen Sie, ob der neue Standby-Knoten entfernt wurde. Rufen Sie dazu die Datei /opt/apigee/apigee-postgresql/conf/pg_hba.conf auf dem Master auf. In dieser Datei sollte nur die folgende Zeile angezeigt werden:
host replication apigee existing_slave_ip/32 trust
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>

Update ohne Ausfallzeiten

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

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

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

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

Beachten Sie vor und nach dem Update Folgendes:

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

Konfigurationsdatei für die automatische Installation verwenden

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

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

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

Wenn Sie derzeit die Postgres-Master-Standby-Replikation verwenden, installieren Sie einen neuen Postgres-Standby-Knoten, wie oben unter Neuen Postgres-Standby-Knoten installieren beschrieben.
Deaktivieren Sie alle CRON-Jobs, die für die Ausführung eines Reparaturvorgangs für Cassandra konfiguriert sind, bis das Update abgeschlossen ist.
Melden Sie sich als Root-Nutzer auf Ihrem Knoten an, um die Edge-RPMs zu installieren.
Hinweis: Für die RPM-Installation ist Root-Zugriff erforderlich. Die Edge-Konfiguration kann jedoch ohne Root-Zugriff durchgeführt werden.
Deaktivieren Sie SELinux wie unter Edge-Dienstprogramm „apigee-setup“ installieren beschrieben.
Laden Sie die Edge 4.16.09-Datei bootstrap_4.16.09.sh 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
Installieren Sie das Edge 4.16.09-Dienstprogramm apigee-service und die Abhängigkeiten:
> sudo bash /tmp/bootstrap_4.16.09.sh apigeeuser=uName apigeepassword=pWord

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

Standardmäßig prüft das Installationsprogramm, ob Java 1.8 installiert ist. Andernfalls wird es für Sie installiert. Verwenden Sie die Option JAVA_FIX, um anzugeben, wie die Java-Installation gehandhabt werden soll. JAVA_FIX nimmt die folgenden Werte an:

I = OpenJDK 1.8 installieren (Standard)
C = Ohne Installation von Java fortfahren
Q = Beenden. Bei dieser Option müssen Sie Java selbst installieren.
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 Dienstprogramm „apigee-setup“ installieren:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  
  Mit diesem Befehl wird das Dienstprogramm update.sh in <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, d. h. 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 auf 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 auf apigee-service wird das Dienstprogramm update.sh in <inst_dir>/apigee/apigee-setup/bin installiert.
Je nach Ihrer aktuellen Edge-Version müssen Sie das Dienstprogramm apigee-validate auf dem Management Server installieren oder aktualisieren.
1. Wenn Sie derzeit Edge 4.16.05 verwenden: Aktualisieren Sie das Dienstprogramm apigee-validate auf dem Management Server:
  > /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 Management Server:
  > /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 Management Server zu installieren und auszuführen.
3. Wenn Sie ein Upgrade von 4.16.01 durchführen: Bearbeiten Sie die Konfigurationsdatei, die an das Dienstprogramm apigee-validate übergeben wird. In der Edge-Version 4.16.01 waren für die von apigee-validate verwendete Konfigurationsdatei die folgenden Attribute erforderlich:
  APIGEE_ADMINPW=sysAdminPword
  MP_POD=gateway
  REGION=dc-1
  
  In dieser Version ist für die Konfigurationsdatei nur das Attribut APIGEE_ADMINPW erforderlich. Die anderen beiden Properties können Sie aus der Datei entfernen.
Aktualisieren Sie das Dienstprogramm apigee-provision:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
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 Nutzer „apigee“ zugänglich oder lesbar sein muss.

Verwenden Sie die Option „-c“, um die zu aktualisierende Komponente anzugeben. Die Liste der möglichen Komponenten umfasst:
ldap = OpenLDAP
cs = Cassandra
zk = Zookeeper
qpid = qpidd
ps = postgresql
edge =Alle Edge-Komponenten außer Edge-UI: Management Server, Message Processor, Router, QPID Server, Postgres Server
ui = Edge-UI
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
Testen Sie das Update, indem Sie das Dienstprogramm „apigee-validate“ auf dem Management Server ausführen, wie unter Installation testen beschrieben.
Wenn Sie einen neuen Postgres-Standby-Knoten installiert haben, nehmen Sie den Knoten 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 unter 4.16.09 Rollback-Prozess beschriebene Verfahren.

Verfahren zum Aktualisieren auf 4.16.09 aus einem lokalen Repository

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

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

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

So aktualisieren Sie von einem lokalen 4.16.09-Repository:

Wenn Sie derzeit die Postgres-Master-Standby-Replikation verwenden, installieren Sie einen neuen Postgres-Standby-Knoten, wie oben unter Neuen Postgres-Standby-Knoten installieren beschrieben.
Erstellen Sie ein lokales 4.16.09-Repository, wie unter Edge-Dienstprogramm „apigee-setup“ installieren im Abschnitt „Lokales Apigee-Repository erstellen“ beschrieben.
Hinweis: Wenn Sie bereits ein 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-Dienstprogramm „apigee-setup“ installieren beschrieben.
So installieren Sie apigee-service aus einer TAR-Datei:
1. Verwenden Sie auf dem Knoten mit dem lokalen Repository den folgenden Befehl, um das lokale Repository in einer einzelnen TAR-Datei mit dem Namen /opt/apigee/data/apigee-mirror/apigee-4.16.09.tar.gz zu verpacken:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
2. Kopieren Sie die TAR-Datei auf den Knoten, auf dem Sie Edge aktualisieren möchten. Kopieren Sie sie beispielsweise in das Verzeichnis /tmp auf dem neuen Knoten.
3. Entpacken Sie die Datei auf dem neuen Knoten in das Verzeichnis /tmp:
  > tar -xzf apigee-4.16.09.tar.gz
  
  Mit diesem Befehl wird ein neues Verzeichnis mit dem Namen „repos“ in dem Verzeichnis erstellt, das die TAR-Datei enthält. Beispiel: /tmp/repos.
4. Installieren Sie das Edge-Dienstprogramm „apigee-service“ und die Abhängigkeiten aus „/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.
So installieren Sie apigee-service mit dem Nginx-Webserver:
1. Konfigurieren Sie den Nginx-Webserver wie unter Edge-Dienstprogramm „apigee-setup“ installieren im Abschnitt „Aus dem Repository mit dem Nginx-Webserver 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
  
  Dabei sind uName:pWord der Nutzername und das Passwort, die Sie oben für das Repository festgelegt haben, und remoteRepo ist die IP-Adresse oder der DNS-Name des Repository-Knotens.
3. Installieren Sie auf dem Remote-Knoten das Edge-Dienstprogramm „apigee-service“ und die Abhängigkeiten:
  > sudo bash /tmp/bootstrap_4.16.09.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
  
  Dabei sind uName:pWord der Nutzername und das Passwort für das Repository.
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 Dienstprogramm „apigee-setup“ installieren:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  
  Mit diesem Befehl wird das Dienstprogramm update.sh in <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, d. h. 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 auf 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.
Je nach Ihrer aktuellen Edge-Version müssen Sie das Dienstprogramm apigee-validate auf dem Management Server installieren oder aktualisieren.
1. Wenn Sie derzeit Edge 4.16.05 verwenden: Aktualisieren Sie das Dienstprogramm apigee-validate auf dem Management Server:
  > /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 Management Server:
  > /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 Management Server zu installieren und auszuführen.
3. Wenn Sie ein Upgrade von 4.16.01 durchführen: Bearbeiten Sie die Konfigurationsdatei, die an das Dienstprogramm apigee-validate übergeben wird. In der Edge-Version 4.16.01 waren für die von apigee-validate verwendete Konfigurationsdatei die folgenden Attribute erforderlich:
  APIGEE_ADMINPW=sysAdminPword
  MP_POD=gateway
  REGION=dc-1
  
  In dieser Version ist für die Konfigurationsdatei nur das Attribut APIGEE_ADMINPW erforderlich. Die anderen beiden Properties können Sie aus der Datei entfernen.
Aktualisieren Sie das Dienstprogramm apigee-provision:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
Führen Sie das Update-Dienstprogramm auf Ihren Knoten in der unten beschriebenen Reihenfolge aus:
> /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

Die einzige Anforderung an die Konfigurationsdatei ist, dass sie für den Nutzer „apigee“ zugänglich oder lesbar sein muss.

Verwenden Sie die Option „-c“, um die zu aktualisierende Komponente anzugeben. Die Liste der möglichen Komponenten umfasst:
ldap = OpenLDAP
cs = Cassandra
zk = Zookeeper
qpid = qpidd
ps = postgresql
edge =Alle Edge-Komponenten außer Edge-UI: Management Server, Message Processor, Router, QPID Server, Postgres Server
ui = Edge-UI
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
Testen Sie das Update, indem Sie das Dienstprogramm „apigee-validate“ auf dem Management Server ausführen, wie unter Installation testen beschrieben.
Wenn Sie einen neuen Postgres-Standby-Knoten installiert haben, nehmen Sie den Knoten 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 unter 4.16.09 Rollback-Prozess beschriebene Verfahren.

Reihenfolge der Maschinenaktualisierung

Die Reihenfolge, in der Sie die Maschinen in einer Edge-Installation aktualisieren, ist wichtig. Die wichtigsten Überlegungen für ein Update sind:

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