Diese Seite wurde von der Cloud Translation API übersetzt.

Aktualisieren Sie Apigee Edge 4.16.05.x auf die neueste Version 4.16.05.

Edge for Private Cloud Version 4.16.05

In diesem Dokument wird das Verfahren beschrieben, mit dem Sie Ihre vorhandene 4.16.05-Installation aktualisieren. um die neuesten RPMs und Supportdateien von Apigee zu verwenden. Bei diesem Verfahren wird das Dienstprogramm update.sh verwendet. um das Update durchzuführen.

Welche Edge-Versionen können aktualisiert werden? auf die neueste Version von 4.16.05

Sie können nur eine vorhandene Apigee Edge-Installation der Version 4.16.05.x auf die neueste Version aktualisieren Version 4.16.05.

Wenn Sie derzeit Edge-Version 4.16.01.0x oder früher verwenden, müssen Sie zuerst zu 4.16.05. Siehe Aktualisieren von Apigee Edge 4.16.01 auf 4.16.05 um Informationen zur Migration zu Version 4.16.05 zu erhalten.

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.

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

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 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 Ihre vorherige Version erforderlich ist, lesen Sie 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: Das Dienstprogramm update.sh schlägt 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, beschrieben, die im nächsten Abschnitt "Einen Router und einen Message Processor nicht erreichbar machen" 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.
Setzen Sie das Update für alle verbleibenden Maschinen in Ihrer Installation fort.

Die Herstellung eines Routers und Message Processor nicht erreichbar

In einer Produktionsumgebung haben Sie mehrere Router und Message Processor, eine optimale Leistung erzielen und die Erreichbarkeit dieser Router und der Nachrichtenfunktion Prozessoren vor/nach dem Update.

Mit dem folgenden API-Aufruf wird ein Knoten als erreichbar oder nicht erreichbar konfiguriert:

> curl -u adminEmail:pWord -X POST "http://<ms_IP>:8080/v1/servers/UUID" -d "reachable=true|false"

wobei UUID die UUID des Message Processor oder Routers ist und Erreichbar ist entweder auf "true" oder "false" gesetzt.

Wenn Sie die UUID des Routers ermitteln müssen, verwenden Sie den folgenden cURL-Befehl:

> curl http://<routerIP>:8081/v1/servers/self

Wenn Sie die UUID des Message Processor ermitteln müssen, verwenden Sie den folgenden cURL Befehl:

> curl http://<mpIP>:8082/v1/servers/self

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. Machen Sie den Router mit dem oben gezeigten API-Aufruf nicht erreichbar.
  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">
- Mache den Router vor dem Update erreichbar.
- 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.05 verwendet haben.

Aktualisierungsverfahren 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. .
Lösche alle Yum-Caches:
> sudo yum clean all
Laden Sie die neueste Datei Edge 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
Aktualisieren Sie das Dienstprogramm und die Abhängigkeiten von Edge Apigee-Dienst:
> sudo Bash /tmp/bootstrap_4.16.05.sh apigeeuser=uName apigeepassword=pWord

Dabei sind uName:pWord der Nutzername und das Passwort, die Sie von Apigee Wenn Sie pWord weglassen, werden Sie aufgefordert, ihn einzugeben.
Verwenden Sie den Apigee-Dienst, um das Dienstprogramm „Apigee-Setup“ zu aktualisieren:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

Dieses Update für den Apigee-Service installiert das Dienstprogramm update.sh in /<inst_dir>/apigee/apigee-setup/bin.
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 = Cassandr
- zk = Zookeeper
- qpid = qpidd
- ps = postgresql
- Edge =Alle Edge-Komponenten außer Edge-UI: Verwaltungsserver, Nachrichtenprozessor, Router, QPID-Server, Postgres-Server
- ui = Edge-Benutzeroberfläche
- all = Alle Komponenten auf dem Computer aktualisieren (nur für Edge Aio-Installationsprofil verwenden) oder ein API BaaS asa-Installationsprofil)
- 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 verwenden, Test the install.

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

Stellen Sie sicher, dass Sie ein lokales 4.16.05-Repository haben, wie unter Edge-Komponenten installieren auf einem Knoten.
Aktualisieren Sie das lokale Repository: <ph type="x-smartling-placeholder">
1. Laden Sie die aktuelle Edge-Datei bootstrap_4.16.05.sh herunter in /tmp/bootstrap_4.16.05.sh:
  > curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
2. Führen Sie die Synchronisierung durch:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
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“:
  <ph type="x-smartling-placeholder"> </ph> > TAR -XZF apigee-4.16.05.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. 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.
5. Deaktivieren Sie SELinux wie unter Edge installieren beschrieben apigee-setup-Dienstprogramm.
6. 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 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 Installieren Edge-Komponenten auf einem Knoten
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
  
  Dabei steht uName:pWord für den Nutzernamen und das Passwort, die Sie oben für dem Repository und remoteRepo ist die IP-Adresse oder der DNS-Name des Repository-Knoten.
3. 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.
4. Deaktivieren Sie SELinux wie unter Edge installieren beschrieben apigee-setup-Dienstprogramm.
5. 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=uNamea pigeepassword=pWord apigeeprotocol=http://
  
  Dabei sind uName:pWord der Nutzername und das Passwort des Repositorys.
Deaktivieren Sie gegebenenfalls alle CRON-Jobs, die zum Ausführen eines Reparaturvorgangs in Cassandra konfiguriert sind. erst nach Abschluss des Updates.
Verwenden Sie den Apigee-Dienst, um das Dienstprogramm „Apigee-Setup“ zu aktualisieren:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

Dieses Update für den apigee-service installiert das Dienstprogramm update.sh in <inst_dir>/apigee/apigee-setup/bin.
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 = Cassandr
- zk = Zookeeper
- qpid = qpidd
- ps = postgresql
- Edge =Alle Edge-Komponenten außer Edge-UI: Verwaltungsserver, Nachrichtenprozessor, Router, QPID-Server, Postgres-Server
- ui = Edge-Benutzeroberfläche
- all = Alle Komponenten auf dem Computer aktualisieren (nur für Edge Aio-Installationsprofil verwenden) oder ein API BaaS asa-Installationsprofil)
- 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 Test the install von Apigee ausführen.

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. und starten Sie dann den Router neu.