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.05 aktualisieren

Edge for Private Cloud v. 4.17.05

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

Mit diesem Verfahren können Sie die Apigee Edge-Version 4.16.09.0x auf 4.17.05 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.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.

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 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 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. Sie müssen jetzt SMTPMAILFROM in der Konfigurationsdatei festlegen, wenn Sie den SMTP-Server aktivieren. 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 Installationstopologien.

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 der Konfigurationsdatei die folgende Zeile hinzu, wenn Sie Edge auf 4.17.05 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 der Fehler ein Rollback des Updates auf die vorherige Version erfordert, finden Sie weitere Informationen unter 4.17.01 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 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.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-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.
Deaktivieren Sie SELinux, wie unter Edge-Dienstprogramm „apigee-setup“ installieren beschrieben.
Laden Sie die Edge 4.17.05-Datei bootstrap_4.17.05.sh in /tmp/bootstrap_4.17.05.sh herunter:
> curl https://software.apigee.com/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.05.sh
Installieren Sie das Edge 4.17.05-Dienstprogramm apigee-service und die Abhängigkeiten:
> sudo bash /tmp/bootstrap_4.17.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.
(Nur CentOS-6.x und RedHat-6.x) Führen Sie auf allen Qpid-Knoten den folgenden Befehl aus, um die richtige Qpid-Version herunterzuladen:
> yum install apigee-qpidd --disablerepo=epel
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.05 – Rollback-Prozess beschriebene Verfahren.

Verfahren zum Aktualisieren auf 4.17.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.17.05-Repository:

Erstellen Sie ein lokales 4.17.05-Repository, wie unter „Lokales Apigee-Repository erstellen“ im Abschnitt Edge-Dienstprogramm apigee-setup installieren beschrieben.
Hinweis: Wenn Sie bereits ein 4.16.09-Repository haben, können Sie das 4.17.05-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.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.17.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.17.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-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.05.sh in /tmp/bootstrap_4.17.05.sh herunter:
  > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.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.17.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 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.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.
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.
(Nur CentOS-6.x und RedHat-6.x) Achten Sie darauf, dass Sie auf allen Qpid-Knoten mit einer externen Internetverbindung den folgenden Befehl ausgeführt haben, um die richtige Qpid-Version wie oben gezeigt herunterzuladen:
> yum install apigee-qpidd --disablerepo=epel

Für eine eigenständige Installation mit einem Host

Legen Sie SMTPMAILFROM in Ihrer Konfigurationsdatei fest, wenn Sie SMTP in Edge aktiviert haben. Dieser Parameter hat das folgende Format:
SMTPMAILFROM="My Company <myco@company.com>"
Aktualisieren Sie Cassandra und ZooKeeper:
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
Legen Sie die folgende iptables-Regel fest:
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
Prüfen Sie die Qpid-Nachrichtenwarteschlange:
> qpid-stat -q

Prüfen Sie die Warteschlange so lange, bis die Anzahl in der Spalte „msg“ 0 ist. Sie können Qpid erst aktualisieren, wenn alle Nachrichten verarbeitet wurden.
Aktualisieren Sie qpidd:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
Leeren Sie die iptables:
> sudo iptables -F
Aktualisieren Sie postgresql:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
Starten Sie postgresql:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
LDAP aktualisieren:
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
Aktualisieren Sie die verbleibenden Edge-Komponenten:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Aktualisieren Sie die Edge-Benutzeroberfläche:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

Für eine eigenständige Installation mit 2 Hosts

Eine Liste der Edge-Topologien und Knotennummern finden Sie unter Installationstopologien.

Legen Sie SMTPMAILFROM in Ihrer Konfigurationsdatei fest, wenn Sie SMTP in Edge aktiviert haben. Dieser Parameter hat das folgende Format:
SMTPMAILFROM="My Company <myco@company.com>"
Aktualisieren Sie Cassandra und ZooKeeper auf Maschine 1:
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
Legen Sie auf Maschine 2 die folgende iptables-Regel fest:
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
Prüfen Sie die Qpid-Nachrichtenwarteschlange auf Maschine 2:
> qpid-stat -q

Prüfen Sie die Warteschlange so lange, bis der Wert in der Spalte „msg“ 0 ist. Sie können Qpid erst aktualisieren, wenn alle Nachrichten verarbeitet wurden.
Aktualisieren Sie qpidd auf Maschine 2:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
Leeren Sie die iptables auf Maschine 2:
> sudo iptables -F
Aktualisieren Sie PostgreSQL auf Maschine 2:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
Starten Sie postgresql auf Maschine 2:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
Aktualisieren Sie LDAP auf Maschine 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
Aktualisieren Sie die Edge-Komponenten auf Maschine 2 und 1:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Aktualisieren Sie die Benutzeroberfläche auf Maschine 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

Für eine Clusterinstallation mit 5 Hosts

Eine Liste der Edge-Topologien und Knotennummern finden Sie unter Installationstopologien.

Legen Sie SMTPMAILFROM in Ihrer Konfigurationsdatei fest, wenn Sie SMTP in Edge aktiviert haben. Dieser Parameter hat das folgende Format:
SMTPMAILFROM="My Company <myco@company.com>"
Aktualisieren Sie Cassandra und ZooKeeper auf den Computern 1, 2 und 3:
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
Legen Sie die folgende iptables-Regel auf Maschine 4 fest:
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
Prüfen Sie die Qpid-Nachrichtenwarteschlange auf Maschine 4:
> qpid-stat -q

Prüfen Sie die Warteschlange so lange, bis der Wert in der Spalte „msg“ 0 ist. Sie können Qpid erst aktualisieren, wenn alle Nachrichten verarbeitet wurden.
Aktualisieren Sie qpidd auf Maschine 4:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
Leeren Sie die iptables auf Maschine 4:
> sudo iptables -F
Wiederholen Sie die Schritte 3 bis 6 auf Maschine 5.
Aktualisieren Sie PostgreSQL auf Maschine 4:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
Starten Sie PostgreSQL auf Maschine 4:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
Wiederholen Sie die Schritte 8 und 9 auf Maschine 5.
Aktualisieren Sie LDAP auf Maschine 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
Aktualisieren Sie die Edge-Komponenten auf den Maschinen 4, 5, 1, 2, 3:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Aktualisieren Sie die Benutzeroberfläche auf Maschine 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

Für eine Clusterinstallation mit 9 Hosts

Eine Liste der Edge-Topologien und Knotennummern finden Sie unter Installationstopologien.

Legen Sie SMTPMAILFROM in Ihrer Konfigurationsdatei fest, wenn Sie SMTP in Edge aktiviert haben. Dieser Parameter hat das folgende Format:
SMTPMAILFROM="My Company <myco@company.com>"
Aktualisieren Sie Cassandra und ZooKeeper auf Maschine 1, 2 und 3:
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
Legen Sie die folgende iptables-Regel auf Maschine 6 fest:
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
Prüfen Sie die Qpid-Nachrichtenwarteschlange auf Maschine 6:
> qpid-stat -q

Prüfen Sie die Warteschlange so lange, bis die Anzahl in der Spalte „msg“ 0 ist. Sie können Qpid erst aktualisieren, wenn alle Nachrichten verarbeitet wurden.
Aktualisieren Sie qpidd auf Maschine 6:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
Leeren Sie die iptables auf Maschine 6:
> sudo iptables -F
Wiederholen Sie die Schritte 3 bis 6 auf Maschine 7.
Aktualisieren Sie PostgreSQL auf Maschine 6:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
Starten Sie PostgreSQL auf Maschine 6:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
Wiederholen Sie die Schritte 8 und 9 auf Maschine 7.
Aktualisieren Sie LDAP auf Maschine 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
Aktualisieren Sie die Edge-Komponenten auf den Computern 6, 7, 8, 9, 1, 4 und 5 in dieser Reihenfolge:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Aktualisieren Sie die Benutzeroberfläche auf Maschine 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

Für eine Clusterinstallation mit 13 Hosts

Eine Liste der Edge-Topologien und Knotennummern finden Sie unter Installationstopologien.

Legen Sie SMTPMAILFROM in Ihrer Konfigurationsdatei fest, wenn Sie SMTP in Edge aktiviert haben. Dieser Parameter hat das folgende Format:
SMTPMAILFROM="My Company <myco@company.com>"
Aktualisieren Sie Cassandra und ZooKeeper auf Maschine 1, 2 und 3:
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
Legen Sie die folgende iptables-Regel auf Maschine 12 fest:
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
Prüfen Sie die Qpid-Nachrichtenwarteschlange auf Maschine 12:
> qpid-stat -q

Prüfen Sie die Warteschlange so lange, bis der Wert in der Spalte „msg“ 0 ist. Sie können Qpid erst aktualisieren, wenn alle Nachrichten verarbeitet wurden.
Aktualisieren Sie qpidd auf Maschine 12:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
Leeren Sie die iptables auf Maschine 12:
> sudo iptables -F
Wiederholen Sie die Schritte 3 bis 6 auf Maschine 13.
Aktualisieren Sie PostgreSQL auf Maschine 12:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
Starten Sie PostgreSQL auf Maschine 12:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
Wiederholen Sie die Schritte 8 und 9 auf Maschine 13.
Aktualisieren Sie LDAP auf Maschine 4 und 5:
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
Aktualisieren Sie die Edge-Komponenten auf den Computern 12, 13, 8, 9, 6, 7, 10 und 11 in dieser Reihenfolge:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Aktualisieren Sie die Benutzeroberfläche auf Maschine 6 und 7:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

Für eine Clusterinstallation mit 12 Hosts

Eine Liste der Edge-Topologien und Knotennummern finden Sie unter Installationstopologien.

Legen Sie SMTPMAILFROM in Ihrer Konfigurationsdatei fest, wenn Sie SMTP in Edge aktiviert haben. Dieser Parameter hat das folgende Format:
SMTPMAILFROM="My Company <myco@company.com>"
Aktualisieren Sie Cassandra und ZooKeeper:
1. Auf den Maschinen 1, 2 und 3 in Rechenzentrum 1:
  > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
2. Auf den Maschinen 7, 8 und 9 in Rechenzentrum 2
  > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
Aktualisieren Sie qpidd:
1. Maschinen 4 und 5 in Rechenzentrum 1
  1. Legen Sie die folgende iptables-Regel auf Maschine 4 fest:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
  2. Prüfen Sie die Qpid-Nachrichtenwarteschlange auf Maschine 4:
    > qpid-stat -q
    
    Prüfen Sie die Warteschlange so lange, bis die Anzahl in der Spalte „msg“ 0 ist. Sie können Qpid erst aktualisieren, wenn alle Nachrichten verarbeitet wurden.
  3. Aktualisieren Sie qpidd auf Maschine 4:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  4. Leeren Sie die iptables auf Maschine 4:
    > sudo iptables -F
  5. Wiederholen Sie die Schritte 1 bis 4 auf Maschine 5.
2. Maschinen 10, 11 in Rechenzentrum 2
  1. Legen Sie die folgende iptables-Regel auf Maschine 10 fest:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
  2. Prüfen Sie die Qpid-Nachrichtenwarteschlange auf Maschine 10:
    > qpid-stat -q
    
    Prüfen Sie die Warteschlange so lange, bis die Anzahl in der Spalte „msg“ 0 ist. Sie können Qpid erst aktualisieren, wenn alle Nachrichten verarbeitet wurden.
  3. Aktualisieren Sie qpidd auf Maschine 10:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  4. Leeren Sie die iptables auf Maschine 10:
    > sudo iptables -F
  5. Wiederholen Sie die Schritte 1 bis 4 auf Maschine 11.
Aktualisieren Sie postgresql:
1. Maschine 6 in Rechenzentrum 1
  > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
2. Maschinen 12 in Rechenzentrum 2
  > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
LDAP aktualisieren:
1. Maschinen 1 in Rechenzentrum 1
  > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
2. Maschinen 7 in Rechenzentrum 2
  > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
Aktualisieren Sie die Edge-Komponenten:
1. Maschinen 4, 5, 6, 1, 2, 3 in Rechenzentrum 1
  > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
2. Maschinen 10, 11, 12, 7, 8, 9 in Rechenzentrum 2
  > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Aktualisieren Sie die Benutzeroberfläche:
1. Maschine 1 in Rechenzentrum 1:
  > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
2. Maschine 7 in Rechenzentrum 2:
  > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

Für eine API BaaS-Installation mit 7 Hosts

Sie müssen der Konfigurationsdatei zwei neue Attribute hinzufügen, bevor Sie das Upgrade ausführen:

# For a single data center, specify the same value as BAAS_CASS_LOCALDC.
BAAS_CASS_DC_LIST="dc-1"

# Defines the initial contact points for members of the BaaS cluster. 
# Specify the IP address of no more than two Stack nodes. 
BAAS_CLUSTER_SEEDS="dc-1:$IP4,dc-1:$IP5"

Ein vollständiges Beispiel für eine Konfigurationsdatei finden Sie unter API BaaS-Installation.

Außerdem müssen Sie dafür sorgen, dass Port 2551 auf allen Stack-Knoten für den Zugriff von allen anderen Stack-Knoten geöffnet ist.

Eine Liste der Edge-Topologien und Knotennummern finden Sie unter Installationstopologien.

Aktualisieren Sie Cassandra auf den Computern 5, 6 und 7:
> /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
Aktualisieren Sie Elasticsearch und den API BaaS-Stack auf Maschine 1, 2 und 3:
> /opt/apigee/apigee-setup/bin/update.sh -c e,b -f configFile
Aktualisieren Sie das API BaaS-Portal auf Maschine 4:
> /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

Für eine API BaaS-Installation mit 10 Hosts

Sie müssen der Konfigurationsdatei zwei neue Attribute hinzufügen, bevor Sie das Upgrade ausführen:

# For a single data center, specify the same value as BAAS_CASS_LOCALDC.
BAAS_CASS_DC_LIST="dc-1"

# Defines the initial contact points for members of the BaaS cluster. 
# Specify the IP address of no more than two Stack nodes. 
BAAS_CLUSTER_SEEDS="dc-1:$IP4,dc-1:$IP5"

Ein vollständiges Beispiel für eine Konfigurationsdatei finden Sie unter API BaaS-Installation.

Außerdem müssen Sie dafür sorgen, dass Port 2551 auf allen Stack-Knoten für den Zugriff von allen anderen Stack-Knoten geöffnet ist.

Eine Liste der Edge-Topologien und Knotennummern finden Sie unter Installationstopologien.

Aktualisieren Sie Cassandra auf den Computern 8, 9 und 10:
> /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
Aktualisieren Sie Elasticsearch auf Maschine 1, 2 und 3:
> /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
Aktualisieren Sie den API BaaS-Stack auf den Maschinen 4, 5 und 6:
> /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
Aktualisieren Sie das API BaaS-Portal auf Maschine 7:
> /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

Für eine nicht standardmäßige Installation

Wenn Sie eine nicht standardmäßige Installation haben, aktualisieren Sie die Edge-Komponenten in der folgenden Reihenfolge:

ZooKeeper
Cassandra
qpidd, ps
LDAP
Edge, d. h. das Profil „-c edge“ auf allen Knoten in der Reihenfolge: Knoten mit Qpid-Server, Postgres-Server, Management Server, Message Processor und Router.
Hinweis: Wenn auf dem Knoten sowohl der Qpid-Server als auch der Postgres-Server installiert ist, führen Sie den Profilschritt „-c edge“ aus.
Edge-UI