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

Betriebssystem-Upgrade für einzelne Knoten für Apigee Edge for Private Cloud

Sie lesen gerade die Dokumentation zu Apigee Edge.
Apigee X-Dokumentation aufrufen info

In diesem Dokument wird eine alternative Methode zum Aktualisieren des Betriebssystems der Server in Ihrem Apigee Edge for Private Cloud-Cluster beschrieben. Anstatt ein völlig neues paralleles Rechenzentrum einzurichten, können Sie mit diesem knotenweisen Ansatz Ihr Betriebssystem direkt auf jeder einzelnen Maschine bzw. jedem einzelnen Knoten aktualisieren.

Kompatibilität

Prüfen Sie vor dem Start des Betriebssystem-Upgrades für jeden Knoten, ob Ihre aktuelle Version von Apigee Edge for Private Cloud die Zielbetriebssystemversion unterstützt. Weitere Informationen finden Sie in der Kompatibilitätsmatrix für Betriebssysteme.

Vorbereitung

Bevor Sie mit dem Upgrade der einzelnen Knoten beginnen, müssen Sie die folgenden Aufgaben ausführen:

Alle Knoten sichern

Bevor Sie die Anleitung ausführen, empfehlen wir, aus Sicherheitsgründen eine vollständige Sicherung aller Knoten durchzuführen, z. B. eine Sicherung auf VM-Ebene, eine Sicherung auf Komponentenebene oder beides. So haben Sie einen Plan B, falls einer der folgenden Schritte nicht richtig funktioniert. Weitere Informationen zur Sicherung auf Komponentenebene 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 Updatevorgangs ausgeführt wird:

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

Reihenfolge des Knotenaustauschs

Wir empfehlen, Knoten in der unten aufgeführten Reihenfolge zu aktualisieren, basierend auf dem Komponententyp:

Cassandra
Zookeeper
Postgres
LDAP
Qpid
Message-Processor
Router
Verwaltungsserver
UI/UE
SSO

Weitere Szenarien

Wenn Sie ein Betriebssystem-Upgrade Knoten für Knoten durchführen und eine der folgenden Konfigurationen in der vorhandenen Einrichtung vorhanden ist, beachten Sie bitte diese zusätzlichen Schritte:

apigee-mtls: Wenn apigee-mtls aktiviert ist, wird für diese Konfiguration kein OS-Upgrade (Rolling) auf Knotenebene unterstützt. Folgen Sie der Anleitung zum Upgrade von apigee-mtls, um ein Upgrade durchzuführen.

Cassandra

Wenn Sie Cassandra ersetzen, sollten Sie zuerst die Nicht-Seed-Knoten und dann die Seed-Knoten ersetzen.

Für Cassandra sind die folgenden Sonderfälle zu berücksichtigen:

Cassandra Native-mTLS: Wenn Native-mTLS aktiviert und erzwungen wird, entfernen Sie die Erzwingung auf mTLS-fähigen Knoten, indem Sie conf_cassandra_client_encryption_optional=true festlegen. Weitere Informationen finden Sie in der Dokumentation zu nativem mTLS.
Cassandra-Knotenverschlüsselung aktiviert: Informationen dazu, wie Sie dafür sorgen, dass die Zertifikate vorhandener Cassandra-Knoten im Truststore des neu ersetzten Knotens und umgekehrt enthalten sind, finden Sie unter Cassandra-Knotenverschlüsselung aktivieren.

Schritte zum Ersetzen eines Cassandra-Knotens:

Sichern Sie den Knoten, indem Sie (falls möglich) Snapshots der virtuellen Maschine erstellen und mit dem folgenden Befehl eine Apigee-Sicherung für Cassandra auf allen Knoten erstellen:
```
apigee-service apigee-cassandra backup
```
Neuen Knoten mit dem aktualisierten Betriebssystem erstellen
Erfüllen Sie die betriebssystemspezifischen Voraussetzungen.
Laden Sie die Edge-Datei herunter und führen Sie sie aus, um das apigee-service-Dienstprogramm zu installieren. Bootstrapping der verwendeten Apigee-Version: Führen Sie „bootstrap“ aus, um apigee-service abzurufen und apigee-setup zu installieren.
HINWEIS:Achten Sie darauf, dass der neue Knoten kein Datenverzeichnis im Pfad des Datenverzeichnisses apigee-cassandra enthält.

Listen Sie die Seed-Knoten auf:

apigee-service apigee-cassandra configure -search conf_cassandra_seeds

Aktualisieren Sie die Konfigurationsdatei, indem Sie die IP-Adresse des vorhandenen Cassandra-Knotens ändern und durch die IP-Adresse des neuen Knotens ersetzen.
HINWEIS:Achten Sie darauf, dass die Reihenfolge der zu ersetzenden IP-Adressen beibehalten wird. Beispiel: IP2 wird durch IP4 ersetzt.

Vorhandene CASS_HOSTS
```
CASS_HOSTS="$IP1 $IP2 $IP3"
```
Neu aktualisierte CASS_HOSTS
```
CASS_HOSTS="$IP1 $IP4 $IP3"
```
Konfigurieren Sie die vorhandenen Knoten im Cluster mit der aktualisierten IP-Adresse des neuen Cassandra-Knotens neu (mit Ausnahme des Knotens, der ersetzt werden soll). Konfigurationsdateireferenz
```
/opt/apigee/apigee-setup/bin/setup.sh -p c -f updatedConfigFile
```
Beenden Sie Cassandra auf dem alten Knoten und heben Sie die Registrierung auf:
1. Beenden Sie Cassandra auf dem Knoten, der ersetzt werden soll:
```
apigee-service apigee-cassandra stop
```
2. Listen Sie die UUID des Cassandra-Knotens auf, der außer Betrieb genommen werden soll (bei mehreren Rechenzentren entsprechend berücksichtigen):
```
apigee-adminapi.sh servers list -r dc-1 -p central -t application-datastore --admin AdminEmailID --pwd 'AdminPassword' --host localhost
```
3. Heben Sie die Registrierung der mit der vorhandenen Cassandra-UUID verknüpften Datenspeichertypen auf:
```
curl -u AdminEmailID:'AdminPassword' -X POST http://MS_IP:8080/v1/servers -d "type=cache-datastore&type=user-settings-datastore&type=scheduler-datastore&type=audit-datastore&type=apimodel-datastore&type=application-datastore&type=edgenotification-datastore&type=identityzone-datastore&type=auth-datastore&region=dc-1&pod=central&uuid=old_cassandra_uuid&action=remove"
```
4. Löschen Sie den Server.
  HINWEIS:Führen Sie diesen Schritt nicht aus, wenn sich Cassandra und andere Edge-Komponenten wie management-server auf demselben Knoten befinden. Das kann der Fall sein, wenn in Ihrer Konfiguration eine Standardkonfiguration mit fünf Apigee-Knoten verwendet wird.
```
curl -u AdminEmailID:AdminPassword -X DELETE http://MS_IP:8080/v1/servers/old_cassandra_uuid
```
Bereiten Sie einen neuen Knoten für den apigee-cassandra-Host vor. Fügen Sie der Datei cassandra.properties auf dem neuen Cassandra-Knoten unter /opt/apigee/customer/application/cassandra.properties die folgende Zeile hinzu (erstellen Sie die Datei, falls sie noch nicht vorhanden ist):
```
conf_jvm_options_custom_settings=-Dcassandra.replace_address=IPOfOldCassandraNode -Dcassandra.allow_unsafe_replace=true
```
Prüfen Sie, ob der Eigentümer und die Gruppe in der Datei cassandra.properties auf apigee:apigee festgelegt sind. Verwenden Sie bei Bedarf den folgenden Befehl, um den Inhaber und die Gruppe zu aktualisieren:
```
chown apigee:apigee /opt/apigee/customer/application/cassandra.properties
```

Installieren Sie Cassandra und führen Sie die Einrichtung auf dem neu hinzugefügten Knoten aus:

apigee-service apigee-cassandra install

apigee-service apigee-cassandra setup -f updatedConfigFile

Nachdem Sie den neuen Knoten eingerichtet haben, entfernen Sie die zusätzliche Konfiguration, die /opt/apigee/customer/application/cassandra.properties hinzugefügt wurde, und starten Sie apigee-cassandra neu:
```
conf_jvm_options_custom_settings=-Dcassandra.replace_address=IPOfOldCassandraNode -Dcassandra.allow_unsafe_replace=true
```
```
apigee-service apigee-cassandra restart
```

Prüfen Sie den Status des neuen, ersetzten Knotens:

apigee-service apigee-cassandra status

/opt/apigee/apigee-cassandra/bin/nodetool status

Erstellen Sie den neuen Knoten, der dem Cluster hinzugefügt wurde, neu:
```
/opt/apigee/apigee-cassandra/bin/nodetool rebuild -dc dc-1
```
Richten Sie die vorhandenen Knoten der Router-, Message-Processor-, Qpid-, Postgres- und Management-Server neu ein, indem Sie die IP-Adresse des neuen Cassandra-Knotens in der Konfigurationsdatei aktualisieren:
```
/opt/apigee/apigee-setup/bin/setup.sh -p r|mp|qs|ps|ms|mo -f updatedConfigFile
```
HINWEIS:Wenn sich der Router und der Message Processor auf demselben Knoten befinden, verwenden Sie -p rmp.
Cassandra vom alten Knoten entfernen/deinstallieren:
```
apigee-service apigee-cassandra uninstall
```
Wiederholen Sie den Vorgang für die anderen Cassandra-Knoten im Cluster.

Zookeeper

Folgen Sie der Anleitung unten, um Zookeeper-Knoten zu ersetzen. Ersetzen Sie zuerst die Follower-Knoten und dann die Leader-Knoten, damit das Ensemble das Quorum beibehält.

Sichern Sie den Knoten, indem Sie Snapshots der virtuellen Maschine erstellen (falls möglich) und eine Apigee-Sicherung für Zookeeper auf allen Knoten durchführen.

Zookeeper auf einem vorhandenen Knoten beenden und deinstallieren:

apigee-service apigee-zookeeper stop

apigee-service apigee-zookeeper uninstall

Neuen Knoten mit dem aktualisierten Betriebssystem erstellen
Erfüllen Sie die betriebssystemspezifischen Voraussetzungen.
Laden Sie den Bootstrap der verwendeten Apigee-Version herunter, führen Sie den Bootstrap aus, um apigee-service zu erhalten, und installieren Sie apigee-setup.
Aktualisieren Sie die Konfigurationsdatei, indem Sie die alten/gelöschten Knoten-IP-Adressen entfernen und durch die neue Knoten-IP für Zookeeper ersetzen. Weitere Informationen finden Sie in der Referenz zur Konfigurationsdatei:
HINWEIS:Achten Sie darauf, dass die Reihenfolge der zu ersetzenden IP-Adressen beibehalten wird. Beispiel: IP2 wird durch IP4 ersetzt.

Vorhandene ZK-Konfiguration
```
ZK_HOSTS="$IP1 $IP2 $IP3"
ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3"
    
```
Aktualisierte ZK-Konfiguration
```
ZK_HOSTS="$IP1 $IP4 $IP3"
ZK_CLIENT_HOSTS="$IP1 $IP4 $IP3"
    
```
Installieren, konfigurieren und starten Sie Zookeeper auf dem neuen Knoten mit der aktualisierten Konfigurationsdatei:
```
/opt/apigee/apigee-setup/bin/setup.sh -p zk -f updatedConfigFile
```
Nehmen Sie mit updatedConfigFile Änderungen am vorhandenen Zookeeper-Knoten vor:
```
/opt/apigee/apigee-setup/bin/setup.sh -p zk -f updatedConfigFile
```
Richten Sie die vorhandenen Knoten der Router-, Message-Processor-, Qpid-, Postgres- und Management-Server neu ein, indem Sie die IP-Adresse des neuen ZooKeeper-Knotens in der Konfigurationsdatei aktualisieren:
```
/opt/apigee/apigee-setup/bin/setup.sh -p r|mp|qs|ps|ms|mo -f updatedConfigFile
```
HINWEIS:Wenn sich der Router und der Message Processor auf demselben Knoten befinden, verwenden Sie -p rmp.
Wiederholen Sie den Vorgang für alle Zookeeper-Knoten.

Postgres

In diesem Abschnitt wird ein Ansatz für das Upgrade der Postgres-Knoten ohne Ausfallzeiten beschrieben, bei dem Sie die beschriebenen Schritte ausführen. Eine detaillierte Anleitung für jeden Schritt finden Sie in den folgenden Unterabschnitten.

Ersetzen Sie einen der vorhandenen Standby-Knoten durch das Zielbetriebssystem.
Stufen Sie den neuen Standby-Knoten zum Master hoch.
Nehmen Sie den alten Master außer Betrieb.
Ersetzen Sie weitere Standby-Knoten.

Bevor Sie mit dem Ersetzen beginnen, sollten Sie den edge-qpid-server beenden, um einen möglichen Verlust von Analysenachrichten zu minimieren.

apigee-service edge-qpid-server stop

Stand‑by

Rufen Sie die UUID der edge-postgres-server-Knoten ab:
```
curl http://pg_standby_ip:8084/v1/servers/self
```

Postgres beenden:

apigee-service edge-postgres-server stop

apigee-service apigee-postgresql stop

Entfernen Sie den vorhandenen Postgres-Standby aus der Analysegruppe gemäß dieser Anleitung.

Deinstallieren Sie apigee-postgres und postgres-server:

apigee-service edge-postgres-server uninstall

apigee-service apigee-postgresql uninstall

Neuen Knoten mit dem aktualisierten Betriebssystem erstellen
Erfüllen Sie die betriebssystemspezifischen Voraussetzungen.
Laden Sie den Bootstrap der verwendeten Apigee-Version herunter, führen Sie den Bootstrap aus, um apigee-service zu erhalten, und installieren Sie apigee-setup.
Richten Sie die Master-Standby-Replikation auf dem vorhandenen Master ein, indem Sie die Konfigurationsdatei mit EXISTING_PG_MASTER_IP und NEW_PG_STANDBY_IP aktualisieren. Weitere Informationen finden Sie in der Referenz zur Konfigurationsdatei:
```
PG_MASTER=EXISTING_PG_MASTER_IP
```
```
PG_STANDBY=NEW_PG_STANDBY_IP
```
```
apigee-service apigee-postgresql setup-replication-on-master -f updatedConfigFile
```

Installieren, konfigurieren und starten Sie Postgres mit Master-Standby-Konfigurationen auf dem neuen Standby-Knoten:

PG_MASTER=EXISTING_PG_MASTER_IP

PG_STANDBY=NEW_PG_STANDBY_IP

/opt/apigee/apigee-setup/bin/setup.sh -p ps -f updatedConfigFile

Standby-Einrichtung prüfen:

apigee-service apigee-postgresql postgres-check-standby

Master

Rufen Sie die UUID des vorhandenen Postgres-Masterknotens ab:
```
curl http://pg_ip:8084/v1/servers/self
```
Stufen Sie den neuen aktualisierten Standby-Knoten des Betriebssystems zum Master hoch.

Beenden Sie Postgres auf dem vorhandenen Master:

apigee-service apigee-postgresql stop

apigee-service edge-postgres-server stop

Stufen Sie den neuen Standby-Knoten zum Master hoch:

apigee-service apigee-postgresql promote-standby-to-master EXISTING_PG_MASTER_IP

Entfernen Sie den alten Masterknoten aus den Analyse- und Nutzergruppen.
Fügen Sie den neuen Masterknoten den Analyse- und Verbrauchergruppen hinzu.
Wenn Sie die Monetarisierung verwenden, aktualisieren Sie den neuen Postgres-Masterknoten und führen Sie die folgenden Schritte aus.
Nachdem der Masterknoten ersetzt wurde, kann der edge-qpid-server mit einer aktualisierten Masterknotenkonfiguration gestartet werden:
```
apigee-service edge-qpid-server start
```
Wenn Sie die Monetarisierung verwenden, starten Sie auch den Management Server und den Message Processor neu:
```
apigee-service edge-management-server restart
```

Beenden und deinstallieren Sie apigee-postgres und postgres-server auf dem alten Master:

apigee-service edge-postgres-server uninstall

apigee-service apigee-postgresql uninstall

Neuen Standby hinzufügen

Neuen Knoten mit dem aktualisierten Betriebssystem erstellen
Erfüllen Sie die betriebssystemspezifischen Voraussetzungen.
Laden Sie den Bootstrap der verwendeten Apigee-Version herunter, führen Sie den Bootstrap aus, um apigee-service zu erhalten, und installieren Sie apigee-setup.
Richten Sie die Master-Standby-Replikation mit der neuen Master-IP-Adresse und der neuen Standby-Knoten-IP-Adresse in der Konfigurationsdatei für den neuen Master und den neuen Standby-Knoten ein. Weitere Informationen finden Sie in der Referenz zur Konfigurationsdatei:
```
apigee-service apigee-postgresql setup-replication-on-master -f updatedConfigFile
```

Installation und Einrichtung auf dem neuen Standby-Knoten:

/opt/apigee/apigee-setup/bin/setup.sh -p ps -f updatedConfigFile

Fügen Sie den neuen Stand-by-Server den Analysegruppen hinzu. Folgen Sie dazu der Anleitung für die Einrichtung des Master-Stand-by-Servers.
Hinweis:Wenn Sie Analytikgruppen neue Standby-Knoten hinzufügen, muss das vorhandene Postgres-System zuerst entfernt und dann gleichzeitig mit dem Standby-System wieder hinzugefügt werden.

LDAP

Wenn der LDAP-Knoten ersetzt wird, muss der Management Server beendet werden. Alle Management APIs sind während des Knotenaustauschs nicht verfügbar.

Beenden Sie den Verwaltungsserver auf allen Knoten:
```
apigee-service edge-management-server stop
```
Außerbetriebnahme des vorhandenen LDAP-Knotens:
HINWEIS:Wenn Sie Version 4.53.01 oder höher verwenden, müssen Sie mdb in allen LDAP-Konfigurationen verwenden. Wenn Sie Version 4.53.00 oder niedriger verwenden, müssen Sie bdb in der LDAP-Konfiguration verwenden.
1. Erstellen Sie eine Sicherung/einen Snapshot auf VM-Ebene des LDAP-Knotens.
2. Bevor Sie LDAP beenden, sollten Sie die Anzahl der LDAP-Daten erfassen, die später überprüft werden kann, z. B.:
```
ldapsearch -o ldif-wrap=no -b "dc=apigee,dc=com" -D "cn=manager,dc=apigee,dc=com" -H ldap://:10389 -LLL -x -w Secret123 | wc -l
```
3. Bei der Aktiv/Passiv-Einrichtung:
  1. Machen Sie den aktuellen passiven Knoten zum aktiven Knoten, indem Sie auf dem passiven Knoten eine Datei mark_writable.ldif mit folgendem Inhalt hinzufügen:
```
dn: olcDatabase={2}bdb,cn=config
changetype: modify
replace: olcReadOnly
olcReadOnly: FALSE
```
  2. Führen Sie den folgenden Befehl auf dem passiven Knoten aus, um ihn zu aktivieren:
```
ldapmodify -a -x -w "$APIGEE_LDAPPW" -D "$CONFIG_BIND_DN" -H "ldap://:10389" -f mark_writable.ldif
```
  3. Fahren Sie mit Schritt (d) fort, um Knoten im Active-Active-Modus außer Betrieb zu nehmen.
4. Bei einer Aktiv/Aktiv-LDAP-Einrichtung müssen Sie die Replikation zwischen den beiden LDAP-Knoten unterbrechen und die Konfigurationen aktualisieren. Folgen Sie der Anleitung im Dokument zur Außerbetriebnahme von LDAP.
5. Beenden Sie den LDAP-Knoten, erstellen Sie eine Sicherung der LDAP-Daten und deinstallieren Sie den vorhandenen LDAP-Knoten (bei einer Active-Active-Konfiguration überspringen, wenn bereits erfolgt):
```
apigee-service apigee-openldap stop
```
```
apigee-service apigee-openldap backup
```
```
apigee-service apigee-openldap uninstall
```
Neuen Knoten mit dem aktualisierten Betriebssystem erstellen
Erfüllen Sie die betriebssystemspezifischen Voraussetzungen.
Laden Sie den Bootstrap der verwendeten Apigee-Version herunter, führen Sie den Bootstrap aus, um apigee-service zu erhalten, und installieren Sie apigee-setup.
Neuen LDAP-Knoten einrichten:
1. Aktualisieren Sie die configFile für den neuen Knoten basierend auf der Einrichtung. Weitere Informationen finden Sie in der Referenz zur Edge-Konfigurationsdatei für die Einrichtung mit nur einem aktiven Knoten oder mit aktiven und inaktiven Knoten:
  - LDAP_TYPE
  - LDAP_PEER
  - LDAP_SID
  - USE_LDAP_REMOTE_HOST=y/n
    Hinweis:Legen Sie USE_LDAP_REMOTE_HOST auf „y“ oder „n“ fest, je nachdem, ob LDAP auf demselben Knoten wie der Management Server konfiguriert ist.
2. LDAP auf dem neuen Knoten mit updatedConfigFile einrichten und starten:
```
/opt/apigee/apigee-setup/bin/setup.sh -p ld -f updatedConfigFile
```
3. Sichern Sie die LDAP-Daten von älteren Knoten (wenn die Aktiv/Aktiv-Einrichtung übersprungen werden kann):
  1. Erstellen Sie eine Beispielsicherung auf dem neuen Knoten, damit ein Standard-Sicherungsordner bzw. -pfad generiert wird:
```
apigee-service apigee-openldap backup
```
  2. Verschieben Sie die gesicherten Daten vom alten Knoten in den generierten Sicherungsordner.
  3. Stoppen Sie apigee-openldap, bevor Sie die Daten wiederherstellen:
```
apigee-service apigee-openldap stop
```
  4. Stellen Sie die Sicherung des alten Knotens wieder her:
```
apigee-service apigee-openldap restore backup_file
```
    Beispiel:
```
apigee-service apigee-openldap restore 2026.02.09,10.28.20
```
Wiederholen Sie den Vorgang für den anderen LDAP-Knoten (falls aktiv-aktiv).
Richten Sie den Management Server mit aktualisierten LDAP-Hostkonfigurationen neu ein und starten Sie ihn:
```
/opt/apigee/apigee-setup/bin/setup.sh -p mt -f updatedConfigFile
```

SSO neu einrichten und starten (falls zutreffend):

apigee-service apigee-sso setup -f updatedConfigFile

apigee-service apigee-sso restart

Optional: Konfigurieren Sie das zweite Active Directory als schreibgeschützt. Folgen Sie dazu der Dokumentation.

Qpid

Um einen vorhandenen Qpid-Knoten durch einen Knoten mit aktualisiertem Betriebssystem zu ersetzen, müssen wir die folgenden Schritte ausführen:

Sie erhalten keine Nachrichten mehr von Message Processors in der vorhandenen Knotenwarteschlange.
Leeren Sie die vorhandenen Nachrichten in der Warteschlange.
Beenden Sie den vorhandenen Knoten und nehmen Sie ihn außer Betrieb.

Außerbetriebnahme vorhandener Knoten. Damit keine Nachrichten verloren gehen, sind hier zusätzliche Maßnahmen aufgeführt:

Qpid-Broker beenden:
```
apigee-service apigee-qpidd stop
```
Eingehenden Traffic auf Port 5672 von allen Nachrichtenprozessoren blockieren:
```
iptables -A INPUT -p tcp --dport 5672 -s MP_IP -j DROP
```
Starten Sie den Qpid-Broker noch einmal, um vorhandene Nachrichten zu leeren:
```
apigee-service apigee-qpidd start
```
Achten Sie darauf, dass alle Nachrichten in der Warteschlange an den Consumer gesendet werden, bevor Sie die Außerbetriebnahme starten.
Rufen Sie die UUID des Knotens edge-qpid-server ab:
```
curl http://qpid_node_ip:8083/v1/servers/self
```
Führen Sie die Schritte zur Außerbetriebnahme oder Entfernung von Qpid aus der Analyse für apigee-qpidd und edge-qpid-server aus.

Beenden und deinstallieren Sie sowohl apigee-qpidd als auch edge-qpid-server:

apigee-service apigee-qpidd stop

apigee-service edge-qpid-server stop

apigee-service apigee-qpidd uninstall

apigee-service edge-qpid-server uninstall

Neuen Knoten hinzufügen:

Neuen Knoten mit dem aktualisierten Betriebssystem erstellen
Erfüllen Sie die betriebssystemspezifischen Voraussetzungen.
Laden Sie den Bootstrap der verwendeten Apigee-Version herunter, führen Sie den Bootstrap aus, um apigee-service zu erhalten, und installieren Sie apigee-setup.
Richten Sie die Qpid-Dienste auf dem neuen Knoten ein und führen Sie sie aus. Fügen Sie sie dann den Verbrauchergruppen hinzu. Folgen Sie dazu dieser Anleitung. Sie können auch andere Gruppen wie für die Monetarisierung hinzufügen.
Wenn der Monetarisierungsdienst aktiviert ist, starten Sie den Management Server und den Message Processor neu:
```
apigee-service edge-management-server restart
```
```
apigee-service edge-message-processor restart
```
Wiederholen Sie den Vorgang für alle Qpid-Knoten.

Message-Processor

Rufen Sie die UUID des edge-message-processor-Knotens ab:
```
curl http://mp_ip:8082/v1/servers/self
```
Nachrichtenverarbeiterknoten deaktivieren und deinstallieren
Wenn der Monetarisierungsdienst aktiviert ist, deinstallieren Sie edge-mint-message-processor.

Message Processor deinstallieren:

apigee-service edge-message-processor uninstall

Neuen Knoten mit dem aktualisierten Betriebssystem erstellen
Erfüllen Sie die betriebssystemspezifischen Voraussetzungen.
Laden Sie den Bootstrap der verwendeten Apigee-Version herunter, führen Sie den Bootstrap aus, um apigee-service zu erhalten, und installieren Sie apigee-setup.
Fügen Sie dem Cluster den Message Processor hinzu, richten Sie ihn ein und starten Sie ihn. Folgen Sie dazu dieser Anleitung.
Wenn die Monetarisierung aktiviert ist, richten Sie den Monetarisierungsdienst zusammen mit dem Message Processor ein. Weitere Informationen finden Sie in der folgenden Dokumentation.

Router

Rufen Sie die UUID des edge-router-Knotens ab:
```
curl http://router_ip:8081/v1/servers/self
```

Erreichbarkeit deaktivieren und prüfen, ob sie erreichbar ist:

iptables -A INPUT -i eth0 -p tcp --dport 15999 -j REJECT

curl -vvv -X GET http://router_ip:15999/v1/servers/self/reachable

Außer Betrieb nehmen und deinstallieren Sie den Routerknoten.
Router deinstallieren:
```
apigee-service edge-router uninstall
```
Neuen Knoten mit dem aktualisierten Betriebssystem erstellen
Erfüllen Sie die betriebssystemspezifischen Voraussetzungen.
Laden Sie den Bootstrap der verwendeten Apigee-Version herunter, führen Sie den Bootstrap aus, um apigee-service zu erhalten, und installieren Sie apigee-setup.
Fügen Sie dem Cluster einen Router hinzu, richten Sie ihn ein und starten Sie ihn.

Verwaltungsserver

Nur ein Verwaltungsserver

Neuen Knoten mit dem aktualisierten Betriebssystem erstellen
Erfüllen Sie die betriebssystemspezifischen Voraussetzungen.
Laden Sie den Bootstrap der verwendeten Apigee-Version herunter, führen Sie den Bootstrap aus, um apigee-service zu erhalten, und installieren Sie apigee-setup.
Fügen Sie den Verwaltungsserver mit der aktualisierten IP-Adresse und Konfigurationsdatei hinzu (siehe hier) und führen Sie den Einrichtungsbefehl aus:
```
/opt/apigee/apigee-setup/bin/setup.sh -p mt -f updatedConfigFile
```
Richten Sie die Benutzeroberfläche mit der neuen Management-IP-Konfiguration neu ein und starten Sie sie neu.
```
/opt/apigee/apigee-setup/bin/setup.sh -p ui -f updatedConfigFile
```
SSO mit neuer Management-IP-Konfiguration neu einrichten (falls zutreffend):
```
/opt/apigee/apigee-setup/bin/setup.sh -p sso -f updatedConfigFile
```
Neue Benutzeroberfläche mit neuer Management-IP-Konfiguration einrichten (falls zutreffend):
```
/opt/apigee/apigee-setup/bin/setup.sh -p ue -f updatedConfigFile
```
Wenn die Monetarisierung aktiviert ist:
1. Richten Sie die Monetarisierung mit der neuen Management-IP-Konfiguration (falls zutreffend) neu ein. Weitere Informationen finden Sie in der Dokumentation zur Monetarisierungskonfiguration.
```
/opt/apigee/apigee-setup/bin/setup.sh -p mo -f updatedConfigFile
```
2. Verwaltungsserver neu starten:
```
apigee-service edge-management-server restart
```
Nehmen Sie den Management Server auf dem vorhandenen/alten Knoten außer Betrieb. Folgen Sie dazu dieser Anleitung.

Wenn die Monetarisierung aktiviert ist, entfernen Sie die Management Server-UUID aus den Analysegruppen. Beispiel:

curl -v -u AdminEmail:AdminPassword -X DELETE "http://localhost:8080/v1/analytics/groups/ax/mint_axgroup/servers?uuid=MS_UUID&type=consumer-server"

Deinstallieren Sie den Monetarisierungs-Verwaltungsserver:
```
apigee-service edge-mint-management-server uninstall
```

Mehrere Verwaltungsserver

Stellen Sie einen der Verwaltungsserver mithilfe des anderen auf dem vorhandenen Knoten außer Betrieb. Folgen Sie dazu dieser Anleitung.

Management Server stoppen und deinstallieren:

apigee-service edge-management-server stop

apigee-service edge-management-server uninstall

Neuen Knoten mit dem aktualisierten Betriebssystem erstellen
Erfüllen Sie die betriebssystemspezifischen Voraussetzungen.
Laden Sie den Bootstrap der verwendeten Apigee-Version herunter, führen Sie den Bootstrap aus, um apigee-service zu erhalten, und installieren Sie apigee-setup.
Fügen Sie den Verwaltungsserver mit der aktualisierten IP-Adresse und Konfigurationsdatei hinzu (siehe hier) und führen Sie den Einrichtungsbefehl aus:
```
/opt/apigee/apigee-setup/bin/setup.sh -p mt -f updatedConfigFile
```
Richten Sie die Benutzeroberfläche mit der aktualisierten Management-IP-Konfiguration neu ein und starten Sie sie neu:
```
/opt/apigee/apigee-setup/bin/setup.sh -p ui -f updatedConfigFile
```
(Nur wenn SSO aktiviert ist) SSO mit aktualisierter Management-IP-Konfiguration neu einrichten und neu starten:
```
/opt/apigee/apigee-setup/bin/setup.sh -p sso -f updatedConfigFile
```
(Nur wenn die neue Benutzeroberfläche aktiviert ist) Richten Sie die neue Benutzeroberfläche mit der aktualisierten Management-IP-Konfiguration neu ein und starten Sie sie neu:
```
/opt/apigee/apigee-setup/bin/setup.sh -p ue -f updatedConfigFile
```
Wiederholen Sie den Vorgang für den anderen Management Server.

UI/UE

Sicherung/VM-Snapshot des UI-Knotens erstellen.

Benutzeroberfläche zum Beenden und Deinstallieren:

apigee-service edge-ui stop

apigee-service edge-ui uninstall

(Nur bei Verwendung der neuen Benutzeroberfläche) Neue Benutzeroberfläche beenden und deinstallieren:
```
apigee-service edge-management-ui stop
```
```
apigee-service edge-management-ui uninstall
```
Neuen Knoten mit dem aktualisierten Betriebssystem erstellen
Erfüllen Sie die betriebssystemspezifischen Voraussetzungen.
Laden Sie den Bootstrap der verwendeten Apigee-Version herunter, führen Sie den Bootstrap aus, um apigee-service zu erhalten, und installieren Sie apigee-setup.
Richten Sie edge-ui auf dem neuen Knoten mit aktualisierten IP-Konfigurationen ein und führen Sie es aus:
```
/opt/apigee/apigee-setup/bin/setup.sh -p ui -f updatedConfigFile
```
(Nur wenn SSO aktiviert ist) SSO mit neuen Knoten-IP-Konfigurationen über die Benutzeroberfläche neu einrichten und ausführen:
```
/opt/apigee/apigee-setup/bin/setup.sh -p sso -f updatedConfigFile
```

(Nur wenn die neue Benutzeroberfläche aktiviert ist) Richten Sie die neue Benutzeroberfläche auf dem neuen Knoten mit aktualisierten IP-Konfigurationen ein und führen Sie sie aus:

/opt/apigee/apigee-setup/bin/setup.sh -p ue -f updatedConfigFile

apigee-service edge-management-ui configure-sso -f updatedConfigFile

apigee-service edge-ui configure-sso -f updatedConfigFile

SSO

Sicherung/VM-Snapshot des UI-Knotens erstellen.

SSO beenden und deinstallieren:

apigee-service apigee-sso stop

apigee-service apigee-sso uninstall

Neuen Knoten mit dem aktualisierten Betriebssystem erstellen
Erfüllen Sie die betriebssystemspezifischen Voraussetzungen.
Laden Sie den Bootstrap der verwendeten Apigee-Version herunter, führen Sie den Bootstrap aus, um apigee-service zu erhalten, und installieren Sie apigee-setup.
Fügen Sie Konfigurationen und Schlüssel für SSO gemäß der Anleitung hinzu und berücksichtigen Sie dabei die neue Knoten-IP-Adresse.

SSO einrichten und starten:

/opt/apigee/apigee-setup/bin/setup.sh -p sso -f updatedConfigFile

Aktualisieren Sie die Konfiguration mit den neuen SSO-Knoten-IPs und konfigurieren Sie SSO für die Benutzeroberfläche neu:
```
apigee-service edge-ui configure-sso -f updatedConfigFile
```
(Bei Verwendung der neuen Benutzeroberfläche) Führen Sie „configure-sso“ auf dem Knoten der neuen Benutzeroberfläche aus. Weitere Informationen finden Sie in der Dokumentation:
```
apigee-service edge-management-ui configure-sso -f updatedConfigFile
```
```
apigee-service edge-ui configure-sso -f updatedConfigFile
```