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

Aktualisieren Sie Apigee Edge 4.16.05.x auf die neueste Version 4.16.05.

Edge for Private Cloud v. 4.16.05

Dieses Dokument enthält das Verfahren, mit dem Sie Ihre vorhandene 4.16.05-Installation aktualisieren, um die neuesten RPMs und Supportdateien von Apigee zu verwenden. Bei diesem Verfahren wird das Update mit dem Dienstprogramm „update.sh“ ausgeführt.

Welche Edge-Versionen können Sie auf die neueste Version 4.16.05 aktualisieren?

Sie können nur eine vorhandene Apigee Edge-Installation der Version 4.16.05.x auf die neueste Version 4.16.05 aktualisieren.

Wenn Sie derzeit Edge-Version 4.16.01.0x oder früher ausführen, müssen Sie zuerst zu 4.16.05 migrieren. Informationen zur Migration auf Version 4.16.05 finden Sie unter Apigee Edge 4.16.01 auf 4.16.05 aktualisieren.

Wer kann das Update durchführen?

Der Nutzer, der das Update ausführt, sollte derselbe Nutzer sein, der Edge ursprünglich installiert hat, oder ein Nutzer, der als Root ausgeführt wird.

Nachdem Sie die Edge-RPMs installiert haben, kann jeder Nutzer sie konfigurieren.

Speicherplatzanforderungen für das Update

Achten Sie darauf, dass Sie mindestens 1 GB freien Speicherplatz haben, bevor Sie das Update ausführen.

Automatische Weitergabe von Attributeinstellungen ab 4.16.05.x

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

Voraussetzungen aktualisieren

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

Alle Knoten sichern
Vor dem Update wird aus Sicherheitsgründen empfohlen, 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 Plan B, falls das Update auf eine neue Version nicht richtig funktioniert. Weitere Informationen zur Sicherung finden Sie unter Sichern und Wiederherstellen.
Prüfen, ob Edge ausgeführt wird
Prüfen Sie mit dem folgenden Befehl, ob Edge während des Aktualisierungsvorgangs ausgeführt wird:

> /<inst_root>/apigee/apigee-service/bin/apigee-all status

Umgang mit einem fehlgeschlagenen Update

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

Wenn Sie aufgrund des Fehlers ein Rollback des Updates auf die vorherige Version durchführen müssen, lesen Sie den Abschnitt 4.16.05 Rollback-Prozess.

Informationen zum Logging-Update

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

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

Wenn der Nutzer, der 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 der Nutzer keinen Zugriff auf /tmp hat, schlägt das Dienstprogramm update.sh fehl.

Update ohne Ausfallzeiten

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

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

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

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

Router und Message Processor nicht erreichbar machen

In einer Produktionsumgebung haben Sie mehrere Router und Message Processors, um eine optimale Leistung zu erzielen. Sie müssen die Erreichbarkeit dieser Router und Message Processors vor/nach der Aktualisierung aktivieren/deaktivieren.

Mit dem folgenden API-Aufruf wird ein Knoten als erreichbar oder nicht erreichbar konfiguriert:

> curl -u adminEmail:pWord -X POST "http://<ms_IP>:8080/v1/servers/UUID" -d "reachable=true|false"

Dabei ist UUID die UUID des Message Processors oder Routers und „reachable“ ist entweder auf „true“ oder „false“ gesetzt.

Wenn Sie die UUID des Routers ermitteln müssen, verwenden Sie den folgenden cURL-Befehl:

> curl http://<routerIP>:8081/v1/servers/self

Wenn Sie die UUID des Message Processors ermitteln müssen, verwenden Sie den folgenden cURL-Befehl:

> curl http://<mpIP>:8082/v1/servers/self

Beachten Sie vor und nach dem Update Folgendes:

Auf kombiniertem Router- und Message Processor-Knoten:
- Führen Sie vor dem Update die folgenden Schritte aus:
  1. Machen Sie den Router mit dem oben gezeigten API-Aufruf nicht erreichbar.
  2. Machen Sie den Message Processor unerreichbar.
- Führen Sie nach dem Update die folgenden Schritte aus:
  1. Machen Sie den Message Processor erreichbar.
  2. Machen Sie den Router erreichbar.
Auf einem einzelnen Routerknoten:
- Sorgen Sie vor dem Update dafür, dass der Router erreichbar ist.
- Nach dem Update muss der Router erreichbar sein.
Auf einem einzelnen Message Processor-Knoten:
- Machen Sie den Message Processor vor dem Update nicht erreichbar.
- Machen Sie den Message Processor nach dem Update erreichbar.

Konfigurationsdatei für die automatische Installation verwenden

Sie müssen eine Konfigurationsdatei für die unbeaufsichtigte Installation an den Aktualisierungsbefehl übergeben. Die Datei für die automatische Konfiguration sollte dieselbe sein, die Sie für die Installation von Edge 4.16.05 verwendet haben.

Verfahren zum Aktualisieren von 4.16.05 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 auf Ihrem Knoten an, um die Edge-RPMs zu installieren.
Hinweis: Für die RPM-Installation ist Root-Zugriff erforderlich. Die Edge-Konfiguration können Sie jedoch ohne Root-Zugriff durchführen.
Deaktivieren Sie SELinux wie unter Edge-Dienstprogramm „apigee-setup“ installieren beschrieben.
Alle Yum-Caches leeren:
> sudo yum clean all
Laden Sie die neueste Edge-Datei bootstrap_4.16.05.sh in /tmp/bootstrap_4.16.05.sh herunter:
> curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
Aktualisieren Sie das Edge-Dienstprogramm „apigee-service“ und die Abhängigkeiten:
> sudo bash /tmp/bootstrap_4.16.05.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.
Verwenden Sie apigee-service, um das apigee-setup-Dienstprogramm zu aktualisieren:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

Durch dieses Update von apigee-service wird das Dienstprogramm update.sh in /<inst_dir>/apigee/apigee-setup/bin installiert.
Führen Sie das Update-Dienstprogramm auf Ihren Knoten in der unten beschriebenen Reihenfolge aus:
> /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

Die einzige Anforderung an die Konfigurationsdatei ist, dass sie für den Nutzer „apigee“ zugänglich oder lesbar sein muss. Legen Sie die Datei beispielsweise im Verzeichnis /tmp auf dem Knoten ab.

Verwenden Sie die Option „-c“, um die zu aktualisierende Komponente anzugeben. Die Liste der möglichen Komponenten umfasst:
- ldap = OpenLDAP
- cs = Cassandra
- zk = Zookeeper
- qpid = qpidd
- ps = postgresql
- edge =Alle Edge-Komponenten außer Edge-UI: Management Server, Message Processor, Router, QPID-Server, Postgres-Server
- ui = Edge-UI
- all = alle Komponenten auf dem Computer aktualisieren (nur für ein Edge-aio-Installationsprofil oder ein API BaaS-asa-Installationsprofil verwenden)
- e = ElasticSearch
- b = API BaaS Stack
- p = API BaaS Portal
- ebp = ElasticSearch, API BaaS Stack und API BaaS Portal auf demselben Knoten
Testen Sie das Update, indem Sie das Dienstprogramm apigee-validate ausführen, Installation testen.

Verfahren zum Aktualisieren von 4.16.05 aus einem lokalen Repository

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

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

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

So aktualisieren Sie von einem lokalen 4.16.05-Repository:

Prüfen Sie, ob Sie ein lokales 4.16.05-Repository haben, wie unter Edge-Komponenten auf einem Knoten installieren beschrieben.
Aktualisieren Sie das lokale Repository:
1. Laden Sie die neueste Edge-Datei bootstrap_4.16.05.sh in /tmp/bootstrap_4.16.05.sh herunter:
  > curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
2. Führen Sie die Synchronisierung durch:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
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.16.05.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.16.05.tar.gz
  
  Mit diesem Befehl wird ein neues Verzeichnis mit dem Namen „repos“ in dem Verzeichnis erstellt, das die TAR-Datei enthält. Beispiel: /tmp/repos.
4. Melden Sie sich als Root auf Ihrem Knoten an, um die Edge-RPMs zu installieren.
  Hinweis: Für die RPM-Installation ist Root-Zugriff erforderlich. Die Edge-Konfiguration können Sie jedoch ohne Root-Zugriff durchführen.
5. Deaktivieren Sie SELinux wie unter Edge-Dienstprogramm „apigee-setup“ installieren beschrieben.
6. Installieren Sie das Edge-Dienstprogramm „apigee-service“ und die Abhängigkeiten aus „/tmp/repos“:
  > sudo bash /tmp/repos/bootstrap_4.16.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
  
  Beachten Sie, dass Sie den Pfad zum Verzeichnis „repos“ in diesen Befehl einfügen.
So installieren Sie apigee-service mit dem Nginx-Webserver:
1. Konfigurieren Sie den Nginx-Webserver wie unter Edge-Komponenten auf einem Knoten installieren im Abschnitt „Aus dem Repository mit dem Nginx-Webserver installieren“ beschrieben.
2. Laden Sie auf dem Remote-Knoten die Edge-Datei bootstrap_4.16.05.sh in /tmp/bootstrap_4.16.05.sh herunter:
  > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
  
  Dabei sind uName:pWord der Nutzername und das Passwort, die Sie oben für das Repository festgelegt haben, und remoteRepo ist die IP-Adresse oder der DNS-Name des Repository-Knotens.
3. Melden Sie sich als Root auf Ihrem Knoten an, um die Edge-RPMs zu installieren.
  Hinweis: Für die RPM-Installation ist Root-Zugriff erforderlich. Die Edge-Konfiguration können Sie jedoch ohne Root-Zugriff durchführen.
4. Deaktivieren Sie SELinux wie unter Edge-Dienstprogramm „apigee-setup“ installieren beschrieben.
5. Installieren Sie auf dem Remote-Knoten das Edge-Dienstprogramm „apigee-service“ und die Abhängigkeiten:
  > sudo bash /tmp/bootstrap_4.16.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uNamea pigeepassword=pWord apigeeprotocol=http://
  
  Dabei sind uName:pWord der Nutzername und das Passwort des Repositorys.
Deaktivieren Sie alle CRON-Jobs, die für die Ausführung eines Reparaturvorgangs für Cassandra konfiguriert sind, bis das Update abgeschlossen ist.
Verwenden Sie apigee-service, um das Dienstprogramm apigee-setup zu aktualisieren:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

Mit diesem Update für apigee-service wird das Dienstprogramm update.sh in <inst_dir>/apigee/apigee-setup/bin installiert.
Führen Sie das Update-Dienstprogramm auf Ihren Knoten in der unten beschriebenen Reihenfolge aus:
> /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

Die einzige Anforderung an die Konfigurationsdatei ist, dass sie für den Nutzer „apigee“ zugänglich oder lesbar sein muss. Legen Sie die Datei beispielsweise im Verzeichnis /tmp auf dem Knoten ab.

Verwenden Sie die Option „-c“, um die zu aktualisierende Komponente anzugeben. Die Liste der möglichen Komponenten umfasst:
- ldap = OpenLDAP
- cs = Cassandra
- zk = Zookeeper
- qpid = qpidd
- ps = postgresql
- edge =Alle Edge-Komponenten außer Edge-UI: Management Server, Message Processor, Router, QPID-Server, Postgres-Server
- ui = Edge-UI
- all = alle Komponenten auf dem Computer aktualisieren (nur für ein Edge-aio-Installationsprofil oder ein API BaaS-asa-Installationsprofil verwenden)
- e = ElasticSearch
- b = API BaaS Stack
- p = API BaaS Portal
- ebp = ElasticSearch, API BaaS Stack und API BaaS Portal auf demselben Knoten
Testen Sie das Update, indem Sie das Dienstprogramm „apigee-validate“ ausführen, Installation testen.

Reihenfolge der Maschinenaktualisierung

Die Reihenfolge, in der Sie die Maschinen in einer Edge-Installation aktualisieren, ist wichtig. Die wichtigsten Überlegungen für ein Update sind:

Sie müssen alle Cassandra- und ZooKeeper-Knoten aktualisieren, bevor Sie andere Knoten aktualisieren.
Sie müssen alle qpidd- und postgresql-Knoten aktualisieren, bevor Sie Router- und Message Processor-Knoten aktualisieren.
Verwenden Sie für alle Maschinen mit mehreren Edge-Komponenten (Management Server, Message Processor, Router, QPID Server, Postgres Server) die Option „-c edge“, um alle gleichzeitig zu aktualisieren.
Wenn in einem Schritt angegeben ist, dass er auf mehreren Maschinen ausgeführt werden soll, führen Sie ihn in der angegebenen Reihenfolge aus.
Es gibt keinen separaten Schritt zum Aktualisieren der Monetarisierung. Sie wird aktualisiert, wenn Sie die Option „-c edge“ angeben.
Nachdem Sie einen Routerknoten aktualisiert haben, müssen Sie alle Dateien aus dem Verzeichnis /opt/nginx/conf.d entfernen und den Router dann neu starten.