Diese Seite wurde von der Cloud Translation API übersetzt.

Apigee Edge 4.16.09 auf 4.17.09 aktualisieren

Edge for Private Cloud Version 4.17.09

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

Mit diesem Verfahren können Sie Apigee Edge-Version 4.16.09.0x auf 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 kann das Update ausführen?

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.

Nach der Installation der Edge-RPMs 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 auf Qpid 1.35. Führen Sie zum Aktualisieren eines Qpid-Knotens folgende Schritte aus:

Sie können vorübergehend verhindern, dass Router und Message Processors 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 leer ist, damit der Qpid-Knoten alle Nachrichten vor dem Update verarbeitet hat. Mit dem folgenden Befehl können Sie prüfen, ob 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. Mit dem folgenden Befehl können Sie die Blockierung dieses Ports aufheben:
> sudo iptables -F

Wenn Sie iptables für andere Regeln verwenden, können Sie die jeweilige Änderung mit der Option „-D“ rückgängig 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 (EPEL) aktivieren, um Edge zu installieren oder zu aktualisieren. Der verwendete Befehl hängt von Ihrer Version von RedHat/CentOS 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 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 aktualisieren, müssen Sie SMTPMAILFROM in der Konfigurationsdatei festlegen.

Dieser Parameter hat das folgende Format:

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

Erforderlich, wenn bei Verwendung der externen Authentifizierung aktualisiert wird

Sie können einen externen Verzeichnisdienst in eine vorhandene Apigee Edge Private Cloud-Installation einbinden. Diese Funktion ist für jeden Verzeichnisdienst konzipiert, der LDAP unterstützt, 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 sie verwenden.

Weitere Informationen finden Sie unter Externe Authentifizierungskonfiguration.

Wenn die externe Authentifizierung aktiviert ist, verwenden die meisten Kunden das SAM-Kontonamen-Feld von Active Directory 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 beim Aktualisieren von Edge auf Version 4.17.09 die folgende Zeile hinzu:

IS_EXTERNAL_AUTH="true"

Mit dieser Zeile wird Edge so konfiguriert, dass als Nutzername ein Kontoname und keine E-Mail-Adresse verwendet wird.

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.

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 zum Sichern 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 zu Logging-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 Ausfallzeit oder einem Rolling Update können Sie Ihre Edge-Installation aktualisieren, ohne dass Edge heruntergefahren werden muss.

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

Der Schlüssel zu Upgrades ohne Ausfallzeiten 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 des Maschinenupdates“ 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 verbleibenden 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 dem Update 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 stille Konfiguration sollte die Datei sein, die Sie bei der Installation von Edge 4.16.09 verwendet haben.

Aktualisierung auf 4.17.09 auf einem Knoten mit externer Internetverbindung

So aktualisieren Sie die Edge-Komponenten auf einem Knoten:

Deaktivieren Sie gegebenenfalls alle CRON-Jobs, die für die Ausführung eines Reparaturvorgangs in Cassandra konfiguriert sind, bis die Aktualisierung 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.
Aktivieren Sie das EPEL-Repository wie oben 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 Edge 4.17.09-Dienstprogramm apigee-service und die zugehörigen Abhängigkeiten:
> sudo bash /tmp/bootstrap_4.17.09.sh apigeeuser=uName apigeepassword=pWord

wobei uName:pWord der Nutzername und das Passwort sind, 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. Verwenden Sie die Option JAVA_FIX, um anzugeben, 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.

ldap
Testen Sie das Update, indem Sie das Dienstprogramm „apigee-valid“ 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 aus dem lokalen Repository zu aktualisieren:

Erstellen Sie eine TAR-Datei des Repositorys, kopieren Sie die TAR-Datei auf einen Knoten und aktualisieren Sie Edge dann über die 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. 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 "Lokales Apigee-Repository erstellen" unter Edge-Apigee-Setup-Dienstprogramm installieren beschrieben.
Hinweis: Wenn Sie bereits ein 4.16.09-Repository haben, können Sie ihm das 4.17.09-Repository hinzufügen. Eine entsprechende Anleitung finden Sie unter Edge-Apigee-Einrichtungs-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 ihn 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-Dienst-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 Verzeichnis „repos“ angeben.
So installieren Sie apigee-service mit dem Nginx-Webserver:
1. Konfigurieren Sie den Nginx-Webserver wie unter „Installation aus dem Repository mithilfe des Nginx-Webservers“ unter Installieren des Edge-Apigee-Setup-Dienstprogramms 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-valid 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 der Maschinenaktualisierung

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.