Diese Seite wurde von der Cloud Translation API übersetzt.

Apigee Edge 4.50.00 oder 4.51.00 auf 4.52.00 aktualisieren

Apigee unterstützt das direkte Upgrade von Edge for Private Cloud von Version 4.50.00 oder Version 4.51.00 auf Version 4.52.00. Auf dieser Seite wird beschrieben, wie Sie beide Upgrades ausführen.

Wer das Update durchführen darf

Die Person, die das Update ausführt, sollte mit der Person identisch sein, die Edge ursprünglich installiert hat, oder eine Person, die als Root-Nutzer ausgeführt wird.

Nachdem Sie die Edge-RPMs installiert haben, kann sie von jedem 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.

Voraussetzungen für Updates

Die folgenden Voraussetzungen müssen erfüllt sein, bevor Sie ein Upgrade von Apigee Edge ausführen:

Alle Knoten sichern
Vor der Aktualisierung empfehlen wir aus Sicherheitsgründen, eine vollständige Sicherung aller Knoten durchzuführen. Folgen Sie der Anleitung für Ihre aktuelle Version von Edge, um die Sicherung durchzuführen.
So haben Sie einen Sicherungsplan für den Fall, dass die Aktualisierung auf eine neue Version nicht ordnungsgemäß funktioniert. Weitere Informationen zur Sicherung finden Sie unter Sicherung und Wiederherstellung.
Achten Sie darauf, dass Edge ausgeführt wird
Stellen Sie mit dem Befehl sicher, dass Edge während des Aktualisierungsvorgangs aktiv ist:
```
/opt/apigee/apigee-service/bin/apigee-all status
```
Die Cassandra-Komptifizierungsstrategie muss LeveledCompactionStrategy sein
Die Cassandra-Kompatibilitätsstrategie muss auf LeveledCompactionStrategy festgelegt sein, wie unter Cassandra-Verdichtungsstrategie ändern beschrieben.

Automatische Übernahme von Property-Einstellungen

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

Erforderliches Upgrade auf Zookeeper 3.8.0

Diese Version von Edge for Private Cloudes enthält ein Upgrade auf Zookeeper 3.8.0. Im Rahmen dieses Upgrades werden alle Zookeeper-Daten zu Zookeeper 3.8.0 migriert.

Lesen Sie vor dem Upgrade von Zookeeper den Zookeeper-Wartungsleitfaden. Die meisten Edge-Produktionssysteme verwenden einen Cluster von Zookeeper-Knoten, die auf mehrere Rechenzentren verteilt sind. Einige dieser Knoten sind als Wähler konfiguriert, die an der Zookeeper-Leader-Auswahl teilnehmen, und der Rest sind als Beobachter konfiguriert. Weitere Informationen finden Sie unter Über Führungskräfte, Follower, Wähler und Beobachter. Die Wählerknoten wählen einen Leader aus, woraufhin die Wählerknoten selbst Follower werden.

Während des Aktualisierungsvorgangs kann es zu einer kurzen Verzögerung oder einem Schreibfehler in Zookeeper kommen, wenn der Leader-Knoten heruntergefahren wird. Dies kann sich auf Verwaltungsvorgänge auswirken, die in Zookeeper schreiben, wie der Bereitstellungsvorgang eines Proxys, und Änderungen an der Apigee-Infrastruktur wie das Hinzufügen oder Entfernen eines Message Processor usw. Es sollte keine Auswirkungen auf die Laufzeit-APIs von Apigee geben (es sei denn, diese Laufzeit-APIs rufen Verwaltungs-APIs auf), während das Upgrade von Zookeeper ausgeführt wird, wenn Sie das unten beschriebene Verfahren ausführen.

Der Upgradeprozess umfasst das Erstellen einer Sicherung jedes Knotens. Anschließend wird ein Upgrade aller Beobachter und Follower sowie schließlich des Leader-Knotens durchgeführt.

Back-up erstellen

Erstellen Sie eine Sicherung aller Zookeeper-Knoten für den Fall, dass ein Rollback erforderlich ist. Durch ein Rollback wird Zookeeper auf den Zustand zum Zeitpunkt der Sicherung zurückgesetzt. Hinweis:Alle Bereitstellungen oder Infrastrukturänderungen in Apigee seit der Sicherung (dessen Informationen in Zookeeper gespeichert sind) gehen während der Wiederherstellung verloren.

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper backup

Wenn Sie virtuelle Maschinen verwenden und die Möglichkeit dazu haben, können auch VM-Snapshots oder -Sicherungen zur Wiederherstellung oder für ein Rollback erstellt werden (falls erforderlich).

Führende Personen, Follower und Beobachter identifizieren

Hinweis:In den folgenden Beispielbefehlen wird das nc-Dienstprogramm verwendet, um Daten an Zookeeper zu senden. Sie können auch andere Dienstprogramme verwenden, um Daten an Zookeeper zu senden.

Wenn es nicht auf dem ZooKeeper-Knoten installiert ist, installieren Sie nc:
```
  sudo yum install nc
```
Führen Sie den folgenden nc-Befehl auf dem Knoten aus, wobei 2181 der ZooKeeper-Port ist:
```
  echo stat | nc localhost 2181
```
Die Ausgabe sollte in etwa so aussehen:
```
  Zookeeper version: 3.8.0-5a02a05eddb59aee6ac762f7ea82e92a68eb9c0f, built on 2022-02-25 08:49 UTC
  Clients:
   /0:0:0:0:0:0:0:1:41246[0](queued=0,recved=1,sent=0)
  
  Latency min/avg/max: 0/0.2518/41
  Received: 647228
  Sent: 647339
  Connections: 4
  Outstanding: 0
  Zxid: 0x400018b15
  Mode: follower
  Node count: 100597
```
In der Zeile Mode der Ausgabe für die Knoten sollten je nach Knotenkonfiguration Observer, Leader oder Follower (d. h. ein Voter, der nicht der Leader ist) angezeigt werden. Hinweis: In einer eigenständigen Installation von Edge mit einem einzelnen ZooKeeper-Knoten ist Mode auf eigenständig festgelegt.
Wiederholen Sie die Schritte 1 und 2 für jeden ZooKeeper-Knoten.

Upgrade für Zookeeper auf den Beobachter- und Follower-Knoten ausführen

Führen Sie ein Upgrade von Zookeeper auf jedem Beobachter- und Follower-Knoten wie folgt durch:

Laden Sie einen Bootstrap von Edge für Private Cloud 4.52 herunter und führen Sie ihn aus, wie unter Auf 4.52.00 auf einem Knoten mit einer externen Internetverbindung aktualisieren beschrieben. Die Vorgehensweise hängt davon ab, ob der Knoten eine externe Internetverbindung hat oder Sie eine Offlineinstallation durchführen.
Führen Sie ein Upgrade der Zookeeper-Komponente durch:
```
  /opt/apigee/apigee-setup/bin/update.sh -c zk -f <silent-config-file>
```
Hinweis: Wenn auf diesen Knoten andere Komponenten installiert sind (z. B. Cassandra), können Sie auch für diese Knoten jetzt ein Upgrade durchführen (z. B. mit dem cs,zk-Profil) oder die anderen Komponenten später aktualisieren. Apigee empfiehlt, dass Sie zuerst Zookeeper aktualisieren und prüfen, ob Ihr Cluster ordnungsgemäß funktioniert, bevor Sie andere Komponenten upgraden.
Wiederholen Sie die obigen Schritte auf allen Zookeeper-Beobachter- und Follower-Knoten.

Leader herunterfahren

Sobald alle Beobachter- und Follower-Knoten aktualisiert wurden, fahren Sie den Leader herunter. Führen Sie auf dem als Leader identifizierten Knoten den folgenden Befehl aus:

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop

Bevor eine neue Führungskraft ernannt wird, kann es während dieser Veranstaltung kurzzeitig zu Verzögerungen oder Schreibfehlern in Zookeeper kommen. Dies kann sich auf Vorgänge auswirken, die in Zookeeper schreiben, z. B. Bereitstellungsaktionen von Proxys oder Änderungen an der Apigee-Infrastruktur wie das Hinzufügen oder Entfernen von Nachrichtenprozessoren usw.

Überprüfen, ob der neue Leader ausgewählt wurde

Prüfen Sie anhand der Schritte im Abschnitt Leader, Follower und Beobachter identifizieren oben, ob ein neuer Leader aus den Followern ausgewählt wurde, nachdem der vorhandene Leader gestoppt wurde. Die Führungskraft könnte auch in einem anderen Rechenzentrum als der aktuelle Leiter ausgewählt worden sein.

Führende Person upgraden

Führen Sie dieselben Schritte wie im obigen Abschnitt Upgrade von Zookeeper auf den Beobachter- und Follower-Knoten ausführen aus.

Nachdem auch das Upgrade des alten Leader-Knotens durchgeführt wurde, prüfen Sie den Zustand des Clusters und sorgen Sie dafür, dass ein Leader-Knoten vorhanden ist.

Rollback

Falls ein Rollback erforderlich ist:

Führen Sie zuerst Rollback-Schritte für Beobachter und Follower durch.
Laden Sie ein Bootstrap der Version herunter, auf die Sie ein Rollback durchführen, entweder auf 4.50 oder 4.51. Der Vorgang variiert wahrscheinlich, je nachdem, ob der Knoten eine externe Internetverbindung hat oder Sie einer Offlineinstallation folgen.

Beenden Sie Zookeeper, wenn er auf dem Knoten ausgeführt wird:

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop

Vorhandenen Zookeeper deinstallieren:

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper uninstall

Zookeeper wie gewohnt installieren:

  /opt/apigee/apigee-setup/bin/setup.sh -p zk -f <silent-config-file>

Sobald ein Rollback für alle Follower und Beobachter durchgeführt wurde, führen Sie ein Rollback für den Leader-Knoten aus. Führen Sie dazu die Schritte 2 bis 5 für den Leader-Knoten aus.

Nachdem für alle Knoten ein Rollback durchgeführt wurde, prüfen Sie den Zustand des Clusters und sorgen Sie dafür, dass ein führender Knoten im Cluster vorhanden ist.

Wiederherstellung aus einem Back-up

Weitere Informationen finden Sie unter Aus einer Sicherung wiederherstellen. Beachten Sie, dass Sicherungen von Zookeeper aus früheren Versionen von Edge für Private Cloud wie 4.50 und 4.51 mit der Version von Zookeeper in Edge für Private Cloud 4.52 kompatibel sein sollten.

Erforderliches Upgrade auf Postgres 14

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

Die meisten Edge-Produktionssysteme verwenden zwei Postgres-Knoten, die für die Master-Stand-by-Replikation konfiguriert sind. Während die Postgres-Knoten wegen der 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 die Postgres-Aktualisierung ausfü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 ein Rollback für die Aktualisierung durchführen müssen, wird der neue Postgres-Standby-Knoten nach dem Rollback zum Postgres-Masterknoten. Wenn Sie den neuen Postgres-Standby-Knoten daher installieren, sollte er sich auf einem Knoten befinden, der alle Hardwareanforderungen eines Postgres-Servers erfüllt, wie in den Edge-Installationsanforderungen definiert.

In einer Edge-Konfiguration mit einem oder zwei Knoten gibt es Topologien, die für das Prototyping und Testen 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 überspringen, die die Installation und spätere Außerbetriebnahme eines neuen Postgres-Standby-Knotens angeben.
Erstellen Sie vor dem Aktualisieren einen Netzwerk-Snapshot des von Postgres verwendeten Datenspeichers. Wenn während der Aktualisierung Fehler auftreten und Sie ein Rollback ausfü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 Ihre vorhandene Edge-Version (4.50.00 oder 4.51.00) und nicht für Version 4.52.00.

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:

Bearbeiten Sie auf dem aktuellen Postgres-Master die Datei /opt/apigee/customer/application/postgresql.properties, um das folgende Token festzulegen. Falls die Datei nicht vorhanden ist, erstellen Sie sie:
```
conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust\ \nhost replication apigee new_standby_ip/32 trust
```
Dabei ist existing_standby_ip die IP-Adresse des aktuellen Postgres-Standby-Servers und new_standby_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. Rufen Sie dazu die Datei /opt/apigee/apigee-postgresql/conf/pg_hba.conf auf dem Master auf. Die Datei sollte die folgenden Zeilen enthalten:
```
host replication apigee existing_standby_ip/32 trust
host replication apigee new_standby_ip/32 trust
```
Installieren Sie den neuen Postgres-Standby-Server:
1. Bearbeiten Sie die Konfigurationsdatei, die Sie zum Installieren Ihrer aktuellen Version von Edge 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 für Apigee-Setup installieren beschrieben.
3. Wenn Sie derzeit Edge 4.51.00 verwenden:
  1. Laden Sie die Datei „Edge bootstrap_4.51.00.sh“ in /tmp/bootstrap_4.51.00.sh herunter:
```
curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
```
  2. Installieren Sie das Edge-Dienstprogramm apigee-service und die Abhängigkeiten:
```
sudo bash /tmp/bootstrap_4.51.00.sh apigeeuser=uName apigeepassword=pWord
```
  Wenn Sie derzeit Edge 4.50.00 verwenden:
  1. Laden Sie die Datei „Edge bootstrap_4.50.00.sh“ in /tmp/bootstrap_4.50.00.sh herunter:
```
curl https://software.apigee.com/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.00.sh
```
  2. Installieren Sie das Edge-Dienstprogramm apigee-service und die Abhängigkeiten:
```
sudo bash /tmp/bootstrap_4.50.00.sh apigeeuser=uName apigeepassword=pWord
```
4. Verwenden Sie apigee-service, um das apigee-setup-Dienstprogramm zu installieren:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
```
5. Postgres installieren:
```
/opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
```
6. Führen Sie auf dem neuen Standby-Knoten den folgenden Befehl aus:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
```
  Prüfen Sie, ob es sich um den Standby-Modus handelt.

Direktes Upgrade von Postgres ausführen

Hinweis: Sie müssen den folgenden vorbereitenden Schritt ausführen, bevor Sie ein direktes Upgrade von Postgres ausführen.

Hinweis: Mit Postgres 14 wird der Postgres-Konfigurationsparameter wal_keep_segments nicht mehr unterstützt. Wenn Sie diesen Postgres-Parameter hinzugefügt oder geändert haben, müssen Sie ihn vor dem Postgres-Upgrade entfernen. Gehen Sie dazu so vor:

Öffnen Sie die Datei $APIGEE_ROOT/customer/application/postgresql.properties.
Entfernen Sie die Konfiguration für wal_keep_segments.
Starten Sie Postgres neu.

Vorschritt

Führen Sie vor einem direkten Upgrade auf Postgres die folgenden Schritte sowohl auf dem Master-Host als auch auf dem Stand-by aus, um das Attribut max_locks_per_transaction auf apigee-postgresql zu aktualisieren:

Falls nicht vorhanden, erstellen Sie die Datei /opt/apigee/customer/application/postgresql.properties.

Ändern Sie die Eigentümerschaft dieser Datei in apigee:

sudo chown apigee:apigee /opt/apigee/customer/application/postgresql.properties

Fügen Sie der Datei das folgende Attribut hinzu:

conf/postgresql.conf+max_locks_per_transaction=30000

apigee-postgresql konfigurieren:

apigee-service apigee-postgresql configure

apigee-postgresql neu starten:

apigee-service apigee-postgresql restart

Direktes Upgrade ausführen

So führen Sie ein direktes Upgrade auf Postgres 14 aus:

Postgres auf dem Master-Host

/opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf

upgraden

Führen Sie den Einrichtungsbefehl auf dem Master-Host aus:
```
apigee-service apigee-postgresql setup -f /opt/silent.conf
```
Führen Sie den Konfigurationsbefehl auf dem Masterhost aus:
```
apigee-service apigee-postgresql configure
```

Starten Sie den Masterhost neu:

apigee-service apigee-postgresql restart

Konfigurieren Sie es als Master:

apigee-service apigee-postgresql setup-replication-on-master -f /opt/silent.conf

Prüfen Sie, ob der Master-Host gestartet wurde:
```
apigee-service apigee-postgresql wait_for_ready
```
Beenden Sie den Standby-Modus:
```
apigee-service apigee-postgresql stop
```
Führen Sie ein Upgrade der Standby-Instanz durch.
Hinweis:Wenn bei diesem Schritt Fehler auftreten oder dieser Schritt fehlschlägt, kann er ignoriert werden. update.sh versucht, den Stand-by-Server mit einer falschen Konfiguration zu starten. Wenn die Postgres-Installation auf 14 aktualisiert wurde, kann der Fehler ignoriert werden.
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
```
Achten Sie darauf, dass der Standby-Modus beendet ist:
```
apigee-service apigee-postgresql stop
```
Entfernen Sie die alte Standby-Konfiguration:
```
rm -rf /opt/apigee/data/apigee-postgresql/
```

Richten Sie die Replikation auf dem Standby-Server ein:

apigee-service apigee-postgresql setup-replication-on-standby -f /opt/silent.conf

Entfernen Sie die Zeile conf/postgresql.conf+max_locks_per_transaction=30000 aus der Datei /opt/apigee/customer/application/postgresql.properties sowohl auf dem Master-Host als auch auf dem Standby-Host. Diese Zeile wurde im vorläufigen Schritt hinzugefügt.

Nach Abschluss dieses Vorgangs wird die Stand-by erfolgreich gestartet.

Postgres-Knoten außer Betrieb nehmen

Außer Betrieb nehmen Sie nach Abschluss des Updates den neuen Stand-by-Knoten außer Betrieb:

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
```
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 in folgendem Format angezeigt werden:
```
"type" : [ "postgres-server" ],
"uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
```
Beenden Sie den neuen Standby-Knoten mit dem folgenden Befehl auf dem neuen Standby-Knoten:
```
/opt/apigee/apigee-service/bin/apigee-all stop
```
Bearbeiten Sie auf dem Postgres-Master-Knoten /opt/apigee/customer/application/postgresql.properties, um den neuen Stand-by-Knoten aus conf_pg_hba_replication.connection zu entfernen:
```
conf_pg_hba_replication.connection=host replication apigee existing_standby_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 der Datei sollte nur die folgende Zeile zu sehen sein:
```
host replication apigee existing_standby_ip/32 trust
```
Löschen Sie die UUID des Standby-Knotens aus ZooKeeper. Führen Sie dazu den folgenden Edge Management API-Aufruf auf dem Verwaltungsserverknoten aus:
```
curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/new_standby_uuid
```

Neue Edge-Benutzeroberfläche

In diesem Abschnitt werden Überlegungen zur Edge-Benutzeroberfläche aufgeführt. Weitere Informationen finden Sie unter Die neue Edge-UI für Private Cloud.

Installieren Sie die Edge-Benutzeroberfläche

Nach Abschluss der Erstinstallation empfiehlt Apigee, dass Sie die Edge-UI installieren. Diese ist eine verbesserte Benutzeroberfläche für Entwickler und Administratoren von Apigee Edge for Private Cloud.

Beachten Sie, dass Sie für die Edge-Benutzeroberfläche die Basisauthentifizierung deaktivieren und einen IdP wie SAML oder LDAP verwenden müssen.

Weitere Informationen finden Sie unter Neue Edge-Benutzeroberfläche installieren.

Edge-Benutzeroberfläche aktualisieren

Berücksichtigen Sie zum Aktualisieren der Edge-UI-Komponente die Version von Edge für die Private Cloud, von der Sie ein Upgrade ausführen:

Von 4.51.00 auf 4.52.00 (wobei die neue Edge-Benutzeroberfläche bereits installiert ist): Folgen Sie der Upgrade-Anleitung in diesem Abschnitt für die edge-management-ui-Komponente.

Mit Apigee mTLS aktualisieren

So aktualisieren Sie Apigee mTLS:

Aktualisierung rückgängig machen

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

Wenn der Fehler erfordert, dass ein Rollback des Updates auf die vorherige Version durchgeführt wird, finden Sie unter Rollback von 4.52.00.

Informationen zum Logging-Update

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

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

Wenn die Person, die 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 die Person 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 bei einer Konfiguration mit 5 Knoten und höher 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.

Aktualisieren Sie die Maschinen in der richtigen Reihenfolge für Ihre Installation, wie unter Reihenfolge des Maschinenupdates beschrieben.
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.
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.
Sorgen Sie dafür, dass der Router wieder erreichbar ist.
Wiederholen Sie die Schritte 2 bis 4 für die verbleibenden Router.
Setzen Sie das Update für alle in der Installation verbleibenden Maschinen fort.

Beachten Sie vor und nach dem Update Folgendes:

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

Konfigurationsdatei im Hintergrund verwenden

Sie müssen eine stille Konfigurationsdatei an den Befehl "update" übergeben. Die stille Konfigurationsdatei sollte mit der Datei identisch sein, die Sie zum Installieren von Edge 4.50.00 oder 4.51.00 verwendet haben.

Aktualisierung auf 4.52.00 auf einem Knoten mit einer externen Internetverbindung

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

Deaktivieren Sie gegebenenfalls alle cron-Jobs, die zum Ausführen eines Reparaturvorgangs auf Cassandra bis nach Abschluss des Updates konfiguriert sind.
Melden Sie sich bei Ihrem Knoten als Root an, um die Edge-RPMs zu installieren.
HINWEIS: Die RPM-Installation erfordert Root-Zugriff, Sie können aber die Edge-Konfiguration ohne Root-Zugriff ausführen.
Installieren Sie yum-utils und yum-plugin-priorities:
Hinweis:Wenn Ihr Betriebssystem RHEL 8.0–8.6 ist, überspringen Sie diesen Schritt.
```
sudo yum install yum-utils
sudo yum install yum-plugin-priorities
```
Deaktivieren Sie SELinux wie unter Das Edge-Dienstprogramm für Apigee-Setup installieren beschrieben.
Wenn Sie die Installation auf Oracle 7.x durchführen, führen Sie den folgenden Befehl aus:
```
sudo yum-config-manager --enable ol7_optional_latest
```

Wenn Sie die Installation auf AWS durchführen, 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

Wenn Sie derzeit Edge 4.51.00 verwenden:
1. Laden Sie die Edge-Datei bootstrap_4.52.00.sh in /tmp/bootstrap_4.52.00.sh herunter:
```
curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
```
2. Installieren Sie das apigee-service-Dienstprogramm von Edge 4.52.00 und die Abhängigkeiten mit dem folgenden Befehl:
```
sudo bash /tmp/bootstrap_4.52.00.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, den Wert einzugeben.
  
  Das Installationsprogramm prüft standardmäßig, ob Sie Java 1.8 installiert haben. Andernfalls installiert das Installationsprogramm sie für Sie.
  
  Geben Sie mit der Option JAVA_FIX an, wie die Java-Installation gehandhabt werden soll. Für JAVA_FIX werden die folgenden Werte verwendet:
  - I: Installiert OpenJDK 1.8 (Standardeinstellung).
  - C: Fahren Sie fort, ohne Java zu installieren.
  - Q: Beenden. Dazu müssen Sie Java selbst installieren.
3. Verwenden Sie apigee-service, um das Dienstprogramm apigee-setup wie im folgenden Beispiel zu aktualisieren:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
```
4. Aktualisieren Sie das Dienstprogramm apigee-validate auf dem Verwaltungsserver wie im folgenden Beispiel gezeigt:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
```
5. Aktualisieren Sie das Dienstprogramm apigee-provision auf dem Verwaltungsserver wie im folgenden Beispiel gezeigt:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
```
6. Führen Sie auf Ihren Knoten das Dienstprogramm update mit dem folgenden Befehl aus:
```
/opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
```
  Führen Sie dies in der unter Reihenfolge des Maschinenupdates beschriebenen Reihenfolge aus.
  
  Wobei:
  - component ist die zu aktualisierende Edge-Komponente. Zulässige Werte:
    - cs: Cassandra
    - edge: alle Edge-Komponenten außer Edge-UI: Management Server, Message Processor, Router, QPID-Server, Postgres Server
    - ldap: OpenLDAP
    - ps: postgresql
    - qpid: qpidd
    - sso: Apigee-SSO (wenn Sie SSO installiert haben)
    - ue: Neue Edge-Benutzeroberfläche
    - ui: Klassische Edge-UI
    - zk: Zookeeper
  - configFile ist die Konfigurationsdatei, die Sie zum Definieren Ihrer Edge-Komponenten während der Installation von 4.50.00 oder 4.51.00 verwendet haben.
  Sie können update.sh für alle Komponenten ausführen. Dazu legen Sie component auf „all“ fest. Dies gilt jedoch nur, wenn Sie ein Edge-All-in-one-Installationsprofil (AIO) haben. Beispiel:
```
/opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
```
7. Starten Sie die Edge-UI-Komponente auf allen Knoten neu, auf denen sie ausgeführt wird, falls Sie dies noch nicht getan haben:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```
8. Testen Sie das Update. Führen Sie dazu das Dienstprogramm apigee-validate auf dem Verwaltungsserver aus, wie unter Installation testen beschrieben.
Wenn Sie später ein Rollback für die Aktualisierung durchführen möchten, gehen Sie wie unter Rollback 4.52.00 beschrieben vor.

Aktualisierung von einem lokalen Repository auf 4.52.00

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 von einem lokalen Repository oder einem 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 sie in 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. Alternativ können Sie Ihren eigenen Webserver verwenden.
So führen Sie eine Aktualisierung von einem lokalen 4.52.00-Repository aus:
1. Erstellen Sie ein lokales 4.52.00-Repository, wie in „Lokales Apigee-Repository erstellen“ unter Das Edge-Dienstprogramm apigee-setup installieren beschrieben.
  HINWEIS: Wenn Sie bereits ein Repository haben, können Sie das Repository 4.52.00 diesem Repository hinzufügen, wie unter „Lokales Apigee-Repository aktualisieren“ unter Dienstprogramm für Edge-apigee-setup installieren beschrieben.
2. 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 einer einzelnen TAR-Datei mit dem Namen /opt/apigee/data/apigee-mirror/apigee-4.52.00.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 ihn 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.52.00.tar.gz
```
    Mit diesem Befehl wird ein neues Verzeichnis mit dem Namen repos in dem Verzeichnis erstellt, das die TAR-Datei enthält. z. B. /tmp/repos.
  4. Installieren Sie das Edge-Dienstprogramm apigee-service und die Abhängigkeiten von /tmp/repos:
```
sudo bash /tmp/repos/bootstrap_4.52.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
```
    Beachten Sie, dass Sie in diesem Befehl den Pfad zum Repository-Verzeichnis angeben.
3. So installieren Sie den Apigee-Dienst mit dem Nginx-Webserver:
  1. Konfigurieren Sie den Nginx-Webserver wie in „Mit dem Nginx-Webserver vom Repository installieren“ unter Das Edge-Dienstprogramm apigee-setup installieren beschrieben.
  2. Laden Sie auf dem Remote-Knoten die Edge-bootstrap_4.52.00.sh-Datei in /tmp/bootstrap_4.52.00.sh herunter:
```
/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.52.00.sh -o /tmp/bootstrap_4.52.00.sh
```
    Dabei sind uName:pWord der Nutzername und das Passwort, die Sie zuvor 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-Dienstprogramm apigee-setup und die Abhängigkeiten:
```
sudo bash /tmp/bootstrap_4.52.00.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
```
    Dabei sind uName:pWord der Nutzername und das Passwort für das Repository.
4. Verwenden Sie apigee-service, um das Dienstprogramm apigee-setup wie im folgenden Beispiel zu aktualisieren:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup update 
```
5. Aktualisieren Sie das Dienstprogramm apigee-validate auf dem Verwaltungsserver wie im folgenden Beispiel gezeigt:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
```
6. Aktualisieren Sie das Dienstprogramm apigee-provision auf dem Verwaltungsserver wie im folgenden Beispiel gezeigt:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
```
7. Führen Sie das Dienstprogramm update auf Ihren Knoten in der Reihenfolge aus, die unter Reihenfolge des Maschinenupdates beschrieben ist:
```
/opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
```
  Wobei:
  - component ist die zu aktualisierende Edge-Komponente. In der Regel aktualisieren Sie die folgenden Komponenten:
    - cs: Cassandra
    - edge: alle Edge-Komponenten außer Edge-UI: Management Server, Message Processor, Router, QPID-Server, Postgres Server
    - ldap: OpenLDAP
    - ps: postgresql
    - qpid: qpidd
    - sso: Apigee-SSO (wenn Sie SSO installiert haben)
    - ue Neue Edge-Benutzeroberfläche
    - ui: Klassische Edge-UI
    - zk: Zookeeper
  - configFile ist die Konfigurationsdatei, die Sie zum Definieren Ihrer Edge-Komponenten während der Installation von 4.50.00 oder 4.51.00 verwendet haben.
    HINWEIS: Die Konfigurationsdatei muss für den „apigee“-Benutzer lesbar sein. Verwenden Sie den folgenden Befehl, um den Inhaber zu ändern:
```
chown apigee:apigee configFile
```
  Sie können update.sh für alle Komponenten ausführen. Dazu legen Sie component auf „all“ fest. Dies gilt jedoch nur, wenn Sie ein Edge-All-in-one-Installationsprofil (AIO) haben. Beispiel:
```
/opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config
```
8. Starten Sie die UI-Komponenten auf allen Knoten neu, auf denen sie ausgeführt wird, falls noch nicht geschehen:
```
/opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
```
9. Testen Sie das Update. Führen Sie dazu das Dienstprogramm apigee-validate auf dem Verwaltungsserver aus, wie unter Installation testen beschrieben.
Wenn Sie später ein Rollback für die Aktualisierung durchführen möchten, gehen Sie wie unter Rollback 4.52.00 beschrieben vor.

Reihenfolge der Maschinenupdates

Die Reihenfolge, in der Sie die Maschinen in einer Edge-Installation aktualisieren, ist wichtig:
- 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 Maschinen ausgeführt werden soll, führen Sie ihn in der angegebenen Maschinenreihenfolge aus.
- Die Monetarisierung muss ohne separaten Schritt aktualisiert werden. Sie wird aktualisiert, wenn Sie die Option -c edge angeben.
HINWEIS: Nachdem Sie die Edge-UI-Komponente aktualisiert haben, müssen Sie den Edge-UI-Dienst wie in der Installationsanleitung für die Aktualisierung beschrieben neu starten.

Eigenständiges Upgrade mit 1 Knoten

So führen Sie ein Upgrade einer eigenständigen Konfiguration mit einem Knoten auf 4.52.00 durch:
1. Alle Komponenten aktualisieren:
```
/opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
```
2. (Wenn Sie apigee-adminapi installiert haben) Das apigee-adminapi-Dienstprogramm wurde aktualisiert:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
Eigenständiges Upgrade mit 2 Knoten

Aktualisieren Sie die folgenden Komponenten für eine eigenständige Installation mit zwei Knoten:

Eine Liste der Edge-Topologien und Knotennummern finden Sie unter Installationstopologien.
1. Aktualisieren Sie Cassandra und ZooKeeper auf Computer 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```
2. Aktualisieren Sie Qpid und Postgres auf Computer 2:
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
```
3. Aktualisieren Sie LDAP auf Gerät 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
4. Aktualisieren Sie Edge-Komponenten auf Maschinen 2 und 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
5. Aktualisieren Sie die UI auf Gerät 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
```
6. (Wenn Sie apigee-adminapi installiert haben) Das apigee-adminapi-Dienstprogramm wurde auf Computer 1 aktualisiert:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
7. (Wenn Sie Apigee SSO installiert haben) Aktualisieren Sie Apigee SSO auf Computer 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
  Dabei ist sso_config_file die Konfigurationsdatei, die Sie bei der Installation der SSO erstellt haben.
8. Starten Sie die Edge-UI-Komponente auf Computer 1 neu:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```
Upgrade mit 5 Knoten

Aktualisieren Sie die folgenden Komponenten für eine Installation mit 5 Knoten:

Eine Liste der Edge-Topologien und Knotennummern finden Sie unter Installationstopologien.
1. Aktualisieren Sie Cassandra und ZooKeeper auf Maschinen 1, 2 und 3:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```
2. Aktualisieren Sie Qpid und Postgres auf Computer 4:
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile
```
3. Aktualisieren Sie Qpid und Postgres auf Computer 5:
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile
```
4. Aktualisieren Sie LDAP auf Gerät 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
5. Aktualisieren Sie die Edge-Komponenten auf Maschinen 4, 5, 1, 2, 3:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
6. Aktualisieren Sie die Edge-Benutzeroberfläche:
  - Klassische UI: Wenn Sie die klassische UI verwenden, aktualisieren Sie die Komponente ui auf Computer 1 wie im folgenden Beispiel gezeigt:
```
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
```
  - Neue Edge-Benutzeroberfläche: Wenn Sie die neue Edge-Benutzeroberfläche installiert haben, aktualisieren Sie die Komponente ue auf dem entsprechenden Computer (möglicherweise nicht auf Computer 1):
```
/opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
```
7. (Wenn Sie apigee-adminapi installiert haben) Das apigee-adminapi-Dienstprogramm wurde auf Computer 1 aktualisiert:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
8. (Wenn Sie Apigee SSO installiert haben) Aktualisieren Sie Apigee SSO auf Computer 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
  Dabei ist sso_config_file die Konfigurationsdatei, die Sie bei der Installation der SSO erstellt haben.
9. Starten Sie die UI-Komponente neu:
  - Klassische UI: Wenn Sie die klassische UI verwenden, starten Sie die Komponente edge-ui auf Computer 1 wie im folgenden Beispiel neu:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```
  - Neue Edge-Benutzeroberfläche: Wenn Sie die neue Edge-Benutzeroberfläche installiert haben, starten Sie die Komponente edge-management-ui auf der entsprechenden Maschine neu (möglicherweise nicht für Computer 1):
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
```
Clusterupgrade mit 9 Knoten

Aktualisieren Sie die folgenden Komponenten für eine Cluster-Installation mit 9 Knoten:

Eine Liste der Edge-Topologien und Knotennummern finden Sie unter Installationstopologien.
1. Aktualisieren Sie Cassandra und ZooKeeper auf Maschinen 1, 2 und 3:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```
2. Aktualisieren Sie Qpid auf den Maschinen 6 und 7:
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
```
3. Aktualisieren Sie Postgres auf Computer 8:
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
4. Aktualisieren Sie Postgres auf Computer 9:
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
5. Aktualisieren Sie LDAP auf Gerät 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
6. Aktualisieren Sie die Edge-Komponenten auf Maschinen 6, 7, 8, 9, 1, 4 und 5 in dieser Reihenfolge:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
7. Aktualisieren Sie entweder die neue UI (ue) oder die klassische UI (ui) auf Maschine 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
```
8. (Wenn Sie apigee-adminapi installiert haben) Aktualisieren Sie das Dienstprogramm apigee-adminapi auf Maschine 1:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
9. (Wenn Sie Apigee SSO installiert haben) Aktualisieren Sie Apigee SSO auf Computer 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
  Dabei ist sso_config_file die Konfigurationsdatei, die Sie bei der Installation der SSO erstellt haben.
10. Starten Sie die UI-Komponente neu:
  - Klassische UI: Wenn Sie die klassische UI verwenden, starten Sie die Komponente edge-ui auf Computer 1 wie im folgenden Beispiel neu:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```
  - Neue Edge-Benutzeroberfläche: Wenn Sie die neue Edge-Benutzeroberfläche installiert haben, starten Sie die Komponente edge-management-ui auf der entsprechenden Maschine neu (möglicherweise nicht für Computer 1):
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
```
Clusterupgrade mit 13 Knoten

Aktualisieren Sie die folgenden Komponenten für eine Clusterinstallation mit 13 Knoten:

Eine Liste der Edge-Topologien und Knotennummern finden Sie unter Installationstopologien.
1. Aktualisieren Sie Cassandra und ZooKeeper auf den Maschinen 1, 2 und 3:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```
2. Aktualisieren Sie Qpid auf den Maschinen 12 und 13:
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
```
3. Aktualisieren Sie Postgres auf Computer 8:
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
4. Aktualisieren Sie Postgres auf Computer 9:
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -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 die Edge-Komponenten auf den Maschinen 12, 13, 8, 9, 6, 7, 10 und 11 in dieser Reihenfolge:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
7. Aktualisieren Sie entweder die neue UI (ue) oder die klassische UI (ui) auf den Maschinen 6 und 7:
```
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
```
8. (Wenn Sie apigee-adminapi installiert haben) Das Dienstprogramm apigee-adminapi wurde auf den Maschinen 6 und 7 aktualisiert:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
9. (Wenn Sie Apigee SSO installiert haben) Aktualisieren Sie Apigee SSO auf den Maschinen 6 und 7:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
  Dabei ist sso_config_file die Konfigurationsdatei, die Sie bei der Installation der SSO erstellt haben.
10. Starten Sie die UI-Komponente neu:
  - Klassische UI: Wenn Sie die klassische UI verwenden, starten Sie die Komponente edge-ui auf den Maschinen 6 und 7 wie im folgenden Beispiel neu:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```
  - Neue Edge-Benutzeroberfläche: Wenn Sie die neue Edge-Benutzeroberfläche installiert haben, starten Sie die Komponente edge-management-ui auf den Maschinen 6 und 7 neu:
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
```
Clusterupgrade mit 12 Knoten

Aktualisieren Sie die folgenden Komponenten für eine Clusterinstallation mit 12 Knoten:

Eine Liste der Edge-Topologien und Knotennummern finden Sie unter Installationstopologien.
1. Aktualisieren Sie Cassandra und ZooKeeper:
  1. Auf den 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
```
2. Aktualisieren Sie qpidd:
  1. Maschinen 4, 5 im Rechenzentrum 1
    1. Aktualisieren Sie qpidd auf Gerät 4:
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
```
    2. Aktualisieren Sie qpidd auf Gerät 5:
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
```
  2. Maschinen 10, 11 im Rechenzentrum 2
    1. Aktualisieren Sie qpidd auf Gerät 10:
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
```
    2. Aktualisieren Sie qpidd auf Gerät 11:
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
```
3. Aktualisieren Sie Postgres:
  1. Maschine 6 im Rechenzentrum 1
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
  2. Maschine 12 im Rechenzentrum 2
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
4. LDAP aktualisieren:
  1. Maschine 1 im Rechenzentrum 1
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
  2. Maschine 7 im Rechenzentrum 2
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
5. Aktualisieren Sie Edge-Komponenten:
  1. Maschinen 4, 5, 6, 1, 2, 3 im Rechenzentrum 1
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
  2. Maschinen 10, 11, 12, 7, 8, 9 im Rechenzentrum 2
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
6. Aktualisieren Sie entweder die neue (ue) oder die klassische UI (ui):
  1. Maschine 1 im Rechenzentrum 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
```
  2. Maschine 7 im Rechenzentrum 2:
```
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
```
7. (Wenn Sie apigee-adminapi installiert haben) Das apigee-adminapi-Dienstprogramm wurde aktualisiert:
  1. Maschine 1 im Rechenzentrum 1:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
  2. Maschine 7 im Rechenzentrum 2:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
8. (Wenn Sie Apigee SSO installiert haben) Aktualisieren Sie Apigee SSO:
  1. Maschine 1 im Rechenzentrum 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
  2. Maschine 7 im Rechenzentrum 2:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
9. Starten Sie die neue Edge-UI (edge-management-ui) oder die klassische Edge-UI-Komponente (edge-ui) auf den Maschinen 1 und 7 neu:
```
/opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart
```
Für eine nicht standardmäßige Konfiguration

Wenn Sie eine nicht standardmäßige Konfiguration haben, aktualisieren Sie die Edge-Komponenten in der folgenden Reihenfolge:
1. ZooKeeper
2. Cassandra
3. qpidd, ps
4. LDAP
5. Edge, d. h. das Profil „-c Edge“ auf allen Knoten in der Reihenfolge: Knoten mit Qpid-Server, Edge Postgres Server, Management Server, Message Processor und Router
  HINWEIS: Wenn auf einem Knoten sowohl der Qpid-Server als auch der Edge Postgres Server installiert sind, führen Sie den Profilschritt „-c Edge“ aus.
6. Edge-Benutzeroberfläche (klassisch oder neu)
7. apigee-adminapi
8. Apigee-SSO
Starten Sie nach dem Update die Edge-UI-Komponente auf allen Maschinen neu, auf denen sie ausgeführt wird.