Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Aktualisieren Sie Apigee Edge 4.51.00, 4.52.00 oder 4.52.01 auf 4.52.02

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

Wer kann das Update durchführen?

Die Person, die das Update ausführt, sollte dieselbe 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 aktualisiert werden?

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 ein vollständiges Back-up aller Knoten durchzuführen. Verwenden Sie das Verfahren für Ihre aktuelle Version von Edge, um die Sicherung durchzuführen.
So haben Sie einen Plan B, falls das Update auf eine neue Version nicht richtig funktioniert. Weitere Informationen zur Sicherung finden Sie unter Sichern und Wiederherstellen.
Sicherstellen, dass Edge ausgeführt wird
Achten Sie darauf, dass Edge während des Aktualisierungsvorgangs ausgeführt wird. Verwenden Sie dazu den folgenden Befehl:
```
/opt/apigee/apigee-service/bin/apigee-all status
```
Hinweis:Achten Sie darauf, dass die Einrichtung von edge-management-server in Ihrer bestehenden Version ohne Fehler ausgeführt wird. Beheben Sie alle Fehler bei der Einrichtung des edge-management-server aus früheren Versionen, bevor Sie mit dem weiteren Upgrade fortfahren.
Prüfen Sie, ob die Cassandra-Kompaktierungsstrategie LeveledCompactionStrategy
ist. Nehmen Sie je nach aktueller Version die erforderlichen Änderungen an der Cassandra-Kompaktierungsstrategie vor. Führen Sie die folgenden Schritte aus und kehren Sie dann zum Haupt-Upgradeverfahren zurück:
- Wenn Sie ein Upgrade von Version 4.51.00 durchführen, lesen Sie das Dokument zur Cassandra-Kompaktierungsstrategie für Version 4.51.00.
- Wenn Sie ein Upgrade von Version 4.52.00 durchführen, lesen Sie das Dokument zur Cassandra-Kompaktierungsstrategie für Version 4.52.00.
- Wenn Sie ein Upgrade von Version 4.52.01 durchführen, lesen Sie das Dokument zur Cassandra-Kompaktierungsstrategie für Version 4.52.01.

Besondere Schritte für das Upgrade

Wenn Sie ein Upgrade auf Edge for Private Cloud 4.52.02 durchführen möchten, müssen Sie möglicherweise bestimmte Software aktualisieren. Die erforderlichen Schritte hängen von Ihrer aktuellen Version ab. In der folgenden Tabelle finden Sie die verschiedenen Softwareprodukte, für die zusätzliche Schritte erforderlich sind. Folgen Sie der detaillierten Anleitung für jedes Produkt. Kehren Sie nach Abschluss der erforderlichen Aufgaben zum Hauptverfahren für das Upgrade zurück, um das Upgrade fortzusetzen.

Aktuelle Version	Software, für die beim Upgrade auf Version 4.52.02 spezielle Schritte erforderlich sind
4.52.01	Cassandra
4.52.00	Zookeeper, Cassandra, Qpid
4.51.00	Zookeeper, Postgres, Cassandra, Qpid

Kehren Sie nach Ausführung der erforderlichen Schritte entsprechend Ihrer Version zum Hauptverfahren für das Upgrade zurück, um fortzufahren.

Automatische Übertragung von Property-Einstellungen

Wenn Sie Eigenschaften durch Bearbeiten von .properties-Dateien in /opt/apigee/customer/application festgelegt haben, bleiben diese Werte nach dem Update erhalten.

Upgrade auf Zookeeper 3.8.3

Edge for Private Cloud 4.52.02 enthält kein ZooKeeper-Upgrade. Wenn Sie jedoch ein Upgrade von einer Version älter als 4.52.01 durchführen, müssen Sie die unten beschriebenen Schritte für das Zookeeper-Upgrade ausführen.

Wenn Sie ein Upgrade von Edge for Private Cloud-Version 4.51.00 oder 4.52.00 durchführen, folgen Sie der Anleitung unter Erforderliches Upgrade auf Zookeeper 3.8.3, um Zookeeper zu aktualisieren.
Wenn Sie ein Upgrade von Edge for Private Cloud Version 4.52.01 durchführen, sollten Sie bereits ZooKeeper Version 3.8.3 verwenden. In diesem Fall sind keine besonderen Schritte für das Upgrade von ZooKeeper erforderlich.

Hinweis:

Das Upgrade von Edge for Private Cloud 4.52.01 auf 4.52.02 ist einfacher, da sich Zookeeper und Cassandra in der Regel auf demselben Host oder derselben VM befinden. Dadurch entfällt die Notwendigkeit separater Zookeeper-Upgrade-Verfahren neben dem wichtigen Cassandra-Upgrade.

Wenn für Zookeeper bestimmte Schritte zum Aktualisieren erforderlich sind, aktualisieren Sie Zookeeper in allen Rechenzentren, indem Sie jeweils einen Knoten aktualisieren. Sobald alle Zookeeper-Knoten weltweit aktualisiert wurden, führen Sie ein Upgrade von Cassandra durch. Gehen Sie dabei jeweils ein Rechenzentrum nach dem anderen vor und halten Sie sich an die Vorgehensweise, die weiter unten in diesem Artikel beschrieben wird.

Der folgende Befehl ermöglicht ein separates Zookeeper-Upgrade:

/opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile

Verwenden Sie für einen Zookeeper-Rollback die Standardprozedur für Zookeeper-Rollbacks. Wenn ein Rollback für Cassandra oder andere Komponenten erforderlich wird, sollten diese Komponenten zurückgesetzt werden. Ein Zookeeper-Rollback ist nicht erforderlich.

Upgrade auf PostgreSQL 14

Wenn Sie von Edge for Private Cloud 4.51.00 auf 4.52.02 upgraden, müssen Sie die Schritte zum Upgraden von Postgres ausführen, auch wenn Edge for Private Cloud 4.52.02 kein Postgres-Upgrade enthält. Für das Upgrade von Edge for Private Cloud 4.51.00 auf 4.52.02 sind zusätzliche Postgres-Upgradeschritte erforderlich. Weitere Informationen finden Sie im Abschnitt Erforderliches Upgrade auf Postgres 14.
Wenn Sie ein Upgrade von Edge for Private Cloud 4.52.00 oder 4.52.01 auf 4.52.02 durchführen, sind keine zusätzlichen Postgres-Upgradeschritte erforderlich.

Upgrade auf Cassandra 3.11.16

Apigee Edge for Private Cloud 4.52.02 enthält ein Upgrade von Cassandra auf Version 3.11.16. Cassandra ist eine wichtige Komponente von Apigee. Dieses Upgrade umfasst auch Aktualisierungen der Treibersoftware in verschiedenen Laufzeit- und Verwaltungskomponenten, die zum Abfragen und Schreiben in Cassandra verwendet werden.

Da es sich um ein großes Upgrade handelt, waren bestimmte Änderungen am Datenmodell von Apigee in Cassandra erforderlich, um eine optimale Leistung in neueren Versionen zu gewährleisten. Diese Änderungen sind zwar minimal, aber der Upgradeprozess unterbricht bestimmte Verwaltungs-APIs, wenn das Upgrade gestartet wird. Die genauen Verwaltungs-APIs, die im Allgemeinen unterbrochen werden, sind in den entsprechenden Abschnitten unten aufgeführt.

Außerdem führt der Upgradeprozess zu Unterbrechungen bei einer größeren Anzahl von Laufzeit-Proxy-Flows und Management-APIs im Rechenzentrum, das aktualisiert wird. Es ist wichtig, dass Sie Ihren Laufzeit- und Verwaltungs-Traffic vom Rechenzentrum, das aktualisiert wird, isolieren, um solche Unterbrechungen zu minimieren. Weitere Informationen finden Sie unten in den Abschnitten Einzelnes Rechenzentrum und Mehrere Rechenzentren.

Hinweis:Das Tool cassandra-cli wird in Cassandra 3.X nicht mehr unterstützt und ist nicht verfügbar.

Entwicklerportal – APIs dokumentieren

Das Apigee Drupal-Entwicklerportal bietet verschiedene Funktionen zum Dokumentieren Ihrer APIs. Es wird empfohlen, das auf Drupal 7 basierende Entwicklerportal nicht mehr zu verwenden. Wenn Sie es jedoch weiterhin nutzen und die SmartDocs-Funktion verwenden, gilt das Dokument SmartDocs-APIs verwenden für Sie. Wenn Sie neuere Versionen des Entwicklerportals verwenden, hat das Upgrade keine Auswirkungen auf Ihre API-Dokumentation.

Wenn Sie ein Upgrade von Apigee auf Version 4.52.02 durchführen, werden alle API-Modelle, die mit der SmartDocs-Funktion des Drupal 7-Entwicklerportals erstellt wurden, nicht automatisch zur neueren Version migriert. Sie müssen jedes Modell manuell über das Entwicklerportal exportieren und nach dem Upgrade wieder importieren.

Verwendete Terminologie

Laufzeit:Die Laufzeit umfasst die Verarbeitung Ihres Laufzeit-Proxy-Traffics. Sie umfasst alle Vorgänge, die von Ihren Routern und Message Processorn ausgeführt werden, um eine Laufzeit-API-Anfrage für vorhandene Proxys effektiv zu verarbeiten. Die Bereitstellung neuer Proxys oder neuer Versionen von Proxys ist jedoch nicht enthalten.

Verwaltung:Die Verwaltung umfasst die Administration Ihres Apigee Edge-Systems. Dazu gehören unter anderem Bereitstellungen und Änderungen von Apps, Produkten, Zielservern und Schlüsselspeichern. Alle Management-APIs (und ihre Clients wie die Apigee-Benutzeroberfläche und das Entwicklerportal) sind in diesem Umfang enthalten.

Während dieses Upgrades ist der Laufzeit- und Verwaltungs-Traffic in der Region oder dem Rechenzentrum betroffen, in dem das Update ausgeführt wird. Unabhängig davon, welches Rechenzentrum aktualisiert wird, wirken sich die Änderungen auf bestimmte Verwaltungs-APIs in allen Rechenzentren aus. Die Auswirkungen werden nach jedem Schritt angegeben.

In jedem Schritt unten wird der Status von Laufzeit und Verwaltung beschrieben, während Sie die verschiedenen Phasen des Upgrade-Vorgangs durchlaufen.

Upgradestrategien

Mehrere Rechenzentren

Das Upgrade muss in jeweils einem Rechenzentrum durchgeführt werden, um den Traffic aufrechtzuerhalten und Ausfallzeiten zu vermeiden. Bevor Sie ein DC aktualisieren, sollte der Traffic zu anderen funktionierenden DCs umgeleitet werden.

Hinweis:

Um Auswirkungen auf den Traffic während des Upgrades zu vermeiden, sollten Sie Rechenzentrum für Rechenzentrum (Data Center by Data Center, DC by DC) vorgehen und den Traffic vorübergehend vom Rechenzentrum, das gerade aktualisiert wird, umleiten. So wird ein kontrollierter Upgradeprozess für Cassandra, Management Server und Laufzeitknoten sichergestellt und gleichzeitig die Dienstverfügbarkeit aufrechterhalten.

Bei einer Einrichtung mit zwei Rechenzentren sind die folgenden Schritte erforderlich:

Traffic von DC-1 nach DC-2 weiterleiten und eingehenden Traffic zu DC-1 blockieren.
Upgrade von DC-1, einschließlich Cassandra, Management Server und Laufzeitkomponenten.
Leiten Sie den Traffic zurück zu DC-1 und blockieren Sie eingehenden Traffic zu DC-2.
Upgrade von DC-2, einschließlich Cassandra, Management Server und Laufzeitkomponenten.

So wird ein nahtloses Traffic-Management während des Upgrades gewährleistet. Ein ähnliches Muster sollte für Setups mit mehr als zwei Rechenzentren befolgt werden, bei denen der Traffic vorübergehend zu Rechenzentren umgeleitet wird, die entweder vollständig aktualisiert oder noch nicht aktualisiert wurden.

Einzelnes Rechenzentrum

Bei einer Einrichtung mit einem einzelnen Rechenzentrum wirkt sich das Upgradeverfahren erheblich auf den Laufzeittraffic und bestimmte Verwaltungs-APIs aus. Für die Einrichtung eines einzelnen Rechenzentrums stehen die folgenden Optionen zur Verfügung.

Erweitern Sie Ihren Edge for Private Cloud-Cluster um ein temporäres Rechenzentrum, indem Sie ein Rechenzentrum neben dem vorhandenen hinzufügen, um den Traffic während des Upgrades zu verarbeiten. Nehmen Sie dann eines der Rechenzentren nach Abschluss des Upgrades außer Betrieb.
Wenn Sie nicht auf ein zusätzliches Rechenzentrum ausweichen können, bereiten Sie sich auf Ausfallzeiten vor und planen Sie das Upgrade für Zeiten mit geringem Traffic, um die Auswirkungen auf Management-APIs und den Laufzeittraffic zu minimieren.

Es wird empfohlen, ein zusätzliches Rechenzentrum zu nutzen, um Auswirkungen auf Laufzeittraffic und Management-APIs zu vermeiden. Während des Upgrades sind die Auswirkungen auf das Rechenzentrum, das aktualisiert wird, unter anderem folgende:

Aktualisieren von OAuth-Tokens durch Runtime APIs
Runtime APIs mit Access Entity-Richtlinie
Verwaltungs-APIs, in denen Entwickler-Apps aufgeführt sind
Management-APIs für die Auflistung von Produkten

Die oben beschriebenen Auswirkungen gelten zusätzlich zu den spezifischen Verwaltungs-APIs, die in allen Rechenzentren nicht funktionieren, bis alle Rechenzentren aktualisiert wurden. Solche Verwaltungs-APIs werden in den Schritten in den folgenden Abschnitten aufgeführt.

Rollback – Übersicht

Auswirkungen während des Rollbacks
Das Zurücksetzen von Cassandra 3.11.x auf 2.1.x wirkt sich sowohl auf den Laufzeit- als auch auf den Verwaltungs-Traffic im Rechenzentrum (DC) aus, in dem das Zurücksetzen erfolgt. Außerdem kann es bei bestimmten Verwaltungs-APIs in allen Rechenzentren zu Störungen kommen, unabhängig davon, welches Rechenzentrum gerade zurückgesetzt wird.
DC by DC Rollback Approach
Der Rollback muss für jeweils ein Rechenzentrum ausgeführt werden, um die Kontinuität des Dienstes aufrechtzuerhalten und Ausfallzeiten zu vermeiden. Bevor Sie das Rollback in einem bestimmten Rechenzentrum starten, müssen Sie dafür sorgen, dass der Anwendungs-Traffic an ein anderes, voll funktionsfähiges Rechenzentrum weitergeleitet wird.
Rollback für teilweise aktualisierten Cluster ausführen
Wenn mindestens ein Rechenzentrum mit der älteren Version von Cassandra (2.1.22) vollständig betriebsbereit bleibt, können andere aktualisierte Rechenzentren durch einen Neuaufbau aus dem voll funktionsfähigen Cassandra 2.1.X-Rechenzentrum zurückgesetzt werden.
Clusterweiter Rollback
Wenn der gesamte Cassandra-Cluster aktualisiert wurde und ein Rollback erforderlich ist, muss er mithilfe von Sicherungen oder VM-Snapshots durchgeführt werden. Dieser Ansatz ist komplex und führt wahrscheinlich zu vorübergehenden Ausfallzeiten oder Datenverlust.
Überlegungen vor dem Upgrade
Es ist wichtig, dass Sie sich mit den Rollback-Verfahren vertraut machen, bevor Sie das Upgrade durchführen. Es ist wichtig, dass die Nuancen des Rollbacks beim Upgrade berücksichtigt werden, damit geeignete Rollback-Pfade verfügbar sind.

Cluster mit einem einzelnen Rechenzentrum zurücksetzen

Die Aktualisierung von Cassandra von Version 2.1.x auf 3.11.x kann sich erheblich auf den Laufzeittraffic und bestimmte Verwaltungs-APIs auswirken. Diese Auswirkungen gelten auch während des Rollbacks und können zu Ausfallzeiten oder Datenverlust führen.

Für Produktionsarbeitslasten wird dringend empfohlen, vor dem Upgrade ein neues Rechenzentrum bereitzustellen. Dies ermöglicht einen sichereren Rollback-Pfad ohne Datenverlust oder Unterbrechung des API-Traffics. Das zusätzliche Rechenzentrum kann außer Betrieb genommen werden, nachdem das Upgrade erfolgreich abgeschlossen wurde.

Wenn das Hinzufügen eines neuen Rechenzentrums nicht möglich ist, aber ein Rollback erforderlich ist, müssen vor dem Upgrade zuverlässige Sicherungen erstellt werden. Die Wiederherstellung von Cassandra 2.1.x aus Sicherungen ist möglich, kann aber zu Dienstausfallzeiten und potenziellem Datenverlust führen.

Cluster mit mehreren Rechenzentren zurücksetzen

Das Rollback mehrerer Rechenzentren erfolgt rechenzentrumsspezifisch. Bei diesem Ansatz wird der Traffic des Rechenzentrums, das zurückgesetzt wird, an andere funktionale Rechenzentren weitergeleitet. So wird ein kontrollierter und isolierter Rollback-Prozess für Cassandra, Verwaltungsserver und Laufzeitknoten sichergestellt, um Traffic-Unterbrechungen zu vermeiden.

Weitere Informationen finden Sie im Abschnitt Rollback des Cassandra 3.11.16-Updates.

Schritt 0: Startstatus

Die Komponenten „Zookeeper“, „Postgres“ und „LDAP“ wurden bereits auf Version 4.52.02 aktualisiert. Ihr Edge-Cluster für eine Private Cloud ist stabil und funktioniert. Wenn ein Rollback erforderlich ist, wird der Cluster auf diesen Zustand zurückgesetzt.
Cassandra in Apigee wird mit Version 2.1.22 ausgeführt.
Edge-Komponenten:

Der Verwaltungsserver kommuniziert mit Cassandra über das ältere Thrift-Protokoll.
Laufzeitserver (Message Processors und Router), die über das ältere Thrift-Protokoll mit Cassandra kommunizieren.

Laufzeitstatus in dieser Phase	Verwaltungsstatus in dieser Phase
Laufzeit voll funktionsfähig	Verwaltung voll funktionsfähig

Schritt 1: Upgrade vorbereiten

Die folgenden Schritte sind zusätzlich zu den Standarddateien erforderlich, die Sie normalerweise erstellen, z. B. die Standardkonfigurationsdatei von Apigee zum Aktivieren von Komponentenupgrades.

Cassandra so ändern, dass LeveledCompactionStrategy verwendet wird
Cassandra mit Apigee sichern
Erstellen Sie VM-Snapshots von Cassandra-Knoten (falls möglich).
Erstellen Sie auf jedem Cassandra-Knoten unter /opt/apigee/apigee-cassandra/cass_upgrade.conf eine Cassandra-Upgrade-Konfigurationsdatei mit dem folgenden Inhalt:
```
# IP Address of node
HOSTIP=10.0.0.1

# Username for running Cassandra queries. Optional. Can be skipped if you have not enabled Cassandra authentication.
CASS_USERNAME=<cassuser>

# Password for running Cassandra queries. Optional. Can be skipped if you have not enabled Cassandra authentication.
CASS_PASSWORD=<casspass>

# Port for connecting to Cassandra via thrift. Optional. Defaults to 9160 if skipped.
CASS_PORT=9160

# Port for connecting to Cassandra via CQL. Optional. Defaults to 9042 if skipped.
CASS_CQL_PORT=9042

# Directory to be used by Cassandra upgrade scripts. Optional. Defaults to /tmp/cass_upgrade_scripts if skipped.
# Note that if upgrade is successful, this directory is deleted via root user - so provide a directory accordingly.
CASS_TMP_DIR=/tmp/cass_upgrade_scripts
    
```
Wenn die Datei nicht unter /opt/apigee/apigee-cassandra/cass_upgrade.conf erstellt werden kann, erstellen Sie die Datei /opt/silent.conf mit demselben Inhalt auf jedem Cassandra-Knoten.
Achtung:Das Apigee-Upgrade-Installationsprogramm sucht an den oben aufgeführten Speicherorten nach der Datei. Wenn die Datei an keinem der oben aufgeführten Speicherorte vorhanden ist, schlägt das Upgrade mit einer Meldung wie der folgenden fehl:
```
could not read env location: '/opt/apigee/apigee-cassandra/cass_upgrade.conf'
file does not exist or cannot be sourced
could not read env location: '/opt/silent.conf'
file does not exist or cannot be sourced
```
In diesem Fall schlägt die Aktualisierung fehl, der Cassandra-Dienst auf dem Knoten ist aber wahrscheinlich beendet. Sie können den Cassandra-Dienst wie gewohnt starten und das Upgrade noch einmal versuchen, indem Sie die Konfigurationsdatei an einem der erwarteten Speicherorte ablegen. Wenn die Datei gefunden wird, die bereitgestellten Konfigurationen jedoch falsch sind (z. B. falsche Cassandra-Anmeldedaten), schlägt das Upgrade mit einem Fehler wie dem folgenden fehl:
```
Error in PREIN scriptlet in rpm package apigee-cassandra-X.XX.XX-X.X.XXXX.noarch
```
Starten Sie in diesem Fall den Cassandra-Dienst, falls er beim fehlgeschlagenen Upgrade beendet wurde, und versuchen Sie das Upgrade noch einmal, nachdem Sie die Konfigurationen in der Datei korrigiert haben.
Wenn Sie die SmartDocs-Funktion des Apigee Drupal 7-Entwicklerportals verwenden, exportieren Sie jedes Ihrer Modelle, indem Sie sie im JSON-Format über die Benutzeroberfläche des Entwicklerportals herunterladen. Diese Modelle müssen nach der Aktualisierung der Verwaltungsserver wieder in Apigee importiert werden.
Prüfen Sie, ob die Ports 9160 und 9042 von allen Edge-Komponenten auf Cassandra-Knoten zugreifen können, falls dies noch nicht der Fall ist. Weitere Informationen finden Sie unter Portanforderungen.

Schritt 2: Traffic vom ersten Rechenzentrum umleiten

Blockieren Sie eingehenden Laufzeit- und Verwaltungs-Traffic aus dem ersten Rechenzentrum.
Leiten Sie den gesamten Laufzeittraffic und alle Management-APIs an die anderen funktionsfähigen Rechenzentren weiter.
Prüfen Sie, ob Laufzeit- und Verwaltungs-Traffic erfolgreich von den anderen Rechenzentren verarbeitet werden.

Schritt 3: Alle Cassandra-Knoten im ersten Rechenzentrum aktualisieren

Führen Sie für alle Cassandra-Knoten im Rechenzentrum 1 ein Upgrade durch. Führen Sie die folgenden Befehle auf jedem Knoten einzeln aus:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
```

Nachdem ein Knoten aktualisiert wurde, führen Sie den folgenden Befehl auf dem Knoten aus, um einige Validierungen durchzuführen, bevor Sie fortfahren:

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra validate_upgrade -f configFile

Die Ausgabe sieht etwa so aus:

Cassandra version is verified - [cqlsh 5.0.1 | Cassandra 3.11.16 | CQL spec 3.4.4 | Native protocol v3] Metadata is verified

Führen Sie den folgenden post_upgrade-Befehl nach Abschluss des Upgrades nacheinander auf jedem Cassandra-Knoten aus:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra post_upgrade
```

Laufzeitstatus in dieser Phase	Verwaltungsstatus in dieser Phase
Laufzeittraffic wird in Rechenzentren blockiert, die aktualisiert werden Laufzeit in anderen Rechenzentren voll funktionsfähig	Der Management-Traffic wird in Rechenzentren blockiert, die gerade aktualisiert werden. Die folgende Verwaltungsfunktion ist nach dem Upgrade von Cassandra in anderen Rechenzentren eingeschränkt: Management API zum Erstellen eines API-Produkts mit Umgebung Management API zum Aktualisieren eines API-Produkts mit Umgebung Management API zum Löschen einer Organisation

Schritt 4: Alle Verwaltungs-Nodes im ersten Rechenzentrum aktualisieren

Führen Sie ein Upgrade aller Verwaltungs-Nodes im Rechenzentrum durch:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

Laufzeitstatus in dieser Phase	Verwaltungsstatus in dieser Phase
Laufzeittraffic wird in Rechenzentren blockiert, die aktualisiert werden Laufzeit voll funktionsfähig	Der Management-Traffic wird in Rechenzentren blockiert, die gerade aktualisiert werden. Die folgende Verwaltungsfunktion ist nach dem Upgrade von Cassandra eingeschränkt verfügbar: Management API zum Erstellen eines API-Produkts mit Umgebung Management API zum Aktualisieren eines API-Produkts mit Umgebung Management API zum Löschen einer Organisation

Schritt 5: Alle Laufzeitknoten im ersten Rechenzentrum aktualisieren

Führen Sie für alle Router- und Message Processor-Knoten im Rechenzentrum ein Upgrade durch:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

Laufzeitstatus in dieser Phase	Verwaltungsstatus in dieser Phase
Laufzeittraffic wird in Rechenzentren blockiert, die aktualisiert werden Laufzeit in anderen Rechenzentren voll funktionsfähig	Der Management-Traffic wird in Rechenzentren blockiert, die gerade aktualisiert werden. Die folgende Verwaltungsfunktion ist nach dem Upgrade von Cassandra in anderen Rechenzentren eingeschränkt: Management API zum Erstellen eines API-Produkts mit Umgebung Management API zum Aktualisieren eines API-Produkts mit Umgebung Management API zum Löschen einer Organisation

Schritt 6: Traffic zurück zum ersten Rechenzentrum umleiten

Nachdem das erste Rechenzentrum mit Cassandra, Laufzeitkomponenten und dem Verwaltungsserver aktualisiert wurde, aktivieren Sie den Laufzeit- und Verwaltungs-Traffic für das erste Rechenzentrum wieder.
Achten Sie darauf, dass der Laufzeit- und Verwaltungs-Traffic in allen Rechenzentren erfolgreich ist.

Schritt 7: Andere Rechenzentren aktualisieren

Wiederholen Sie Schritt 1 bis Schritt 6 für die verbleibenden Rechenzentren. Leiten Sie dazu den Traffic jeweils von den Rechenzentren weg, aktualisieren Sie die Apigee-Software und aktivieren Sie den Traffic in den Rechenzentren wieder.

Schritt 8: Upgrade-Schritt auf allen Managementknoten noch einmal ausführen

Führen Sie den folgenden Upgrade-Befehl auf allen Verwaltungs-Nodes in allen Rechenzentren noch einmal aus:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

Schritt 9: [Optional] Zuvor exportierte SmartDocs importieren

Sobald alle Verwaltungsserver aktualisiert wurden, können Sie die in Schritt 1 exportierten Smart Docs-Modelle importieren. Sie können das auch später tun.

Sie müssen dies nur tun, wenn Sie ein auf Drupal 7 basierendes Entwicklerportal verwenden und die SmartDocs-Funktion nutzen.

Laufzeitstatus in dieser Phase	Verwaltungsstatus in dieser Phase
Laufzeit voll funktionsfähig	Verwaltung voll funktionsfähig

Schritt 10: Nicht verwendete Tabellen löschen

Führen Sie den folgenden Befehl aus, um alte, nicht verwendete Tabellen aus dem Cassandra-Cluster zu löschen. Bis dahin können Sie bestimmte Funktionen von Cassandra nicht verwenden, z. B. die Einrichtung einer neuen Authentifizierung. Die alten Authentifizierungsmechanismen funktionieren weiterhin. Dieser Befehl kann nur auf einem Knoten im Cluster ausgeführt werden.

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra drop_old_tables -f configFile

Schritt 11: Alle verbleibenden Edge- und anderen Komponenten für Private Cloud 4.52.02 aktualisieren

Führen Sie für alle verbleibenden edge-qpid-server- und edge-postgres-server-Knoten in allen Regionen ein Upgrade durch.

Wenn Sie ein Upgrade von Versionen vor Edge for Private Cloud 4.52.01 durchführen, müssen Sie in dieser Phase zusätzliche Schritte für das Upgrade von Qpid und Postgres ausführen und die verbleibenden Komponenten gemäß dieser Anleitung aktualisieren.

Upgrade auf Qpid J-Broker

Auch wenn Edge for Private Cloud 4.52.02 kein Upgrade auf Qpid enthält, müssen Sie die Schritte zum Aktualisieren von QPID ausführen, wenn Sie ein Upgrade von Versionen älter als 4.52.01 durchführen.

Wenn Sie ein Upgrade von Edge for Private Cloud 4.51.00 oder 4.52.00 auf 4.52.02 durchführen, sind zusätzliche Qpid-Upgradeschritte erforderlich. Wenn Sie ein Upgrade von Version 4.51.00 oder 4.52.00 auf 4.52.02 durchführen, lesen Sie den Abschnitt Qpid aktualisieren.
Wenn Sie ein Upgrade von Edge for Private Cloud 4.52.01 auf 4.52.02 durchführen, sollten Sie bereits die aktuelle Version des Qpid-Brokers verwenden. In diesem Fall sind keine zusätzlichen Qpid-Upgradeschritte erforderlich.

Neue Edge-Benutzeroberfläche

In diesem Abschnitt werden Aspekte der Edge-UI 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-UI zu installieren. Das ist eine verbesserte Benutzeroberfläche für Entwickler und Administratoren von Apigee Edge for Private Cloud.

Hinweis: 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 for Private Cloud, von der Sie ein Upgrade durchführen:

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

Update mit Apigee mTLS

So aktualisieren Sie Apigee mTLS:

Aktualisierung rückgängig machen

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

Wenn Sie das Update auf die vorherige Version zurücksetzen müssen, finden Sie eine detaillierte Anleitung unter Rollback auf Version 4.52.00.

Informationen zum Aktualisieren des Loggings

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

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

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

Wenn Sie keinen Zugriff auf /tmp haben, schlägt das update.sh-Tool fehl.

Aktualisierung ohne Ausfallzeiten

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

Ein Update ohne Ausfallzeit ist nur mit einer Konfiguration mit mindestens fünf Knoten möglich.

Der Schlüssel für Upgrades ohne Ausfallzeiten besteht darin, jeden Router einzeln aus dem Load-Balancer zu entfernen. Aktualisieren Sie dann den Router und alle anderen Komponenten auf demselben Computer wie der Router und fügen Sie den Router wieder dem Load-Balancer 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 Servererreichbarkeit (Message Processor/Router) aktivieren/deaktivieren beschrieben.
Aktualisieren Sie den ausgewählten Router und alle anderen Edge-Komponenten auf demselben Computer wie den Router. In allen Edge-Konfigurationen sind ein Router und ein Message Processor auf demselben Knoten zu sehen.
Sorge dafür, dass der Router wieder erreichbar ist.
Wiederhole die Schritte 2 bis 4 für die verbleibenden Router.
Setzen Sie das Update für alle verbleibenden Computer in Ihrer Installation fort.

Beachten Sie vor und nach dem Update Folgendes:

Auf dem kombinierten Router- und Nachrichtenprozessorknoten:
- Führen Sie vor dem Update die folgenden Schritte aus:
  1. Machen Sie den Router unerreichbar.
  2. Machen Sie den Message Processor unerreichbar.
- Nach dem Update führen Sie die folgenden Schritte aus:
  1. Sorgen Sie dafür, dass der Message Processor erreichbar ist.
  2. Sorgen Sie dafür, dass der Router erreichbar ist.
Auf einzelnen Router-Knoten:
- Trennen Sie den Router vom Stromnetz, bevor Sie das Update durchführen.
- Sorge nach dem Update dafür, dass der Router erreichbar ist.
Auf einzelnen Message Processor-Knoten:
- Machen Sie den Message Processor vor dem Update unerreichbar.
- Sorgen Sie nach dem Update dafür, dass der Message Processor erreichbar ist.

Konfigurationsdatei für die unbeaufsichtigte Installation verwenden

Sie müssen dem Update-Befehl eine Konfigurationsdatei im Silent-Modus übergeben. Die stille Konfigurationsdatei sollte dieselbe sein, die Sie für die Installation von Edge 4.50.00 oder 4.51.00 verwendet haben.

Aktualisierung auf Version 4.52.02 auf einem Knoten mit einer externen Internetverbindung

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

Deaktivieren Sie alle cron-Jobs, die für die Durchführung eines Reparaturvorgangs in Cassandra konfiguriert sind, bis das Update abgeschlossen ist.
Melden Sie sich als Root in 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 erfolgen.
Installieren Sie yum-utils und yum-plugin-priorities:
Hinweis:Wenn auf Ihrem Betriebssystem RHEL 8.0 bis 8.6 ausgeführt wird, überspringen Sie diesen Schritt.
```
sudo yum install yum-utils
sudo yum install yum-plugin-priorities
```
Deaktivieren Sie SELinux wie unter Das Edge-Einrichtungsprogramm apigee-setup installieren beschrieben.
Wenn Sie die Installation unter Oracle 7.x durchführen, führen Sie den folgenden Befehl aus:
```
sudo yum-config-manager --enable ol7_optional_latest
```

Wenn Sie die Installation in AWS durchführen, führen Sie die folgenden yum-configure-manager-Befehle aus:

yum update rh-amazon-rhui-client.noarch
sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional

Wenn Sie derzeit Edge 4.51.00 verwenden:
1. Laden Sie die Edge-Datei bootstrap_4.52.02.sh in /tmp/bootstrap_4.52.02.sh herunter:
```
curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
```
2. Installieren Sie das Dienstprogramm apigee-service 4.52.02 und die Abhängigkeiten, indem Sie den folgenden Befehl ausführen:
```
sudo bash /tmp/bootstrap_4.52.02.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 installiert.
  
  Mit der Option JAVA_FIX können Sie angeben, wie die Java-Installation behandelt 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 apigee-validate-Dienstprogramm auf dem Management Server, wie im folgenden Beispiel gezeigt:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
```
5. Aktualisieren Sie das apigee-provision-Dienstprogramm 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 unter Reihenfolge der Maschinenupdates beschriebenen Reihenfolge vor.
  
  Wobei:
  - component ist die Edge-Komponente, die aktualisiert werden soll. Zulässige Werte:
    - cs: Cassandra
    - edge: Alle Edge-Komponenten mit Ausnahme der Edge-Benutzeroberfläche: Management Server, Message Processor, Router, Qpid Server, Postgres Server
    - ldap: OpenLDAP
    - ps: postgresql
    - qpid: qpidd
    - sso: Apigee-SSO (wenn Sie SSO installiert haben)
    - ue: Neue Edge-Benutzeroberfläche
    - ui: Klassische Edge-UI
    - zk: Zookeeper
  - configFile ist dieselbe Konfigurationsdatei, die Sie bei der Installation von Version 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“ festlegen. Das ist jedoch 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 noch nicht geschehen:
```
/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 Management Server ausführen, wie in Installation testen beschrieben.

Wenn Sie das Update später rückgängig machen möchten, folgen Sie der Anleitung unter Version 4.52.02 zurücksetzen.

Aktualisierung auf Version 4.52.02 über ein lokales Repository

Wenn sich Ihre Edge-Knoten hinter einer Firewall befinden oder der Zugriff auf das Apigee-Repository über das Internet anderweitig verhindert wird, können Sie das Update über ein lokales Repository oder einen Spiegel des Apigee-Repositorys ausführen.#heading

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 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 führen Sie ein Update über ein lokales Repo der Version 4.52.02 durch:

Erstellen Sie ein lokales Repo der Version 4.52.02, wie unter Install the Edge apigee-setup utility (Das Edge-apigee-setup-Dienstprogramm installieren) im Abschnitt „Create a local Apigee repository“ (Lokales Apigee-Repository erstellen) beschrieben.
HINWEIS:Wenn Sie bereits ein vorhandenes Repository haben, können Sie das Repository 4.52.02 hinzufügen, wie unter Installieren des Edge-Dienstprogramms „apigee-setup“ im Abschnitt „Lokales Apigee-Repository aktualisieren“ beschrieben.
So installieren Sie „apigee-service“ aus einer TAR-Datei:
1. Verwenden Sie auf dem Knoten mit dem lokalen Repository den folgenden Befehl, um das lokale Repository in einer einzelnen TAR-Datei mit dem Namen /opt/apigee/data/apigee-mirror/apigee-4.52.02.tar.gz zu packen:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
```
2. Kopieren Sie die TAR-Datei auf den Knoten, auf dem Sie Edge aktualisieren möchten. Kopieren Sie sie beispielsweise in das Verzeichnis /tmp auf dem neuen Knoten.
3. Entpacken Sie die Datei auf dem neuen Knoten in das Verzeichnis /tmp:
```
tar -xzf apigee-4.52.02.tar.gz
```
  Mit diesem Befehl wird ein neues Verzeichnis mit dem Namen repos in dem Verzeichnis erstellt, das die TAR-Datei enthält. z. B. /tmp/repos.
4. Installieren Sie das Edge-Dienstprogramm apigee-service und die Abhängigkeiten aus /tmp/repos:
```
sudo bash /tmp/repos/bootstrap_4.52.02.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
```
  Beachten Sie, dass Sie in diesem Befehl den Pfad zum Verzeichnis „repos“ angeben.
So installieren Sie apigee-service mit dem Nginx-Webserver:
1. Konfigurieren Sie den Nginx-Webserver wie unter Edge-Einrichtungsprogramm apigee-setup installieren im Abschnitt „Über das Repository mit dem Nginx-Webserver installieren“ beschrieben.
2. Laden Sie auf dem Remote-Knoten die Edge-Datei bootstrap_4.52.02.sh in /tmp/bootstrap_4.52.02.sh herunter:
```
/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.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 zugehörigen Abhängigkeiten:
```
sudo bash /tmp/bootstrap_4.52.02.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
```
  Dabei sind uName:pWord der Nutzername und das Passwort für das Repository.
Verwenden Sie apigee-service, um das Dienstprogramm apigee-setup zu aktualisieren, wie im folgenden Beispiel gezeigt:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup update 
```
Aktualisieren Sie das apigee-validate-Dienstprogramm auf dem Management Server, wie im folgenden Beispiel gezeigt:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
```
Aktualisieren Sie das apigee-provision-Dienstprogramm auf dem Management Server, wie im folgenden Beispiel gezeigt:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
```
Führen Sie das update-Dienstprogramm auf Ihren Knoten in der Reihenfolge aus, die unter Reihenfolge der Maschinenaktualisierung beschrieben ist:
```
/opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
```
Wobei:
- component ist die Edge-Komponente, die aktualisiert werden soll. Normalerweise aktualisieren Sie die folgenden Komponenten:
  - cs: Cassandra
  - edge: Alle Edge-Komponenten mit Ausnahme der Edge-Benutzeroberfläche: Management Server, Message Processor, Router, Qpid Server, Postgres Server
  - ldap: OpenLDAP
  - ps: postgresql
  - qpid: qpidd
  - sso: Apigee-SSO (wenn Sie SSO installiert haben)
  - ue Neue Edge-Benutzeroberfläche
  - ui: Klassische Edge-UI
  - zk: Zookeeper
- configFile ist dieselbe Konfigurationsdatei, die Sie bei der Installation von Version 4.50.00 oder 4.51.00 verwendet haben, um Ihre Edge-Komponenten zu definieren.
  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“ festlegen. Das ist jedoch 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
```
Starten Sie die UI-Komponenten auf allen Knoten, auf denen sie ausgeführt werden, neu, falls noch nicht geschehen:
```
/opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
```
Testen Sie das Update, indem Sie das apigee-validate-Dienstprogramm auf dem Management Server ausführen, wie in Installation testen beschrieben.

Wenn Sie das Update später rückgängig machen möchten, folgen Sie der Anleitung unter 4.52.02 zurücksetzen.

Reihenfolge der Maschinenaktualisierung – Upgrade von 4.51.00, 4.52.00 oder 4.52.01

Die Reihenfolge, in der Sie die Maschinen in einer Edge-Installation aktualisieren, ist wichtig:

Sie müssen alle ZooKeeper-Knoten in allen Rechenzentren aktualisieren, bevor Sie alle anderen Komponenten aktualisieren. Wenn Sie ein Upgrade von Edge Private Cloud 4.51.00 oder 4.52.00 durchführen, müssen Sie auch zusätzliche Schritte ausführen, um Zookeeper zu aktualisieren.
Sie müssen Postgresql in allen Rechenzentren aktualisieren. Wenn Sie ein Upgrade von Edge Private Cloud 4.51.00 durchführen, müssen Sie außerdem zusätzliche Schritte ausführen, um Postgres zu aktualisieren.
Sie müssen LDAP-Knoten in allen Rechenzentren aktualisieren.
Sie müssen alle Cassandra-, Management Server-, Message Processor- und Router-Knoten ein Rechenzentrum nach dem anderen aktualisieren, bis alle Rechenzentren aktualisiert sind.
Sie müssen die edge-qpid-server- und edge-postgres-server-Komponenten in allen Rechenzentren aktualisieren.
Sie müssen Qpid-Knoten in allen Rechenzentren aktualisieren. Wenn Sie ein Upgrade von Edge Private Cloud 4.51.00 oder 4.52.00 durchführen, müssen Sie außerdem zusätzliche Schritte ausführen, um Qpid zu aktualisieren.
Aktualisieren Sie die Edge-Benutzeroberfläche und die neue Edge-Benutzeroberfläche sowie SSO-Knoten in allen Rechenzentren.
Es gibt keinen separaten Schritt zum Aktualisieren der Monetarisierung. Sie wird aktualisiert, wenn Sie die Edge-Option -c 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 mit einem Knoten

So führen Sie ein Upgrade einer eigenständigen 1-Knoten-Konfiguration auf Version 4.52.02 durch:

Alle Komponenten aktualisieren:

/opt/apigee/apigee-setup/bin/update.sh -c all -f configFile

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

Zookeeper auf Maschine 1 aktualisieren:

/opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile

Aktualisieren Sie Postgres auf Computer 2:

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

LDAP auf Computer 1 aktualisieren:

/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

Aktualisieren Sie Cassandra auf Maschine 1:

/opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile

Aktualisieren Sie die Edge-Komponenten auf Maschine 1 und Maschine 2:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```

Qpid auf Maschine 2 aktualisieren:

/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

Aktualisieren Sie die Benutzeroberfläche auf Computer 1:

/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

(Wenn Sie apigee-adminapi installiert haben) Das apigee-adminapi-Dienstprogramm auf Computer 1 wurde aktualisiert:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
(Wenn Sie Apigee SSO installiert haben): Apigee SSO auf Maschine 1 aktualisieren:
```
/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.

Starten Sie die Edge-UI-Komponente auf Maschine 1 neu:

/opt/apigee/apigee-service/bin/apigee-service edge-ui restart

5-Knoten-Upgrade

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

Eine Liste der Edge-Topologien und Knotennummern finden Sie unter Installationstopologien.

Aktualisieren Sie ZooKeeper auf den Maschinen 1, 2 und 3:
```
/opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile
```

Postgres auf Maschine 4 aktualisieren:

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

Postgres auf Maschine 5 aktualisieren:

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

LDAP auf Computer 1 aktualisieren:

/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

Aktualisieren Sie Cassandra auf den Maschinen 1, 2 und 3:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
```
Aktualisieren Sie die Edge-Komponenten auf den Maschinen 1, 2, 3, 4 und 5:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```

Qpid auf Maschine 4 aktualisieren:

/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

Qpid auf Maschine 5 aktualisieren:

/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

Aktualisieren Sie die Edge-Benutzeroberfläche:
- Klassische Benutzeroberfläche:Wenn Sie die klassische Benutzeroberfläche verwenden, aktualisieren Sie die Komponente ui auf Computer 1, wie im folgenden Beispiel gezeigt:
```
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
```
- Neue Edge-Benutzeroberfläche:Wenn Sie die neue Edge-Benutzeroberfläche installiert haben, aktualisieren Sie die ue-Komponente auf dem entsprechenden Computer (möglicherweise nicht Computer 1):
```
/opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
```
(Wenn Sie apigee-adminapi installiert haben) Das apigee-adminapi-Dienstprogramm auf Computer 1 wurde aktualisiert:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
(Wenn Sie Apigee SSO installiert haben): Apigee SSO auf Maschine 1 aktualisieren:
```
/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.
Starten Sie 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 (möglicherweise nicht Computer 1):
```
/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.

Aktualisieren Sie ZooKeeper auf den Maschinen 1, 2 und 3:
```
/opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile
```

Postgres auf Maschine 8 aktualisieren:

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

Postgres auf Maschine 9 aktualisieren:

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

LDAP auf Computer 1 aktualisieren:

/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

Aktualisieren Sie Cassandra auf Maschine 1, 2 und 3:

/opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile

Aktualisieren Sie die Edge-Komponenten auf den Maschinen 1, 4, 5, 6, 7, 8 und 9 in dieser Reihenfolge:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```

Qpid auf den Maschinen 6 und 7 aktualisieren:

/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

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
```
(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
```
(Wenn Sie Apigee SSO installiert haben): Apigee SSO auf Maschine 1 aktualisieren:
```
/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.
Starten Sie 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 (möglicherweise nicht Computer 1):
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
```

Upgrade eines Clusters 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.

Aktualisieren Sie ZooKeeper auf den Maschinen 1, 2 und 3:
```
/opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile
```

Postgres auf Maschine 8 aktualisieren:

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

Postgres auf Maschine 9 aktualisieren:

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

LDAP auf den Maschinen 4 und 5 aktualisieren:

/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

Aktualisieren Sie Cassandra auf den Maschinen 1, 2 und 3:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
```
Aktualisieren Sie die Edge-Komponenten auf den Computern 6, 7, 10, 11, 12, 13, 8 und 9 in dieser Reihenfolge:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```

Qpid auf den Maschinen 12 und 13 aktualisieren:

/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

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
```
(Wenn Sie apigee-adminapi installiert haben) Das apigee-adminapi-Dienstprogramm auf den Computern 6 und 7 wurde aktualisiert:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
(Wenn Sie Apigee SSO installiert haben): Apigee SSO auf den Maschinen 6 und 7 aktualisieren:
```
/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.
Starten Sie 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
```

Upgrade eines Clusters mit 12 Knoten

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

Eine Liste der Edge-Topologien und Knotennummern finden Sie unter Installationstopologien.

Aktualisieren Sie ZooKeeper auf den Maschinen 1, 2, 3, 7, 8 und 9 in beiden DCs:
```
/opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile
```
Postgres auf den Maschinen 6 und 12 in beiden Rechenzentren aktualisieren:
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
Aktualisieren Sie LDAP auf den Computern 1 und 7 in beiden DCs:
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
Blockieren Sie den Traffic in DC-1 und sorgen Sie dafür, dass der gesamte Traffic zu DC-2 umgeleitet wird.
Aktualisieren Sie Cassandra auf den Maschinen 1, 2 und 3 in DC-1:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
```
Aktualisieren Sie den Verwaltungsserver auf Computer 1 in DC-1:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
Router und Message Processor auf Maschine 2 und 3 in DC-1 aktualisieren:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
Entsperren Sie den Traffic in DC-1, validieren Sie DC-1 und fahren Sie mit DC-2 fort, indem Sie den Traffic in DC-2 blockieren und den Traffic zu DC-1 umleiten.
Aktualisieren Sie Cassandra auf den Maschinen 7, 8 und 9 in DC-2:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
```
Aktualisieren Sie den Verwaltungsserver auf Computer 7 in DC-2:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
Router und Message Processor auf Maschine 8 und 9 in DC-2 aktualisieren:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
Heben Sie die Blockierung des Traffics in DC-2 auf. Nun wird der Traffic von beiden DCs verarbeitet.
Führen Sie den Aktualisierungsbefehl auf allen Verwaltungsservern in allen Rechenzentren auf den Computern 1 und 7 noch einmal aus:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
Aktualisiere „edge-qpid-server“ und „edge-postgres-server“ auf den Maschinen 4, 5, 6, 10, 11 und 12 in beiden Rechenzentren:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
Aktualisieren Sie Qpid auf den Maschinen 4, 5, 10 und 11 in beiden Rechenzentren:
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
```
Aktualisieren Sie entweder die neue Benutzeroberfläche (ue) oder die klassische Benutzeroberfläche (ui) in beiden DCs:
```
/opt/apigee/apigee-setup/bin/update.sh -c  [ui|ue] -f configFile
```
Wenn Sie apigee-adminapi installiert haben, aktualisieren Sie apigee-adminapi in beiden DCs:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
Wenn Sie Apigee SSO installiert haben, aktualisieren Sie die Apigee SSO-Knoten in beiden Rechenzentren:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f configFile
```
Starten Sie die neue Edge-Benutzeroberfläche (edge-management-ui) oder die klassische Edge-Benutzeroberfläche (edge-ui) in beiden DCs neu:
```
/opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart
```