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

Apigee Edge 4.16.01 auf 4.16.05 aktualisieren

Edge for Private Cloud v. 4.16.05

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

Sie können nur die Apigee Edge-Version 4.16.01.x auf 4.16.05 aktualisieren.

Wenn Sie eine Edge-Version vor Version 4.16.01.x haben, müssen Sie zuerst zu Version 4.16.01.x migrieren und dann auf Version 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.

Erforderliches Upgrade auf Java JDK Version 8

Für diese Version von Edge muss Java JDK Version 8 auf allen Edge-Verarbeitungsknoten installiert sein. Sie können Oracle JDK 8 oder OpenJDK 8 installieren. Wenn Java JDK 8 noch nicht installiert ist, kann das Update-Skript es für Sie installieren.

Im Rahmen des Updates auf Java 8 sind einige TLS-Chiffren in Oracle JDK 8 nicht mehr verfügbar. Eine vollständige Liste finden Sie im Abschnitt „Standardmäßig deaktivierte Cipher Suites“ unter http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html.

Warnung: Diese Version von Edge unterstützt JDK 7 nicht. Wenn Sie derzeit JDK 7 verwenden, müssen Sie ein Upgrade auf JDK 8 durchführen. Wenn Sie ein Rollback der Edge 4.16.05-Installation durchführen, können Sie Edge optional so konfigurieren, dass Java JDK 7 verwendet wird.

Downgrade von ZooKeeper

Die Version des Zookeeper-RPM in Edge for Private Cloud 4.16.01 ist apigee-zookeeper-3.4.5-1.0.905.noarch.rpm. In nachfolgenden Versionen von Edge wurde die Zookeeper-Version wieder in apigee-zookeeper-3.4.5-0.0.948 geändert. Dadurch wird verhindert, dass yum ZooKeeper auf eine höhere Version als 4.16.01 aktualisiert. Um dieses Problem zu beheben, führen Sie yum downgrade apigee-zookeeper aus, bevor Sie Zookeeper aktualisieren.

Sie können Ihre ZooKeeper-Version mit dem folgenden Befehl prüfen:

> rpm -qa |grep apigee-zookeeper

Wenn dieser Befehl die Zookeeper-Version zurückgibt:

apigee-zookeeper-3.4.5-1.0.905

Anschließend müssen Sie das Downgrade durchführen.

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.01.x

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

Dienstprogramm „apigee-validate“ aktualisieren

In Version 4.16.01 haben Sie das Dienstprogramm apigee-validate auf einem Message Processor-Knoten installiert und ausgeführt. In 4.16.05 wurde das Dienstprogramm apigee-validate aktualisiert, um auf dem Management Server-Knoten ausgeführt zu werden.

Wenn Sie auf 4.16.05 aktualisieren, haben Sie zwei Möglichkeiten, das Dienstprogramm apigee-validate zu aktualisieren:

Von Apigee empfohlen: Installieren Sie das Dienstprogramm apigee-validate auf dem Management Server-Knoten und führen Sie es aus.

Optional können Sie das Dienstprogramm apigee-validate von den Message Processor-Knoten deinstallieren. Wenn Sie ihn auf dem Message Processor-Knoten belassen, müssen Sie ihn auf 4.16.05 aktualisieren.
Alternativ können Sie das Dienstprogramm apigee-validate auf dem Message Processor-Knoten aktualisieren und von dort aus ausführen. Apigee empfiehlt jedoch, es auf dem Management Server zu installieren und auszuführen.

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, finden Sie weitere Informationen unter 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 beliebigen Router aus und machen Sie ihn unerreichbar, wie unter Erreichbarkeit von Servern (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.
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.

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 unerreichbar.
  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:
- Machen Sie den Router vor dem Update unerreichbar.
- 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.01 verwendet haben.

Verfahren zum Aktualisieren auf 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.
Laden Sie die Edge 4.16.05-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
Installieren Sie das Edge 4.16.05-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.
Standardmäßig prüft das Installationsprogramm, ob Java 1.8 installiert ist. Andernfalls wird es für Sie installiert. Verwenden Sie die Option JAVA_FIX, um anzugeben, wie die Java-Installation gehandhabt werden soll. JAVA_FIX nimmt die folgenden Werte an:
I = OpenJDK 1.8 installieren (Standard)
C = Ohne Installation von Java fortfahren
Q = Beenden. Bei dieser Option müssen Sie Java selbst installieren.
Verwenden Sie apigee-service, um das Dienstprogramm apigee-setup zu aktualisieren:
1. Wenn Sie 4.16.01 durch ein Upgrade der Edge-Version 4.15.07.0x installiert haben, müssen Sie das Dienstprogramm apigee-setup installieren:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  Mit diesem Befehl wird das Dienstprogramm update.sh in <inst_dir>/apigee/apigee-setup/bin installiert.
  
  Wenn Sie das Dienstprogramm apigee-setup bereits installiert haben, aktualisieren Sie es:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
2. Wenn Sie 4.16.01 direkt installiert haben, d. h. kein Upgrade von 4.15.07.0x durchgeführt haben, müssen Sie das Dienstprogramm apigee-setup aktualisieren:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  Durch dieses Update auf apigee-service wird das Dienstprogramm update.sh in <inst_dir>/apigee/apigee-setup/bin installiert.
Installieren Sie das Dienstprogramm apigee-validate auf dem Management Server:
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate install
Hinweis: Wenn Sie das Dienstprogramm apigee-validate auf einem Message Processor-Knoten installiert haben, können Sie es mit dem folgenden Befehl auf diesem Knoten aktualisieren:
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
Für 4.16.05 empfiehlt Apigee jedoch, das Dienstprogramm apigee-validate auf dem Management Server zu installieren und auszuführen.
Bearbeiten Sie die Konfigurationsdatei, die an das Dienstprogramm apigee-validate übergeben wird. In der vorherigen Edge-Version erforderte die von apigee-validate verwendete Konfigurationsdatei die folgenden Attribute:
APIGEE_ADMINPW=sysAdminPword
MP_POD=gateway
REGION=dc-1
In dieser Version erfordert die Konfigurationsdatei nur das Attribut APIGEE_ADMINPW. Die anderen beiden Properties können Sie aus der Datei entfernen.
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“ auf dem Management Server ausführen, wie unter Installation testen beschrieben.

Wenn Sie das Update später rückgängig machen möchten, verwenden Sie das unter 4.16.05 – Rollback-Prozess beschriebene Verfahren.

Verfahren zum Aktualisieren auf 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:

Erstellen Sie ein lokales 4.16.05-Repository, wie unter Edge-Dienstprogramm „apigee-setup“ installieren im Abschnitt „Lokales Apigee-Repository erstellen“ beschrieben.
Hinweis: Wenn Sie bereits ein 4.16.01-Repository haben, können Sie das 4.16.05-Repository hinzufügen.
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. 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 in diesem Befehl den Pfad zum Verzeichnis „repos“ angeben.
So installieren Sie apigee-service mit dem Nginx-Webserver:
1. Konfigurieren Sie den Nginx-Webserver wie unter Edge-Dienstprogramm „apigee-setup“ 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. 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=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:
1. Wenn Sie 4.16.01 durch ein Upgrade der Edge-Version 4.15.07.0x installiert haben, müssen Sie das Dienstprogramm apigee-setup installieren:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  Mit diesem Befehl wird das Dienstprogramm update.sh in <inst_dir>/apigee/apigee-setup/bin installiert.
  
  Wenn Sie das Dienstprogramm apigee-setup bereits installiert haben, aktualisieren Sie es:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
2. Wenn Sie 4.16.01 direkt installiert haben, d. h. kein Upgrade von 4.15.07.0x durchgeführt haben, müssen Sie das Dienstprogramm apigee-setup 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.
Installieren Sie das Dienstprogramm apigee-validate auf dem Management Server-Knoten:
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate install
Hinweis: Wenn Sie das Dienstprogramm apigee-validate auf einem Message Processor-Knoten installiert haben, können Sie es mit dem folgenden Befehl auf diesem Knoten aktualisieren:

> /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
Für 4.16.05 empfiehlt Apigee jedoch, das Dienstprogramm „apigee-validate“ auf dem Management Server zu installieren und auszuführen.
Bearbeiten Sie die Konfigurationsdatei, die an das Dienstprogramm apigee-validate übergeben wird. In der vorherigen Edge-Version erforderte die von apigee-validate verwendete Konfigurationsdatei die folgenden Attribute:
APIGEE_ADMINPW=sysAdminPword
MP_POD=gateway
REGION=dc-1
In dieser Version erfordert die Konfigurationsdatei nur das Attribut APIGEE_ADMINPW. Die anderen beiden Properties können Sie aus der Datei entfernen.
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“ auf dem Management Server ausführen, wie unter Installation testen beschrieben.

Wenn Sie das Update später rückgängig machen möchten, verwenden Sie das unter 4.16.05 – Rollback-Prozess beschriebene Verfahren.

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.