Diese Seite wurde von der Cloud Translation API übersetzt.

Apigee Edge 4.17.01/4.17.05 auf 4.17.09 aktualisieren

Edge for Private Cloud Version 4.17.09

Auf welche Edge-Versionen können Sie auf 4.17.09 aktualisieren?

Mit diesem Verfahren können Sie Apigee Edge-Version 4.17.01.0x/4.17.05.0x auf Version 4.17.09 aktualisieren.

Wenn Sie eine Version von Edge vor Version 4.16.01 verwenden, müssen Sie zuerst auf Version 4.16.01.x migrieren und dann auf Version 4.17.09 aktualisieren.

Wer das Update durchführen kann

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

Nachdem Sie die Edge-RPMs installiert haben, können sie von jedem Nutzer konfiguriert werden.

Welche Komponenten müssen Sie aktualisieren?

Sie müssen alle Edge-Komponenten aktualisieren. Edge unterstützt keine Einrichtung, die Komponenten aus mehreren Versionen enthält.

Automatische Übernahme von Hoteleigenschaften

Wenn Sie Eigenschaften festgelegt haben, indem Sie .properties-Dateien in /opt/apigee/customer/application bearbeitet haben, bleiben diese Werte beim Update erhalten.

Erforderliche Ergänzung des Konfigurationsparameters SMTPMAILFROM

Edge 4.17.05 hat der Konfigurationsdatei einen neuen erforderlichen Parameter hinzugefügt, wenn Sie einen SMTP-Server aktivieren. Wenn Sie von 4.17.01 aktualisieren, müssen Sie SMTPMAILFROM in der Konfigurationsdatei festlegen, wenn Sie den SMTP-Server aktivieren.

In der API BaaS-Version 4.17.09 wurde außerdem die Unterstützung für das Attribut SMTPMAILFROM hinzugefügt. Wenn Sie API BaaS von 4.17.01 oder 4.17.05 aktualisieren, müssen Sie SMTPMAILFROM in der Konfigurationsdatei festlegen.

Dieser Parameter hat das folgende Format:

SMTPMAILFROM="My Company <myco@company.com>"

Voraussetzungen für die Aktualisierung

Beachten Sie die folgenden Voraussetzungen, bevor Sie Apigee Edge aktualisieren:

Alle Knoten sichern
Aus Sicherheitsgründen empfehlen wir, vor dem Aktualisieren ein vollständiges Back-up aller Knoten durchzuführen. Führen Sie die Sicherung mit der Anleitung für Ihre aktuelle Version von Edge durch.

So haben Sie einen Notfallplan, 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 Befehl, ob Edge während des Aktualisierungsvorgangs ausgeführt wird:

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

Fehlgeschlagene Updates verarbeiten

Wenn ein Update fehlschlägt, können Sie versuchen, das Problem zu beheben, und update.sh dann 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 das Update auf die vorherige Version zurücksetzen müssen, finden Sie weitere Informationen unter 4.17.09 Rollback-Vorgang.

Informationen zum Logging von Updates

Standardmäßig schreibt das Dienstprogramm update.sh Loginformationen an folgende Stelle:

/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 Protokoll 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.

Aktualisierung ohne Ausfallzeiten

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

Aktualisierungen ohne Ausfallzeit sind nur mit einer Konfiguration mit mindestens fünf Knoten möglich.

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

Aktualisieren Sie die Computer in der richtigen Reihenfolge für Ihre Installation, wie unten unter „Reihenfolge der Aktualisierung von Computern“ 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 Verfügbarkeit des Servers (Nachrichtenprozessors/Routers) 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.
Sorgen Sie dafür, dass der Router wieder erreichbar ist.
Wiederholen Sie die Schritte 2 bis 4 für die übrigen Router.
Fahren Sie mit dem Update für alle verbleibenden Computer in Ihrer Installation fort.

Beachten Sie vor und nach dem Update Folgendes:

Auf einem kombinierten Router- und Message Processor-Knoten:
- Vor dem Update:
  1. Den Router unerreichbar machen.
  2. Machen Sie den Message Processor nicht erreichbar.
- Nach dem Update:
  1. Sorgen Sie dafür, dass der Message Processor erreichbar ist.
  2. Sorgen Sie dafür, dass der Router erreichbar ist.
Auf einem einzelnen Routerknoten:
- Sorgen Sie vor dem Update dafür, dass der Router nicht erreichbar ist.
- Sorgen Sie nach dem Update dafür, dass der Router erreichbar ist.
Auf einem einzelnen Message Processor-Knoten:
- Stellen Sie vor dem Update sicher, dass der Nachrichten-Prozessor nicht erreichbar ist.
- Sorgen Sie nach der Aktualisierung dafür, dass der Message Processor erreichbar ist.

Konfigurationsdatei im Hintergrund verwenden

Sie müssen dem Befehl „update“ eine Konfigurationsdatei für die Installation ohne Benutzerinteraktion übergeben. Die Datei für die Installation ohne Benutzerinteraktion muss dieselbe sein, die Sie für die Installation von Edge 4.17.01 verwendet haben.

Verfahren für die Aktualisierung auf 4.17.09 auf einem Knoten mit einer externen Internetverbindung

So aktualisieren Sie die Edge-Komponenten auf einem Knoten:

Deaktivieren Sie gegebenenfalls alle CRON-Jobs, die für die Ausführung eines Reparaturvorgangs auf 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 kann jedoch auch ohne Root-Zugriff durchgeführt werden.
Installieren Sie yum-utils und yum-plugin-priorities:
> sudo yum install yum-utils
> sudo yum install yum-plugin-priorities
Deaktivieren Sie SELinux wie unter Installieren Sie das Hilfsprogramm für das Edge-Apigee-Setup beschrieben.
Wenn Sie die Installation in AWS ausführen, führen Sie den folgenden Befehl yum-configure-manager aus:
> sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
Laden Sie die Datei bootstrap_4.17.09.sh für Edge 4.17.09 in /tmp/bootstrap_4.17.09.sh herunter:
> curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
Installieren Sie das Dienstprogramm apigee-service von Edge 4.17.09 und die Abhängigkeiten:
> sudo bash /tmp/bootstrap_4.17.09.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 wird beim Installationsvorgang geprüft, ob Java 1.8 installiert ist. Andernfalls wird es automatisch installiert. Mit der Option JAVA_FIX können Sie angeben, wie die Java-Installation behandelt werden soll. Für JAVA_FIX sind folgende Werte zulässig:

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:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
Aktualisieren Sie das Dienstprogramm apigee-validate auf dem Verwaltungsserver:
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
Aktualisieren Sie das Dienstprogramm apigee-provision:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
Führen Sie das Update-Dienstprogramm auf Ihren Knoten in der unten unter Reihenfolge der Aktualisierung von Maschinen beschriebenen Reihenfolge aus:
> /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

Die einzige Anforderung an die Konfigurationsdatei ist, dass der Nutzer „apigee“ darauf zugreifen oder sie lesen kann.

Mit der Option „-c“ können Sie die zu aktualisierende Komponente angeben. Die Liste der möglichen Komponenten umfasst:
ldap = OpenLDAP
cs = Cassandra
zk = Zookeeper
qpid = qpidd
ps = postgresql
edge =Alle Edge-Komponenten mit Ausnahme der Edge-Benutzeroberfläche: Verwaltungsserver, Nachrichtenprozessor, Router, QPID-Server, Postgres-Server
ui = Edge-Benutzeroberfläche
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 Verwaltungsserver ausführen, wie unter Installation testen beschrieben.

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

Aktualisierung auf 4.17.09 über ein lokales 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 Mirror des Apigee-Repositories 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 auf dem Knoten mit dem lokalen Repository einen Webserver, damit andere Knoten darauf zugreifen können. Apigee stellt Ihnen den Nginx-Webserver zur Verfügung. Sie können aber auch Ihren eigenen Webserver verwenden.

So aktualisieren Sie über ein lokales 4.17.09-Repository:

Erstellen Sie ein lokales 4.17.09-Repository, wie unter Installieren Sie das Hilfsprogramm für das Edge-Apigee-Setup unter „Create a local Apigee repository“ (Lokales Apigee-Repository erstellen) beschrieben.
Hinweis: Wenn Sie bereits ein 4.17.01-/4.17.05-Repository haben, können Sie das 4.17.09-Repository hinzufügen. Eine entsprechende Anleitung finden Sie unter Edge-Apigee-Setup-Dienstprogramm installieren im Abschnitt „Lokales Apigee-Repository aktualisieren“.
So installieren Sie apigee-service aus einer .tar-Datei:
1. Verpacken Sie das lokale Repository auf dem Knoten mit dem lokalen Repository mit dem folgenden Befehl in einer einzelnen TAR-Datei mit dem Namen /opt/apigee/data/apigee-mirror/apigee-4.17.09.tar.gz:
  > /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 im Verzeichnis „/tmp“:
  > tar -xzf apigee-4.17.09.tar.gz
  
  Mit diesem Befehl wird im Verzeichnis mit der .tar-Datei ein neues Verzeichnis mit dem Namen „repos“ erstellt. Beispiel: /tmp/repos.
4. Installieren Sie das Edge-Apigee-Service-Dienstprogramm und die Abhängigkeiten unter /tmp/repos:
  > sudo bash /tmp/repos/bootstrap_4.17.09.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
  
  Beachten Sie, dass Sie in diesem Befehl den Pfad zum Repository-Verzeichnis angeben.
So installieren Sie apigee-service mit dem Nginx-Webserver:
1. Konfigurieren Sie den Nginx-Webserver wie unter Installieren Sie das Hilfsprogramm für das Edge-Apigee-Setup unter „Über den Nginx-Webserver aus dem Repository installieren“ beschrieben.
2. Laden Sie auf dem Remote-Knoten die Edge-Datei bootstrap_4.17.09.sh in /tmp/bootstrap_4.17.09.sh herunter:
  > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
  
  wobei uName:pWord der Nutzername und das Passwort sind, die Sie oben für das Repository festgelegt haben, und remoteRepo die IP-Adresse oder der DNS-Name des Repository-Knotens.
3. Installieren Sie auf dem Remoteknoten das Edge-Apigee-Dienst-Dienstprogramm und die Abhängigkeiten:
  > sudo bash /tmp/bootstrap_4.17.09.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
  
  wobei uName:pWord der Nutzername und das Passwort für das Repository sind.
Verwenden Sie apigee-service, um das Dienstprogramm „apigee-setup“ zu aktualisieren:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
Aktualisieren Sie das Dienstprogramm apigee-validate auf dem Verwaltungsserver.
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
Aktualisieren Sie das Dienstprogramm apigee-provision:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
Führen Sie das Update-Dienstprogramm auf Ihren Knoten in der unten unter „Reihenfolge der Aktualisierung des Computers“ beschriebenen Reihenfolge aus:
> /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

Die einzige Anforderung an die Konfigurationsdatei ist, dass der Nutzer „apigee“ darauf zugreifen oder sie lesen kann.

Mit der Option „-c“ können Sie die zu aktualisierende Komponente angeben. Die Liste der möglichen Komponenten umfasst:
ldap = OpenLDAP
cs = Cassandra
zk = Zookeeper
qpid = qpidd
ps = postgresql
edge =Alle Edge-Komponenten mit Ausnahme der Edge-Benutzeroberfläche: Verwaltungsserver, Nachrichtenprozessor, Router, QPID-Server, Postgres-Server
ui = Edge-Benutzeroberfläche
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 Verwaltungsserver ausführen, wie unter Installation testen beschrieben.

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

Reihenfolge des Maschinenupdates

Die Reihenfolge, in der Sie die Maschinen in einer Edge-Installation aktualisieren, ist wichtig. Die wichtigsten Aspekte bei einem Update sind:

Sie müssen alle Cassandra- und ZooKeeper-Knoten aktualisieren, bevor Sie andere Knoten aktualisieren.
Verwenden Sie für jeden Computer mit mehreren Edge-Komponenten (Management-Server, Nachrichtenprozessor, Router, QPID-Server, aber nicht Postgres-Server) die Option „-c edge“, um sie alle gleichzeitig zu aktualisieren.
Wenn für einen Schritt angegeben ist, dass er auf mehreren Maschinen ausgeführt werden soll, führen Sie ihn in der angegebenen Maschinenreihenfolge aus.
Es gibt keinen separaten Schritt, um die Monetarisierung zu aktualisieren. Sie wird aktualisiert, wenn Sie die Option "-c Edge" angeben.