Diese Seite wurde von der Cloud Translation API übersetzt.

Aktualisieren Sie Apigee Edge 4.19.06 oder 4.50.00 auf 4.51.00.

In diesem Abschnitt wird beschrieben, wie Sie von Apigee Edge 4.19.06 oder 4.50.00 auf 4.51.00 upgraden.

Wer kann das Update durchführen?

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

Nachdem Sie die Edge-RPMs installiert haben, kann sie von jedem konfiguriert werden.

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.

Automatische Übernahme von Property-Einstellungen

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

Erforderliches Upgrade auf Postgres 10.17

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

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

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

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

In einer Konfiguration mit einem und zwei Knoten von Edge haben Topologien, die für Prototyping und Tests verwendet werden, nur einen Postgres-Knoten. Sie können diese Postgres-Knoten direkt aktualisieren, ohne einen neuen Postgres-Knoten erstellen zu müssen.
Wenn Sie für Ihre Postgres-Knoten einen Netzwerkspeicher verwenden, wie von Apigee empfohlen, müssen Sie keinen neuen Postgres-Knoten installieren. In den folgenden Verfahren können Sie die Schritte zum Installieren und späteren Außerbetriebnahme eines neuen Postgres-Standby-Knotens überspringen.
Erstellen Sie vor dem Update einen Netzwerk-Snapshot des von Postgres verwendeten Datenspeichers. Wenn dann während der Aktualisierung Fehler auftreten und Sie ein Rollback durchführen müssen, können Sie den Postgres-Knoten aus diesem Snapshot wiederherstellen.

Neuen Postgres-Standby-Knoten installieren

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

Verwenden Sie zum Durchführen der Installation dieselbe Konfigurationsdatei, mit der Sie Ihre aktuelle Edge-Version installiert haben.

So erstellen Sie einen neuen Postgres-Standby-Knoten:

Bearbeiten Sie auf dem aktuellen Postgres-Master die Datei /opt/apigee/customer/application/postgresql.properties, um das folgende Token festzulegen. Wenn die Datei nicht vorhanden ist, erstellen Sie sie:
```
conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust\ \nhost replication apigee new_standby_ip/32 trust
```
Dabei ist existing_standby_ip die IP-Adresse des aktuellen Postgres-Standby-Servers und new_standby_ip die IP-Adresse des neuen Standby-Knotens.

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

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

Prüfen Sie, ob der neue Standby-Knoten hinzugefügt wurde. Sehen Sie sich dazu die Datei /opt/apigee/apigee-postgresql/conf/pg_hba.conf auf dem Master an. Die Datei sollte folgende Zeilen enthalten:
```
host replication apigee existing_standby_ip/32 trust
host replication apigee new_standby_ip/32 trust
```
Installieren Sie den neuen Postgres-Standby-Server:
1. Bearbeiten Sie die Konfigurationsdatei, mit der Sie Ihre aktuelle Version von Edge installiert haben, um Folgendes anzugeben:
```
# IP address of the current master:
PG_MASTER=192.168.56.103
# IP address of the new standby node
PG_STANDBY=192.168.56.102
```
2. Deaktivieren Sie SELinux wie unter Das Edge-Dienstprogramm für die Apigee-Einrichtung installieren beschrieben.
3. Führen Sie je nach Edge-Version, von der Sie ein Upgrade ausführen, einen der folgenden Schritte aus:
  - Wenn Sie ein Upgrade von Edge 4.19.06 ausführen, laden Sie die Datei Edge bootstrap_4.19.06.sh in /tmp/bootstrap_4.19.06.sh herunter:
```
curl https://software.apigee.com/bootstrap_4.19.06.sh -o /tmp/bootstrap_4.19.06.sh
```
    Installieren Sie als Nächstes das Edge apigee-service-Dienstprogramm und die Abhängigkeiten:
```
sudo bash /tmp/bootstrap_4.19.06.sh apigeeuser=uName apigeepassword=pWord
```
  - Wenn Sie ein Upgrade von Edge 4.50.00 ausführen, laden Sie die Datei Edge bootstrap_4.50.00.sh in /tmp/bootstrap_4.50.00.sh herunter:
```
curl https://software.apigee.com/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.00.sh
```
    Installieren Sie als Nächstes das Edge apigee-service-Dienstprogramm und die Abhängigkeiten:
```
sudo bash /tmp/bootstrap_4.50.00.sh apigeeuser=uName apigeepassword=pWord
```
4. Verwenden Sie apigee-service, um das apigee-setup-Dienstprogramm zu installieren:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
```
5. Postgres installieren:
```
/opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
```
6. Führen Sie auf dem neuen Standby-Knoten den folgenden Befehl aus:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
```
  Prüfen Sie, ob es sich um den Standby-Modus handelt.

Direktes Upgrade von Postgres durchführen

So führen Sie ein direktes Upgrade auf Postgres 10.17 aus:

Upgrade von Postgres auf dem Master-Host

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

durchführen

Führen Sie den Einrichtungsbefehl auf dem Masterhost aus:

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

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

Starten Sie den Master-Host neu:

apigee-service apigee-postgresql restart

Konfigurieren Sie es als Master:

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

Prüfen Sie, ob der Masterhost gestartet wurde:

apigee-service apigee-postgresql wait_for_ready

Beenden Sie den Standby-Modus:
```
apigee-service apigee-postgresql stop
```
Aktualisieren Sie den Standby-Modus.
Hinweis:Wenn bei diesem Schritt ein Fehler auftritt oder fehlschlägt, können Sie ihn ignorieren. update.sh versucht, den Stand-by-Server mit einer falschen Konfiguration zu starten. Wenn die Postgres-Installation auf 10.17 aktualisiert wurde, kann der Fehler ignoriert werden.
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
```
Achten Sie darauf, dass der Standby-Modus beendet ist:
```
apigee-service apigee-postgresql stop
```
Entfernen Sie die alte Standby-Konfiguration:
```
rm -rf /opt/apigee/data/apigee-postgresql/
```

Richten Sie die Replikation auf dem Standby-Server ein:

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

Nach Abschluss dieses Verfahrens wird der Standby-Modus erfolgreich gestartet.

Postgres-Knoten außer Betrieb nehmen

Nach Abschluss des Updates können Sie den neuen Standby-Knoten außer Betrieb nehmen:

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

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

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

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

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

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

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

Prüfen Sie, ob der neue Standby-Knoten entfernt wurde. Sehen Sie sich dazu die Datei /opt/apigee/apigee-postgresql/conf/pg_hba.conf auf dem Master an. In dieser Datei sollte nur die folgende Zeile zu sehen sein:
```
host replication apigee existing_standby_ip/32 trust
```
Löschen Sie die UUID des Standby-Knotens aus ZooKeeper. Dazu führen Sie den folgenden Edge Management API-Aufruf auf dem Verwaltungsserverknoten aus:
```
curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/new_standby_uuid
```

Voraussetzungen für Updates

Beachten Sie vor dem Upgrade von Apigee Edge die folgenden Voraussetzungen:

Alle Knoten sichern
Vor der Aktualisierung empfehlen wir aus Sicherheitsgründen, eine vollständige Sicherung aller Knoten durchzuführen. Führen Sie die Sicherung anhand des Verfahrens für Ihre aktuelle Edge-Version aus.
So haben Sie einen Sicherungsplan für den Fall, dass die Aktualisierung auf eine neue Version nicht ordnungsgemäß funktioniert. Weitere Informationen zur Sicherung finden Sie unter Sichern und Wiederherstellen.
Überprüfen Sie, ob Edge ausgeführt wird
Prüfen Sie mit dem folgenden Befehl, ob Edge während des Aktualisierungsprozesses aktiv ist:
```
/opt/apigee/apigee-service/bin/apigee-all status
```

Neue Edge-Benutzeroberfläche

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

Installieren Sie die Edge-Benutzeroberfläche

Nach Abschluss der Erstinstallation empfiehlt Apigee, dass Sie die Edge-Benutzeroberfläche installieren. Dabei handelt es sich um eine verbesserte Benutzeroberfläche für Entwickler und Administratoren von Apigee Edge für Private Cloud.

Beachten Sie, dass für die Edge-Benutzeroberfläche die Basisauthentifizierung deaktiviert und ein IdP wie SAML oder LDAP verwendet werden muss.

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

Aktualisieren Sie die Edge-Benutzeroberfläche

Berücksichtigen Sie zum Aktualisieren der Edge-UI-Komponente die Version von Edge für die Private Cloud, von der Sie ein Upgrade durchführen:

Von 4.19.06 oder 4.50.00 auf 4.51.00 (bei bereits installierter neuer Edge-Benutzeroberfläche): Folgen Sie der Upgrade-Anleitung in diesem Abschnitt für die edge-management-ui-Komponente.

Mit Apigee mTLS aktualisieren

So aktualisieren Sie Apigee mTLS:

Aktualisierung rückgängig machen

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

Wenn aufgrund des Fehlers ein Rollback auf die vorherige Version durchgeführt werden muss, finden Sie unter Rollback auf 4.51.00 eine ausführliche 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 Log in das Verzeichnis /tmp als Datei mit dem Namen update_username.log geschrieben.

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

Update ohne Ausfallzeiten

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

Updates ohne Ausfallzeiten sind nur ab einer Konfiguration mit 5 Knoten möglich.

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

Aktualisieren Sie die Maschinen in der richtigen Reihenfolge für Ihre Installation, wie unter Reihenfolge des Maschinenupdates beschrieben.
Wenn es an der Zeit ist, die Router zu aktualisieren, wählen Sie einen 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. Alle Edge-Konfigurationen zeigen einen Router und einen Message Processor auf demselben Knoten an.
Machen Sie den Router wieder erreichbar.
Wiederholen Sie die Schritte 2 bis 4 für die verbleibenden Router.
Fahren Sie für alle in Ihrer Installation verbleibenden Maschinen fort.

Beachten Sie vor und nach dem Update Folgendes:

Auf dem kombinierten Router- und Message Processor-Knoten:
- Führen Sie vor der Aktualisierung die folgenden Schritte aus:
  1. Machen Sie den Router unerreichbar.
  2. Machen Sie den Message Processor unerreichbar.
- Nach der Aktualisierung:
  1. Machen Sie den Message Processor erreichbar.
  2. Sorgen Sie dafür, dass der Router erreichbar ist.
Auf einzelnen Routerknoten:
- Machen Sie den Router vor dem Update unerreichbar.
- Machen Sie den Router nach dem Update erreichbar.
Auf einzelnen Message Processor-Knoten:
- Machen Sie den Message Processor vor der Aktualisierung unerreichbar.
- Machen Sie nach dem Update den Message Processor erreichbar.

Konfigurationsdatei im Hintergrund verwenden

Sie müssen eine unbeaufsichtigte Konfigurationsdatei an den Aktualisierungsbefehl übergeben. Die stille Konfigurationsdatei sollte mit der Datei identisch sein, die Sie zum Installieren von Edge 4.19.06 oder 4.50.00 verwendet haben.

Aktualisierung auf 4.51.00 auf einem Knoten mit einer externen Internetverbindung

Aktualisieren Sie mit dem folgenden Verfahren die Edge-Komponenten auf einem Knoten:

Deaktivieren Sie gegebenenfalls alle cron-Jobs, die für die Durchführung eines Reparaturvorgangs für Cassandra konfiguriert sind, bis die Aktualisierung abgeschlossen ist.
Melden Sie sich bei Ihrem Knoten als Root an, um die Edge-RPMs zu installieren.
HINWEIS: Für die RPM-Installation ist Root-Zugriff erforderlich. Sie können die Edge-Konfiguration aber auch ohne Root-Zugriff ausführen.
Installieren Sie yum-utils und yum-plugin-priorities:
Hinweis: Wenn Sie als Betriebssystem RHEL 8.0–8.6 verwenden, überspringen Sie diesen Schritt.
```
sudo yum install yum-utils
sudo yum install yum-plugin-priorities
```
Deaktivieren Sie SELinux wie unter Das Edge-Dienstprogramm für die Apigee-Einrichtung installieren beschrieben.
Wenn Sie die Installation auf Oracle 7.x ausführen, führen Sie den folgenden Befehl aus:
```
sudo yum-config-manager --enable ol7_optional_latest
```

Wenn Sie die Installation auf 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

Laden Sie die Datei bootstrap_4.51.00.sh von Edge 4.51.00 in /tmp/bootstrap_4.51.00.sh herunter:
```
curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
```
Installieren Sie das apigee-service-Dienstprogramm von Edge 4.51.00 und die Abhängigkeiten, indem Sie den folgenden Befehl ausführen:
```
sudo bash /tmp/bootstrap_4.51.00.sh apigeeuser=uName apigeepassword=pWord
```
Dabei sind uName:pWord der Nutzername und das Passwort, die Sie von Apigee erhalten haben. Wenn Sie pWord weglassen, werden Sie aufgefordert, ihn einzugeben.

Das Installationsprogramm prüft standardmäßig, ob Java 1.8 installiert ist. Andernfalls installiert das Installationsprogramm es für Sie.

Geben Sie mit der Option JAVA_FIX an, wie die Java-Installation verarbeitet werden soll. JAVA_FIX verwendet die folgenden Werte:
- I: Installiert OpenJDK 1.8 (Standardeinstellung).
- C: Fortfahren, ohne Java zu installieren.
- Q: Beenden. Für diese Option müssen Sie Java selbst installieren.
Verwenden Sie apigee-service, um das Dienstprogramm apigee-setup wie im folgenden Beispiel zu aktualisieren:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
```
Aktualisieren Sie das Dienstprogramm apigee-validate auf dem Verwaltungsserver wie im folgenden Beispiel gezeigt:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
```
Aktualisieren Sie das Dienstprogramm apigee-provision auf dem Verwaltungsserver wie im folgenden Beispiel gezeigt:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
```
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
```
Führen Sie dies in der unter Reihenfolge des Maschinenupdates beschriebenen Schritte aus.

Wobei:
- component ist die zu aktualisierende Edge-Komponente. Zulässige 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 die Konfigurationsdatei, die Sie während der Installation von 4.19.06 oder 4.50.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. Dies gilt jedoch nur, wenn Sie ein Edge All-in-one-Installationsprofil (AIO) haben. Beispiel:
```
/opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
```
Starten Sie die Edge-UI-Komponente auf allen Knoten neu, auf denen sie ausgeführt wird, falls Sie dies noch nicht getan haben:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```
Testen Sie das Update, indem Sie das Dienstprogramm apigee-validate auf dem Verwaltungsserver ausführen, wie unter Installation testen beschrieben.

Wenn Sie später ein Rollback der Aktualisierung durchführen möchten, folgen Sie der Anleitung unter Rollback 4.51.00.

Aktualisierung auf 4.51.00 von einem lokalen Repository

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

Nachdem Sie ein lokales Edge-Repository erstellt haben, haben Sie zwei Möglichkeiten, Edge über das lokale Repository zu aktualisieren:

Erstellen Sie eine TAR-Datei des Repositorys, kopieren Sie die TAR-Datei auf einen Knoten und aktualisieren Sie dann Edge über die TAR-Datei.
Installieren Sie einen Webserver auf dem Knoten mit dem lokalen Repository, damit andere Knoten darauf zugreifen können. Apigee stellt Ihnen den NGINX-Webserver zur Verfügung. Alternativ können Sie Ihren eigenen Webserver verwenden.

So führen Sie eine Aktualisierung von einem lokalen 4.51.00-Repository aus:

Erstellen Sie ein lokales 4.51.00-Repository, wie in „Lokales Apigee-Repository erstellen“ unter Dienstprogramm für Edge-Apigee-Setup installieren beschrieben.
HINWEIS: Wenn Sie bereits ein Repository haben, können Sie dem Repository das 4.51.00-Repository hinzufügen, wie unter „Lokales Apigee-Repository aktualisieren“ unter Dienstprogramm für das Edge-Apigee-Setup installieren beschrieben.
So installieren Sie den Apigee-Dienst aus einer TAR-Datei:
1. Verwenden Sie auf dem Knoten mit dem lokalen Repository den folgenden Befehl, um das lokale Repository in eine einzelne TAR-Datei namens /opt/apigee/data/apigee-mirror/apigee-4.51.00.tar.gz zu verpacken:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
```
2. Kopieren Sie die TAR-Datei auf den Knoten, in dem Sie Edge aktualisieren möchten. Kopieren Sie ihn beispielsweise in das Verzeichnis /tmp auf dem neuen Knoten.
3. Entpacken Sie die Datei auf dem neuen Knoten in das Verzeichnis /tmp:
```
tar -xzf apigee-4.51.00.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 Abhängigkeiten von /tmp/repos:
```
sudo bash /tmp/repos/bootstrap_4.51.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
```
  Beachten Sie, dass Sie den Pfad zum Repository-Verzeichnis in diesen Befehl aufnehmen.
So installieren Sie den Apigee-Dienst mit dem NGINX-Webserver:
1. Konfigurieren Sie den NGINX-Webserver wie unter „Mit dem NGINX-Webserver vom Repository installieren“ unter Dienstprogramm für Edge-Apigee-Setup installieren beschrieben.
2. Laden Sie auf dem Remote-Knoten die Edge-bootstrap_4.51.00.sh-Datei in /tmp/bootstrap_4.51.00.sh herunter:
```
/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
```
  Dabei sind uName:pWord der Nutzername und das Passwort, die Sie zuvor für das Repository festgelegt haben, und remoteRepo die IP-Adresse oder der DNS-Name des Repository-Knotens.
3. Installieren Sie auf dem Remote-Knoten das Edge-Dienstprogramm apigee-setup und die Abhängigkeiten:
```
sudo bash /tmp/bootstrap_4.51.00.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
```
  Dabei sind uName:pWord der Nutzername und das Passwort des Repositorys.
Verwenden Sie apigee-service, um das Dienstprogramm apigee-setup wie im folgenden Beispiel zu aktualisieren:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup update 
```
Aktualisieren Sie das Dienstprogramm apigee-validate auf dem Verwaltungsserver wie im folgenden Beispiel gezeigt:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
```
Aktualisieren Sie das Dienstprogramm apigee-provision auf dem Verwaltungsserver 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 des Maschinenupdates 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 die Konfigurationsdatei, die Sie während der Installation von 4.19.06 oder 4.50.00 zum Definieren Ihrer Edge-Komponenten verwendet haben.
  HINWEIS: Die Konfigurationsdatei muss für den Nutzer „apigee“ gelesen werden. 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. Dies gilt jedoch nur, wenn Sie ein Edge All-in-one-Installationsprofil (AIO) haben. Beispiel:
```
/opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config
```
Starten Sie die UI-Komponenten auf allen Knoten neu, auf denen sie ausgeführt werden, falls noch nicht geschehen:
```
/opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
```
Testen Sie das Update, indem Sie das Dienstprogramm apigee-validate auf dem Verwaltungsserver ausführen, wie unter Installation testen beschrieben.

Wenn Sie später ein Rollback der Aktualisierung durchführen möchten, folgen Sie der Anleitung unter Rollback 4.51.00.

Reihenfolge des Maschinenupdates

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

Sie müssen alle Cassandra- und ZooKeeper-Knoten aktualisieren, bevor Sie andere Knoten aktualisieren.
Verwenden Sie die Option -c edge für alle Maschinen mit mehreren Edge-Komponenten (Management Server, Message Processor, Router, QPID-Server, aber nicht Postgres-Server), um alle gleichzeitig zu aktualisieren.
Wenn für einen Schritt festgelegt ist, dass er auf mehreren Computern ausgeführt werden soll, führen Sie ihn in der angegebenen Maschinenreihenfolge aus.
Für die Monetarisierung ist kein separater Schritt erforderlich. Sie wird aktualisiert, wenn Sie die Option -c edge angeben.

Eigenständiges Upgrade mit 1 Knoten

So führen Sie ein Upgrade einer eigenständigen Konfiguration mit einem Knoten auf 4.51.00 durch:

Alle Komponenten aktualisieren:

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

(Wenn Sie apigee-adminapi installiert haben) Aktualisierung des Dienstprogramms apigee-adminapi:
```
/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.

Cassandra und ZooKeeper auf Maschine 1 aktualisieren:

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

Aktualisieren Sie Qpid und Postgres auf Computer 2:

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

LDAP auf Gerät 1 aktualisieren:

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

Aktualisieren Sie Edge-Komponenten auf Maschinen 2 und 1:

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

Aktualisieren Sie die UI auf Gerät 1:

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

(Wenn Sie apigee-adminapi installiert haben) Aktualisierung des Dienstprogramms apigee-adminapi auf Computer 1:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
(Wenn Sie Apigee SSO installiert haben) Aktualisieren Sie Apigee-SSO auf Computer 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
Dabei ist sso_config_file die Konfigurationsdatei, die Sie bei der Installation von SSO erstellt haben.

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

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

Upgrade mit 5 Knoten

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

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

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

Aktualisieren Sie Qpid und Postgres auf Computer 4:

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

Aktualisieren Sie Qpid und Postgres auf Computer 5:

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

LDAP auf Gerät 1 aktualisieren:

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

Aktualisieren Sie Edge-Komponenten auf Maschinen 4, 5, 1, 2, 3:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
Aktualisieren Sie die Edge-Benutzeroberfläche:
- Klassische UI: 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 Komponente ue auf dem entsprechenden Computer (möglicherweise nicht auf Computer 1):
```
/opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
```
(Wenn Sie apigee-adminapi installiert haben) Aktualisierung des Dienstprogramms apigee-adminapi auf Computer 1:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
(Wenn Sie Apigee SSO installiert haben) Aktualisieren Sie Apigee-SSO auf Computer 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
Dabei ist sso_config_file die Konfigurationsdatei, die Sie bei der Installation 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 Computer 1 wie im folgenden Beispiel neu:
```
/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 (möglicherweise nicht auf Computer 1) neu:
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
```

Geclustertes Upgrade 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 Cassandra und ZooKeeper auf Maschinen 1, 2 und 3:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```

Aktualisieren Sie Qpid auf Maschinen 6 und 7:

/opt/apigee/apigee-setup/bin/update.sh -c qpid -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

LDAP auf Gerät 1 aktualisieren:

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

Aktualisieren Sie die Edge-Komponenten auf den Maschinen 6, 7, 8, 9, 1, 4 und 5 in dieser Reihenfolge:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
Aktualisieren Sie entweder die neue UI (ue) oder die klassische UI (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 Dienstprogramm apigee-adminapi auf Computer 1:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
(Wenn Sie Apigee SSO installiert haben) Aktualisieren Sie Apigee-SSO auf Computer 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
Dabei ist sso_config_file die Konfigurationsdatei, die Sie bei der Installation 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 Computer 1 wie im folgenden Beispiel neu:
```
/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 (möglicherweise nicht auf Computer 1) neu:
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
```

Geclustertes Upgrade mit 13 Knoten

Aktualisieren Sie die folgenden Komponenten für eine Clusterinstallation mit 13 Knoten:

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

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

Aktualisieren Sie Qpid auf Maschinen 12 und 13:

/opt/apigee/apigee-setup/bin/update.sh -c qpid -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 Computer 4 und 5:

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

Aktualisieren Sie die Edge-Komponenten auf den Maschinen 12, 13, 8, 9, 6, 7, 10 und 11 in dieser Reihenfolge:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
Aktualisieren Sie entweder die neue UI (ue) oder die klassische UI (ui) auf den Maschinen 6 und 7:
```
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
```
(Wenn Sie apigee-adminapi installiert haben) Aktualisierung des Dienstprogramms apigee-adminapi auf den Maschinen 6 und 7:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
(Wenn Sie Apigee SSO installiert haben) Aktualisieren Sie die Apigee-SSO auf den Maschinen 6 und 7:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
Dabei ist sso_config_file die Konfigurationsdatei, die Sie bei der Installation von SSO erstellt haben.
Starten Sie die UI-Komponente neu:
- Klassische UI: Wenn Sie die klassische Benutzeroberfläche verwenden, starten Sie die Komponente edge-ui auf den Maschinen 6 und 7 wie im folgenden Beispiel neu:
```
/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 Maschinen 6 und 7 neu:
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
```

Geclustertes Upgrade mit 12 Knoten

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

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

Aktualisieren Sie Cassandra und ZooKeeper:
1. Auf Maschinen 1, 2 und 3 im Rechenzentrum 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```
2. Auf den Maschinen 7, 8 und 9 im Rechenzentrum 2
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```

Aktualisieren Sie qpidd:

Maschinen 4, 5 im Rechenzentrum 1

Aktualisieren Sie qpidd auf Gerät 4:

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

Aktualisieren Sie qpidd auf Gerät 5:

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

Maschinen 10, 11 im Rechenzentrum 2

Aktualisieren Sie qpidd auf Computer 10:

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

Aktualisieren Sie qpidd auf Gerät 11:

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

Aktualisieren Sie Postgres:

Maschine 6 im Rechenzentrum 1

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

Maschine 12 im Rechenzentrum 2

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

LDAP aktualisieren:

Maschine 1 im Rechenzentrum 1

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

Maschine 7 im Rechenzentrum 2

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

Aktualisieren Sie Edge-Komponenten:
1. Maschinen 4, 5, 6, 1, 2, 3 im Rechenzentrum 1
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
2. Maschinen 10, 11, 12, 7, 8, 9 im Rechenzentrum 2
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
Aktualisieren Sie entweder die neue UI (ue) oder die klassische UI (ui):
1. Maschine 1 im Rechenzentrum 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
```
2. Maschine 7 im Rechenzentrum 2:
```
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
```
(Wenn Sie apigee-adminapi installiert haben) Aktualisierung des Dienstprogramms apigee-adminapi:
1. Maschine 1 im Rechenzentrum 1:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
2. Maschine 7 im Rechenzentrum 2:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
(Wenn Sie Apigee SSO installiert haben) Aktualisieren Sie Apigee SSO:
1. Maschine 1 im Rechenzentrum 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
2. Maschine 7 im Rechenzentrum 2:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
Starten Sie die neue Edge-UI-Komponente (edge-management-ui) oder die klassische Edge-UI-Komponente (edge-ui) auf den Maschinen 1 und 7 neu:
```
/opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart
```

Für eine nicht standardmäßige Konfiguration

Wenn Sie eine nicht standardmäßige Konfiguration haben, aktualisieren Sie die Edge-Komponenten in der folgenden Reihenfolge:

ZooKeeper
Cassandra
QPIdd, PS
LDAP
Edge, d. h. das Profil "-c" auf allen Knoten in der Reihenfolge: Knoten mit Qpid-Server, Edge Postgres Server, Management Server, Message Processor und Router.
HINWEIS: Wenn auf einem Knoten sowohl der Qpid-Server als auch der Edge Postgres-Server installiert sind, führen Sie den Profilschritt „-c Edge“ aus.
Edge-Benutzeroberfläche (klassisch oder neu)
apigee-adminapi
Apigee-SSO

Nachdem Sie das Update abgeschlossen haben, müssen Sie die Edge-UI-Komponente auf allen Maschinen neu starten, auf denen sie ausgeführt wird.