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 ein Upgrade von Edge for Private Cloud von Version 4.50.00 oder Version 4.51.00 direkt auf Version 4.52.00. Auf dieser Seite wird beschrieben, wie Sie ein Upgrade ausführen.

Wer das Update durchführen kann

Die Person, die das Update ausführt, muss die Person sein, die Edge ursprünglich installiert hat, oder eine Person, die als Root ausgeführt wird.

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

Welche Komponenten müssen Sie aktualisieren?

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

Voraussetzungen für die Aktualisierung

Prüfen Sie vor dem Upgrade von Apigee Edge, ob die folgenden Voraussetzungen erfüllt sind:

Alle Knoten sichern
Aus Sicherheitsgründen empfehlen wir Ihnen, vor dem Aktualisieren ein vollständiges Back-up aller Knoten zu erstellen. Führen Sie die Sicherung mit der Anleitung für Ihre aktuelle Version von Edge durch.
So haben Sie einen Notfallplan, falls das Update auf eine neue Version nicht richtig funktioniert. Weitere Informationen zum Sichern 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:
```
/opt/apigee/apigee-service/bin/apigee-all status
```
Cassandra-Komprimierungsstrategie muss LeveledCompactionStrategy sein
Die Cassandra-Komprimierungsstrategie muss auf LeveledCompactionStrategy festgelegt sein, wie unter Cassandra-Komprimierungsstrategie ändern beschrieben.

Automatische Übernahme von Hoteleigenschaften

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

Erforderliches Upgrade auf Zookeeper 3.8.0

Diese Version von Edge for Private Cloud 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 sich vor dem Upgrade von Zookeeper den Zookeeper-Wartungsleitfaden durch. 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-Wahl teilnehmen, die übrigen als Beobachter. Weitere Informationen finden Sie unter Leiter, Mitläufer, Wähler und Beobachter. Die Knoten wählen einen Leader aus, woraufhin sie selbst zu Followern werden.

Während des Aktualisierungsvorgangs kann es zu einer kurzen Verzögerung oder einem Schreibfehler in Zookeeper kommen, wenn der Führungsknoten heruntergefahren wird. Dies kann sich auf Verwaltungsvorgänge auswirken, die in Zookeeper schreiben, z. B. Bereitstellungsvorgänge eines Proxys, und auf Änderungen an der Apigee-Infrastruktur, z. B. das Hinzufügen oder Entfernen eines Message Processors. Bei der Umstellung von Zookeeper sollte es keine Auswirkungen auf die Laufzeit-APIs von Apigee geben (es sei denn, diese Laufzeit-APIs rufen Verwaltungs-APIs auf). Folgen Sie dazu der Anleitung unten.

Im Allgemeinen umfasst der Upgradeprozess das Erstellen einer Sicherung jedes Knotens. Anschließend werden alle Beobachter und Follower und schließlich der Führungsknoten aktualisiert.

Sicherung erstellen

Sichern Sie alle Zookeeper-Knoten für den Fall, dass ein Rollback erforderlich ist. Beachten Sie, dass Zookeeper durch ein Rollback in den Zustand zurückversetzt wird, in dem es sich zum Zeitpunkt der Sicherung befand. Hinweis: Alle Bereitstellungen oder Infrastrukturänderungen in Apigee seit der Sicherung (deren Informationen in Zookeeper gespeichert sind) gehen bei der Wiederherstellung verloren.

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

Wenn Sie virtuelle Maschinen verwenden und die entsprechenden Funktionen haben, können auch VM-Snapshots oder -Sicherungen zur Wiederherstellung oder Rollback erstellt werden (falls erforderlich).

Identifizieren Sie die Führungskraft, die Mitläufer und die Beobachter.

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

Wenn nc nicht auf dem ZooKeeper-Knoten installiert ist, führen Sie Folgendes aus:
```
  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 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 Sie je nach Knotenkonfiguration Beobachter, Leader oder Follower (d. h. einen Voter, der nicht der Leader ist) sehen. Hinweis: Bei einer eigenständigen Installation von Edge mit einem einzelnen ZooKeeper-Knoten ist Mode auf „standalone“ (eigenständig) gesetzt.
Wiederholen Sie die Schritte 1 und 2 auf jedem ZooKeeper-Knoten.

Zookeeper auf den Beobachter- und Follower-Knoten upgraden

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

Laden Sie Bootstrap von Edge für Private Cloud 4.52 herunter und führen Sie es aus, wie unter Update auf 4.52.00 auf einem Knoten mit externer Internetverbindung beschrieben. Der Vorgang variiert je nachdem, 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 jetzt auch für diese Knoten ein Upgrade durchführen (wie beim Profil cs,zk) oder die anderen Komponenten später upgraden. Apigee empfiehlt, zuerst nur Zookeeper zu aktualisieren und dafür zu sorgen, dass Ihr Cluster ordnungsgemäß funktioniert, bevor Sie andere Komponenten aktualisieren.
Wiederholen Sie die oben genannten Schritte für alle ZooKeeper-Beobachter- und ‑Followerknoten.

Leitende Person herunterfahren

Sobald alle Beobachter- und Followerknoten aktualisiert wurden, fahren Sie den Hauptknoten 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 ein neuer Leader ausgewählt wird, kann es während dieses Ereignisses vorübergehende Verzögerungen oder Schreibfehler in Zookeeper geben. 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 Nachrichten-Prozessoren.

Prüfen, ob der neue Leiter gewählt wurde

Prüfen Sie anhand der Schritte im Abschnitt Leiter, Mitläufer und Beobachter identifizieren oben, ob ein neuer Leiter aus den Mitläufern gewählt wurde, sobald der vorhandene Leiter gestoppt wurde. Beachten Sie, dass der neue Leader in einem anderen Rechenzentrum als der aktuelle Leader gewählt werden kann.

Beste Variante für das Upgrade

Führen Sie die Schritte unter Zookeeper auf den Beobachter- und Follower-Knoten aktualisieren aus.

Sobald der alte Leaderknoten ebenfalls aktualisiert wurde, prüfen Sie den Clusterstatus und achten Sie darauf, dass es einen Leaderknoten gibt.

Rollback

So führen Sie ein Rollback durch:

Führen Sie die Rollback-Schritte zuerst für Beobachter und Mitbeobachter aus.
Laden Sie das Bootstrap der Version herunter, auf die Sie zurückgehen möchten, also entweder 4.50 oder 4.51, und führen Sie es aus. Der Vorgang unterscheidet sich wahrscheinlich je nachdem, ob der Knoten eine externe Internetverbindung hat oder Sie die Offlineinstallation ausführen.

Beenden Sie ZooKeeper, falls es auf dem Knoten ausgeführt wird:

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

Bestehenden Zookeeper deinstallieren:

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

Installieren Sie Zookeeper wie gewohnt:

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

Nachdem alle Follower und Beobachter rückgängig gemacht wurden, rollen Sie den Leader-Knoten zurück. Gehen Sie dazu die Schritte 2 bis 5 auf dem Leader-Knoten aus.

Nachdem alle Knoten rückgängig gemacht wurden, prüfen Sie die Clusterintegrität und achten Sie darauf, dass es einen führenden Knoten im Cluster gibt.

Sicherung wiederherstellen

Weitere Informationen finden Sie unter Daten aus einer Sicherung wiederherstellen. Hinweis: Back-ups von Zookeeper aus früheren Versionen von Edge für Private Cloud wie 4.50 und 4.51 sollten mit der Zookeeper-Version in Edge für Private Cloud 4.52 kompatibel sein.

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-Standby-Replikation konfiguriert sind. Während des Aktualisierungsprozesses, wenn die Postgres-Knoten wegen der Aktualisierung nicht verfügbar sind, werden Analytics-Daten weiterhin in die Qpid-Knoten geschrieben. Nachdem die Postgres-Knoten aktualisiert und wieder online sind, werden Analysedaten an die Postgres-Knoten gesendet.

Wie Sie die PostgreSQL-Aktualisierung ausführen, hängt davon ab, wie Sie den Datenspeicher für Ihre PostgreSQL-Knoten konfiguriert haben:

Wenn Sie lokalen Datenspeicher für Ihre Postgres-Knoten verwenden, müssen Sie während des Upgrades einen neuen Postgres-Standby-Knoten installieren. Nach Abschluss des Upgrades können Sie den neuen Postgres-Standbyknoten außer Betrieb nehmen.
Der zusätzliche Postgres-Standbyknoten ist erforderlich, wenn Sie das Update aus irgendeinem Grund rückgängig machen müssen. Wenn Sie das Update rückgängig machen müssen, wird der neue Postgres-Standbyknoten nach dem Rollback zum Postgres-Masterknoten. Daher sollte der neue Postgres-Standbyknoten auf einem Knoten installiert werden, der alle Hardwareanforderungen eines Postgres-Servers erfüllt, wie in den Installationsanforderungen für Edge definiert.

In einer 1-Knoten- und 2-Knoten-Konfiguration von Edge, die für das Prototyping und Testen verwendet wird, gibt es nur einen einzigen Postgres-Knoten. Sie können diese Postgres-Knoten direkt aktualisieren, ohne einen neuen Postgres-Knoten erstellen zu müssen.
Wenn Sie wie von Apigee empfohlen Netzwerkspeicher für Ihre Postgres-Knoten verwenden, müssen Sie keinen neuen Postgres-Knoten installieren. In den folgenden Anleitungen können Sie die Schritte zum Installieren und späteren Ausmustern eines neuen Postgres-Standby-Knotens überspringen.
Bevor Sie mit dem Aktualisierungsprozess beginnen, erstellen Sie einen Netzwerk-Snapshot des von Postgres verwendeten Datenspeichers. Wenn während der Aktualisierung Fehler auftreten und Sie einen Rollback ausführen müssen, können Sie den Postgres-Knoten aus diesem Snapshot wiederherstellen.

Neuen Postgres-Standbyknoten 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), nicht für Version 4.52.00.

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

So erstellen Sie einen neuen Postgres-Standbyknoten:

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_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. In dieser Datei sollten die folgenden Zeilen angezeigt werden:
```
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 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 Installieren Sie das Hilfsprogramm für das Edge-Apigee-Setup beschrieben.
3. Wenn Sie derzeit Edge 4.51.00 verwenden:
  1. Laden Sie die Edge-Datei „bootstrap_4.51.00.sh“ auf /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 nach /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-apigee-service-Dienstprogramm und die Abhängigkeiten:
```
sudo bash /tmp/bootstrap_4.50.00.sh apigeeuser=uName apigeepassword=pWord
```
4. Verwenden Sie apigee-service, um das Dienstprogramm apigee-setup zu installieren:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
```
5. Installieren Sie Postgres:
```
/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 In-Place-Upgrade von Postgres durchführen.

Hinweis: Unter 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.

In der Postgres-Dokumentation finden Sie Informationen zu alternativen Properties, die in Postgres 14 verfügbar sind, z. B. wal_keep_size.

Vorschritt

Bevor Sie ein In-Place-Upgrade auf Postgres ausführen, führen Sie die folgenden Schritte sowohl auf dem Master- als auch auf dem Standby-Host aus, um die Property 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

Konfigurieren Sie apigee-postgresql:

apigee-service apigee-postgresql configure

Starten Sie apigee-postgresql neu:

apigee-service apigee-postgresql restart

Direktes Upgrade ausführen

So führen Sie ein In-Place-Upgrade auf Postgres 14 durch:

Postgres auf dem Masterhost aktualisieren

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

Führen Sie den Befehl „setup“ auf dem Masterhost aus:

apigee-service apigee-postgresql setup -f /opt/silent.conf

Führen Sie den Befehl „configure“ auf dem Master-Host aus:
```
apigee-service apigee-postgresql configure
```

Starten Sie den Master-Host neu:

apigee-service apigee-postgresql restart

Konfigurieren Sie ihn als Master:

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

Vergewissern Sie sich, dass der Master-Host gestartet wurde:
```
apigee-service apigee-postgresql wait_for_ready
```
Beenden Sie den Standby:
```
apigee-service apigee-postgresql stop
```
Aktualisieren Sie den Standby.
Hinweis:Wenn dieser Schritt fehlschlägt oder fehlschlägt, kann er ignoriert werden. update.sh versucht, den Standby-Server mit einer falschen Konfiguration zu starten. Wenn die Postgres-Installation auf Version 14 aktualisiert wird, 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 der Standby-Modus gestartet.

Postgres-Knoten außer Betrieb nehmen

Stellen Sie den neuen Standby-Knoten nach Abschluss des Updates 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 Standby-Knotens ab, indem Sie auf dem neuen Standby-Knoten den folgenden curl-Befehl ausführen:
```
curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self
```
Die UUID des Knotens sollte am Ende der Ausgabe im folgenden 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 /opt/apigee/customer/application/postgresql.properties auf dem Postgres-Masterknoten, um den neuen Standby-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, indem Sie die Datei /opt/apigee/apigee-postgresql/conf/pg_hba.conf auf dem Master aufrufen. In dieser Datei sollte nur die folgende Zeile angezeigt werden:
```
host replication apigee existing_standby_ip/32 trust
```
Löschen Sie die UUID des Standby-Knotens aus ZooKeeper, indem Sie den folgenden Edge Management API-Aufruf auf dem Management-Serverknoten ausführen:
```
curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/new_standby_uuid
```

Schritte nach dem Upgrade für Postgres

Nach einem größeren Postgres-Upgrade werden die internen Statistiken von Postgres gelöscht. Diese Statistiken helfen dem Postgres-Abfrageplaner, die optimalen Indexe und Pfade zum Ausführen von Abfragen zu verwenden.

Postgres kann seine Statistiken im Laufe der Zeit nach und nach neu erstellen, wenn Abfragen ausgeführt und der Autovacuum-Daemon ausgeführt wird. Bis die Statistiken neu erstellt sind, sind Ihre Abfragen jedoch möglicherweise langsam.

Führen Sie zum Beheben dieses Problems ANALYZE auf allen Tabellen in der Datenbank auf dem Master-Postgres-Knoten aus. Alternativ können Sie ANALYZE für mehrere Tabellen gleichzeitig ausführen.

HINWEIS: ANALYZE kann lange dauern, erfordert aber nur eine Lesesperre für die Tabelle. Andere Vorgänge in Postgres können also während der Ausführung von ANALYZE fortgesetzt werden.

Neue Edge-Benutzeroberfläche

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

Edge-Benutzeroberfläche installieren

Nach der Erstinstallation empfiehlt Apigee, die Edge-Benutzeroberfläche zu installieren. Das ist eine erweiterte Benutzeroberfläche für Entwickler und Administratoren von Apigee Edge for Private Cloud.

Für die Edge-Benutzeroberfläche müssen Sie die Standardauthentifizierung deaktivieren und einen IdP wie SAML oder LDAP verwenden.

Weitere Informationen finden Sie unter Installieren der neuen Edge-Benutzeroberfläche.

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 (die neue Edge-Benutzeroberfläche ist bereits installiert): Folgen Sie der Anleitung zum Upgrade in diesem Abschnitt für die edge-management-ui-Komponente.

Mit Apigee mTLS aktualisieren

Führen Sie die folgenden Schritte aus , um Apigee mTLS zu aktualisieren:

Aktualisierung rückgängig machen

Tritt bei der Aktualisierung ein Fehler auf, 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.

Falls für den Fehler ein Rollback des Updates auf die vorherige Version durchgeführt werden muss, finden Sie unter Rollback für Version 4.52.00 eine ausführliche Anleitung.

Informationen zum Logging von Updates

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

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

Wenn die Person, die das update.sh-Dienstprogramm ausführt, keinen Zugriff auf dieses Verzeichnis hat, wird das Protokoll als Datei namens update_username.log in das Verzeichnis /tmp geschrieben.

Wenn die Person keinen Zugriff auf /tmp hat, schlägt das update.sh-Dienstprogramm fehl.

Aktualisierung ohne Ausfallzeiten

Mit einem Update ohne Ausfallzeit oder einem Rolling Update können Sie Ihre Edge-Installation aktualisieren, ohne dass Edge heruntergefahren werden muss.

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

Der Schlüssel zu einem Upgrade ohne Ausfallzeit 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 den Router dann wieder dem Load-Balancer hinzu.

Aktualisieren Sie die Computer 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 der Router aus und machen Sie ihn nicht erreichbar, wie unter Erreichbarkeit des Servers (Nachrichtenprozessor/Routers) 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 an.
Sorgen Sie dafür, dass der Router wieder erreichbar ist.
Wiederholen Sie die Schritte 2 bis 4 für die übrigen Router.
Fahren Sie mit dem Update für alle verbleibenden Computer in Ihrer Installation fort.

Achten Sie vor und nach dem Update auf Folgendes:

Auf einem kombinierten Router- und Message Processor-Knoten:
- Vor dem Update:
  1. Den Router unerreichbar machen.
  2. Machen Sie den Message Processor nicht erreichbar.
- Nach dem Update:
  1. Sorgen Sie dafür, dass der Message Processor erreichbar ist.
  2. Sorgen Sie dafür, dass der Router erreichbar ist.
Auf einzelnen Routerknoten:
- Machen Sie den Router vor dem Update unzugänglich.
- Sorgen Sie nach dem Update dafür, dass der Router erreichbar ist.
Auf einzelnen Nachrichtenverarbeiterknoten:
- Machen Sie den Nachrichten-Prozessor vor dem Update unzugänglich.
- Sorgen Sie nach dem Update dafür, dass der Nachrichten-Prozessor erreichbar ist.

Konfigurationsdatei im Hintergrund verwenden

Sie müssen dem Befehl „update“ eine Konfigurationsdatei für die Installation ohne Benutzerinteraktion übergeben. Die Datei für die stille Konfiguration sollte die Datei sein, die Sie bei der Installation von Edge 4.50.00 oder 4.51.00 verwendet haben.

Auf einem Knoten mit einer externen Internetverbindung auf Version 4.52.00 aktualisieren

So aktualisieren Sie die Edge-Komponenten auf einem Knoten:

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

Wenn Sie in AWS installieren, 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 Dienstprogramm apigee-service und die Abhängigkeiten für Edge 4.52.00 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, ihn einzugeben.
  
  Standardmäßig prüft das Installationsprogramm, ob Java 1.8 installiert ist. Andernfalls installiert das Installationsprogramm es für Sie.
  
  Verwenden Sie die Option JAVA_FIX, um anzugeben, wie die Java-Installation erfolgen soll. JAVA_FIX verwendet die folgenden Werte:
  - I: Installieren Sie OpenJDK 1.8 (Standardeinstellung).
  - C: Ohne Installation von Java fortfahren.
  - Q: Beenden. Bei dieser Option müssen Sie Java selbst installieren.
3. Verwenden Sie apigee-service, um das Dienstprogramm apigee-setup zu aktualisieren, wie im folgenden Beispiel gezeigt:
```
/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 apigee-provision-Dienstprogramm auf dem Verwaltungsserver, wie im folgenden Beispiel gezeigt:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
```
6. Führen Sie das Dienstprogramm update auf Ihren Knoten mit dem folgenden Befehl aus:
```
/opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
```
  Gehen Sie dabei in der unter Reihenfolge der Maschinenaktualisierung beschriebenen Reihenfolge vor.
  
  Wobei:
  - component ist die Edge-Komponente, die aktualisiert werden soll. Mögliche Werte:
    - cs: Cassandra
    - edge: Alle Edge-Komponenten mit Ausnahme der Edge-Benutzeroberfläche: Management-Server, Nachrichtenprozessor, Router, QPID-Server, Postgres-Server
    - ldap: OpenLDAP
    - ps: postgresql
    - qpid: qpidd
    - sso: Apigee SSO (falls Sie SSO installiert haben)
    - ue: Neue Edge-Benutzeroberfläche
    - ui: Klassische Edge-Benutzeroberfläche
    - zk: Zoowärter
  - configFile ist dieselbe Konfigurationsdatei, mit der Sie bei der Installation von 4.50.00 oder 4.51.00 Ihre Edge-Komponenten definiert haben.
  Sie können update.sh für alle Komponenten ausführen, indem Sie component auf „alle“ setzen. Dies ist jedoch nur möglich, 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 noch nicht geschehen:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```
8. Testen Sie das Update, indem Sie das Dienstprogramm apigee-validate auf dem Verwaltungsserver ausführen, wie unter Installation testen beschrieben.
Wenn Sie das Update später rückgängig machen möchten, folgen Sie der Anleitung unter 4.52.00 rückgängig machen.

Über ein lokales Repository auf Version 4.52.00 aktualisieren

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

Nachdem Sie ein lokales Edge-Repository erstellt haben, haben Sie zwei Möglichkeiten, Edge aus dem lokalen Repository zu aktualisieren:
- Erstellen Sie eine TAR-Datei des Repositorys, kopieren Sie die TAR-Datei auf einen Knoten und aktualisieren Sie Edge dann ü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. Sie können aber auch Ihren eigenen Webserver verwenden.
So aktualisieren Sie über ein lokales 4.52.00-Repository:
1. Erstellen Sie ein lokales 4.52.00-Repository, wie unter Installieren Sie das Hilfsprogramm für das Edge-Apigee-Setup im Abschnitt „Create a local Apigee repository“ (Lokales Apigee-Repository erstellen) beschrieben.
  HINWEIS: Wenn Sie bereits ein Repository haben, können Sie ihm das Repository 4.52.00 hinzufügen. Eine entsprechende Anleitung finden Sie unter Edge-Apigee-Einrichtungs-Dienstprogramm installieren im Abschnitt „Lokales Apigee-Repository aktualisieren“.
2. So installieren Sie den Apigee-Dienst aus einer TAR-Datei:
  1. Verpacken Sie das lokale Repository auf dem Knoten mit dem lokalen Repository mit dem folgenden Befehl in einer einzelnen TAR-Datei mit dem Namen /opt/apigee/data/apigee-mirror/apigee-4.52.00.tar.gz:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
```
  2. Kopieren Sie die .tar-Datei auf den Knoten, auf dem Sie Edge aktualisieren möchten. Kopieren Sie ihn beispielsweise in das Verzeichnis /tmp auf dem neuen Knoten.
  3. Entpacken Sie die Datei auf dem neuen Knoten im Verzeichnis /tmp:
```
tar -xzf apigee-4.52.00.tar.gz
```
    Mit diesem Befehl wird im Verzeichnis mit der .tar-Datei ein neues Verzeichnis mit dem Namen repos erstellt. z. B. /tmp/repos.
  4. Installieren Sie das Edge-Dienstprogramm apigee-service und die Abhängigkeiten aus /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 Verzeichnis „repos“ angeben.
3. So installieren Sie apigee-service mit dem Nginx-Webserver:
  1. Konfigurieren Sie den Nginx-Webserver wie unter Installieren Sie das Hilfsprogramm für das Edge-Apigee-Setup unter „Über den Nginx-Webserver aus dem Repository installieren“ beschrieben.
  2. Laden Sie auf dem Remote-Knoten die Edge-Datei bootstrap_4.52.00.sh 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 zu aktualisieren, wie im folgenden Beispiel gezeigt:
```
/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 unter Reihenfolge des Maschinenupdates beschriebenen Reihenfolge aus:
```
/opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
```
  Wobei:
  - component ist die Edge-Komponente, die aktualisiert werden soll. Normalerweise aktualisieren Sie die folgenden Komponenten:
    - cs: Cassandra
    - edge: Alle Edge-Komponenten mit Ausnahme der Edge-Benutzeroberfläche: Management-Server, Nachrichtenprozessor, Router, QPID-Server, Postgres-Server
    - ldap: OpenLDAP
    - ps: postgresql
    - qpid: qpidd
    - sso: Apigee SSO (falls Sie SSO installiert haben)
    - ue Neue Edge-Benutzeroberfläche
    - ui: Klassische Edge-Benutzeroberfläche
    - zk: Zookeeper
  - configFile ist dieselbe Konfigurationsdatei, mit der Sie bei der Installation von 4.50.00 oder 4.51.00 Ihre Edge-Komponenten definiert haben.
    HINWEIS: Die Konfigurationsdatei muss für den Nutzer „apigee“ lesbar sein. Verwenden Sie den folgenden Befehl, um den Eigentümer zu ändern:
    chown apigee:apigee configFile
  Sie können update.sh auf alle Komponenten anwenden, indem Sie component auf „alle“ festlegen. Das ist aber nur möglich, wenn Sie ein Edge-AIO-Installationsprofil (All-in-One) 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 Sie dies noch nicht getan haben:
```
/opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
```
9. Testen Sie das Update, indem Sie das apigee-validate-Dienstprogramm auf dem Verwaltungsserver ausführen, wie unter Installation testen beschrieben.
Wenn Sie das Update später rückgängig machen möchten, folgen Sie der Anleitung unter 4.52.00 rückgängig machen.

Reihenfolge der Maschinenaktualisierung

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 die Option -c edge, um alle Edge-Komponenten (Management-Server, Nachrichtenprozessor, Router, QPID-Server, aber nicht Postgres-Server) auf einem Computer gleichzeitig zu aktualisieren.
- Wenn ein Schritt angibt, dass er auf mehreren Rechnern ausgeführt werden soll, führen Sie ihn in der angegebenen Maschinenreihenfolge aus.
- Es gibt keinen separaten Schritt, um die Monetarisierung zu aktualisieren. Sie wird aktualisiert, wenn Sie die Option -c edge angeben.
HINWEIS: Nachdem Sie die Edge-Benutzeroberfläche aktualisiert haben, müssen Sie den Edge-Benutzeroberflächendienst wie in der Installationsanleitung für das Update beschrieben neu starten.

Eigenständiges Upgrade für 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 Dienstprogramm apigee-adminapi wurde aktualisiert:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
Eigenständiges Upgrade für 2 Knoten

Aktualisieren Sie bei einer eigenständigen Installation mit zwei Knoten die folgenden Komponenten:

Eine Liste der Edge-Topologien und Knotennummern finden Sie unter Installationstopologien.
1. Cassandra und ZooKeeper auf Computer 1 aktualisieren:
```
/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. LDAP auf Computer 1 aktualisieren:
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
4. Aktualisieren Sie die Edge-Komponenten auf Computer 2 und 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
5. Aktualisieren Sie die Benutzeroberfläche auf Computer 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
```
6. (Wenn Sie apigee-adminapi installiert haben) Aktualisieren Sie das apigee-adminapi-Dienstprogramm auf Computer 1:
```
/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 beim Installieren von SSO erstellt haben.
8. Starten Sie die Edge-Benutzeroberflächenkomponente auf Maschine 1 neu:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```
Upgrade mit 5 Knoten

Aktualisieren Sie bei einer Installation mit fünf Knoten die folgenden Komponenten:

Eine Liste der Edge-Topologien und Knotennummern finden Sie unter Installationstopologien.
1. Aktualisieren Sie Cassandra und ZooKeeper auf Computer 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. LDAP auf Gerät 1 aktualisieren:
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
5. Aktualisieren Sie die Edge-Komponenten auf Maschine 4, 5, 1, 2, 3:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
6. Edge-Benutzeroberfläche aktualisieren:
  - Klassische Benutzeroberfläche: Wenn Sie die klassische Benutzeroberfläche verwenden, aktualisieren Sie die ui-Komponente 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 ue-Komponente auf dem entsprechenden Computer (muss nicht Computer 1 sein):
```
/opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
```
7. (Wenn Sie apigee-adminapi installiert haben) Aktualisieren Sie das apigee-adminapi-Dienstprogramm auf Computer 1:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
8. (Wenn Sie Apigee-SSO installiert haben) Aktualisieren Sie die Apigee-SSO auf Maschine 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
  Dabei ist sso_config_file die Konfigurationsdatei, die Sie beim Installieren von SSO erstellt haben.
9. Starte die UI-Komponente neu:
  - Klassische Benutzeroberfläche: Wenn Sie die klassische Benutzeroberfläche verwenden, starten Sie die edge-ui-Komponente auf Computer 1 neu, wie im folgenden Beispiel gezeigt:
```
/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 edge-management-ui-Komponente auf dem entsprechenden Computer neu (muss nicht Computer 1 sein):
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
```
Upgrade eines Clusters mit 9 Knoten

Aktualisieren Sie die folgenden Komponenten für eine Clusterinstallation mit 9 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 6 und 7:
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
```
3. Postgres auf Computer 8 aktualisieren:
```
/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. LDAP auf Computer 1 aktualisieren:
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
6. Aktualisieren Sie die Edge-Komponenten auf den Maschinen 6, 7, 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 Benutzeroberfläche (ue) oder die klassische Benutzeroberfläche (ui) auf Computer 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
```
8. (Wenn Sie apigee-adminapi installiert haben) Aktualisieren Sie das apigee-adminapi-Dienstprogramm auf Computer 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 Einmalanmeldung (SSO) erstellt haben.
10. Starte die UI-Komponente neu:
  - Klassische Benutzeroberfläche: Wenn Sie die klassische Benutzeroberfläche verwenden, starten Sie die edge-ui-Komponente auf Computer 1 neu, wie im folgenden Beispiel gezeigt:
```
/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 edge-management-ui-Komponente auf dem entsprechenden Computer neu (muss nicht Computer 1 sein):
```
/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 den Maschinen 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 Benutzeroberfläche (ue) oder die klassische Benutzeroberfläche (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) apigee-adminapi-Dienstprogramm auf den Computern 6 und 7 aktualisiert:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
9. (Wenn Sie Apigee-SSO installiert haben) Aktualisieren Sie die Apigee-SSO auf den Computern 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 Einmalanmeldung (SSO) erstellt haben.
10. Starte die UI-Komponente neu:
  - Klassische Benutzeroberfläche: Wenn Sie die klassische Benutzeroberfläche verwenden, starten Sie die edge-ui-Komponente auf den Maschinen 6 und 7 neu, wie im folgenden Beispiel gezeigt:
```
/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 Computern 6 und 7 neu:
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
```
Cluster mit 12 Knoten upgraden

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 in Rechenzentrum 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```
  2. Auf den Maschinen 7, 8 und 9 in Rechenzentrum 2
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```
2. Aktualisieren Sie qpidd:
  1. Maschinen 4, 5 in Rechenzentrum 1
    1. qpidd auf Computer 4 aktualisieren:
      /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 und 11 in Rechenzentrum 2
    1. qpidd auf Computer 10 aktualisieren:
      /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
    2. qpidd auf Computer 11 aktualisieren:
      /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
3. Aktualisieren Sie Postgres:
  1. Maschine 6 in Rechenzentrum 1
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
  2. Maschine 12 in Rechenzentrum 2
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
4. LDAP aktualisieren:
  1. Maschine 1 in Rechenzentrum 1
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
  2. Maschine 7 in Rechenzentrum 2
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
5. Aktualisieren Sie die Edge-Komponenten:
  1. Maschinen 4, 5, 6, 1, 2 und 3 in Rechenzentrum 1
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
  2. Maschinen 10, 11, 12, 7, 8 und 9 in Rechenzentrum 2
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
6. Aktualisieren Sie entweder die neue Benutzeroberfläche (ue) oder die klassische Benutzeroberfläche (ui):
  1. Maschine 1 in Rechenzentrum 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
```
  2. Maschine 7 in Rechenzentrum 2:
```
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
```
7. (Wenn Sie apigee-adminapi installiert haben) apigee-adminapi-Dienstprogramm aktualisiert:
  1. Maschine 1 in Rechenzentrum 1:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
  2. Maschine 7 in 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 in Rechenzentrum 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
  2. Maschine 7 in Rechenzentrum 2:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
9. Starten Sie die neue Edge-Benutzeroberfläche (edge-management-ui) oder die klassische Edge-Benutzeroberfläche (edge-ui) auf den Computern 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, Verwaltungsserver, Nachrichtenprozessor und Router.
  HINWEIS: Wenn auf einem Knoten sowohl ein Qpid-Server als auch ein Edge Postgres-Server installiert ist, führen Sie den Profilschritt „-c edge“ aus.
6. Edge-Benutzeroberfläche (entweder klassisch oder neu)
7. apigee-adminapi
8. Apigee SSO
Nach Abschluss der Aktualisierung müssen Sie die Edge-UI-Komponente auf allen Computern neu starten, auf denen sie ausgeführt wird.