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 frühere Edge-Version als 4.16.01 verwenden, müssen Sie zuerst zu Version 4.16.01.x und dann ein Update auf Version 4.17.09 durchzuführen.

Wer das Update durchführen kann

Der Benutzer, der das Update ausführt, muss der Benutzer sein, der Edge ursprünglich installiert hat, oder eine ausgeführt wird.

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

Welche Komponenten müssen aktualisiert werden?

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

Erforderliches Upgrade auf Qpid 1.35

Diese Version enthält ein erforderliches Update auf Qpid 1.35. Im Rahmen der Aktualisierung eines Qpid-Knotens müssen:

Verhindern Sie vorübergehend, dass Router und Message Processor auf den Qpid-Knoten schreiben, indem Sie der Port 5672 auf dem Qpid-Knoten blockiert. Mit dem folgenden Befehl können Sie diesen Port auf dem Qpid-Knoten:
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
Warten Sie, bis keine Nachrichten in der Qpid-Warteschlange vorhanden sind, um sicherzustellen, dass der Qpid-Knoten alle verarbeitet hat. vor dem Update gesendet wurden. Verwenden Sie den folgenden Befehl, um sicherzustellen, dass die Qpid-Nachrichtenwarteschlange leer:
> 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 Processorn 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 mit der Option -D die spezifische Änderung:
> 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.

Zum Aktivieren des EPEL-Repositorys erforderlich

Sie müssen Zusätzliche Pakete für Enterprise Linux (oder EPEL) zur Installation oder Aktualisierung von Edge Der verwendete Befehl hängt davon ab, für Ihre Version von RedHat/CentOS:

Für RedHat/CentOS/Oracle 7.x:
> wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm; U/min –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; U/min –ivh epel-release-latest-6.noarch.rpm

Hinzufügung von SMTPMAILFROM erforderlich Konfigurationsparameter

Edge 4.17.05 hat einen neuen erforderlichen Parameter zur Konfigurationsdatei hinzugefügt, die verwendet wird, wenn Sie einen SMTP-Server. Wenn Sie ein Update von Version 4.17.01 durchführen, müssen Sie SMTPMAILFROM in der Konfigurationsdatei festlegen. wenn Sie den SMTP-Server aktivieren.

Die API-BaaS-Version 4.17.09 unterstützt außerdem die Property SMTPMAILFROM. Wenn Sie die API BaaS aktualisieren, müssen Sie SMTPMAILFROM im Feld Konfigurationsdatei.

Dieser Parameter hat die Form:

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

Erforderlich bei Aktualisierung bei Verwendung externe Authentifizierung

Sie können einen externen Verzeichnisdienst in eine vorhandene Apigee Edge Private Cloud einbinden Installation. Diese Funktion funktioniert mit jedem Verzeichnisdienst, der LDAP unterstützt, wie Active Directory und OpenLDAP. Eine externe LDAP-Lösung ermöglicht dem System, Administratoren können Nutzeranmeldedaten über einen zentralen Verzeichnisverwaltungsdienst verwalten. außerhalb von Systemen wie Apigee Edge, die sie verwenden.

Siehe Extern Authentication Configuration (Authentifizierungskonfiguration) weitere Informationen.

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

Wenn Sie einen externen Verzeichnisdienst integriert haben, fügen Sie die folgende Zeile zu Ihre Konfigurationsdatei, wenn Sie Edge auf 4.17.09 aktualisieren:

IS_EXTERNAL_AUTH="true"

Mit dieser Zeile wird Edge so konfiguriert, dass er einen Kontonamen anstelle einer E-Mail-Adresse unterstützt, als das Nutzernamen.

Automatische Weitergabe von Property Einstellungen

Wenn Sie Eigenschaften festgelegt haben, indem Sie .properties-Dateien in /opt/apigee/customer/application bearbeitet haben, dann sind diese werden bei der Aktualisierung beibehalten.

Voraussetzungen aktualisieren

Erfüllen Sie die folgenden Voraussetzungen, bevor Sie ein Upgrade von Apigee Edge ausführen:

Alle Knoten sichern
Vor dem Update wird empfohlen, aus Sicherheitsgründen eine vollständige Sicherung aller Knoten durchzuführen Gründe. Verwenden Sie das Verfahren für Ihre aktuelle Version von Edge, um die Sicherung durchzuführen.

So können Sie einen Sicherungsplan haben, falls das Update auf eine neue Version nicht ordnungsgemäß funktioniert. Weitere Informationen zum Sichern finden Sie unter Sichern und Wiederherstellen.
Sicherstellen, dass Edge ausgeführt wird
Stellen Sie mit dem folgenden Befehl sicher, dass Edge während des Aktualisierungsvorgangs aktiv ist und ausgeführt wird:

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

Fehlgeschlagene Updates verarbeiten

Tritt bei der Aktualisierung ein Fehler auf, können Sie versuchen, das Problem zu beheben, und anschließend update.sh ausführen. noch einmal. Sie können das Update mehrmals ausführen und es wird an der Stelle fortgesetzt, an der es zuletzt angehalten wurde. deaktiviert.

Wenn aufgrund des Fehlers ein Rollback des Updates auf die vorherige Version durchgeführt werden muss, lesen Sie den Abschnitt 4.17.09 Rollback-Prozess.

Informationen zu Logging-Updates

Standardmäßig enthält die Datei update.sh schreibt das Dienstprogramm Protokollinformationen in:

/opt/apigee/var/log/apigee-setup/update.log

Wenn der Nutzer, der das Dienstprogramm update.sh ausführt, keinen Zugriff auf wird das Protokoll als Datei namens update_username.log in das Verzeichnis /tmp 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 Rolling Update können Sie Ihre Edge-Installation ohne und bringt Edge herunter.

Eine Aktualisierung ohne Ausfallzeiten ist nur bei einer Konfiguration mit fünf und mehr Knoten möglich.

Der Schlüssel zu Upgrades ohne Ausfallzeiten besteht darin, jeden Router einzeln aus der Last zu entfernen. aus. Anschließend aktualisieren Sie den Router und alle anderen Komponenten auf demselben Rechner wie der Router. Fügen Sie den Router dann wieder zum Load-Balancer hinzu.

Aktualisieren Sie die Computer in der richtigen Reihenfolge für Ihre Installation, wie unten unter „Bestellungen des maschinellen Updates“.
Wenn es an der Zeit ist, die Router zu aktualisieren, wählen Sie einen der Router aus und machen Sie ihn nicht erreichbar, wie unter Aktivieren/Deaktivieren Erreichbarkeit des Servers (Message Processor/Routers)
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.
Setzen Sie das Update für alle verbleibenden Maschinen in Ihrer Installation fort.

Achten Sie vor/nach dem Update auf Folgendes:

Auf einem kombinierten Router und einem Message Processor-Knoten: <ph type="x-smartling-placeholder">
- Vor der Aktualisierung: <ph type="x-smartling-placeholder">
  1. Sorgen Sie dafür, dass der Router nicht erreichbar ist.
  2. Machen Sie den Message Processor nicht erreichbar.
- Führen Sie nach der Aktualisierung die folgenden Schritte aus: <ph type="x-smartling-placeholder">
  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: <ph type="x-smartling-placeholder">
- Sorge vor dem Update dafür, dass der Router nicht erreichbar ist.
- Mache nach dem Update den Router erreichbar.
Auf einem einzelnen Message Processor-Knoten: <ph type="x-smartling-placeholder">
- Sorgen Sie vor einem Update dafür, dass der Message Processor nicht erreichbar ist.
- Sorgen Sie nach der Aktualisierung dafür, dass der Message Processor erreichbar ist.

Konfigurationsdatei im Hintergrund verwenden

Sie müssen eine Konfigurationsdatei im Hintergrund an den Aktualisierungsbefehl übergeben. Die Datei für die stille Konfiguration sollte dieselbe sein, die Sie bei der Installation von Edge 4.16.09 verwendet haben.

Vorgehensweise für Aktualisierung auf 4.17.09 auf einem Knoten mit externer Internetverbindung

Gehen Sie wie folgt vor, um die Edge-Komponenten auf einem Knoten zu aktualisieren:

Deaktivieren Sie gegebenenfalls alle CRON-Jobs, die zum Ausführen eines Reparaturvorgangs in Cassandra konfiguriert sind. erst nach Abschluss des Updates.
Melden Sie sich als Root beim Knoten an, um die Edge-RPMs zu installieren.
Hinweis: Die RPM-Installation erfordert zwar Root-Zugriff, du kannst aber auch Edge- ohne Root-Zugriff konfigurieren.
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 des Edge-Apigee-Setups beschrieben. .
Aktivieren Sie das EPEL-Repository wie oben beschrieben.
Wenn Sie auf AWS installieren, 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 nach /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 Abhängigkeiten:
> sudo Bash /tmp/bootstrap_4.17.09.sh apigeeuser=uName apigeepassword=pWord

Dabei steht uName:pWord für den Nutzernamen und das Passwort, die Sie von Apigee Wenn Sie pWord weglassen, werden Sie aufgefordert, ihn einzugeben.

Das Installationsprogramm überprüft standardmäßig, ob Java 1.8 installiert ist. Andernfalls installiert. Mit der Option JAVA_FIX geben Sie an, wie die Version verarbeitet werden soll. Java-Installation. JAVA_FIX verwendet die folgenden Werte:

I = OpenJDK 1.8 installieren (Standard)
C = ohne Installation von Java fortfahren
Q = Beenden. Dazu müssen Sie Java selbst installieren.
Verwenden Sie apigee-service zum Aktualisieren des Apigee-Setup Dienstprogramm:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
Aktualisieren Sie die Methode apigee-validate auf dem Verwaltungsserver:
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
Aktualisieren Sie die apigee-provision. Dienstprogramm:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
Führen Sie das Update-Dienstprogramm auf Ihren Knoten in der unten unter Reihenfolge des Computers beschriebenen Reihenfolge aus aktualisieren“ unten:
> /opt/apigee/apigee-setup/bin/update.sh -c Komponente -f configFile

Die einzige Anforderung an die Konfigurationsdatei ist, dass die Konfigurationsdatei zugänglich oder lesbar durch den „Apigee“- Nutzer.

Verwenden Sie die Option „-c“, um die zu aktualisierende Komponente anzugeben. Die Liste der möglichen Komponenten umfassen:
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-Benutzeroberfläche
all = Alle Komponenten aktualisieren auf Computer (nur für ein Edge Aio-Installationsprofil oder eine API-BaaS-asa-Installation verwenden) Profil)
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-valid“ auf dem Management Server ausführen, wie unter Installation testen beschrieben.

Gehen Sie wie unter beschrieben vor, um später ein Rollback der Aktualisierung durchzuführen. 4.17.09 Rollback-Prozess.

Aktualisierung von einer lokalen Version auf 4.17.09 Repository

Wenn sich Ihre Edge-Knoten hinter einer Firewall befinden oder auf andere Weise der Zugriff verhindert wird das Apigee-Repository über das Internet, dann können Sie das Update von einem lokalen Repository aus durchführen, oder Spiegel des Apigee-Repositorys.

Nachdem Sie ein lokales Edge-Repository erstellt haben, haben Sie zwei Möglichkeiten, um Edge über die Lokales Repository:

Erstellen Sie eine TAR-Datei des Repositorys, kopieren Sie die TAR-Datei auf einen Knoten und aktualisieren Sie dann Edge vom 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 verwenden. Webserver.

So führen Sie ein Update von einem lokalen Repository aus 4.17.09 aus:

Erstellen Sie ein lokales 4.17.09-Repository, wie unter „Lokales Apigee-Repository erstellen“ beschrieben bei Installieren Sie das Dienstprogramm Edge für die Einrichtung von Apigee.
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“ beschrieben bei Installieren Sie das Dienstprogramm Edge für die Einrichtung von Apigee.
So installieren Sie den Apigee-Dienst aus einer TAR-Datei: <ph type="x-smartling-placeholder">
1. Verwenden Sie auf dem Knoten mit dem lokalen Repository den folgenden Befehl, um das lokale Repository zu verpacken in eine einzelne TAR-Datei mit dem Namen /opt/apigee/data/apigee-mirror/apigee-4.17.09.tar.gz umwandeln:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror-Paket
2. Kopieren Sie die TAR-Datei in den Knoten, auf dem Sie Edge aktualisieren möchten. Sie können sie zum Beispiel /tmp-Verzeichnis im neuen Knoten.
3. Entpacken Sie auf dem neuen Knoten die Datei in das Verzeichnis „/tmp“:
  > TAR -XZF apigee-4.17.09.tar.gz
  
  Mit diesem Befehl wird ein neues Verzeichnis namens „repos“ in dem Verzeichnis erstellt, das die TAR-Datei enthält. -Datei. Beispiel: /tmp/repos.
4. Installieren Sie das Edge-Apigee-Service-Dienstprogramm 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 in diesem Befehl den Pfad zum Repository-Verzeichnis angeben.
So installieren Sie den Apigee-Dienst mit dem Nginx-Webserver: <ph type="x-smartling-placeholder">
1. Konfigurieren Sie den Nginx-Webserver wie unter „Aus dem Repository mithilfe von Nginx installieren“ beschrieben. webserver" unter Install the Edge apigee-setup-Dienstprogramm.
2. Laden Sie auf dem Remote-Knoten die Edge-Datei bootstrap_4.17.09.sh herunter, /tmp/bootstrap_4.17.09.sh:
  > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
  
  Dabei steht uName:pWord für den Nutzernamen und das Passwort, die Sie oben für das Repository und remoteRepo ist die IP-Adresse oder der DNS-Name des Repository-Knoten.
3. Installieren Sie auf dem Remote-Knoten das Dienstprogramm für den Edge-Apigee-Dienst 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 des Repositorys.
Verwenden Sie apigee-service für Aktualisieren Sie das Dienstprogramm „Apigee-setup“:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
Aktualisieren Sie die Methode apigee-validate auf dem Verwaltungsserver.
> /opt/apigee/apigee-service/bin/apigee-service apigee-valid update
Aktualisieren Sie die apigee-provision. Dienstprogramm:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
Führen Sie das Update-Dienstprogramm auf Ihren Knoten in der unten unter "Reihenfolge des Computers beschriebenen Reihenfolge" aus aktualisieren“ unten:
> /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

Die einzige Anforderung an die Konfigurationsdatei ist, dass die Konfigurationsdatei zugänglich oder lesbar durch den „Apigee“- Nutzer.

Verwenden Sie die Option „-c“, um die zu aktualisierende Komponente anzugeben. Die Liste der möglichen Komponenten umfassen:
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-Benutzeroberfläche
all = Alle Komponenten aktualisieren auf Computer (nur für ein Edge Aio-Installationsprofil oder eine API-BaaS-asa-Installation verwenden) Profil)
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-valid“ auf dem Management Server ausführen, wie unter Installation testen beschrieben.

Gehen Sie wie unter beschrieben vor, um später ein Rollback der Aktualisierung durchzuführen. 4.17.09 Rollback-Prozess.

Reihenfolge des Maschinenupdates

Die Reihenfolge, in der Sie die Maschinen in einer Edge-Installation aktualisieren, ist wichtig. Die meisten wichtige Überlegungen bei einem Update:

Sie müssen alle Cassandra- und ZooKeeper-Knoten aktualisieren, bevor Sie irgendwelche anderen Knoten.
Für jede Maschine mit mehreren Edge-Komponenten (Verwaltungsserver, Nachrichtenprozessor, Router, QPID-Server, aber nicht Postgres-Server), verwenden Sie das "-c"-Edge um sie alle auf der Seite gleichzeitig.
Wenn ein Schritt angibt, dass er auf mehreren Rechnern ausgeführt werden soll, führen Sie ihn im angegebene Reihenfolge der Maschine.
Es gibt keinen separaten Schritt, um die Monetarisierung zu aktualisieren. Sie wird aktualisiert, wenn Sie den Parameter "-c" Edge“ Option.