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

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 beide Upgrades durchführen.

Wer kann das Update durchführen?

Die Person, die das Update ausführt, sollte dieselbe 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 sie jeder 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 aktualisieren

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

Alle Knoten sichern
Vor dem Update empfehlen wir, aus Sicherheitsgründen eine vollständige Sicherung aller Knoten durchzuführen. Führen Sie die Sicherung gemäß dem Verfahren für Ihre aktuelle Edge-Version durch.
So haben Sie einen Notfallplan, falls das Update auf eine neue Version nicht ordnungsgemäß funktioniert. Weitere Informationen zur Sicherung finden Sie unter Sichern und Wiederherstellen.
Prüfen, ob Edge ausgeführt wird
Prüfen Sie mit dem folgenden Befehl, ob Edge während des Aktualisierungsvorgangs ausgeführt wird:
```
/opt/apigee/apigee-service/bin/apigee-all status
```
Prüfen, ob die Cassandra-Komprimierungsstrategie LeveledCompactionStrategy ist
Prüfen Sie, ob die Cassandra-Komprimierungsstrategie auf LeveledCompactionStrategy festgelegt ist, wie unter Cassandra-Komprimierungsstrategie ändern beschrieben.

Automatische Übernahme von Property-Einstellungen

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

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 vor dem Upgrade von Zookeeper den Zookeeper-Wartungsleitfaden. Die meisten Edge-Produktionssysteme verwenden einen Cluster von ZooKeeper-Knoten, die über mehrere Rechenzentren verteilt sind. Einige dieser Knoten sind als Wähler konfiguriert, die an der Zookeeper-Leader-Wahl teilnehmen, und die restlichen sind als Beobachter konfiguriert. Weitere Informationen finden Sie unter Leader, Follower, Voter und Observer. Die Voter-Knoten wählen einen Leader, woraufhin die Voter-Knoten selbst zu Followern werden.

Während des Aktualisierungsvorgangs kann es zu einer vorübergehenden Verzögerung oder einem Schreibfehler in Zookeeper kommen, wenn der Leader-Knoten heruntergefahren wird. Dies kann sich auf Verwaltungsvorgänge auswirken, die in Zookeeper schreiben, z. B. die Bereitstellung eines Proxys, und auf Änderungen an der Apigee-Infrastruktur, z. B. das Hinzufügen oder Entfernen eines Message Processors usw. Die Laufzeit-APIs von Apigee sollten während des Upgrades von Zookeeper nicht beeinträchtigt werden (es sei denn, diese Laufzeit-APIs rufen Verwaltungs-APIs auf), wenn Sie das folgende Verfahren befolgen.

Im Großen und Ganzen umfasst der Upgradeprozess das Erstellen einer Sicherung jedes Knotens. Anschließend werden alle Beobachter und Follower und schließlich der Leader-Knoten aktualisiert.

Sicherung erstellen

Erstellen Sie eine Sicherung aller ZooKeeper-Knoten, falls ein Rollback erforderlich ist. Beachten Sie, dass ein Rollback ZooKeeper in den Zustand zurückversetzt, 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 während der Wiederherstellung verloren.

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

Wenn Sie virtuelle Maschinen verwenden und die Möglichkeit dazu haben, können Sie auch VM-Snapshots oder -Backups für die Wiederherstellung oder den Rollback (falls erforderlich) erstellen.

Leader, Follower und Beobachter identifizieren

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

Wenn es nicht auf dem ZooKeeper-Knoten installiert ist, installieren Sie nc:
```
  sudo yum install nc
```
Führen Sie den folgenden nc-Befehl auf dem Knoten aus, wobei 2181 der ZooKeeper-Port ist:
```
  echo stat | nc localhost 2181
```
Die Ausgabe sollte 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“ (also ein Voter, der nicht der Leader ist) angezeigt werden. Hinweis: Bei einer eigenständigen Installation von Edge mit einem einzelnen ZooKeeper-Knoten wird Mode auf „standalone“ 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 den Bootstrap von Edge for Private Cloud 4.52 herunter und führen Sie ihn aus, wie unter Auf einem Knoten mit einer externen Internetverbindung auf 4.52.00 aktualisieren beschrieben. Der Prozess variiert wahrscheinlich je nachdem, ob der Knoten eine externe Internetverbindung hat oder ob Sie eine Offline-Installation durchfü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 zu prüfen, ob Ihr Cluster ordnungsgemäß funktioniert, bevor Sie andere Komponenten aktualisieren.
Wiederholen Sie die obigen Schritte auf jedem der Zookeeper-Beobachter- und Follower-Knoten.

Leader herunterfahren

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

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

Beachten Sie, dass es während dieses Ereignisses, bevor ein neuer Leader gewählt wird, zu vorübergehenden Verzögerungen oder Schreibfehlern in Zookeeper kommen kann. Dies kann sich auf Vorgänge auswirken, die in Zookeeper schreiben, z. B. die Bereitstellung von Proxys oder Änderungen an der Apigee-Infrastruktur, z. B. das Hinzufügen oder Entfernen von Message Processors.

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

Prüfen Sie anhand der Schritte im Abschnitt Leader, Follower und Beobachter identifizieren oben, ob ein neuer Leader aus den Followern gewählt wurde, sobald der vorhandene Leader beendet wurde. Beachten Sie, dass der Leader in einem anderen Rechenzentrum als der aktuelle Leader gewählt worden sein könnte.

Upgrade-Leader

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

Nachdem der alte Leader-Knoten ebenfalls aktualisiert wurde, prüfen Sie den Clusterzustand und stellen Sie sicher, dass ein Leader-Knoten vorhanden ist.

Rollback

Falls ein Rollback erforderlich ist:

Führen Sie die Rollback-Schritte zuerst für Beobachter und Follower aus.
Laden Sie die Bootstrap-Datei der Version herunter, auf die Sie ein Rollback durchführen möchten (entweder 4.50 oder 4.51), und führen Sie sie aus. Der Vorgang hängt wahrscheinlich davon ab, ob der Knoten eine externe Internetverbindung hat oder ob Sie eine Offlineinstallation durchführen.

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

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

Vorhandenen ZooKeeper deinstallieren:

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

Installieren Sie ZooKeeper wie gewohnt:

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

Nachdem alle Follower und Beobachter zurückgesetzt wurden, setzen Sie den Leader-Knoten zurück. Folgen Sie dazu den Schritten 2 bis 5 auf dem Leader-Knoten.

Nachdem alle Knoten zurückgesetzt wurden, prüfen Sie den Zustand des Clusters und stellen Sie sicher, dass ein Leader-Knoten im Cluster vorhanden ist.

Sicherung wiederherstellen

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

Erforderliches Upgrade auf Postgres 14

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

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

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

Wenn Sie einen lokalen Datenspeicher für Ihre Postgres-Knoten verwenden, müssen Sie für die Dauer des Upgrades einen neuen Postgres-Standby-Knoten installieren. Nach Abschluss des Upgrades können Sie den neuen Postgres-Standby-Knoten außer Betrieb nehmen.
Der zusätzliche Postgres-Standby-Knoten ist erforderlich, wenn Sie das Update aus irgendeinem Grund zurücksetzen müssen. Wenn Sie das Update rückgängig machen müssen, wird der neue Postgres-Standby-Knoten nach dem Rollback zum Master-Postgres-Knoten. Wenn Sie den neuen Postgres-Standby-Knoten installieren, sollte er sich auf einem Knoten befinden, 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, Topologien, die für Prototyping und Tests verwendet werden, haben Sie nur einen einzigen Postgres-Knoten. Sie können diese Postgres-Knoten direkt aktualisieren, ohne einen neuen Postgres-Knoten erstellen zu müssen.
Wenn Sie Netzwerkspeicher für Ihre Postgres-Knoten verwenden, wie von Apigee empfohlen, müssen Sie keinen neuen Postgres-Knoten installieren. In den folgenden Verfahren können Sie die Schritte überspringen, in denen die Installation und spätere Außerbetriebnahme eines neuen Postgres-Standby-Knotens beschrieben wird.
Erstellen Sie vor dem Update einen Netzwerk-Snapshot des von Postgres verwendeten Datenspeichers. Wenn dann während der Aktualisierung Fehler auftreten und Sie ein Rollback ausführen müssen, können Sie den Postgres-Knoten aus diesem Snapshot wiederherstellen.

Neuen Postgres-Standby-Knoten installieren

Mit diesem Verfahren wird ein Postgres-Standby-Server auf einem neuen Knoten erstellt. Installieren Sie einen neuen Postgres-Standby-Server für Ihre vorhandene Edge-Version (4.50.00 oder 4.51.00), nicht für Version 4.52.00.

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

So erstellen Sie einen neuen Postgres-Standby-Knoten:

Bearbeiten Sie auf dem aktuellen Postgres-Master die Datei /opt/apigee/customer/application/postgresql.properties, um das folgende Token festzulegen. Wenn diese Datei nicht vorhanden ist, erstellen Sie sie:
```
conf_pg_hba_replication.connection=host replication apigee existing_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 enthalten sein:
```
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 zur Installation Ihrer aktuellen Edge-Version verwendet haben, um Folgendes anzugeben:
```
# IP address of the current master:
PG_MASTER=192.168.56.103
# IP address of the new standby node
PG_STANDBY=192.168.56.102
```
2. Deaktivieren Sie SELinux, wie unter Edge-Dienstprogramm „apigee-setup“ installieren beschrieben.
3. Wenn Sie derzeit Edge 4.51.00 verwenden:
  1. Laden Sie die Edge-Datei „bootstrap_4.51.00.sh“ in /tmp/bootstrap_4.51.00.sh herunter:
```
curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
```
  2. Installieren Sie das Edge-apigee-service-Dienstprogramm 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 Edge-Datei „bootstrap_4.50.00.sh“ in /tmp/bootstrap_4.50.00.sh herunter:
```
curl https://software.apigee.com/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.00.sh
```
  2. Installieren Sie das Edge-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 die Stand-by-Instanz handelt.

Direktes Upgrade von Postgres durchführen

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

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

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

Vorläufiger Schritt

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

Wenn die Datei /opt/apigee/customer/application/postgresql.properties nicht vorhanden ist, erstellen Sie sie.

Ä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 direktes Upgrade auf Postgres 14 durch:

Postgres auf dem Master-Host aktualisieren

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

Führen Sie den Einrichtungsbefehl 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

Prüfen Sie, ob der Master-Host gestartet wurde:
```
apigee-service apigee-postgresql wait_for_ready
```
Beenden Sie den Stand-by-Modus:
```
apigee-service apigee-postgresql stop
```
Führen Sie ein Upgrade des Stand-by-Systems durch.
Hinweis: Wenn dieser Schritt fehlschlägt, kann er ignoriert werden. update.sh versucht, den Stand-by-Server mit einer falschen Konfiguration zu starten. Wenn die Postgres-Installation auf 14 aktualisiert wurde, kann der Fehler ignoriert werden.
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
```
Prüfen Sie, ob die Stand-by-Instanz beendet wurde:
```
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 die Stand-by-Datenbank erfolgreich gestartet.

Postgres-Knoten außer Betrieb nehmen

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

Prüfen Sie, ob Postgres ausgeführt wird:

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

Wenn Postgres nicht ausgeführt wird, starten Sie es:

/opt/apigee/apigee-service/bin/apigee-all start

Rufen Sie die UUID des neuen Stand-by-Knotens ab, indem Sie den folgenden curl-Befehl auf dem neuen Stand-by-Knoten ausführen:
```
curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self
```
Am Ende der Ausgabe sollte die UUID des Knotens in folgendem Format angezeigt werden:
```
"type" : [ "postgres-server" ],
"uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
```
Beenden Sie den neuen Standby-Knoten, indem Sie den folgenden Befehl auf dem neuen Standby-Knoten ausführen:
```
/opt/apigee/apigee-service/bin/apigee-all stop
```
Bearbeiten Sie auf dem Postgres-Masterknoten /opt/apigee/customer/application/postgresql.properties, um den neuen Standby-Knoten aus conf_pg_hba_replication.connection zu entfernen:
```
conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust
```

Starten Sie apigee-postgresql auf dem Postgres-Master neu:

/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart

Prüfen Sie, ob der neue Standby-Knoten entfernt wurde. Rufen Sie dazu die Datei /opt/apigee/apigee-postgresql/conf/pg_hba.conf auf dem Master auf. In dieser Datei sollte nur die folgende Zeile angezeigt werden:
```
host replication apigee existing_standby_ip/32 trust
```
Löschen Sie die UUID des Stand-by-Knotens aus ZooKeeper. Führen Sie dazu den folgenden Edge Management API-Aufruf auf dem Management Server-Knoten aus:
```
curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/new_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 schrittweise neu erstellen, wenn Abfragen ausgeführt werden und der Autovacuum-Daemon ausgeführt wird. Bis die Statistiken neu erstellt wurden, können Ihre Abfragen jedoch langsam sein.

Führen Sie zur Behebung dieses Problems ANALYZE für alle Tabellen in der Datenbank auf dem primären Postgres-Knoten aus. Alternativ können Sie ANALYZE für jeweils einige Tabellen ausführen.

HINWEIS: Die Ausführung von ANALYZE kann lange dauern. Es wird jedoch nur eine Lesesperre für die Tabelle festgelegt, sodass andere Vorgänge in Postgres während der Ausführung von ANALYZE fortgesetzt werden können.

Neue Edge-Benutzeroberfläche

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

Edge-Benutzeroberfläche installieren

Nach 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.

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

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

Edge-Benutzeroberfläche aktualisieren

Wenn Sie die Edge-UI-Komponente aktualisieren möchten, berücksichtigen Sie die Version von Edge for Private Cloud, von der Sie ein Upgrade durchführen:

Von 4.51.00 auf 4.52.00 (mit bereits installierter neuer Edge-Benutzeroberfläche): Verwenden Sie die Upgrade-Anleitung in diesem Abschnitt für die Komponente edge-management-ui.

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 dann update.sh noch einmal ausführen. Sie können das Update mehrmals ausführen. Es wird dann an der Stelle fortgesetzt, an der es zuletzt unterbrochen wurde.

Wenn Sie aufgrund des Fehlers ein Rollback des Updates auf die vorherige Version durchführen müssen, finden Sie eine ausführliche Anleitung unter Rollback von 4.52.00.

Informationen zum Logging-Update

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

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

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

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

Update ohne Ausfallzeiten

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

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

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

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

Beachte vor und nach dem Update Folgendes:

Auf dem kombinierten Router- und Message Processor-Knoten:
- Vor dem Update:
  1. Machen Sie den Router unerreichbar.
  2. Machen Sie den Message Processor unerreichbar.
- Nach dem Update:
  1. Machen Sie den Message Processor erreichbar.
  2. Machen Sie den Router erreichbar.
Auf einzelnen Routerknoten:
- Machen Sie den Router vor dem Update unerreichbar.
- Machen Sie den Router nach der Aktualisierung erreichbar.
Auf einzelnen Message Processor-Knoten:
- Machen Sie den Message Processor vor dem Update nicht erreichbar.
- Machen Sie den Message Processor nach der Aktualisierung erreichbar.

Konfigurationsdatei für die unbeaufsichtigte Installation verwenden

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

Auf einem Knoten mit einer externen Internetverbindung auf 4.52.00 aktualisieren

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

Deaktivieren Sie alle cron-Jobs, die für die Ausführung eines Reparaturvorgangs für Cassandra konfiguriert sind, bis das Update abgeschlossen ist.
Melden Sie sich als Root-Nutzer auf Ihrem Knoten an, um die Edge-RPMs zu installieren.
HINWEIS: Für die RPM-Installation ist Root-Zugriff erforderlich. Die Edge-Konfiguration kann jedoch ohne Root-Zugriff durchgeführt werden.
Installieren Sie yum-utils und yum-plugin-priorities:
Hinweis: Wenn Ihr Betriebssystem RHEL 8.0–8.6 ist, überspringen Sie diesen Schritt.
```
sudo yum install yum-utils
sudo yum install yum-plugin-priorities
```
Deaktivieren Sie SELinux wie unter Edge-Dienstprogramm „apigee-setup“ installieren beschrieben.
Wenn Sie die Installation auf Oracle 7.x durchführen, führen Sie den folgenden Befehl aus:
```
sudo yum-config-manager --enable ol7_optional_latest
```

Wenn Sie auf 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 Edge 4.52.00-Dienstprogramm apigee-service und die Abhängigkeiten mit dem folgenden Befehl:
```
sudo bash /tmp/bootstrap_4.52.00.sh apigeeuser=uName apigeepassword=pWord
```
  Dabei sind uName:pWord der Nutzername und das Passwort, die Sie von Apigee erhalten haben. Wenn Sie pWord weglassen, werden Sie aufgefordert, es einzugeben.
  
  Standardmäßig prüft das Installationsprogramm, ob Java 1.8 installiert ist. Andernfalls wird sie vom Installationsprogramm installiert.
  
  Verwenden Sie die Option JAVA_FIX, um anzugeben, wie die Java-Installation gehandhabt werden soll. JAVA_FIX kann folgende Werte haben:
  - I: OpenJDK 1.8 installieren (Standard).
  - 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 Management Server, wie im folgenden Beispiel gezeigt:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
```
5. Aktualisieren Sie das Dienstprogramm apigee-provision auf dem Management Server, 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 Reihenfolge vor, die unter Reihenfolge der Maschinenaktualisierung beschrieben ist.
  
  Wobei:
  - component ist die zu aktualisierende Edge-Komponente. Mögliche Werte:
    - cs: Cassandra
    - edge: Alle Edge-Komponenten außer Edge-UI: Management Server, Message Processor, Router, QPID Server, Postgres Server
    - ldap: OpenLDAP
    - ps: postgresql
    - qpid: qpidd
    - sso: Apigee-SSO (wenn Sie SSO installiert haben)
    - ue: Neue Edge-Benutzeroberfläche
    - ui: Klassische Edge-Benutzeroberfläche
    - zk: Zookeeper
  - configFile ist dieselbe Konfigurationsdatei, die Sie während der Installation von 4.50.00 oder 4.51.00 zum Definieren Ihrer Edge-Komponenten verwendet haben.
  Sie können update.sh für alle Komponenten ausführen, indem Sie component auf „all“ setzen, aber nur, wenn Sie ein Edge-All-in-One-Installationsprofil (AIO) haben. Beispiel:
```
/opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
```
7. Starten Sie die Edge-UI-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 Dienstprogramm apigee-validate auf dem Management Server ausführen, wie unter Installation testen beschrieben.
Wenn Sie das Update später rückgängig machen möchten, verwenden Sie das unter Rollback 4.52.00 beschriebene Verfahren.

Update auf 4.52.00 aus einem lokalen Repository

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

Nachdem Sie ein lokales Edge-Repository erstellt haben, haben Sie zwei Möglichkeiten, Edge über das lokale Repository zu aktualisieren:
- Erstellen Sie eine TAR-Datei des Repositorys, kopieren Sie die TAR-Datei auf einen Knoten und aktualisieren Sie dann Edge aus der TAR-Datei.
- Installieren Sie einen Webserver auf dem Knoten mit dem lokalen Repository, damit andere Knoten darauf zugreifen können. Apigee stellt den Nginx-Webserver zur Verfügung, den Sie verwenden können. Sie können aber auch Ihren eigenen Webserver verwenden.
So aktualisieren Sie von einem lokalen 4.52.00-Repository:
1. Erstellen Sie ein lokales 4.52.00-Repository, wie unter „Lokales Apigee-Repository erstellen“ im Abschnitt Edge-Dienstprogramm „apigee-setup“ installieren beschrieben.
  HINWEIS: Wenn Sie bereits ein Repository haben, können Sie das Repository 4.52.00 hinzufügen, wie unter „Lokales Apigee-Repository aktualisieren“ unter Edge-Dienstprogramm „apigee-setup“ installieren beschrieben.
2. So installieren Sie apigee-service aus einer TAR-Datei:
  1. Verwenden Sie auf dem Knoten mit dem lokalen Repository den folgenden Befehl, um das lokale Repository in einer einzelnen TAR-Datei mit dem Namen /opt/apigee/data/apigee-mirror/apigee-4.52.00.tar.gz zu verpacken:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
```
  2. Kopieren Sie die TAR-Datei auf den Knoten, auf dem Sie Edge aktualisieren möchten. Kopieren Sie sie 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, das die TAR-Datei enthält, ein neues Verzeichnis mit dem Namen repos erstellt. z. B. /tmp/repos.
  4. Installieren Sie das Edge-Dienstprogramm apigee-service und die Abhängigkeiten von /tmp/repos:
```
sudo bash /tmp/repos/bootstrap_4.52.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
```
    Beachten Sie, dass Sie in diesem Befehl den Pfad zum Verzeichnis „repos“ angeben.
3. So installieren Sie apigee-service mit dem Nginx-Webserver:
  1. Konfigurieren Sie den Nginx-Webserver wie unter „Aus dem Repository mit dem Nginx-Webserver installieren“ unter Edge-Dienstprogramm „apigee-setup“ 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 ist 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 Management Server, wie im folgenden Beispiel gezeigt:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
```
6. Aktualisieren Sie das Dienstprogramm apigee-provision auf dem Management Server, 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 der Maschinenaktualisierung beschriebenen Reihenfolge aus:
```
/opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
```
  Wobei:
  - component ist die zu aktualisierende Edge-Komponente. In der Regel aktualisieren Sie die folgenden Komponenten:
    - cs: Cassandra
    - edge: Alle Edge-Komponenten außer Edge-UI: Management Server, Message Processor, Router, QPID Server, Postgres Server
    - ldap: OpenLDAP
    - ps: postgresql
    - qpid: qpidd
    - sso: Apigee-SSO (wenn Sie SSO installiert haben)
    - ue Neue Edge-Benutzeroberfläche
    - ui: Klassische Edge-Benutzeroberfläche
    - zk: Zookeeper
  - configFile ist dieselbe Konfigurationsdatei, die Sie während der Installation von 4.50.00 oder 4.51.00 zum Definieren Ihrer Edge-Komponenten verwendet haben.
    HINWEIS: Die Konfigurationsdatei muss für den Nutzer „apigee“ lesbar sein. Verwenden Sie den folgenden Befehl, um den Inhaber zu ändern:
    chown apigee:apigee configFile
  Sie können update.sh für alle Komponenten ausführen, indem Sie component auf „all“ setzen, aber nur, wenn Sie ein Edge-All-in-One-Installationsprofil (AIO) haben. Beispiel:
```
/opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config
```
8. Starten Sie die UI-Komponenten auf allen Knoten neu, auf denen sie ausgeführt werden, 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 Dienstprogramm apigee-validate auf dem Management Server ausführen, wie unter Installation testen beschrieben.
Wenn Sie das Update später rückgängig machen möchten, verwenden Sie das unter Rollback von 4.52.00 beschriebene Verfahren.

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 für alle Computer mit mehreren Edge-Komponenten (Management Server, Message Processor, Router, QPID-Server, aber nicht Postgres-Server) die Option -c edge, um alle gleichzeitig zu aktualisieren.
- Wenn ein Schritt auf mehreren Maschinen ausgeführt werden soll, führen Sie ihn in der angegebenen Reihenfolge aus.
- Es gibt keinen separaten Schritt zum Aktualisieren der Monetarisierung. Sie wird aktualisiert, wenn Sie die Option -c edge angeben.
HINWEIS: Nachdem Sie die Edge-UI-Komponente aktualisiert haben, müssen Sie den Edge-UI-Dienst neu starten, wie in der Installationsanleitung für das Update beschrieben.

Eigenständiges Upgrade für 1 Knoten

So aktualisieren Sie eine eigenständige Konfiguration mit einem Knoten auf 4.52.00:
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 2 Knoten

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

Eine Liste der Edge-Topologien und Knotennummern finden Sie unter Installationstopologien.
1. Aktualisieren Sie Cassandra und ZooKeeper auf Maschine 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```
2. Aktualisieren Sie Qpid und Postgres auf Maschine 2:
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
```
3. Aktualisieren Sie LDAP auf Maschine 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
4. Aktualisieren Sie die Edge-Komponenten auf Maschine 2 und 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
5. Aktualisieren Sie die Benutzeroberfläche auf Maschine 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
```
6. (Wenn Sie apigee-adminapi installiert haben) Aktualisieren Sie das Dienstprogramm apigee-adminapi auf Maschine 1:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
7. (Wenn Sie Apigee-SSO installiert haben) Aktualisieren Sie 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 bei der Installation von SSO erstellt haben.
8. Starten Sie die Edge-UI-Komponente auf Maschine 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 Computern 1, 2 und 3:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```
2. Aktualisieren Sie Qpid und Postgres auf Maschine 4:
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile
```
3. Aktualisieren Sie Qpid und Postgres auf Maschine 5:
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile
```
4. Aktualisieren Sie LDAP auf Maschine 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
5. Aktualisieren Sie die Edge-Komponenten auf den Maschinen 4, 5, 1, 2, 3:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
6. Aktualisieren Sie die Edge-Benutzeroberfläche:
  - Klassische UI: Wenn Sie die klassische UI verwenden, aktualisieren Sie die Komponente ui auf Maschine 1, wie im folgenden Beispiel gezeigt:
```
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
```
  - Neue Edge-Benutzeroberfläche: Wenn Sie die neue Edge-Benutzeroberfläche installiert haben, aktualisieren Sie die Komponente ue auf dem entsprechenden Computer (möglicherweise nicht Computer 1):
```
/opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
```
7. (Wenn Sie apigee-adminapi installiert haben) Aktualisieren Sie das Dienstprogramm apigee-adminapi auf Maschine 1:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
8. (Wenn Sie Apigee-SSO installiert haben) Aktualisieren Sie 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 bei der Installation von SSO erstellt haben.
9. Starten Sie die UI-Komponente neu:
  - Klassische UI: Wenn Sie die klassische UI verwenden, starten Sie die Komponente edge-ui auf Maschine 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 Komponente edge-management-ui auf dem entsprechenden Computer neu (möglicherweise nicht Computer 1):
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
```
Upgrade für Cluster 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 Computern 1, 2 und 3:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```
2. Aktualisieren Sie Qpid auf den Computern 6 und 7:
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
```
3. Aktualisieren Sie Postgres auf Maschine 8:
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
4. Aktualisieren Sie Postgres auf Maschine 9:
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
5. Aktualisieren Sie LDAP auf Maschine 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
6. Aktualisieren Sie die Edge-Komponenten auf den Computern 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 Maschine 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
```
8. (Wenn Sie apigee-adminapi installiert haben) Aktualisieren Sie das Dienstprogramm apigee-adminapi auf Maschine 1:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
9. (Wenn Sie Apigee-SSO installiert haben) Aktualisieren Sie Apigee-SSO auf Maschine 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 von SSO erstellt haben.
10. Starten Sie die UI-Komponente neu:
  - Klassische UI: Wenn Sie die klassische UI verwenden, starten Sie die Komponente edge-ui auf Maschine 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 Komponente edge-management-ui auf dem entsprechenden Computer neu (möglicherweise nicht Computer 1):
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
```
Cluster-Upgrade 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 Computern 1, 2 und 3:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```
2. Aktualisieren Sie Qpid auf den Computern 12 und 13:
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
```
3. Aktualisieren Sie Postgres auf Maschine 8:
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
4. Aktualisieren Sie Postgres auf Maschine 9:
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
5. Aktualisieren Sie LDAP auf Maschine 4 und 5:
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
6. Aktualisieren Sie die Edge-Komponenten auf den Computern 12, 13, 8, 9, 6, 7, 10 und 11 in dieser Reihenfolge:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
7. Aktualisieren Sie entweder die neue UI (ue) oder die klassische UI (ui) auf den Maschinen 6 und 7:
```
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
```
8. (Wenn Sie apigee-adminapi installiert haben) Aktualisieren Sie das Dienstprogramm apigee-adminapi auf den Computern 6 und 7:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
9. (Wenn Sie Apigee-SSO installiert haben) Aktualisieren Sie 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 von SSO erstellt haben.
10. Starten Sie die UI-Komponente neu:
  - Klassische UI: Wenn Sie die klassische UI verwenden, starten Sie die Komponente edge-ui auf den Computern 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
```
Upgrade für Cluster 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. Aktualisieren Sie qpidd auf Maschine 4:
      /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
    2. Aktualisieren Sie qpidd auf Maschine 5:
      /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  2. Maschinen 10, 11 in Rechenzentrum 2
    1. Aktualisieren Sie qpidd auf Maschine 10:
      /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
    2. Aktualisieren Sie qpidd auf Maschine 11:
      /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
3. Postgres aktualisieren:
  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, 3 in Rechenzentrum 1
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
  2. Maschinen 10, 11, 12, 7, 8, 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) Das Dienstprogramm apigee-adminapi wurde 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 der neuen Edge-Benutzeroberfläche (edge-management-ui) oder der klassischen 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, Management Server, Message Processor und Router.
  HINWEIS: Wenn auf einem Knoten sowohl der Qpid-Server als auch der Edge Postgres-Server installiert sind, führen Sie den Profilschritt „-c edge“ aus.
6. Edge-UI (klassisch oder neu)
7. apigee-adminapi
8. Apigee-SSO
Nachdem Sie die Aktualisierung abgeschlossen haben, müssen Sie die Edge-UI-Komponente auf allen Computern neu starten, auf denen sie ausgeführt wird.