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

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 ausfü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 für die Aktualisierung

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 richtig funktioniert. Weitere Informationen zu Sicherungen 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
```
Hinweis: Achten Sie darauf, dass die Einrichtung von edge-management-server in Ihrer vorhandenen Version erfolgreich und ohne Fehler ausgeführt wird. Beheben Sie alle Fehler in der edge-management-server-Einrichtung aus früheren Versionen, bevor Sie mit dem Upgrade fortfahren.
Prüfen, ob die Cassandra-Komprimierungsstrategie LeveledCompactionStrategy ist
Nehmen Sie je nach aktueller Version die erforderlichen Änderungen an der Cassandra-Komprimierungsstrategie vor. Führen Sie die folgenden Schritte aus und kehren Sie dann zum Hauptupgradeverfahren zurück:
- Wenn Sie ein Upgrade von Version 4.51.00 durchführen, lesen Sie das Dokument zur Cassandra-Komprimierungsstrategie für Version 4.51.00.
- Wenn Sie ein Upgrade von Version 4.52.00 durchführen, lesen Sie das Dokument zur Cassandra-Komprimierungsstrategie für Version 4.52.00.
- Wenn Sie ein Upgrade von Version 4.52.01 durchführen, lesen Sie das Dokument zur Cassandra-Komprimierungsstrategie für Version 4.52.01.

Besondere Schritte, die beim Upgrade zu beachten sind

Wenn Sie ein Upgrade auf Edge for Private Cloud 4.52.02 durchführen möchten, müssen Sie bestimmte Schritte ausführen, um bestimmte Software zu aktualisieren. Die erforderlichen Schritte hängen von Ihrer aktuellen Version ab. In der folgenden Tabelle finden Sie die verschiedenen Softwareprogramme, für die zusätzliche Schritte erforderlich sind. Folgen Sie der detaillierten Anleitung für die jeweilige Software. Nachdem Sie die erforderlichen Aufgaben ausgeführt haben, kehren Sie zum Hauptverfahren für das Upgrade zurück, um den Upgradeprozess fortzusetzen.

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

Nachdem Sie die erforderlichen Schritte für Ihre Version ausgeführt haben, kehren Sie zum Hauptverfahren für das Upgrade zurück, um fortzufahren.

Automatische Übernahme von Property-Einstellungen

Wenn Sie Attribute 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 vor 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, finden Sie die Schritte zum Upgrade von Zookeeper unter Erforderliches Upgrade auf Zookeeper 3.8.3.
Wenn Sie ein Upgrade von Edge for Private Cloud Version 4.52.01 durchführen, sollten Sie bereits ZooKeeper Version 3.8.3 verwenden. Sie müssen dann keine besonderen Schritte für das Upgrade von ZooKeeper ausführen.

Hinweis:

Das Upgrade von Edge for Private Cloud 4.52.01 auf 4.52.02 ist vereinfacht, da Zookeeper und Cassandra in der Regel auf demselben Host oder derselben virtuellen Maschine gehostet werden. Dadurch sind keine separaten Zookeeper-Upgradeverfahren neben dem umfangreichen Cassandra-Upgrade erforderlich.

Wenn ZooKeeper mit bestimmten Schritten aktualisiert werden muss, aktualisieren Sie ZooKeeper in allen Rechenzentren, indem Sie jeweils einen Knoten aktualisieren. Nachdem alle ZooKeeper-Knoten global aktualisiert wurden, aktualisieren Sie Cassandra Rechenzentrum für Rechenzentrum. Folgen Sie dazu dem weiter unten in diesem Artikel beschriebenen Verfahren.

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

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

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

Upgrade auf Postgres 14 durchführen

Wenn Sie ein Upgrade von Edge for Private Cloud 4.51.00 auf 4.52.02 durchführen, müssen Sie die Schritte zum Upgrade von Postgres ausführen, obwohl 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 größeres Upgrade handelt, waren bestimmte Änderungen am Datenmodell von Apigee in Cassandra erforderlich, um eine optimale Leistung in neueren Versionen zu gewährleisten. Obwohl diese Änderungen minimal sind, werden durch den Upgradevorgang bestimmte Verwaltungs-APIs unterbrochen, 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-Flüssen und Verwaltungs-APIs im Rechenzentrum, das aktualisiert wird. Es ist wichtig, dass Sie den Laufzeit- und Verwaltungstraffic 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 cassandra-cli-Tool 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 Drupal 7-basierte 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 dieses 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 Abschluss des Upgrades wieder importieren.

Verwendete Terminologie

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

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

Während dieses Upgrades ist der Laufzeit- und Verwaltungstraffic in der Region oder im Rechenzentrum (RZ) betroffen, in der bzw. dem das Update ausgeführt wird. Unabhängig davon, welches Rechenzentrum aktualisiert wird, sind bestimmte Verwaltungs-APIs in allen Rechenzentren betroffen. Diese Auswirkungen werden nach jedem Schritt aufgeführt.

In den folgenden Schritten wird der Status der Laufzeit und der Verwaltung beschrieben, während Sie die verschiedenen Phasen des Upgrades durchlaufen.

Upgradestrategien

Mehrere Rechenzentren

Das Upgrade muss für jedes Rechenzentrum einzeln durchgeführt werden, um die Kontinuität des Traffics zu gewährleisten und Ausfallzeiten zu vermeiden. Vor dem Upgrade eines Rechenzentrums sollte der Traffic an andere funktionierende Rechenzentren umgeleitet werden.

Hinweis:

Um Auswirkungen auf den Traffic während des Upgrades zu vermeiden, sollten Sie Rechenzentrum für Rechenzentrum vorgehen und den Traffic vorübergehend vom Rechenzentrum, das aktualisiert wird, wegleiten. So wird ein kontrollierter Upgradevorgang für Cassandra, Management Server und Laufzeitknoten gewährleistet, während die Dienstverfügbarkeit aufrechterhalten wird.

Führen Sie für eine Einrichtung mit zwei Rechenzentren die folgenden allgemeinen Schritte aus:

Leiten Sie den Traffic von DC-1 zu DC-2 um und blockieren Sie eingehenden Traffic zu DC-1.
Führen Sie ein Upgrade von DC-1 durch, einschließlich Cassandra, Management Server und Laufzeitkomponenten.
Leiten Sie den Traffic zurück zu DC-1 weiter und blockieren Sie eingehenden Traffic zu DC-2.
Führen Sie ein Upgrade für DC-2 durch, einschließlich Cassandra, Management Server und Laufzeitkomponenten.

Dieser Prozess sorgt für eine nahtlose Trafficverwaltung während des Upgrades. Ein ähnliches Muster sollte für Setups mit mehr als zwei Rechenzentren befolgt werden, bei denen der Traffic vorübergehend an Rechenzentren weitergeleitet wird, die entweder vollständig aktualisiert oder noch nicht aktualisiert wurden.

Einzelnes Rechenzentrum

Bei einer Einrichtung mit einem einzelnen Rechenzentrum hat das Upgrade-Verfahren erhebliche Auswirkungen auf den Laufzeittraffic und bestimmte Verwaltungs-APIs. Für die Einrichtung eines einzelnen Rechenzentrums sind die folgenden Optionen verfügbar.

Erweitern Sie Ihren Edge for Private Cloud-Cluster auf ein temporäres Rechenzentrum, indem Sie neben dem vorhandenen Rechenzentrum ein Rechenzentrum 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 erweitern können, sollten Sie sich auf Ausfallzeiten vorbereiten und das Upgrade für Zeiten mit geringem Traffic planen, um die Auswirkungen auf Verwaltungs-APIs und den Laufzeit-Traffic zu minimieren.

Es wird empfohlen, ein zusätzliches Rechenzentrum hinzuzufügen, um Auswirkungen auf den Laufzeit-Traffic und die Verwaltungs-APIs zu vermeiden. Während des Upgrades sind die Auswirkungen auf das Rechenzentrum, das aktualisiert wird, einschließlich, aber nicht beschränkt auf die folgenden Bereiche zu spüren:

Laufzeit-APIs, die OAuth-Tokens aktualisieren
Laufzeit-APIs mit AccessEntity-Richtlinie
Verwaltungs-APIs, die Entwickler-Apps auflisten
Verwaltungs-APIs, die Produkte auflisten

Die oben beschriebenen Auswirkungen kommen zu den spezifischen Verwaltungs-APIs hinzu, die in allen Rechenzentren nicht funktionieren, bis alle Rechenzentren aktualisiert wurden. Diese Verwaltungs-APIs sind in den Schritten in den folgenden Abschnitten aufgeführt.

Rollback – Übersicht

Auswirkungen während des Rollbacks
Das Rollback von Cassandra 3.11.x auf 2.1.x wirkt sich sowohl auf den Laufzeit- als auch auf den Verwaltungstraffic im Rechenzentrum (DC) aus, in dem das Rollback durchgeführt wird. Darüber hinaus kann es bei bestimmten Verwaltungs-APIs in allen Rechenzentren zu Störungen kommen, unabhängig davon, welches Rechenzentrum gerade zurückgesetzt wird.
Rollback-Ansatz für jedes Rechenzentrum einzeln
Das Rollback muss für jedes Rechenzentrum einzeln ausgeführt werden, um die Dienstkontinuität aufrechtzuerhalten und Ausfallzeiten zu vermeiden. Bevor Sie ein Rollback in einem bestimmten Rechenzentrum initiieren, müssen Sie dafür sorgen, dass der Anwendungstraffic an ein anderes, voll funktionsfähiges Rechenzentrum weitergeleitet wird.
Rollback für teilweise aktualisierte Cluster
Wenn mindestens ein Rechenzentrum mit der älteren Version von Cassandra (2.1.22) vollständig funktionsfähig bleibt, können andere aktualisierte Rechenzentren durch einen Rebuild aus dem vollständig funktionsfähigen Cassandra 2.1.X-Rechenzentrum zurückgesetzt werden.
Clusterweites Rollback
Wenn der gesamte Cassandra-Cluster aktualisiert wurde und ein Rollback erforderlich ist, muss dieser mithilfe von Sicherungen oder VM-Snapshots durchgeführt werden. Dieser Ansatz ist komplex und führt wahrscheinlich zu vorübergehenden Ausfallzeiten oder Datenverlusten.
Ü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

Das Upgrade von Cassandra von Version 2.1.x auf 3.11.x kann erhebliche Auswirkungen auf den Laufzeittraffic und bestimmte Verwaltungs-APIs haben. 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 nach erfolgreichem Abschluss des Upgrades außer Betrieb genommen werden.

Wenn das Hinzufügen eines neuen Rechenzentrums nicht möglich ist, aber dennoch eine Rollback-Funktion erforderlich ist, sollten Sie vor dem Upgrade zuverlässige Sicherungen erstellen. Die Wiederherstellung von Cassandra 2.1.x aus Sicherungen ist möglich, kann aber zu Dienstausfällen und Datenverlust führen.

Cluster mit mehreren Rechenzentren zurücksetzen

Das Rollback mehrerer Rechenzentren erfolgt Rechenzentrum für Rechenzentrum. Bei diesem Ansatz wird der Traffic vom Rechenzentrum, für das ein Rollback durchgeführt wird, an andere funktionierende Rechenzentren weitergeleitet. So wird ein kontrollierter und isolierter Rollback-Prozess für Cassandra, Management Server und Laufzeitknoten ermöglicht, um Traffic-Unterbrechungen zu vermeiden.

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

Schritt 0: Ausgangszustand

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

Der Management-Server kommuniziert mit Cassandra über das ältere Thrift-Protokoll.
Laufzeit-Server (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: Auf 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 folgendem 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 Upgrade-Installationsprogramm von Apigee 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 das Upgrade fehl, aber der Cassandra-Dienst auf dem Knoten befindet sich wahrscheinlich im Status „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 angegebenen 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, wenn er beendet wurde, als das Upgrade fehlgeschlagen ist, 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 es im JSON-Format über die Benutzeroberfläche des Entwicklerportals herunterladen. Diese Modelle müssen nach der Aktualisierung der Verwaltungsserver wieder in Apigee importiert werden.
Achten Sie darauf, dass die Ports 9160 und 9042 von allen Edge-Komponenten zu Cassandra-Knoten zugänglich sind, falls dies noch nicht der Fall ist. Weitere Informationen finden Sie unter Portanforderungen.

Schritt 2: Traffic vom ersten Rechenzentrum wegleiten

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

Schritt 3: Alle Cassandra-Knoten im ersten Rechenzentrum aktualisieren

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

Führen Sie nach der Aktualisierung eines Knotens 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 in 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 nach Abschluss des Upgrades den folgenden post_upgrade-Befehl 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 in Rechenzentren, die aktualisiert werden, blockiert Laufzeit in anderen Rechenzentren voll funktionsfähig	Verwaltungstraffic wird in Rechenzentren blockiert, die aktualisiert werden. Die folgende Verwaltungsfunktion ist nach dem Upgrade von Cassandra in anderen Rechenzentren beeinträchtigt: 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 Verwaltungsknoten im ersten Rechenzentrum aktualisieren

Aktualisieren Sie alle Verwaltungsknoten im Rechenzentrum:

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

Laufzeitstatus in dieser Phase	Verwaltungsstatus in dieser Phase
Laufzeittraffic in Rechenzentren, die aktualisiert werden, blockiert Laufzeit voll funktionsfähig	Verwaltungstraffic wird in Rechenzentren blockiert, die aktualisiert werden. Die folgende Verwaltungsfunktion ist nach dem Upgrade von Cassandra 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 5: Alle Laufzeitknoten im ersten Rechenzentrum aktualisieren

Aktualisieren Sie alle Router- und Message Processor-Knoten im Rechenzentrum nacheinander:

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

Laufzeitstatus in dieser Phase	Verwaltungsstatus in dieser Phase
Laufzeittraffic in Rechenzentren, die aktualisiert werden, blockiert Laufzeit in anderen Rechenzentren voll funktionsfähig	Verwaltungstraffic wird in Rechenzentren blockiert, die aktualisiert werden. Die folgende Verwaltungsfunktion ist nach dem Upgrade von Cassandra in anderen Rechenzentren beeinträchtigt: 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 leiten

Nachdem das erste Rechenzentrum mit Cassandra, Laufzeitkomponenten und Verwaltungsserver aktualisiert wurde, aktivieren Sie den Laufzeit- und Verwaltungstraffic zum ersten Rechenzentrum wieder.
Sorgen Sie dafür, dass der Laufzeit- und Verwaltungstraffic über Rechenzentren hinweg erfolgreich ist.

Schritt 7: Andere Rechenzentren aktualisieren

Wiederholen Sie Schritt 1 bis Schritt 6 für die verbleibenden Rechenzentren, indem Sie den Traffic von diesen Rechenzentren wegleiten, die Apigee-Software aktualisieren und den Traffic auf diesen Rechenzentren wieder aktivieren.

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

Führen Sie den folgenden Upgrade-Befehl auf allen Verwaltungsknoten 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 sind, können Sie die SmartDocs-Modelle importieren, die Sie in Schritt 1 exportiert haben. Sie können dies auch später tun.

Das ist nur erforderlich, wenn Sie ein Drupal 7-basiertes Entwicklerportal und die SmartDocs-Funktion verwenden.

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. das Einrichten einer neuen Authentifizierung – alte 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 nacheinander ein Upgrade aller verbleibenden edge-qpid-server- und edge-postgres-server-Knoten in allen Regionen durch.

Wenn Sie ein Upgrade von einer Version vor Edge for Private Cloud 4.52.01 durchführen, müssen Sie an dieser Stelle zusätzliche Schritte ausführen, um Qpid bzw. Postgres zu aktualisieren und die verbleibenden Komponenten gemäß dieser Anleitung zu aktualisieren.

Upgrade auf Qpid J-Broker

Edge for Private Cloud 4.52.02 enthält zwar kein Upgrade auf Qpid, aber wenn Sie ein Upgrade von Versionen vor 4.52.01 durchführen, müssen Sie die Schritte zum Upgrade von Qpid ausführen.

Wenn Sie ein Upgrade von Edge for Private Cloud 4.51.00 oder 4.52.00 auf 4.52.02 durchführen, müssen Sie zusätzliche Qpid-Upgradeschritte ausführen. 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. Es sind keine zusätzlichen Qpid-Upgradeschritte erforderlich.

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

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 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 der Fehler ein Rollback des Updates auf die vorherige Version erfordert, finden Sie unter Rollback von 4.52.00 eine detaillierte Anleitung.

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 Sie keinen Zugriff auf /tmp haben, 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. Aktualisieren Sie dann den Router und alle anderen Komponenten auf demselben Computer wie den 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 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.
Wiederholen Sie die Schritte 2 bis 4 für die verbleibenden Router.
Fahren Sie mit dem Update für alle verbleibenden Maschinen in Ihrer Installation fort.

Beachten Sie vor und nach dem Update Folgendes:

Auf dem kombinierten Router- und Message Processor-Knoten:
- Führen Sie vor dem Update die folgenden Schritte aus:
  1. Router nicht erreichbar machen.
  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 nicht erreichbar.
- Machen Sie den Router nach der Aktualisierung erreichbar.
Auf einzelnen Message Processor-Knoten:
- Machen Sie den Message Processor vor der Aktualisierung nicht erreichbar.
- Machen Sie den Message Processor nach der Aktualisierung erreichbar.

Silent-Konfigurationsdatei verwenden

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

Aktualisierung auf 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 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.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 Edge 4.52.02-Dienstprogramm apigee-service und die Abhängigkeiten mit dem folgenden Befehl:
```
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, es einzugeben.
  
  Das Installationsprogramm prüft standardmäßig, 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 unter Reihenfolge der Maschinenaktualisierung beschriebenen Reihenfolge vor.
  
  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 bei 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-AIO-Installationsprofil (All-in-One) haben. Beispiel:
```
/opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
```
7. Starten Sie die Edge-UI-Komponenten auf allen Knoten neu, auf denen sie ausgeführt werden, falls Sie dies noch nicht getan haben:
```
/opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
```
8. Testen Sie das Update, indem Sie das 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, gehen Sie wie unter 4.52.02 rückgängig machen beschrieben vor.

Update auf 4.52.02 aus einem lokalen Repository

Wenn sich Ihre Edge-Knoten hinter einer Firewall befinden oder anderweitig 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.#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 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.02-Repository:

Erstellen Sie ein lokales 4.52.02-Repository, wie unter Edge-Dienstprogramm „apigee-setup“ installieren im Abschnitt „Lokales Apigee-Repository erstellen“ beschrieben.
HINWEIS: Wenn Sie bereits ein Repository haben, können Sie das Repository 4.52.02 hinzufügen, wie unter „Lokales Apigee-Repository aktualisieren“ unter Edge-Dienstprogramm „apigee-setup“ installieren 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 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 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 von /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 „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.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 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.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 Dienstprogramm apigee-validate auf dem Management Server, wie im folgenden Beispiel gezeigt:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
```
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
```
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 bei der Installation von 4.50.00 oder 4.51.00 zum Definieren Ihrer Edge-Komponenten verwendet haben.
  HINWEIS: Die Konfigurationsdatei muss vom Nutzer „apigee“ gelesen werden können. 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-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 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
```
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, gehen Sie wie unter 4.52.02 rückgängig machen beschrieben vor.

Reihenfolge der Maschinenaktualisierung – Upgrade von 4.51.00 (oder) 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 außerdem 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 Komponenten edge-qpid-server und edge-postgres-server in allen Rechenzentren aktualisieren.
Sie müssen ein Upgrade der Qpid-Knoten in allen Rechenzentren durchführen. 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 die SSO-Knoten in allen Rechenzentren.
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 Anleitung zur Updateinstallation beschrieben.

Eigenständiges Upgrade für 1 Knoten

So aktualisieren Sie eine eigenständige Konfiguration mit einem Knoten auf 4.52.02:

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.

Aktualisieren Sie ZooKeeper auf Maschine 1:

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

Aktualisieren Sie Postgres auf Maschine 2:

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

Aktualisieren Sie LDAP auf Maschine 1:

/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 2:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```

Aktualisieren Sie Qpid auf Maschine 2:

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

Aktualisieren Sie die Benutzeroberfläche auf Maschine 1:

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

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

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.

Aktualisieren Sie ZooKeeper auf den Computern 1, 2 und 3:

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

Aktualisieren Sie Postgres auf Maschine 4:

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

Aktualisieren Sie Postgres auf Maschine 5:

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

Aktualisieren Sie LDAP auf Maschine 1:

/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 1, 2, 3, 4 und 5:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```

Aktualisieren Sie Qpid auf Maschine 4:

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

Aktualisieren Sie Qpid auf Maschine 5:

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

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
```
(Wenn Sie apigee-adminapi installiert haben) Das Dienstprogramm apigee-adminapi auf Maschine 1 wurde aktualisiert:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
(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.
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 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 Maschine 1, 2 und 3:

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

Aktualisieren Sie Postgres auf Maschine 8:

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

Aktualisieren Sie Postgres auf Maschine 9:

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

Aktualisieren Sie LDAP auf Maschine 1:

/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 Computern 1, 4, 5, 6, 7, 8 und 9 in dieser Reihenfolge:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```

Aktualisieren Sie Qpid auf den Computern 6 und 7:

/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 Maschine 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
```
(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
```
(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.
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 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 Computern 1, 2 und 3:

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

Aktualisieren Sie Postgres auf Maschine 8:

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

Aktualisieren Sie Postgres auf Maschine 9:

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

Aktualisieren Sie LDAP auf den Computern 4 und 5:

/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
```

Aktualisieren Sie Qpid auf den Computern 12 und 13:

/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) Aktualisieren Sie das Dienstprogramm apigee-adminapi auf den Computern 6 und 7:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
(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.
Starten Sie die UI-Komponente neu:
- Klassische Benutzeroberfläche: Wenn Sie die klassische Benutzeroberfläche 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 eines Clusters 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.

Aktualisieren Sie ZooKeeper auf den Maschinen 1,2,3,7,8,9 in beiden Rechenzentren:
```
/opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile
```
Aktualisieren Sie Postgres auf den Maschinen 6 und 12 in beiden Rechenzentren:
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
Aktualisieren Sie LDAP auf den Computern 1 und 7 in beiden Rechenzentren:
```
/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 an DC-2 weitergeleitet 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 Management Server auf Maschine 1 in DC-1:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
Aktualisieren Sie den Router und den Message Processor auf Maschine 2,3 in DC-1:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
Heben Sie die Blockierung des Traffics in DC-1 auf, validieren Sie DC-1 und fahren Sie mit DC-2 fort, indem Sie den Traffic in DC-2 blockieren und den Traffic an DC-1 weiterleiten.
Aktualisieren Sie Cassandra auf den Computern 7, 8 und 9 in DC-2:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
```
Aktualisieren Sie den Management Server auf Maschine 7 in DC-2:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
Aktualisieren Sie Router und Message Processor auf Maschine 8 und 9 in DC-2:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
Heben Sie die Blockierung des Traffics in DC-2 auf. Jetzt wird der Traffic von beiden DCs verarbeitet.
Führen Sie den Update-Befehl auf allen Management Servern in allen Rechenzentren auf Maschine 1 und 7 noch einmal aus:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
Aktualisieren Sie edge-qpid-server und edge-postgres-server auf den Computern 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 Computern 4, 5, 10 und 11 in beiden Rechenzentren:
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
```
Aktualisieren Sie entweder die neue UI (ue) oder die klassische UI (ui) in beiden Rechenzentren:
```
/opt/apigee/apigee-setup/bin/update.sh -c  [ui|ue] -f configFile
```
(Wenn Sie apigee-adminapi installiert haben) Aktualisieren Sie apigee-adminapi in beiden Rechenzentren:
```
/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-UI-Komponente (edge-management-ui) oder die klassische Edge-UI-Komponente (edge-ui) in beiden Rechenzentren neu:
```
/opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart
```