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 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 kann das Update ausführen?

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, kann jeder sie konfigurieren.

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 aus.
So haben Sie einen Notfallplan, falls das Update auf eine neue Version nicht richtig funktioniert. Weitere Informationen zur Sicherung finden Sie unter Sicherung und Wiederherstellung.
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 Clouds 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 Änderungen an der Apigee-Infrastruktur, z. B. das Hinzufügen oder Entfernen eines Message Processors. Bei der Umstellung von Zookeeper sollten die Laufzeit-APIs von Apigee nicht beeinträchtigt werden, es sei denn, diese Laufzeit-APIs rufen Verwaltungs-APIs auf. Folgen Sie dazu der Anleitung unten.

Im Großen und Ganzen umfasst der Upgradeprozess die 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 Möglichkeit dazu haben, können Sie auch VM-Snapshots oder ‑Sicherungen zur Wiederherstellung oder zum Rollback (falls erforderlich) erstellen.

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 auf dem Knoten den folgenden nc-Befehl 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 sollte je nach Knotenkonfiguration „observer“, „leader“ oder „follower“ (d. h. ein Wähler, der nicht der Leader ist) angezeigt werden. 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 aktualisieren

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

Laden Sie das Bootstrap von Edge for Private Cloud 4.52 herunter und führen Sie es aus, wie unter Auf einem Knoten mit einer externen Internetverbindung auf 4.52.00 aktualisieren beschrieben. Der Vorgang variiert je nachdem, ob der Knoten eine externe Internetverbindung hat oder ob Sie eine Offlineinstallation ausführen.
Aktualisieren Sie die Zookeeper-Komponente:
```
  /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 diese jetzt auch aktualisieren (z. B. mit dem cs,zk-Profil) oder die anderen Komponenten später aktualisieren. 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

Beachten Sie, dass es während dieses Ereignisses, bevor ein neuer Leader gewählt wird, zu kurzen Verzögerungen oder Schreibfehlern in Zookeeper kommen kann. 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 Follower 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

Deinstallieren Sie den vorhandenen ZooKeeper:

  /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 PostgreSQL-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 Analysedaten 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 für Ihre Postgres-Knoten lokalen Datenspeicher 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 des Updates 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 auch 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, indem Sie die Datei /opt/apigee/apigee-postgresql/conf/pg_hba.conf auf dem Master aufrufen. 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, mit der Sie die aktuelle Version von Edge installiert haben, und geben Sie Folgendes an:
```
# 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-Apigee-Einrichtungsprogramm installieren 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 „bootstrap_4.50.00.sh“ von Edge auf /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 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 handelt.

Direktes Upgrade von Postgres durchfü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.

Vorabschritt

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 Masterhost 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

Prüfen Sie, ob 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 bei diesem Schritt ein Fehler auftritt, 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 vorbereitenden Schritt hinzugefügt.

Nach Abschluss dieses Vorgangs wird der Standby-Modus gestartet.

Postgres-Knoten außer Betrieb setzen

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 den folgenden curl-Befehl auf dem neuen Standby-Knoten 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"
```
Stoppen Sie den neuen Standby-Knoten, indem Sie den folgenden Befehl auf dem neuen Standby-Knoten ausführen:
```
/opt/apigee/apigee-service/bin/apigee-all stop
```
Bearbeiten Sie auf dem Postgres-Masterknoten /opt/apigee/customer/application/postgresql.properties, um den neuen Standbyknoten 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 für die Ausführung 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 Abschluss der Erstinstallation empfiehlt Apigee, die Edge-Benutzeroberfläche zu installieren. Dies 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 Neue Edge-Benutzeroberfläche installieren.

Edge-Benutzeroberfläche aktualisieren

Berücksichtigen Sie beim Aktualisieren der Edge-UI-Komponente die Version von Edge für die Private Cloud, von der Sie ein Upgrade durchfü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

So aktualisieren Sie Apigee mTLS:

Aktualisierung rückgängig machen

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

Wenn Sie aufgrund des Fehlers das Update auf die vorherige Version zurücksetzen müssen, finden Sie unter 4.52.00 rückgängig machen eine detaillierte Anleitung.

Informationen zum Logging von Updates

Standardmäßig schreibt das update.sh-Dienstprogramm Loginformationen an folgende Stellen:

/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. Aktualisieren Sie dann den Router und alle anderen Komponenten auf demselben Computer wie den Router und fügen Sie den Router dem Load Balancer wieder hinzu.

Aktualisieren Sie die Maschinen in der richtigen Reihenfolge für Ihre Installation, wie unter Reihenfolge der Maschinenaktualisierung 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 (Nachrichtenprozessor/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 Nachrichtenprozessor 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.

Beachten Sie vor und nach dem Update Folgendes:

Auf einem kombinierten Router- und Nachrichtenprozessorknoten:
- Vor dem Update:
  1. Den Router unerreichbar machen.
  2. Sorgen Sie dafür, dass der Nachrichtenverarbeiter nicht erreichbar ist.
- Nach dem Update:
  1. Sorgen Sie dafür, dass der Message Processor erreichbar ist.
  2. Sorgen Sie dafür, dass der Router erreichbar ist.
Auf 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.

Silent-Konfigurationsdatei verwenden

Sie müssen dem Befehl „update“ eine Konfigurationsdatei für die Installation ohne Benutzerinteraktion übergeben. Die stille Konfigurationsdatei muss dieselbe sein, mit der Sie Edge 4.50.00 oder 4.51.00 installiert 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 Durchführung eines Reparaturvorgangs auf Cassandra konfiguriert sind, bis das Update abgeschlossen ist.
Melden Sie sich als Root auf dem Knoten an, um die Edge-RPMs zu installieren.
HINWEIS:Für die RPM-Installation ist Root-Zugriff erforderlich. Die Edge-Konfiguration kann jedoch auch ohne Root-Zugriff durchgeführt werden.
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 Edge-Apigee-Einrichtungsprogramm installieren 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 die Installation in AWS ausfü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-bootstrap_4.52.00.sh-Datei auf /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, sie einzugeben.
  
  Standardmäßig prüft das Installationsprogramm, ob Java 1.8 installiert ist. Andernfalls wird sie vom Installationsprogramm für Sie installiert.
  
  Verwenden Sie die Option JAVA_FIX, um anzugeben, wie die Java-Installation erfolgen soll. JAVA_FIX kann folgende Werte haben:
  - I: OpenJDK 1.8 installieren (Standard).
  - C: Ohne 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 apigee-validate-Dienstprogramm 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: Verwaltungsserver, 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.
  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 ./sa_silent_config
```
7. Starten Sie die Edge-UI-Komponenten auf allen Knoten neu, auf denen sie ausgeführt werden, falls Sie dies noch nicht getan haben:
```
/opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
```
8. 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.

Ü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 aus einem lokalen Repository oder einem Spiegel 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 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 Edge apigee-setup-Dienstprogramm installieren unter „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 apigee-service aus einer .tar-Datei:
  1. Verpacken Sie das lokale Repository auf dem Knoten mit dem lokalen Repository mit dem folgenden Befehl in einer einzelnen TAR-Datei mit dem Namen /opt/apigee/data/apigee-mirror/apigee-4.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 es 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 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 Edge APIgee-Setup-Dienstprogramm installieren unter „Über das Repository mit dem Nginx-Webserver 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 apigee-setup-Dienstprogramm 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 apigee-validate-Dienstprogramm auf dem Verwaltungsserver, wie im folgenden Beispiel gezeigt:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
```
6. Aktualisieren Sie das apigee-provision-Dienstprogramm auf dem Verwaltungsserver, wie im folgenden Beispiel gezeigt:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
```
7. Führen Sie das update-Dienstprogramm auf Ihren Knoten in der in Reihenfolge der Aktualisierung von Computern 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: Verwaltungsserver, Nachrichtenprozessor, Router, QPID-Server, Postgres-Server
    - ldap: OpenLDAP
    - ps: postgresql
    - qpid: qpidd
    - sso: Apigee SSO (falls Sie SSO installiert haben)
    - ue New 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 werden, falls noch nicht geschehen:
```
/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 für einen Schritt angegeben ist, dass er auf mehreren Maschinen ausgeführt werden soll, führen Sie ihn in der angegebenen Maschinenreihenfolge aus.
- Es gibt keinen separaten Schritt zum Aktualisieren der Monetarisierung. 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 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 mit zwei 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. 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-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 den 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. LDAP auf Computer 1 aktualisieren:
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
5. Edge-Komponenten auf den Maschinen 4, 5, 1, 2 und 3 aktualisieren:
```
/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 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.
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. Aktualisieren Sie Postgres auf Computer 8:
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
4. Postgres auf Computer 9 aktualisieren:
```
/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 beim Installieren von 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. Postgres auf Computer 9 aktualisieren:
```
/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) Das 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 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 beim Installieren von 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 edge-management-ui-Komponente auf den Computern 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 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 und 5 in Rechenzentrum 1
    1. qpidd auf Computer 4 aktualisieren:
      /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
    2. qpidd auf Computer 5 aktualisieren:
      /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 im 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 Komponente „Neue Edge-Benutzeroberfläche“ (edge-management-ui) oder „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 Schritt „-c edge“ aus.
6. Edge-Benutzeroberfläche (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.