Aktualisieren Sie Apigee Edge 4.51.00, 4.52.00 oder 4.52.01 auf 4.52.02

Apigee unterstützt ein direktes Upgrade von Edge for Private Cloud von Version 4.51.00, 4.52.00 oder 4.52.01 auf Version 4.52.02. Auf dieser Seite wird beschrieben, wie Sie solche Upgrades ausführen.

Wer kann das Update ausführen?

Die Person, die das Update ausführt, muss die Person sein, die Edge ursprünglich installiert hat, oder eine Person, die als Root ausgeführt wird.

Nachdem Sie die Edge-RPMs installiert haben, kann jeder 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.

Voraussetzungen für die Aktualisierung

Prüfen Sie vor dem Upgrade von Apigee Edge, ob die folgenden Voraussetzungen erfüllt sind:

  • Alle Knoten sichern
    Vor dem Aktualisieren empfehlen wir aus Sicherheitsgründen, eine vollständige Sicherung aller Knoten durchzuführen. Führen Sie die Sicherung mit der Anleitung für Ihre aktuelle Version von Edge aus.

    So haben Sie einen Notfallplan für den Fall, dass 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
  • Die Cassandra-Komprimierungsstrategie muss LeveledCompactionStrategy
    sein. Nehmen Sie je nach aktueller Version die erforderlichen Änderungen an der Cassandra-Komprimierungsstrategie vor. Führen Sie die folgenden Schritte aus und kehren Sie dann zum Hauptupgradeverfahren zurück:

Besondere Schritte für die Umstellung

Wenn Sie auf Edge for Private Cloud 4.52.02 umstellen möchten, sollten Sie bestimmte Schritte zum Aktualisieren bestimmter Software ausführen. Die erforderlichen Schritte hängen von Ihrer aktuellen Version ab. In der folgenden Tabelle finden Sie die verschiedenen Softwareprogramme, für die zusätzliche Schritte erforderlich sind. Folgen Sie der jeweiligen Anleitung. Kehren Sie nach Abschluss der erforderlichen Aufgaben zum Haupt-Upgradeverfahren zurück, um mit dem Upgrade fortzufahren.

Aktuelle Version Software, für die spezielle Schritte für das Upgrade auf 4.52.02 erforderlich sind
4.52.01 Cassandra
4.52.00 ZooKeeper, Cassandra, Qpid
4.51.00 Zookeeper, Postgres, Cassandra, Qpid

Nachdem Sie die erforderlichen Schritte für Ihre Version ausgeführt haben, kehren Sie zum Hauptupgradeverfahren zurück, um fortzufahren.

Automatische Übernahme von Hoteleigenschaften

Wenn Sie Eigenschaften festgelegt haben, indem Sie .properties-Dateien in /opt/apigee/customer/application bearbeitet haben, bleiben diese Werte nach dem Update erhalten.

Upgrade auf Zookeeper 3.8.3

Edge for Private Cloud 4.52.02 enthält kein Zookeeper-Upgrade. Wenn Sie jedoch von einer älteren Version als 4.52.01 ein Upgrade ausführen, müssen Sie die unten beschriebenen Schritte für das Zookeeper-Upgrade ausführen.

  • Wenn Sie ein Upgrade von Edge for Private Cloud-Version 4.51.00 oder 4.52.00 ausführen, lesen Sie die Schritte unter Erforderliches Upgrade auf Zookeeper 3.8.3, um Zookeeper zu aktualisieren.
  • Wenn Sie ein Upgrade von Edge for Private Cloud Version 4.52.01 durchführen, sollten Sie bereits Zookeeper Version 3.8.3 verwenden. Für das Upgrade von Zookeeper sind dann keine speziellen Schritte erforderlich.

Upgrade auf Postgres 14

  • Wenn Sie von Edge for Private Cloud 4.51.00 auf 4.52.02 umstellen, müssen Sie die Schritte zum Aktualisieren von Postgres ausführen, auch wenn Edge for Private Cloud 4.52.02 kein Postgres-Upgrade enthält. Für das Upgrade von Edge for Private Cloud 4.51.00 auf 4.52.02 sind zusätzliche Postgres-Upgradeschritte erforderlich. Weitere Informationen finden Sie im Abschnitt Erforderliches Upgrade auf Postgres 14.
  • Wenn Sie von Edge for Private Cloud 4.52.00 oder 4.52.01 auf 4.52.02 upgraden, sind keine zusätzlichen Schritte für das PostgreSQL-Upgrade erforderlich.

Upgrade auf Cassandra 3.11.16

Apigee Edge for Private Cloud 4.52.02 enthält ein Upgrade von Cassandra auf Version 3.11.16. Cassandra ist eine wichtige Komponente von Apigee. Dieses Upgrade umfasst auch Updates der Treibersoftware in verschiedenen Laufzeit- und Verwaltungskomponenten, die zum Abfragen und Schreiben in Cassandra verwendet werden.

Da es sich um ein größeres Upgrade handelt, waren bestimmte Änderungen am Apigee-Datenmodell in Cassandra erforderlich, um eine optimale Leistung in neueren Versionen zu gewährleisten. Obwohl diese Änderungen minimal sind, werden bestimmte Verwaltungs-APIs durch den Upgradeprozess unterbrochen, wenn das Upgrade gestartet wird. Die genauen Verwaltungs-APIs, die in der Regel unterbrochen werden, sind in den entsprechenden Abschnitten unten aufgeführt.

Außerdem führt der Upgradeprozess zu Unterbrechungen bei einer größeren Anzahl von Laufzeit-Proxy-Flows und Verwaltungs-APIs im aktualisierten Rechenzentrum. Es ist wichtig, dass Sie den Laufzeit- und Verwaltungsverkehr vom aktualisierten Rechenzentrum isolieren, um solche Unterbrechungen zu minimieren. Weitere Informationen finden Sie in den Abschnitten Ein Rechenzentrum und Mehrere Rechenzentren unten.

Entwicklerportal – APIs dokumentieren

Das Apigee-Drupal-Entwicklerportal bietet verschiedene Funktionen zur Dokumentation Ihrer APIs. Wir empfehlen, das Drupal 7-basierte Entwicklerportal nicht mehr zu verwenden. Wenn Sie es jedoch weiterhin verwenden und die SmartDocs-Funktion nutzen, gilt für Sie das Dokument SmartDocs APIs verwenden. Wenn Sie neuere Versionen des Entwicklerportals verwenden, hat dieses Upgrade keine Auswirkungen auf Ihre API-Dokumentation.

Wenn Sie Apigee auf Version 4.52.02 aktualisieren, werden alle API-Modelle, die mit der SmartDocs-Funktion des Drupal 7-Entwicklerportals erstellt wurden, nicht automatisch in die neuere Version migriert. Sie müssen jedes Modell manuell über das Entwicklerportal exportieren und nach Abschluss des Upgrades wieder importieren.

Im Folgenden verwendete Begriffe

Laufzeit: Die Laufzeit umfasst die Verarbeitung Ihres Laufzeit-Proxy-Traffics. Sie enthält alle Vorgänge, die von Ihren Routern und Message Processorn ausgeführt werden, um eine Laufzeit-API-Anfrage für vorhandene Proxys effektiv zu verarbeiten. Die Bereitstellung neuer Proxys oder neuer Versionen von Proxys ist jedoch nicht inbegriffen.

Verwaltung:Dazu gehört die Verwaltung Ihres Apigee Edge-Systems. Dazu gehören unter anderem Bereitstellungen, Änderungen an Apps, Produkten, Zielservern, Schlüsselspeichern usw. Alle Management APIs (und ihre Clients wie die Apigee-Benutzeroberfläche und das Entwicklerportal) sind in diesem Umfang enthalten.

Während dieses Upgrades kommt es in der Region oder im Rechenzentrum (DC), in dem das Update ausgeführt wird, zu Laufzeit- und Verwaltungs-Traffic. Unabhängig vom aktualisierten Rechenzentrum wirken sich die Änderungen auf bestimmte Verwaltungs-APIs in allen Rechenzentren aus. Diese Auswirkungen werden nach jedem Schritt vermerkt.

In den einzelnen Schritten unten wird der Laufzeit- und Verwaltungsstatus beschrieben, während Sie die verschiedenen Phasen des Upgrade-Vorgangs durchlaufen.

Upgradestrategien

Mehrere Rechenzentren

Das Upgrade muss Rechenzentrum für Rechenzentrum durchgeführt werden, um die Verkehrskontinuität zu gewährleisten und Ausfallzeiten zu vermeiden. Bevor ein DC aktualisiert wird, sollte der Traffic auf andere funktionsfähige DCs umgeleitet werden.

Ein Rechenzentrum

Bei einer Einrichtung mit einem einzigen Rechenzentrum hat das Upgrade erhebliche Auswirkungen auf den Laufzeittraffic und bestimmte Verwaltungs-APIs. Für die Einrichtung eines einzelnen Rechenzentrums sind die folgenden Optionen verfügbar.

Wir empfehlen, auf ein zusätzliches Rechenzentrum umzustellen, um Auswirkungen auf den Laufzeit-Traffic und die Verwaltungs-APIs zu vermeiden. Während des Upgrades sind unter anderem die folgenden Bereiche des betroffenen Rechenzentrums betroffen:

  • Aktualisierung von OAuth-Tokens durch Runtime APIs
  • Runtime APIs mit Access Entity-Richtlinie
  • Verwaltungs-APIs mit Entwickler-Apps
  • Management-APIs für Produkteinträge

Die oben beschriebenen Auswirkungen treten zusätzlich zu den spezifischen Verwaltungs-APIs auf, die in allen Rechenzentren so lange nicht funktionieren, bis alle Rechenzentren aktualisiert wurden. Solche Verwaltungs-APIs werden in den Schritten in den folgenden Abschnitten aufgeführt.

Rollback – allgemeine Informationen

  • Auswirkungen während des Rollbacks

    Ein Rollback von Cassandra 3.11.x auf 2.1.x wirkt sich sowohl auf den Laufzeit- als auch auf den Verwaltungsverkehr im Rechenzentrum aus, in dem das Rollback durchgeführt wird. Außerdem kann es bei bestimmten Verwaltungs-APIs zu Unterbrechungen in allen Rechenzentren kommen, unabhängig davon, in welchem Rechenzentrum gerade ein Rollback durchgeführt wird.

  • DC-by-DC-Rollback-Ansatz verwenden

    Das Rollback muss für jedes Rechenzentrum einzeln ausgeführt werden, um die Dienstkontinuität aufrechtzuerhalten und Ausfallzeiten zu vermeiden. Bevor Sie ein Rollback in einem bestimmten Rechenzentrum starten, achten Sie darauf, dass der Anwendungsverkehr an ein anderes voll funktionsfähiges Rechenzentrum weitergeleitet wird.

  • Teilweise aktualisierte Cluster rückgängig machen

    Wenn mindestens ein Rechenzentrum mit der älteren Cassandra-Version (2.1.22) voll funktionsfähig bleibt, können andere aktualisierte Rechenzentren rückgängig gemacht werden, indem sie aus dem voll funktionsfähigen Cassandra 2.1.X-Rechenzentrum neu erstellt werden.

  • Clusterweites Rollback

    Wenn der gesamte Cassandra-Cluster aktualisiert wurde und ein Rollback erforderlich ist, muss es mithilfe von Sicherungen oder VM-Snapshots durchgeführt werden. Dieser Ansatz ist komplex und führt wahrscheinlich zu einer vorübergehenden Ausfallzeit oder zu Datenverlusten.

  • Vor dem Upgrade zu beachtende Punkte

    Es ist wichtig, dass Sie sich mit Rollback-Verfahren vertraut machen, bevor Sie das Upgrade ausführen. Es ist wichtig, dass beim Upgrade die Feinheiten des Rollbacks berücksichtigt werden, damit geeignete Rollback-Pfade verfügbar sind.

Rollback-Cluster mit einem einzigen Rechenzentrum

Das Upgrade von Cassandra von Version 2.1.x auf Version 3.11.x kann sich erheblich auf den Laufzeittraffic und bestimmte Verwaltungs-APIs auswirken. Diese Auswirkungen gelten auch beim Rollback und können zu Ausfallzeiten oder Datenverlusten führen.

Bei Produktionsarbeitslasten wird dringend empfohlen, vor dem Upgrade ein neues Rechenzentrum bereitzustellen. Dies ermöglicht einen sichereren Rollback-Pfad ohne Datenverlust oder Unterbrechung des API-Traffics. Das zusätzliche Rechenzentrum kann nach Abschluss des Upgrades außer Betrieb genommen werden.

Wenn das Hinzufügen eines neuen Rechenzentrums nicht möglich ist, aber eine Rollback-Funktion erforderlich ist, müssen vor dem Upgrade zuverlässige Sicherungen erstellt werden. Die Wiederherstellung von Cassandra 2.1.x aus Sicherungen ist möglich, kann aber zu Dienstausfällen und potenziellen Datenverlusten führen.

Rollback-Cluster mit mehreren Rechenzentren

Beim Zurückrollen mehrerer Rechenzentren wird ein Rechenzentrum-zu-Rechenzentrum-Ansatz (DC-by-DC) verwendet. Bei diesem Ansatz wird der Traffic aus dem zurückgerollten Rechenzentrum an andere funktionsfähige Rechenzentren weitergeleitet. So wird ein kontrollierter und isolierter Rollback-Prozess für Cassandra, Management Server und Laufzeitknoten sichergestellt, um Verkehrsunterbrechungen zu vermeiden.

Weitere Informationen finden Sie im Abschnitt Rollback des Cassandra-Updates 3.11.16.

Schritt 0: Startstatus

  • Die Zookeeper-, Postgres- und LDAP-Komponenten wurden bereits auf Version 4.52.02 aktualisiert. Ihr Edge für einen Private-Cloud-Cluster ist stabil und funktioniert. Wenn ein Rollback erforderlich ist, wird der Cluster auf diesen Zustand zurückgesetzt.
  • Cassandra in Apigee wird mit Version 2.1.22 ausgeführt.
  • Edge-Komponenten:
    • Verwaltungsserver, der über das ältere Thrift-Protokoll mit Cassandra kommuniziert.
    • Laufzeitserver (Message Processors und Router), die über das ältere Thrift-Protokoll mit Cassandra kommunizieren.
Laufzeitstatus in dieser Phase Verwaltungsstatus in dieser Phase
Laufzeit vollständig funktionsfähig Verwaltung vollständig funktionsfähig

Schritt 1: Upgrade vorbereiten

Die folgenden Schritte ergänzen die Standarddateien, die Sie normalerweise erstellen, z. B. die Standardkonfigurationsdatei von Apigee zum Aktivieren von Komponentenupgrades.

  1. Ändern Sie Cassandra so, dass LeveledCompactionStrategy verwendet wird.
  2. Cassandra mit Apigee sichern
  3. Erstellen Sie (falls möglich) VM-Snapshots der Cassandra-Knoten.
  4. Erstellen Sie auf jedem Cassandra-Knoten unter /opt/apigee/apigee-cassandra/cass_upgrade.conf eine Cassandra-Upgrade-Konfigurationsdatei mit dem folgenden Inhalt: 
    # IP Address of node
HOSTIP=10.0.0.1

# Username for running Cassandra queries. Optional. Can be skipped if you have not enabled Cassandra authentication.
CASS_USERNAME=<cassuser>

# Password for running Cassandra queries. Optional. Can be skipped if you have not enabled Cassandra authentication.
CASS_PASSWORD=<casspass>

# Port for connecting to Cassandra via thrift. Optional. Defaults to 9160 if skipped.
CASS_PORT=9160

# Port for connecting to Cassandra via CQL. Optional. Defaults to 9042 if skipped.
CASS_CQL_PORT=9042

# Directory to be used by Cassandra upgrade scripts. Optional. Defaults to /tmp/cass_upgrade_scripts if skipped.
# Note that if upgrade is successful, this directory is deleted via root user - so provide a directory accordingly.
CASS_TMP_DIR=/tmp/cass_upgrade_scripts
    Wenn die Datei nicht unter /opt/apigee/apigee-cassandra/cass_upgrade.conf erstellt werden kann, erstellen Sie die Datei /opt/silent.conf mit demselben Inhalt auf jedem Cassandra-Knoten.
  5. Wenn Sie die SmartDocs-Funktion des Apigee Drupal 7-Entwicklerportals verwenden, exportieren Sie jedes Ihrer Modelle, indem Sie sie im JSON-Format über die Benutzeroberfläche des Entwicklerportals herunterladen. Diese Modelle müssen nach der Aktualisierung der Verwaltungsserver wieder in Apigee importiert werden.
  6. Sorgen Sie dafür, dass von allen Edge-Komponenten auf die Ports 9160 und 9042 zu Cassandra-Knoten zugegriffen werden kann, falls dies nicht bereits der Fall ist. Weitere Informationen finden Sie unter Anforderungen an Anschlüsse.

Schritt 2: Traffic vom ersten Rechenzentrum wegleiten

  1. Blockieren Sie eingehenden Laufzeit- und Verwaltungsverkehr aus dem ersten Rechenzentrum.
  2. Leiten Sie den gesamten Laufzeit-Traffic und die Verwaltungs-APIs an die anderen funktionsfähigen Rechenzentren weiter.
  3. Prüfen Sie, ob Laufzeit- und Verwaltungs-Traffic von den anderen DCs erfolgreich verarbeitet wird.

Schritt 3: Alle Cassandra-Knoten im ersten Rechenzentrum aktualisieren

  1. Führen Sie ein Upgrade aller Cassandra-Knoten im Rechenzentrum nacheinander durch. Führen Sie die folgenden Befehle nacheinander auf jedem Knoten aus: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  2. Führen Sie nach dem Aktualisieren eines Knotens den folgenden Befehl auf dem Knoten aus, um einige Validierungen auszuführen, bevor Sie fortfahren: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra validate_upgrade -f configFile
     Die Ausgabe sieht in etwa so aus: 
    Cassandra version is verified - [cqlsh 5.0.1 | Cassandra 3.11.16 | CQL spec 3.4.4 | Native protocol v3] Metadata is verified
  3. Führen Sie nach Abschluss des Upgrades den folgenden post_upgrade-Befehl nacheinander auf jedem Cassandra-Knoten aus: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra post_upgrade
Laufzeitstatus in dieser Phase Verwaltungsstatus in dieser Phase
  • Laufzeit-Traffic in aktualisierten Rechenzentren blockiert
  • Vollständige Laufzeitfunktion in anderen Rechenzentren

Schritt 4: Alle Verwaltungsknoten im ersten Rechenzentrum aktualisieren

Führen Sie ein Upgrade auf allen Verwaltungsknoten im Rechenzentrum aus:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Laufzeitstatus in dieser Phase Verwaltungsstatus in dieser Phase
  • Laufzeit-Traffic in aktualisierten Rechenzentren blockiert
  • Laufzeit vollständig funktionsfähig

Schritt 5: Alle Laufzeitknoten im ersten Rechenzentrum aktualisieren

Führen Sie ein Upgrade aller Router und Message Processor-Knoten im Rechenzentrum nacheinander durch:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Laufzeitstatus in dieser Phase Verwaltungsstatus in dieser Phase
  • Laufzeit-Traffic in aktualisierten Rechenzentren blockiert
  • Vollständige Laufzeitfunktion in anderen Rechenzentren

Schritt 6: Traffic zurück zum ersten Rechenzentrum leiten

  • Nachdem das erste Rechenzentrum mit Cassandra, Laufzeitkomponenten und Verwaltungsserver aktualisiert wurde, aktivieren Sie den Laufzeit- und Verwaltungstraffic für das erste Rechenzentrum wieder.
  • Prüfen Sie, ob der Laufzeit- und Verwaltungsverkehr zwischen den Rechenzentren erfolgreich ist.

Schritt 7: Andere Rechenzentren aktualisieren

Wiederholen Sie die Schritte 1 bis 6 für die verbleibenden Rechenzentren nacheinander, indem Sie den Traffic von diesen Rechenzentren umleiten, die Apigee-Software aktualisieren und den Traffic für diese Rechenzentren wieder aktivieren.

Schritt 8: Upgradeschritt auf allen Verwaltungsknoten noch einmal ausführen

Führen Sie den folgenden Upgrade-Befehl noch einmal auf allen Verwaltungsknoten in allen Rechenzentren aus:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

Schritt 9 – [Optional] Zuvor exportierte Smartdocs importieren

Sobald alle Verwaltungsserver aktualisiert wurden, können Sie die Smart Docs-Modelle importieren, die Sie in Schritt 1 exportiert haben. Sie können das auch später tun.

Das ist nur erforderlich, wenn Sie ein Drupal 7-basiertes Entwicklerportal und die SmartDocs-Funktion verwenden.

Laufzeitstatus in dieser Phase Verwaltungsstatus in dieser Phase
Laufzeit vollständig funktionsfähig Verwaltung vollständig funktionsfähig

Schritt 10: Nicht verwendete Tabellen löschen

Führen Sie den folgenden Befehl aus, um alte nicht verwendete Tabellen aus dem Cassandra-Cluster zu löschen. Bis dahin können Sie bestimmte Funktionen von Cassandra nicht verwenden, z. B. die Einrichtung einer neuen Authentifizierung. Alte Authentifizierungsmechanismen funktionieren jedoch weiterhin. Dieser Befehl kann nur auf einem Knoten im Cluster ausgeführt werden.

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra drop_old_tables -f configFile

Schritt 11: Alle verbleibenden Edge- und anderen Komponenten auf Private Cloud 4.52.02 aktualisieren

Führen Sie ein Upgrade für alle verbleibenden edge-qpid-server- und edge-postgres-server-Knoten in allen Regionen einzeln durch.

Wenn Sie in dieser Phase ein Upgrade von einer Version ausführen, die älter als Edge for Private Cloud 4.52.01 ist,müssen Sie wie unten beschrieben zusätzliche Schritte für das Upgrade von Qpid bzw. Postgres ausführen und die übrigen Komponenten gemäß diesen Schritten aktualisieren.

Upgrade auf Qpid J-Broker

Auch wenn Edge for Private Cloud 4.52.02 kein Upgrade auf Qpid enthält, müssen Sie die Schritte zum Upgrade von QPID ausführen, wenn Sie von einer älteren Version als 4.52.01 aktualisieren.

  • Wenn Sie von Edge for Private Cloud 4.51.00 oder 4.52.00 auf 4.52.02 upgraden, müssen Sie zusätzliche Schritte für das Qpid-Upgrade ausführen. Wenn Sie von Version 4.51.00 oder 4.52.00 auf Version 4.52.02 aktualisieren, lesen Sie den Abschnitt Qpid aktualisieren.
  • Wenn Sie von Edge for Private Cloud 4.52.01 auf 4.52.02 upgraden, sollten Sie bereits die neueste Version des Qpid-Brokers verwenden. Es sind keine zusätzlichen Schritte für das Qpid-Upgrade erforderlich.

Neue Edge-Benutzeroberfläche

In diesem Abschnitt werden Aspekte zur Edge-Benutzeroberfläche aufgeführt. Weitere Informationen finden Sie unter Die neue Edge-Benutzeroberfläche für die Private Cloud.

Edge-Benutzeroberfläche installieren

Nach Abschluss der Erstinstallation empfiehlt Apigee, die Edge-Benutzeroberfläche zu installieren. Dies ist eine erweiterte Benutzeroberfläche für Entwickler und Administratoren von Apigee Edge for Private Cloud.

Für die Edge-Benutzeroberfläche müssen Sie die Standardauthentifizierung deaktivieren und einen IDP wie SAML oder LDAP verwenden.

Weitere Informationen finden Sie unter Neue Edge-Benutzeroberfläche installieren.

Edge-Benutzeroberfläche aktualisieren

Berücksichtigen Sie beim Aktualisieren der Edge-UI-Komponente die Version von Edge für die Private Cloud, von der Sie ein Upgrade durchführen:

Mit Apigee mTLS aktualisieren

So aktualisieren Sie Apigee mTLS:

Aktualisierung rückgängig machen

Wenn die Aktualisierung fehlschlägt, können Sie versuchen, das Problem zu beheben und update.sh dann noch einmal auszuführen. Sie können das Update mehrmals ausführen. Es wird dann an der Stelle fortgesetzt, an der es zuletzt beendet wurde.

Wenn Sie aufgrund des Fehlers das Update auf die vorherige Version zurücksetzen müssen, finden Sie unter 4.52.00 rückgängig machen eine detaillierte Anleitung.

Informationen zum Logging von Updates

Standardmäßig schreibt das Dienstprogramm update.sh Loginformationen an folgende Stellen:

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

Wenn die Person, die das update.sh-Dienstprogramm ausführt, keinen Zugriff auf dieses Verzeichnis hat, wird das Protokoll als Datei namens update_username.log in das Verzeichnis /tmp geschrieben.

Wenn Sie keinen Zugriff auf /tmp haben, schlägt das update.sh-Dienstprogramm 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 einem Upgrade ohne Ausfallzeit 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 wieder dem Load Balancer hinzu.

  1. Aktualisieren Sie die Maschinen in der richtigen Reihenfolge für Ihre Installation, wie unter Reihenfolge der Maschinenaktualisierung beschrieben.
  2. Wenn es an der Zeit ist, die Router zu aktualisieren, wählen Sie einen beliebigen Router aus und machen Sie ihn unerreichbar, wie unter Erreichbarkeit des Servers (Nachrichtenprozessor/Router) aktivieren/deaktivieren beschrieben.
  3. 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 Nachrichtenprozessor auf demselben Knoten an.
  4. Sorgen Sie dafür, dass der Router wieder erreichbar ist.
  5. Wiederholen Sie die Schritte 2 bis 4 für die übrigen Router.
  6. Fahren Sie mit dem Update für alle verbleibenden Computer in Ihrer Installation fort.

Beachten Sie vor und nach dem Update Folgendes:

Silent-Konfigurationsdatei verwenden

Sie müssen dem Befehl „update“ eine Konfigurationsdatei für die Installation ohne Benutzerinteraktion übergeben. Die stille Konfigurationsdatei muss dieselbe sein, die Sie für die Installation von Edge 4.50.00 oder 4.51.00 verwendet haben.

Auf einem Knoten mit einer externen Internetverbindung auf Version 4.52.02 aktualisieren

So aktualisieren Sie die Edge-Komponenten auf einem Knoten:

  1. Deaktivieren Sie gegebenenfalls alle cron-Jobs, die für die Ausführung eines Reparaturvorgangs auf Cassandra konfiguriert sind, bis das Update abgeschlossen ist.
  2. Melden Sie sich als Root auf Ihrem Knoten an, um die Edge-RPMs zu installieren.
  3. Installieren Sie yum-utils und yum-plugin-priorities: 
    sudo yum install yum-utils
sudo yum install yum-plugin-priorities
  4. Deaktivieren Sie SELinux wie unter Edge-Apigee-Einrichtungsprogramm installieren beschrieben.
  5. Wenn Sie die Installation unter Oracle 7.x ausführen, führen Sie den folgenden Befehl aus: 
    sudo yum-config-manager --enable ol7_optional_latest
  6. Wenn Sie die Installation in AWS ausführen, führen Sie die folgenden yum-configure-manager-Befehle aus: 
    yum update rh-amazon-rhui-client.noarch
sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional

  7. Wenn Sie derzeit Edge 4.51.00 verwenden:

    1. Laden Sie die Edge-bootstrap_4.52.02.sh-Datei auf /tmp/bootstrap_4.52.02.sh herunter: 
      curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
    2. Installieren Sie das Dienstprogramm apigee-service und die Abhängigkeiten für Edge 4.52.02 mit dem folgenden Befehl: 
      sudo bash /tmp/bootstrap_4.52.02.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, sie einzugeben.

      Standardmäßig prüft das Installationsprogramm, ob Java 1.8 installiert ist. Andernfalls wird sie vom Installationsprogramm für Sie installiert.

      Verwenden Sie die Option JAVA_FIX, um anzugeben, wie die Java-Installation erfolgen soll. JAVA_FIX kann folgende Werte haben:

      • I: OpenJDK 1.8 installieren (Standard).
      • C: Ohne Java fortfahren.
      • Q: Beenden Bei dieser Option müssen Sie Java selbst installieren.
    3. Verwenden Sie apigee-service, um das Dienstprogramm apigee-setup zu aktualisieren, wie im folgenden Beispiel gezeigt: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
    4. Aktualisieren Sie das apigee-validate-Dienstprogramm auf dem Verwaltungsserver, wie im folgenden Beispiel gezeigt: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
    5. Aktualisieren Sie das apigee-provision-Dienstprogramm auf dem Verwaltungsserver, wie im folgenden Beispiel gezeigt: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
    6. Führen Sie das Dienstprogramm update auf Ihren Knoten mit dem folgenden Befehl aus: 
      /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

      Gehen Sie dabei in der unter Reihenfolge der Maschinenaktualisierung beschriebenen Reihenfolge vor.

      Wobei:

      • component ist die Edge-Komponente, die aktualisiert werden soll. Mögliche Werte:
        • cs: Cassandra
        • edge: Alle Edge-Komponenten mit Ausnahme der Edge-Benutzeroberfläche: Verwaltungsserver, Nachrichtenprozessor, Router, Qpid-Server, Postgres-Server
        • ldap: OpenLDAP
        • ps: postgresql
        • qpid: qpidd
        • sso: Apigee SSO (falls Sie SSO installiert haben)
        • ue: Neue Edge-Benutzeroberfläche
        • ui: Klassische Edge-UI
        • zk: Zookeeper
      • configFile ist dieselbe Konfigurationsdatei, mit der Sie bei der Installation von 4.50.00 oder 4.51.00 Ihre Edge-Komponenten definiert haben.

      Sie können update.sh auf alle Komponenten anwenden, indem Sie component auf „alle“ festlegen. Das ist aber nur möglich, wenn Sie ein Edge-AIO-Installationsprofil (All-in-One) haben. Beispiel:

      /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
    7. Starten Sie die Edge-UI-Komponenten auf allen Knoten neu, auf denen sie ausgeführt werden, falls Sie dies noch nicht getan haben: 
      /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
    8. Testen Sie das Update, indem Sie das apigee-validate-Dienstprogramm auf dem Verwaltungsserver ausführen, wie unter Installation testen beschrieben.

Wenn Sie das Update später rückgängig machen möchten, folgen Sie der Anleitung unter 4.52.02 rückgängig machen.

Über ein lokales Repository auf Version 4.52.02 aktualisieren

Wenn sich Ihre Edge-Knoten hinter einer Firewall befinden oder anderweitig nicht über das Internet auf das Apigee-Repository zugreifen können, können Sie die Aktualisierung aus einem lokalen Repository oder einem Spiegel des Apigee-Repositories ausführen.#heading

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.52.02-Repository:

  1. Erstellen Sie ein lokales 4.52.02-Repository, wie unter Edge apigee-setup-Dienstprogramm installieren unter „Create a local Apigee repository“ (Lokales Apigee-Repository erstellen) beschrieben.
  2. 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.52.02.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 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.52.02.tar.gz

      Mit diesem Befehl wird im Verzeichnis mit der .tar-Datei ein neues Verzeichnis mit dem Namen repos erstellt. z. B. /tmp/repos.

    4. Installieren Sie das Edge-Dienstprogramm apigee-service und die Abhängigkeiten aus /tmp/repos: 
      sudo bash /tmp/repos/bootstrap_4.52.02.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

      Beachten Sie, dass Sie in diesem Befehl den Pfad zum Verzeichnis „repos“ angeben.

  3. So installieren Sie apigee-service mit dem Nginx-Webserver:
    1. Konfigurieren Sie den Nginx-Webserver wie unter Edge APIgee-Setup-Dienstprogramm installieren unter „Über das Repository mit dem Nginx-Webserver installieren“ beschrieben.
    2. Laden Sie auf dem Remote-Knoten die Edge-Datei bootstrap_4.52.02.sh in /tmp/bootstrap_4.52.02.sh herunter: 
      /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh

      Dabei sind uName:pWord der Nutzername und das Passwort, die Sie zuvor für das Repository festgelegt haben, und remoteRepo die IP-Adresse oder der DNS-Name des Repository-Knotens.

    3. Installieren Sie auf dem Remote-Knoten das Edge apigee-setup-Dienstprogramm und die Abhängigkeiten: 
      sudo bash /tmp/bootstrap_4.52.02.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

      Dabei sind uName:pWord der Nutzername und das Passwort für das Repository.

  4. Verwenden Sie apigee-service, um das Dienstprogramm apigee-setup zu aktualisieren, wie im folgenden Beispiel gezeigt: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  5. Aktualisieren Sie das apigee-validate-Dienstprogramm auf dem Verwaltungsserver, wie im folgenden Beispiel gezeigt: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  6. Aktualisieren Sie das apigee-provision-Dienstprogramm auf dem Verwaltungsserver, wie im folgenden Beispiel gezeigt: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  7. Führen Sie das update-Dienstprogramm auf Ihren Knoten in der in Reihenfolge der Aktualisierung von Computern beschriebenen Reihenfolge aus: 
    /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

    Wobei:

    • component ist die Edge-Komponente, die aktualisiert werden soll. Normalerweise aktualisieren Sie die folgenden Komponenten:
      • cs: Cassandra
      • edge: Alle Edge-Komponenten mit Ausnahme der Edge-Benutzeroberfläche: Verwaltungsserver, Nachrichtenprozessor, Router, Qpid-Server, Postgres-Server
      • ldap: OpenLDAP
      • ps: postgresql
      • qpid: qpidd
      • sso: Apigee SSO (falls Sie SSO installiert haben)
      • ue New Edge-Benutzeroberfläche
      • ui: Klassische Edge-Benutzeroberfläche
      • zk: Zookeeper
    • configFile ist dieselbe Konfigurationsdatei, mit der Sie bei der Installation von 4.50.00 oder 4.51.00 Ihre Edge-Komponenten definiert haben.

    Sie können update.sh auf alle Komponenten anwenden, indem Sie component auf „alle“ festlegen. Das ist aber nur möglich, wenn Sie ein Edge-AIO-Installationsprofil (All-in-One) haben. Beispiel:

    /opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config
  8. Starten Sie die UI-Komponenten auf allen Knoten neu, auf denen sie ausgeführt werden, falls Sie dies noch nicht getan haben: 
    /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
  9. Testen Sie das Update, indem Sie das apigee-validate-Dienstprogramm auf dem Verwaltungsserver ausführen, wie unter Installation testen beschrieben.

Wenn Sie das Update später rückgängig machen möchten, folgen Sie der Anleitung unter 4.52.02 rückgängig machen.

Reihenfolge der Maschinenaktualisierung – Upgrade von 4.51.00 (oder) 4.52.00 (oder) 4.52.01

Die Reihenfolge, in der Sie die Computer in einer Edge-Installation aktualisieren, ist wichtig:

  • Sie müssen alle ZooKeeper-Knoten in den Rechenzentren aktualisieren, bevor Sie alle anderen Komponenten aktualisieren. Wenn Sie von Edge Private Cloud 4.51.00 oder 4.52.00 auf eine neuere Version umstellen, müssen Sie auch ZooKeeper aktualisieren.
  • Sie müssen PostgreSQL in allen Rechenzentren aktualisieren. Wenn Sie von Edge Private Cloud 4.51.00 auf eine neuere Version umstellen, müssen Sie auch PostgreSQL aktualisieren.
  • Sie müssen die LDAP-Knoten in allen Rechenzentren aktualisieren.
  • Sie müssen alle Cassandra-, Management-Server-, Message Processor- und Routerknoten jeweils ein Rechenzentrum nach dem anderen aktualisieren, bis alle Rechenzentren aktualisiert sind.
  • Sie müssen die edge-qpid-server- und edge-postgres-server-Komponenten in allen Rechenzentren aktualisieren.
  • Sie müssen die Qpid-Knoten in allen Rechenzentren aktualisieren. Wenn Sie von Edge Private Cloud 4.51.00 oder 4.52.00 auf eine neuere Version umstellen, müssen Sie auch Qpid aktualisieren.
  • Aktualisieren Sie die Edge-Benutzeroberfläche und die neue Edge-Benutzeroberfläche sowie die SSO-Knoten in allen Rechenzentren.
  • Es gibt keinen separaten Schritt, um die Monetarisierung zu aktualisieren. Sie wird aktualisiert, wenn Sie die Option „-c edge“ angeben.

Eigenständiges Upgrade für 1 Knoten

So führen Sie ein Upgrade einer eigenständigen Konfiguration mit einem Knoten auf 4.52.02 durch:
  1. Alle Komponenten aktualisieren: 
    /opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
  2. (Wenn Sie apigee-adminapi installiert haben) Das Dienstprogramm apigee-adminapi wurde aktualisiert: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

Eigenständiges Upgrade mit zwei Knoten

Aktualisieren Sie die folgenden Komponenten für eine eigenständige Installation mit zwei Knoten:

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

  1. Aktualisieren Sie Zookeeper auf Computer 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile
  2. Aktualisieren Sie Postgres auf Computer 2: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. LDAP auf Computer 1 aktualisieren: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  4. Aktualisieren Sie Cassandra auf Computer 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  5. Aktualisieren Sie die Edge-Komponenten auf Computer 1 und 2: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. Qpid auf Computer 2 aktualisieren: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. Aktualisieren Sie die Benutzeroberfläche auf Computer 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  8. (Wenn Sie apigee-adminapi installiert haben) Aktualisieren Sie das apigee-adminapi-Dienstprogramm auf Computer 1: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  9. (Wenn Sie Apigee SSO installiert haben) Aktualisieren Sie Apigee SSO auf Computer 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    Dabei ist „sso_config_file“ die Konfigurationsdatei, die Sie beim Installieren von SSO erstellt haben.

  10. Starten Sie die Edge-UI-Komponente auf Computer 1 neu: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

Upgrade mit 5 Knoten

Aktualisieren Sie die folgenden Komponenten für eine Installation mit 5 Knoten:

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

  1. Aktualisieren Sie ZooKeeper auf den Maschinen 1, 2 und 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile
  2. Aktualisieren Sie Postgres auf Computer 4: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. Aktualisieren Sie Postgres auf Computer 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. LDAP auf Computer 1 aktualisieren: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Aktualisieren Sie Cassandra auf den Maschinen 1, 2 und 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  6. Aktualisieren Sie die Edge-Komponenten auf den Maschinen 1, 2, 3, 4 und 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. Qpid auf Computer 4 aktualisieren: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. Qpid auf Computer 5 aktualisieren: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  9. Edge-Benutzeroberfläche aktualisieren:
    • Klassische Benutzeroberfläche:Wenn Sie die klassische Benutzeroberfläche verwenden, aktualisieren Sie die ui-Komponente auf Computer 1, wie im folgenden Beispiel gezeigt: 
      /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
    • Neue Edge-Benutzeroberfläche:Wenn Sie die neue Edge-Benutzeroberfläche installiert haben, aktualisieren Sie die ue-Komponente auf dem entsprechenden Computer (muss nicht Computer 1 sein): 
      /opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
  10. (Wenn Sie apigee-adminapi installiert haben) Aktualisieren Sie das apigee-adminapi-Dienstprogramm auf Computer 1: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  11. (Wenn Sie Apigee SSO installiert haben) Aktualisieren Sie Apigee SSO auf Computer 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    Dabei ist sso_config_file die Konfigurationsdatei, die Sie beim Installieren von SSO erstellt haben.

  12. Starte die UI-Komponente neu:
    • Klassische Benutzeroberfläche:Wenn Sie die klassische Benutzeroberfläche verwenden, starten Sie die edge-ui-Komponente auf Computer 1 neu, wie im folgenden Beispiel gezeigt: 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • Neue Edge-Benutzeroberfläche:Wenn Sie die neue Edge-Benutzeroberfläche installiert haben, starten Sie die edge-management-ui-Komponente auf dem entsprechenden Computer neu (muss nicht Computer 1 sein): 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

Upgrade eines Clusters mit 9 Knoten

Aktualisieren Sie die folgenden Komponenten für eine Clusterinstallation mit 9 Knoten:

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

  1. Aktualisieren Sie ZooKeeper auf den Maschinen 1, 2 und 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile
  2. Aktualisieren Sie Postgres auf Computer 8: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. Postgres auf Computer 9 aktualisieren: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. LDAP auf Computer 1 aktualisieren: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Aktualisieren Sie Cassandra auf den Maschinen 1, 2 und 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  6. Aktualisieren Sie die Edge-Komponenten auf den Maschinen 1, 4, 5, 6, 7, 8 und 9 in dieser Reihenfolge: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. Aktualisieren Sie Qpid auf den Maschinen 6 und 7: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. Aktualisieren Sie entweder die neue Benutzeroberfläche (ue) oder die klassische Benutzeroberfläche (ui) auf Computer 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  9. (Wenn Sie apigee-adminapi installiert haben) Aktualisieren Sie das apigee-adminapi-Dienstprogramm auf Computer 1: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  10. (Wenn Sie Apigee SSO installiert haben) Aktualisieren Sie Apigee SSO auf Computer 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    Dabei ist sso_config_file die Konfigurationsdatei, die Sie beim Installieren von SSO erstellt haben.

  11. Starte die UI-Komponente neu:
    • Klassische Benutzeroberfläche:Wenn Sie die klassische Benutzeroberfläche verwenden, starten Sie die edge-ui-Komponente auf Computer 1 neu, wie im folgenden Beispiel gezeigt: 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • Neue Edge-Benutzeroberfläche:Wenn Sie die neue Edge-Benutzeroberfläche installiert haben, starten Sie die edge-management-ui-Komponente auf dem entsprechenden Computer neu (muss nicht Computer 1 sein): 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

Upgrade eines Clusters mit 13 Knoten

Aktualisieren Sie die folgenden Komponenten für eine Clusterinstallation mit 13 Knoten:

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

  1. Aktualisieren Sie ZooKeeper auf den Maschinen 1, 2 und 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile
  2. Aktualisieren Sie Postgres auf Computer 8: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. Postgres auf Computer 9 aktualisieren: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. Aktualisieren Sie LDAP auf den Maschinen 4 und 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Aktualisieren Sie Cassandra auf den Maschinen 1, 2 und 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  6. Aktualisieren Sie die Edge-Komponenten auf den Maschinen 6, 7, 10, 11, 12, 13, 8 und 9 in dieser Reihenfolge: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. Aktualisieren Sie Qpid auf den Maschinen 12 und 13: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. Aktualisieren Sie entweder die neue Benutzeroberfläche (ue) oder die klassische Benutzeroberfläche (ui) auf den Maschinen 6 und 7: 
    /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  9. (Wenn Sie apigee-adminapi installiert haben) Das apigee-adminapi-Dienstprogramm auf den Computern 6 und 7 aktualisiert: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  10. (Wenn Sie Apigee SSO installiert haben) Aktualisieren Sie Apigee SSO auf den Maschinen 6 und 7: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    Dabei ist sso_config_file die Konfigurationsdatei, die Sie beim Installieren von SSO erstellt haben.

  11. Starte die UI-Komponente neu:
    • Klassische Benutzeroberfläche:Wenn Sie die klassische Benutzeroberfläche verwenden, starten Sie die edge-ui-Komponente auf den Maschinen 6 und 7 neu, wie im folgenden Beispiel gezeigt: 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • Neue Edge-Benutzeroberfläche:Wenn Sie die neue Edge-Benutzeroberfläche installiert haben, starten Sie die edge-management-ui-Komponente auf den Computern 6 und 7 neu: 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

Upgrade eines Clusters mit 12 Knoten

Aktualisieren Sie die folgenden Komponenten für eine Clusterinstallation mit 12 Knoten:

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

  1. Aktualisieren Sie ZooKeeper auf den Maschinen 1, 2, 3, 7, 8 und 9 in beiden Rechenzentren:

    /opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile
  2. Aktualisieren Sie Postgres auf den Maschinen 6 und 12 in beiden Rechenzentren: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. Aktualisieren Sie LDAP auf den Maschinen 1 und 7 in beiden DCs: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

  4. Blockieren Sie den Traffic in DC-1 und sorgen Sie dafür, dass der gesamte Traffic an DC-2 weitergeleitet wird.

  5. Aktualisieren Sie Cassandra auf den Maschinen 1, 2 und 3 in DC-1: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  6. Aktualisieren Sie den Verwaltungsserver auf Computer 1 in DC-1: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. Router und Message Processor auf Maschine 2 und 3 in DC-1 aktualisieren: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  8. Heben Sie die Blockierung des Traffics in DC-1 auf, validieren Sie DC-1 und fahren Sie mit DC-2 fort, indem Sie den Traffic in DC-2 blockieren und den Traffic an DC-1 weiterleiten.
  9. Aktualisieren Sie Cassandra auf den Maschinen 7, 8 und 9 in DC-2: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  10. Aktualisieren Sie den Verwaltungsserver auf Computer 7 in DC-2: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  11. Router und Message Processor auf Maschine 8,9 in DC-2 aktualisieren: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  12. Heben Sie die Blockierung des Traffics in DC-2 auf. Jetzt wird der Traffic von beiden DCs verarbeitet.
  13. Führen Sie den Befehl „update“ noch einmal auf allen Verwaltungsservern in den DCs auf den Maschinen 1 und 7 aus: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  14. Aktualisieren Sie edge-qpid-server und edge-postgres-server auf den Maschinen 4, 5, 6, 10, 11 und 12 in beiden Rechenzentren: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  15. Aktualisieren Sie Qpid auf den Maschinen 4, 5, 10 und 11 in beiden DCs: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  16. Aktualisieren Sie entweder die neue Benutzeroberfläche (ue) oder die klassische Benutzeroberfläche (ui) in beiden Rechenzentren: 
    /opt/apigee/apigee-setup/bin/update.sh -c  [ui|ue] -f configFile
  17. (Wenn Sie apigee-adminapi installiert haben) Aktualisieren Sie apigee-adminapi in beiden DCs: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  18. (Wenn Sie Apigee SSO installiert haben) Aktualisieren Sie die Apigee SSO-Knoten in beiden DCs: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f configFile
  19. Starten Sie die neue Edge-Benutzeroberfläche (edge-management-ui) oder die klassische Edge-Benutzeroberfläche (edge-ui) in beiden DCs neu: 
    /opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart