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

Apigee Edge 4.16.09 auf 4.17.09 aktualisieren

Edge for Private Cloud v. 4.17.09

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

Mit diesem Verfahren können Sie die Apigee Edge-Version 4.16.09.0x auf 4.17.09 aktualisieren.

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

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.

Erforderliches Upgrade auf Qpid 1.35

Diese Version enthält ein erforderliches Update für Qpid 1.35. Im Rahmen der Aktualisierung eines Qpid-Knotens müssen Sie Folgendes tun:

Verhindern Sie vorübergehend, dass Router und Message Processor auf den Qpid-Knoten schreiben, indem Sie Port 5672 auf dem Qpid-Knoten blockieren. Mit dem folgenden Befehl können Sie diesen Port auf dem Qpid-Knoten blockieren:
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
Warten Sie, bis die Qpid-Warteschlange keine Nachrichten mehr enthält, um sicherzustellen, dass der Qpid-Knoten alle Nachrichten vor dem Update verarbeitet hat. Verwenden Sie den folgenden Befehl, um sicherzustellen, dass die Qpid-Nachrichtenwarteschlange leer ist:
> qpid-stat -q
Aktualisieren Sie den Qpid-Knoten.
Heben Sie die Blockierung von Port 5672 auf dem Qpid-Knoten auf, um den Zugriff von Routern und Message Processors zu ermöglichen. Sie können den folgenden Befehl verwenden, um diesen Port freizugeben:
> sudo iptables -F

Wenn Sie iptables für andere Regeln verwenden, können Sie die Option -D verwenden, um die spezifische Änderung rückgängig zu machen:
> sudo iptables -D INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP

Dieser Vorgang wird unten für jede Edge-Topologie ausführlich beschrieben.

Erforderlich, um das EPEL-Repository zu aktivieren

Sie müssen Extra Packages for Enterprise Linux (oder EPEL) aktivieren, um Edge zu installieren oder zu aktualisieren. Der verwendete Befehl hängt von Ihrer RedHat/CentOS-Version ab:

Für RedHat/CentOS/Oracle 7.x:
> wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm; rpm -ivh epel-release-latest-7.noarch.rpm
Für RedHat/CentOS/Oracle 6.x:
wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm; rpm -ivh epel-release-latest-6.noarch.rpm

Erforderliche Hinzufügung des Konfigurationsparameters SMTPMAILFROM

In Edge 4.17.05 wurde der Konfigurationsdatei, die beim Aktivieren eines SMTP-Servers verwendet wird, ein neuer erforderlicher Parameter hinzugefügt. Wenn Sie ein Update von 4.17.01 ausführen, müssen Sie beim Aktivieren des SMTP-Servers SMTPMAILFROM in der Konfigurationsdatei festlegen.

In API BaaS Version 4.17.09 wurde auch die Unterstützung für das Attribut SMTPMAILFROM hinzugefügt. Wenn Sie API BaaS aktualisieren, müssen Sie SMTPMAILFROM in der Konfigurationsdatei festlegen.

Dieser Parameter hat das folgende Format:

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

Erforderlich, wenn die externe Authentifizierung verwendet wird und aktualisiert werden soll

Sie können einen externen Verzeichnisdienst in eine vorhandene Apigee Edge Private Cloud-Installation einbinden. Diese Funktion ist für alle Verzeichnisdienste konzipiert, die LDAP unterstützen, z. B. Active Directory und OpenLDAP. Mit einer externen LDAP-Lösung können Systemadministratoren Nutzeranmeldedaten über einen zentralen Verzeichnisverwaltungsdienst verwalten, der sich außerhalb von Systemen wie Apigee Edge befindet, die diese verwenden.

Weitere Informationen finden Sie unter Konfiguration der externen Authentifizierung.

Wenn die externe Authentifizierung aktiviert ist, verwenden die meisten Kunden das Active Directory-SAM-Kontonamenfeld als Nutzernamen für die Authentifizierung anstelle einer E-Mail-Adresse, die vom Edge OpenLDAP-Server verwendet wird.

Wenn Sie einen externen Verzeichnisdienst eingebunden haben, fügen Sie Ihrer Konfigurationsdatei die folgende Zeile hinzu, wenn Sie Edge auf 4.17.09 aktualisieren:

IS_EXTERNAL_AUTH="true"

Mit dieser Zeile wird Edge so konfiguriert, dass ein Kontoname anstelle einer E-Mail-Adresse als Nutzername unterstützt wird.

Automatische Weitergabe von Property-Einstellungen

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:

> /opt/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 Rollback-Prozess für 4.17.09.

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 Konfigurationsdatei für die unbeaufsichtigte Installation sollte dieselbe sein, die Sie für die Installation von Edge 4.16.09 verwendet haben.

Verfahren zum Aktualisieren auf 4.17.09 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-Nutzer 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 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 Edge-Dienstprogramm „apigee-setup“ installieren beschrieben.
Aktivieren Sie das EPEL-Repository wie oben beschrieben.
Wenn Sie die Installation auf AWS durchführen, führen Sie den folgenden yum-configure-manager-Befehl aus:
> sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
Laden Sie die Edge 4.17.09-Datei bootstrap_4.17.09.sh 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 Edge 4.17.09-Dienstprogramm apigee-service 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 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:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
Aktualisieren Sie das Dienstprogramm apigee-validate auf dem Management Server:
> /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 Maschinenaktualisierung beschriebenen Reihenfolge aus:
> /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

Die einzige Anforderung an die Konfigurationsdatei ist, dass die Konfigurationsdatei für den Nutzer „apigee“ zugänglich oder lesbar sein muss.

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.17.09 Rollback-Prozess beschriebene Verfahren.

Verfahren zum Aktualisieren auf 4.17.09 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.17.09-Repository:

Erstellen Sie ein lokales 4.17.09-Repository, wie unter Edge-Dienstprogramm „apigee-setup“ installieren im Abschnitt „Lokales Apigee-Repository erstellen“ beschrieben.
Hinweis: Wenn Sie bereits ein 4.16.09-Repository haben, können Sie das 4.17.09-Repository hinzufügen, wie unter „Lokales Apigee-Repository aktualisieren“ im Abschnitt Edge-Dienstprogramm „apigee-setup“ installieren beschrieben.
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.17.09.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.17.09.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.17.09.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-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.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
  
  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.17.09.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 apigee-setup-Dienstprogramm zu aktualisieren:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
Aktualisieren Sie das Dienstprogramm apigee-validate auf dem Management Server.
> /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 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.

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.17.09 – 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.
Verwenden Sie für alle Maschinen mit mehreren Edge-Komponenten (Management Server, Message Processor, Router, QPID-Server, aber nicht 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.