Diese Seite wurde von der Cloud Translation API übersetzt.

Apigee Edge 4.16.01 auf 4.16.05 aktualisieren

Edge for Private Cloud Version 4.16.05

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

Sie können nur Apigee Edge-Version 4.16.01.x auf 4.16.05 aktualisieren.

Wenn Sie eine ältere Edge-Version als 4.16.01.x haben, müssen Sie zuerst zu Version 4.16.01.x und dann ein Update auf Version 4.16.05 durchfü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.

Erforderliches Upgrade auf Java JDK Version 8

Diese Edge-Version setzt voraus, dass Sie Java JDK Version 8 auf allen Edge-Geräten installiert haben. Verarbeitungsknoten. Sie können Oracle JDK 8 oder OpenJDK 8 installieren. Wenn Java JDK 8 nicht installiert ist kann es durch das Update-Skript installiert werden.

Im Rahmen des Updates auf Java 8 sind einige TLS-Chiffren in Oracle JDK 8 nicht mehr verfügbar. Für finden Sie im Abschnitt „Default Disabled Cipher Suites“ (Standard deaktivierte Chiffrensammlungen). http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html.

Warnung: Diese Version von Edge unterstützt nicht JDK 7. Wenn Sie derzeit mit JDK 7 müssen Sie ein Upgrade auf JDK 8 ausführen. Wenn Sie für die Installation von Edge 4.16.05 ein Rollback durchführen, können Sie Optional können Sie Edge neu konfigurieren, um Java JDK 7 zu verwenden.

Downgrade von Zookeeper durchführen

Die Version des Zookeeper-RPM in Edge für Private Cloud 4.16.01 ist apigee-zookeeper-3.4.5-1.0.905.noarch.rpm. In späteren Versionen von Edge wurde die Zookeeper-Version wieder in apigee-zookeeper-3.4.5-0.0.948 geändert. Dadurch wird verhindert, yum vom Upgrade von Zookeeper auf eine spätere Version von 4.16.01 durchgeführt haben. Die Art und Weise, diese Situation zu yum Downgrade ausführen apigee-zookeeper vor der Aktualisierung von Zookeeper.

Mit dem folgenden Befehl können Sie Ihre Zookeeper-Version prüfen:

> rpm -qa |grep apigee-zookeeper

Wenn dieser Befehl die Zookeeper-Version zurückgibt:

apigee-zookeeper-3.4.5-1.0.905

Dann müssen Sie das Downgrade ausführen.

Speicherplatzbedarf für Update

Stellen Sie sicher, dass Sie über mindestens 1 GB freien Speicherplatz verfügen, bevor Sie die aktualisieren.

Automatische Weitergabe von Property Einstellungen aus Version 4.16.01.x

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

Apigee-Validieren-Dienstprogramm aktualisieren

In 4.16.01 haben Sie das Dienstprogramm apigee-validate einer Nachricht installiert und ausgeführt. Prozessorknoten. In 4.16.05 wurde das Dienstprogramm apigee-validate zur Ausführung auf dem Knoten Verwaltungsserver aktualisiert.

Nach der Aktualisierung auf 4.16.05 haben Sie zwei Möglichkeiten, das Dienstprogramm apigee-validate zu aktualisieren:

Apigee empfohlen: Installieren und führen Sie das Dienstprogramm apigee-validate auf der Verwaltungsserverknoten.

Optional können Sie das Dienstprogramm apigee-validate aus der Message Processor-Knoten. Wenn Sie ihn auf dem Message Processor-Knoten belassen, müssen Sie ihn aktualisieren bis zum 16.04.2005.
Alternativ können Sie das Dienstprogramm apigee-validate auf der Message Processor-Knoten und führen ihn von dort aus aus. Apigee empfiehlt jedoch, dass Sie und führen es auf dem Verwaltungsserver aus.

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:

> /<inst_root>/apigee/apigee-service/bin/apigee-all-Status

Fehlgeschlagene Updates verarbeiten

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

Wenn der Fehler ein Rollback des Updates auf Ihre vorherige Version erfordert, finden Sie weitere Informationen unter Rollback-Prozess für 4.16.05.

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 Server aktivieren/deaktivieren Erreichbarkeit (Message Processor/Router)
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.01 verwendet haben.

Vorgehensweise für Aktualisierung auf 4.16.05 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.
Deaktivieren Sie SELinux wie unter Installieren des Edge-Apigee-Setups beschrieben. .
Laden Sie die Edge 4.16.05-Datei bootstrap_4.16.05.sh nach /tmp/bootstrap_4.16.05.sh herunter:
> curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
Installieren Sie das Dienstprogramm apigee-service von Edge 4.16.05 und Abhängigkeiten:
> sudo Bash /tmp/bootstrap_4.16.05.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 für Aktualisieren Sie das apigee-setup Dienstprogramm: <ph type="x-smartling-placeholder">
1. Wenn Sie 4.16.01 durch ein Upgrade auf Edge-Version 4.15.07.0x installiert haben, müssen Sie Installieren Sie das Dienstprogramm apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service Apigee-Setup-Installation
  Dieser Befehl installiert das Dienstprogramm update.sh in <inst_dir>/apigee/apigee-setup/bin.
  
  Wenn Sie das Dienstprogramm apigee-setup bereits installiert haben, aktualisieren Sie es:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
2. Wenn Sie 4.16.01 direkt installiert haben, das heißt, Sie haben kein Upgrade vom 4.15.07.0x, müssen Sie das Dienstprogramm apigee-setup aktualisieren:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  Dieses Update für apigee-service installiert den Dienstprogramm update.sh in <inst_dir>/apigee/apigee-setup/bin.
Installieren Sie die Funktion apigee-validate. auf dem Verwaltungsserver:
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate install
Hinweis: Wenn Sie das Dienstprogramm apigee-validate auf einem Message Processor-Knoten können Sie ihn mit dem folgenden Befehl auf diesem Knoten aktualisieren:
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
Für 4.16.05 empfiehlt Apigee jedoch, dass Sie das Dienstprogramm apigee-valid auf einem auf dem Verwaltungsserver.
Bearbeiten Sie die Konfigurationsdatei, die an das Dienstprogramm apigee-validate übergeben wird. Im Beim vorherigen Edge-Release erforderte die von apigee-validate verwendete Konfigurationsdatei die folgende Properties:
APIGEE_ADMINPW=sysAdminPword
MP_POD=gateway
REGION=dc-1
In diesem Release ist für die Konfigurationsdatei nur die Eigenschaft APIGEE_ADMINPW erforderlich. Sie können die zwei weitere Eigenschaften aus der Datei.
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. Speichern Sie die Datei beispielsweise im Verzeichnis „/tmp“ im Knoten.
Verwenden Sie die Option „-c“, um die zu aktualisierende Komponente anzugeben. Die Liste der möglichen Komponenten umfassen: <ph type="x-smartling-placeholder">
- ldap = OpenLDAP
- cs = Cassandra
- zk = Zookeeper
- qpid = qpidd
- ps = postgresql
- edge =Alle Kanten Komponenten außer Edge UI: Management Server, Message Processor, Router, QPID Server, Postgres-Server
- ui = Edge-Benutzeroberfläche
- all = Alle aktualisieren Gerätekomponenten (nur für Edge Aio-Installationsprofil oder API BaaS asa verwenden) Installationsprofil)
- e = ElasticSearch
- b = API-BaaS-Stack
- p = API-BaaS Portale
- 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.

Verwenden Sie für ein späteres Rollback des Updates die unter 4.16.05 Rollback-Prozess beschriebene Vorgehensweise.

Aktualisierung von einer lokalen Version auf 4.16.05 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 4.16.05-Repository aus:

Erstellen Sie ein lokales 4.16.05-Repository, wie unter „Lokales Apigee-Repository erstellen“ beschrieben unter Installieren des Edge-Apigee-Setups .
Hinweis: Wenn Sie bereits ein 4.16.01-Repository haben, können Sie das 4.16.05-Repository hinzufügen ihr ihr ihr Repository entnehmen könnt.
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 namens /opt/apigee/data/apigee-mirror/apigee-4.16.05.tar.gz:
  > /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.16.05.tar.gz
  Mit diesem Befehl wird ein neues Verzeichnis in dem Verzeichnis, das die TAR-Datei enthält. Beispiel: /tmp/repos.
4. Installieren Sie das Edge-Apigee-Service-Dienstprogramm und die Abhängigkeiten aus /tmp/repos:
  > sudo Bash /tmp/repos/bootstrap_4.16.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
  Beachten Sie, dass Sie den Pfad zu in diesem Befehl das Repository-Verzeichnis an.
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 Datei Edge bootstrap_4.16.05.sh herunter nach /tmp/bootstrap_4.16.05.sh:
  > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
  wo uName:pWord sind der Nutzername und das Passwort, die Sie oben für den Repository und remoteRepo ist die IP-Adresse oder der DNS-Name des Repositorys 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.16.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
  wo uName:pWord sind der Nutzername des Repositorys und Passwort.
Verwenden Sie apigee-service für Aktualisieren Sie das Dienstprogramm apigee-setup: <ph type="x-smartling-placeholder">
1. Wenn Sie 4.16.01 durch ein Upgrade auf Edge-Version 4.15.07.0x installiert haben, müssen Sie Installieren Sie das Dienstprogramm apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service Apigee-Setup-Installation
  Mit diesem Befehl wird das Dienstprogramm update.sh installiert. in <inst_dir>/apigee/apigee-setup/bin
  
  Wenn Sie das Dienstprogramm apigee-setup bereits installiert haben, aktualisieren Sie es:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
2. Wenn Sie 4.16.01 direkt installiert haben, das heißt, Sie haben kein Upgrade vom 4.15.07.0x, müssen Sie das Dienstprogramm apigee-setup aktualisieren:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  Dieses Update für apigee-service-Installationen Das Dienstprogramm update.sh in <inst_dir>/apigee/apigee-setup/bin.
Installieren Sie das Dienstprogramm apigee-validate. auf dem Knoten des Verwaltungsservers:
> /opt/apigee/apigee-service/bin/apigee-service apigee-valid install
Hinweis: Wenn Sie das Dienstprogramm apigee-validate auf einem Message Processor-Knoten können Sie ihn mit dem folgenden Befehl auf diesem Knoten aktualisieren:

> /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
Für 4.16.05 empfiehlt Apigee jedoch, dass Sie die Apigee-Validierung installieren und ausführen. auf dem Verwaltungsserver.
Bearbeiten Sie die Konfigurationsdatei, die an das Dienstprogramm apigee-validate übergeben wird. In Im vorherigen Edge-Release war die von apigee-validate verwendete Konfigurationsdatei erforderlich, folgende Properties:
APIGEE_ADMINPW=sysAdminPword
MP_POD=gateway
REGION=dc-1
In diesem Release ist für die Konfigurationsdatei nur das Attribut APIGEE_ADMINPW erforderlich. Sie können die zwei weitere Eigenschaften aus der Datei.
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. Speichern Sie die Datei beispielsweise im Verzeichnis „/tmp“ im Knoten.
Verwenden Sie die Option „-c“, um die zu aktualisierende Komponente anzugeben. Die Liste der möglichen Komponenten umfassen: <ph type="x-smartling-placeholder">
- ldap = OpenLDAP
- cs = Cassandra
- zk = Zookeeper
- qpid = qpidd
- ps = postgresql
- edge =Alle Kanten Komponenten außer Edge UI: Management Server, Message Processor, Router, QPID Server, Postgres-Server
- ui = Edge-Benutzeroberfläche
- all = Alle aktualisieren Gerätekomponenten (nur für Edge Aio-Installationsprofil oder API BaaS asa verwenden) Installationsprofil)
- e = ElasticSearch
- b = API-BaaS-Stack
- p = API-BaaS Portale
- 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.

Verwenden Sie für ein späteres Rollback des Updates die unter 4.16.05 Rollback-Prozess beschriebene Vorgehensweise.

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.
Sie müssen alle qpidd- und postgresql-Knoten aktualisieren, bevor Sie Router- und Message Processor-Knoten.
Für jede Maschine mit mehreren Edge-Komponenten (Verwaltungsserver, Nachrichtenprozessor, Router, QPID-Server, Postgres-Server), verwenden Sie das „-c“-Edge um alle gleichzeitig zu aktualisieren, .
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.
Nachdem Sie einen Routerknoten aktualisiert haben, müssen Sie alle Dateien aus dem Verzeichnis /opt/nginx/conf.d entfernen. starten Sie den Router neu.