Aktualisieren Sie Apigee Edge 4.51.00, 4.52.00 oder 4.52.01 auf 4.52.02

Apigee unterstützt ein Upgrade von Edge für Private Cloud direkt 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 durchführen.

Wer das Update durchführen kann

Die Person, die das Update ausführt, sollte 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, können sie von jedem konfiguriert werden.

Welche Komponenten müssen aktualisiert werden?

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

Voraussetzungen aktualisieren

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

  • Alle Knoten sichern
    Vor der Aktualisierung empfehlen wir aus Sicherheitsgründen, eine vollständige Sicherung aller Knoten durchzuführen. Verwenden Sie das Verfahren für Ihre aktuelle Version von Edge, um die Sicherung durchzuführen.

    Auf diese Weise erhalten Sie einen Sicherungsplan für den Fall, dass das Update auf eine neue Version nicht ordnungsgemäß funktioniert. Weitere Informationen zum Sichern 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 aktiv ist und ausgeführt wird: 
    /opt/apigee/apigee-service/bin/apigee-all status
  • Die Cassandra-Verdichtungsstrategie muss LeveledCompactionStrategy lauten.
    Die Cassandra-Verdichtungsstrategie muss auf LeveledCompactionStrategy festgelegt sein, wie unter Cassandra-Verdichtungsstrategie ändern beschrieben.

Spezielle Schritte bei der Umstellung

Wenn Sie ein Upgrade auf Edge für Private Cloud 4.52.02 durchführen 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 Software, die zusätzliche Schritte erfordert. Spätere Abschnitte auf dieser Seite enthalten ausführliche Diskussionen und genaue Schritte für jede Software.

Aktuelle Version Software, die besondere Schritte für das Upgrade auf 4.52.02 erfordert
4.52.01 Cassandra
4.52.00 Cassandra, Zookeeper, Qpid
4.51.00 Cassandra, Zookeeper, Qpid, Postgres

Automatische Weitergabe von Property-Einstellungen

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

Erforderliches Upgrade auf Cassandra 3.11.16

Apigee Edge für 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 Aktualisierungen der Treibersoftware in verschiedenen Laufzeit- und Verwaltungskomponenten, die zum Abfragen und Schreiben in Cassandra verwendet werden.

Da dies ein großes Upgrade ist, waren bestimmte Änderungen am Datenmodell von Apigee in Cassandra erforderlich, um eine optimale Leistung in neueren Versionen zu gewährleisten. Obwohl diese Änderungen minimal sind, werden durch den Upgradeprozess bestimmte Verwaltungs-APIs unterbrochen, was sich sowohl auf die Apigee-Benutzeroberfläche als auch auf das Entwicklerportal auswirkt. Im folgenden Dokument sind die genauen APIs aufgeführt, die nicht funktionieren. Außerdem werden die Schritte für das Upgrade zu Beginn und Ende der Unterbrechung beschrieben. Wichtig ist, dass der Laufzeittraffic während des Upgrades nicht unterbrochen wird.

High-Level-Rollback

Mit Cassandra wird jeweils nur ein Knoten aktualisiert. Sobald ein Knoten aktualisiert wird, werden bestimmte Schemaänderungen wirksam, für die kein direktes Rollback durchgeführt werden kann. Lesen Sie den Abschnitt zum Rollback sorgfältig, da je nachdem, wie viel des Clusters aktualisiert wurde, unterschiedliche Techniken verwendet werden können.

Wenn das Upgrade nach dem Upgrade des gesamten Cassandra-Clusters rückgängig gemacht werden muss, können Sie die Sicherungen wiederherstellen. Bereiten Sie sich darauf vor und machen Sie sich mit der Cassandra-Sicherungswiederherstellung vertraut. Wenn Sie Snapshots auf VM-Ebene schneller als Apigee-Sicherungen wiederherstellen können, verwenden Sie VM-Snapshots, um Ihre Cassandra-VMs in einen früheren Zustand wiederherzustellen.

Weitere Informationen finden Sie im Abschnitt Rollback des Updates für Cassandra 3.11.16.

APIs im Entwicklerportal dokumentieren

Das Apigee Drupal-Entwicklerportal bietet verschiedene Funktionen zum Dokumentieren Ihrer APIs. Es wird zwar empfohlen, von der Nutzung des auf Drupal 7 basierenden Entwicklerportals umzustellen. Wenn Sie es jedoch weiterhin und die zugehörige SmartDocs-Funktion nutzen, gilt das Dokument SmartDocs APIs verwenden für Sie. 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 API-Modelle, die mit der SmartDocs-Funktion des Drupal 7-Entwicklerportals erstellt wurden, nicht automatisch zur neueren Version migriert. Es wird erwartet, dass Sie jedes Modell manuell über das Entwicklerportal exportieren und nach Abschluss des Upgrades noch einmal importieren.

In den folgenden Abschnitten verwendete Terminologie

Laufzeit:Die Laufzeit umfasst die Verarbeitung Ihres Laufzeit-Proxy-Traffics. Sie umfasst alle Vorgänge, die von Ihren Routern und Message Processor 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 enthalten.

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

In jedem Schritt unten wird der Status von Laufzeit und Verwaltung beschrieben, während Sie die verschiedenen Phasen des Upgradeverfahrens durchlaufen. Das Upgrade hat keine Auswirkungen auf den Laufzeittraffic. Es kommt jedoch zu Störungen bei einigen Verwaltungs-APIs und den Funktionen des Entwicklerportals.

Schritt 0: Startstatus

  1. Cassandra in Apigee, ausgeführt mit Version 2.1.22.
  2. Edge für Komponenten der Private Cloud 4.52.02:
    • Management-Server, der mit Cassandra über ein älteres Secondhand-Protokoll kommuniziert
    • Laufzeitserver (Nachrichtenprozessoren und Router), die über ein älteres Secondhand-Protokoll mit Cassandra kommunizieren.
Laufzeitstatus in dieser Phase Verwaltungsstatus in dieser Phase
Laufzeit voll funktionsfähig Verwaltung voll funktionsfähig

Schritt 1: Umstellung vorbereiten

Die folgenden Schritte gelten zusätzlich zu den Standarddateien, die Sie normalerweise erstellen, z. B. der Standardkonfigurationsdatei von Apigee zum Aktivieren von Komponentenupgrades.

  1. Ändern Sie Cassandra in „LeveledCompactionStrategy“.
  2. Cassandra-Sicherung mit Apigee
  3. Erstellen Sie nach Möglichkeit VM-Snapshots von Cassandra-Knoten.
  4. Erstellen Sie auf jedem Cassandra-Knoten unter /opt/apigee/apigee-cassandra/cass_upgrade.conf eine Cassandra-Upgrade-Konfigurationsdatei mit folgendem 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.
  • Wenn Sie die SmartDocs-Funktion des Apigee Drupal 7-Entwicklerportals verwenden, exportieren Sie jedes Ihrer Modelle, indem Sie sie im JSON-Format von der Benutzeroberfläche des Entwicklerportals herunterladen. Diese Modelle müssen nach der Aktualisierung der Verwaltungsserver wieder in Apigee importiert werden.
  • Achten Sie darauf, dass die Ports 9160 und 9042 von allen Komponenten von Edge for Private Cloud 4.52.02 für Cassandra-Knoten zugänglich sind, sofern noch nicht vorhanden. Weitere Informationen finden Sie unter Portanforderungen.

Schritt 2: Alle Cassandra-Knoten upgraden

  1. Führen Sie ein Upgrade aller Cassandra-Knoten in allen Regionen nacheinander durch. Führen Sie auf jedem Knoten die folgenden Befehle aus: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  2. Nachdem ein Knoten aktualisiert wurde, führen Sie den folgenden Befehl auf dem Knoten aus, um einige Validierungen durchzuführen, bevor Sie fortfahren: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra validate_upgrade -f configFile
  3. Die Ausgabe des Beispiels sieht ungefähr 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
Laufzeitstatus in dieser Phase Verwaltungsstatus in dieser Phase
Laufzeit voll funktionsfähig Die folgende Verwaltungsfunktion wird nach dem Upgrade von Cassandra eingeschränkt:

Schritt 3: Alle Verwaltungsknoten upgraden

Führen Sie ein Upgrade aller Verwaltungsknoten in allen Regionen einzeln durch:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Laufzeitstatus Verwaltungsstatus
Laufzeit voll funktionsfähig Management API eingeschränkt:

Schritt 3a: [optional] SmartDocs importieren, die zuvor exportiert wurden

Sobald alle Verwaltungsserver aktualisiert wurden, können Sie die SmartDocs-Modelle importieren, die Sie in Schritt 1 exportiert haben. Sie können sich auch später dafür entscheiden.

Laufzeitstatus Verwaltungsstatus
Laufzeit voll funktionsfähig Verwaltung voll funktionsfähig

Schritt 4: Alle Laufzeitknoten aktualisieren

Führen Sie ein Upgrade aller Router und Message Processor-Knoten in allen Regionen nacheinander durch:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Laufzeitstatus Verwaltungsstatus
Laufzeit voll funktionsfähig Verwaltung voll funktionsfähig

Schritt 5: Alle verbleibenden Edge for Private Cloud 4.52.02-Komponenten upgraden

Führen Sie nacheinander ein Upgrade aller verbleibenden edge-qpid-server- und edge-postgres-server-Knoten in allen Regionen durch.

Wenn Sie zu diesem Zeitpunkt ein Upgrade von früheren Versionen als Edge for Private Cloud 4.52.01 ausführen und zusätzliche Schritte zum Upgrade von Qpid oder Postgres ausführen, folgen Sie den entsprechenden Schritten, um das Upgrade durchzuführen.

Laufzeitstatus Verwaltungsstatus
Laufzeit voll funktionsfähig Verwaltung voll funktionsfähig

Schritt 6: Schritte nach der Umstellung

Führen Sie nach Abschluss des Upgrades nacheinander auf jedem Cassandra-Knoten den folgenden Befehl aus:

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra post_upgrade

Führen Sie den folgenden Befehl aus, um alte, nicht verwendete Tabellen aus dem Cassandra-Cluster zu löschen. Bis dahin können bestimmte Funktionen von Cassandra (z. B. das Einrichten einer neuen Authentifizierung) nicht verwendet werden. Alte Authentifizierungsmechanismen funktionieren 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

Schließen Sie Schritt 3a ab, falls Sie dies noch nicht getan haben.

Laufzeitstatus Verwaltungsstatus
Laufzeit voll funktionsfähig Verwaltung voll funktionsfähig

Erforderliches Upgrade auf Zookeeper 3.8.3

Obwohl Edge für Private Cloud 4.52.02 kein Upgrade auf Zookeeper enthält, müssen Sie die Schritte zum Upgrade von Zookeeper ausführen, wenn Sie ein Upgrade von Versionen vor 4.52.01 durchführen.

  • Wenn Sie ein Upgrade von Edge for Private Cloud-Version 4.51.00 oder 4.52.00 ausführen, folgen Sie den Schritten unter Erforderliches Upgrade auf Zookeeper 3.8.3, um Zookeeper zu aktualisieren.
  • Wenn Sie ein Upgrade von Edge für Private Cloud-Version 4.52.01 ausführen, sollten Sie bereits Zookeeper-Version 3.8.3 verwenden und müssen keine besonderen Schritte für das Upgrade von Zookeeper ausführen.

Erforderliches Upgrade auf Postgres 14

  • Wenn Sie ein Upgrade von Edge für Private Cloud 4.51.00 auf 4.52.02 ausführen, müssen Sie die Schritte zum Upgrade von Postgres ausführen, auch wenn Edge für Private Cloud 4.52.02 kein Postgres-Upgrade enthält. Für ein Upgrade von Edge für 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 ein Upgrade von Edge für Private Cloud 4.52.00 oder 4.52.01 auf 4.52.02 ausführen, sind keine zusätzlichen Postgres-Upgradeschritte erforderlich.

Erforderliches Upgrade auf Qpid J-Broker

Obwohl Edge für Private Cloud 4.52.02 kein Upgrade auf QPID enthält, müssen Sie die Schritte zum Aktualisieren von QPID ausführen, wenn Sie ein Upgrade von Versionen vor 4.52.01 durchführen.

  • Wenn Sie ein Upgrade von Edge für Private Cloud 4.51.00 oder 4.52.00 auf 4.52.02 ausführen, müssen Sie zusätzliche QPID-Upgradeschritte ausführen. Lesen Sie den Abschnitt Upgrade von Qpid durchführen, wenn Sie ein Upgrade von Version 4.51.00 oder 4.52.00 auf 4.52.02 durchführen.
  • Wenn Sie ein Upgrade von Edge für Private Cloud 4.52.01 auf 4.52.02 ausführen, sollten Sie bereits die neueste Version von Qpid Broker verwenden. Es sind keine zusätzlichen QPID-Upgradeschritte erforderlich.

Neue Edge-Benutzeroberfläche

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

Installieren Sie die Edge-Benutzeroberfläche

Nachdem Sie die Erstinstallation abgeschlossen haben, empfiehlt Apigee die Installation der Edge-UI. Diese ist eine verbesserte Benutzeroberfläche für Entwickler und Administratoren von Apigee Edge für Private Cloud.

Beachten Sie, dass Sie für die Edge-Benutzeroberfläche die Basisauthentifizierung deaktivieren und einen IdP wie SAML oder LDAP verwenden müssen.

Weitere Informationen finden Sie unter Installieren der neuen Edge-Benutzeroberfläche.

Aktualisieren der Edge-Benutzeroberfläche

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

Mit Apigee mTLS aktualisieren

Führen Sie die folgenden Schritte aus , um Apigee mTLS zu aktualisieren:

Aktualisierung rückgängig machen

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

Falls für den Fehler ein Rollback des Updates auf die vorherige Version durchgeführt werden muss, finden Sie unter Rollback für Version 4.52.00 eine ausführliche Anleitung.

Informationen zu Logging-Updates

Standardmäßig schreibt das Dienstprogramm update.sh Loginformationen in:

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

Wenn die Person, die das Dienstprogramm update.sh ausführt, keinen Zugriff auf dieses Verzeichnis hat, wird das Log als Datei mit dem Namen update_username.log in das Verzeichnis /tmp geschrieben.

Wenn die Person 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 aktualisieren, ohne Edge herunterzufahren.

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 dem Load-Balancer zu entfernen. Anschließend aktualisieren Sie den Router und alle anderen Komponenten auf demselben Computer wie der Router und fügen den Router dann wieder dem Load-Balancer hinzu.

  1. Aktualisieren Sie die Computer in der richtigen Reihenfolge für Ihre Installation, wie unter Reihenfolge des Maschinenupdates beschrieben.
  2. 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 Erreichbarkeit des Servers (Nachrichtenprozessor/Routers) 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 Message Processor 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 verbleibenden Router.
  6. Setzen Sie das Update für alle verbleibenden Maschinen in Ihrer Installation fort.

Achten Sie vor und nach dem Update auf Folgendes:

Konfigurationsdatei im Hintergrund verwenden

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

Update auf 4.52.02 auf einem Knoten mit externer Internetverbindung

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

  1. Deaktivieren Sie gegebenenfalls alle cron-Jobs, die für die Ausführung eines Reparaturvorgangs in Cassandra konfiguriert sind, bis die Aktualisierung abgeschlossen ist.
  2. Melden Sie sich als Root beim 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-Setup-Dienstprogramm installieren beschrieben.
  5. Wenn Sie Oracle 7.x installieren, führen Sie den folgenden Befehl aus: 
    sudo yum-config-manager --enable ol7_optional_latest
  6. Wenn Sie in AWS installieren, 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 in /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 für Edge 4.52.02 und die Abhängigkeiten, indem Sie den folgenden Befehl ausführen: 
      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, ihn einzugeben.

      Standardmäßig überprüft das Installationsprogramm, ob bei Ihnen Java 1.8 installiert ist. Andernfalls installiert das Installationsprogramm es für Sie.

      Mit der Option JAVA_FIX können Sie angeben, wie die Java-Installation verarbeitet werden soll. JAVA_FIX verwendet die folgenden Werte:

      • I: Installieren Sie OpenJDK 1.8 (Standardeinstellung).
      • C: Fahren Sie fort, ohne Java zu installieren.
      • Q: Beenden. Für diese Option müssen Sie Java selbst installieren.
    3. Verwenden Sie apigee-service, um das Dienstprogramm apigee-setup wie im folgenden Beispiel zu aktualisieren: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
    4. Aktualisieren Sie das Dienstprogramm apigee-validate auf dem Verwaltungsserver wie im folgenden Beispiel gezeigt: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
    5. Aktualisieren Sie das Dienstprogramm apigee-provision 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

      Führen Sie die Schritte in der unter Reihenfolge des Maschinenupdates beschriebenen Reihenfolge aus.

      Wobei:

      • component ist die zu aktualisierende Edge-Komponente. Zulässige Werte:
        • cs: Cassandra
        • edge: Alle Edge-Komponenten außer Edge-UI: Verwaltungsserver, Nachrichtenprozessor, Router, QPID-Server, Postgres-Server
        • ldap: OpenLDAP
        • ps: postgresql
        • qpid: qpidd
        • sso: Apigee-SSO (wenn Sie SSO installiert haben)
        • ue: Neue Edge-Benutzeroberfläche
        • ui: Klassische Edge-Benutzeroberfläche
        • zk: Zoowärter
      • configFile ist dieselbe Konfigurationsdatei, mit der Sie während der Installation von Version 4.50.00 oder 4.51.00 Ihre Edge-Komponenten definiert haben.

      Sie können update.sh für alle Komponenten ausführen, indem Sie component auf „alle“ setzen. Dies ist jedoch nur möglich, wenn Sie ein Edge All-in-one-Installationsprofil (AIO) haben. Beispiel:

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

Wenn Sie sich später für ein Rollback der Aktualisierung entscheiden, gehen Sie wie unter Rollback für Version 4.52.02 beschrieben vor.

Von einem lokalen Repository auf 4.52.02 aktualisieren

Wenn sich Ihre Edge-Knoten hinter einer Firewall befinden oder aus einem anderen Grund nicht über das Internet auf das Apigee-Repository zugegriffen werden kann, können Sie die Aktualisierung von einem lokalen Repository oder einem Spiegel des Apigee-Repositorys durchführen.

Nachdem Sie ein lokales Edge-Repository erstellt haben, haben Sie zwei Möglichkeiten, Edge über das lokale Repository zu aktualisieren:

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

So führen Sie eine Aktualisierung von einem lokalen 4.52.02-Repository aus:

  1. Erstellen Sie ein lokales 4.52.02-Repository, wie unter "Lokales Apigee-Repository erstellen" unter Edge-Apigee-Setup-Dienstprogramm installieren beschrieben.
  2. So installieren Sie den Apigee-Dienst aus einer TAR-Datei:
    1. Verwenden Sie auf dem Knoten mit dem lokalen Repository den folgenden Befehl, um das lokale Repository in eine einzelne TAR-Datei mit dem Namen /opt/apigee/data/apigee-mirror/apigee-4.52.02.tar.gz zu verpacken: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
    2. Kopieren Sie die TAR-Datei in den Knoten, auf dem Sie Edge aktualisieren möchten. Kopieren Sie ihn beispielsweise in das Verzeichnis /tmp auf dem neuen Knoten.
    3. Entpacken Sie auf dem neuen Knoten die Datei im Verzeichnis /tmp: 
      tar -xzf apigee-4.52.02.tar.gz

      Mit diesem Befehl wird ein neues Verzeichnis namens repos in dem Verzeichnis erstellt, das die TAR-Datei enthält. z. B. /tmp/repos.

    4. Installieren Sie das Edge-Dienstprogramm apigee-service und die Abhängigkeiten über /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 Repository-Verzeichnis angeben.

  3. So installieren Sie den Apigee-Dienst mit dem Nginx-Webserver:
    1. Konfigurieren Sie den Nginx-Webserver wie unter „Installation aus dem Repository mithilfe des Nginx-Webservers“ unter Installieren des Edge-Apigee-Setup-Dienstprogramms beschrieben.
    2. Laden Sie auf dem Remote-Knoten die Edge-Datei bootstrap_4.52.02.sh nach /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 ist 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-Dienstprogramm apigee-setup 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 des Repositorys.

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

    Wobei:

    • component ist die zu aktualisierende Edge-Komponente. In der Regel aktualisieren Sie die folgenden Komponenten:
      • cs: Cassandra
      • edge: Alle Edge-Komponenten außer Edge-UI: Verwaltungsserver, Nachrichtenprozessor, Router, QPID-Server, Postgres-Server
      • ldap: OpenLDAP
      • ps: postgresql
      • qpid: qpidd
      • sso: Apigee-SSO (wenn Sie SSO installiert haben)
      • ue Neue Edge-Benutzeroberfläche
      • ui: Klassische Edge-Benutzeroberfläche
      • zk: Zoowärter
    • configFile ist dieselbe Konfigurationsdatei, mit der Sie während der Installation von Version 4.50.00 oder 4.51.00 Ihre Edge-Komponenten definiert haben.

    Sie können update.sh für alle Komponenten ausführen, indem Sie component auf „alle“ setzen. Dies ist jedoch nur möglich, wenn Sie ein Edge All-in-one-Installationsprofil (AIO) 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, die sie ausführen, falls noch nicht geschehen: 
    /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
  9. Testen Sie das Update, indem Sie das Dienstprogramm apigee-validate auf dem Verwaltungsserver ausführen, wie unter Installation testen beschrieben.

Wenn Sie sich später für ein Rollback der Aktualisierung entscheiden, gehen Sie wie unter Rollback für Version 4.52.02 beschrieben vor.

Reihenfolge des Maschinenupdates

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

  • Sie müssen alle Cassandra- und ZooKeeper-Knoten aktualisieren, bevor Sie andere Knoten aktualisieren.
  • Verwenden Sie für alle Maschinen mit mehreren Edge-Komponenten (Verwaltungsserver, Message Processor, Router, QPID-Server, aber nicht Postgres Server) die Option -c edge, um alle gleichzeitig zu aktualisieren.
  • Wenn ein Schritt angibt, dass er auf mehreren Rechnern ausgeführt werden soll, führen Sie ihn in der angegebenen Maschinenreihenfolge aus.
  • Es gibt keinen separaten Schritt, um die Monetarisierung zu aktualisieren. Sie wird aktualisiert, wenn Sie die Option -c edge angeben.

Eigenständiges Upgrade mit 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 2 Knoten

Aktualisieren Sie bei einer eigenständigen Installation mit zwei Knoten die folgenden Komponenten:

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

  1. Cassandra und ZooKeeper auf Computer 1 aktualisieren: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Postgres auf Computer 2 aktualisieren: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. LDAP auf Gerät 1 aktualisieren: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  4. Aktualisieren Sie die Edge-Komponenten auf Rechner 2 und 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  5. Qpid auf Computer 2 aktualisieren: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  6. Aktualisieren Sie die UI auf Gerät 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  7. (Wenn Sie apigee-adminapi installiert haben) Das Dienstprogramm apigee-adminapi auf Computer 1 wurde aktualisiert: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  8. (Wenn Sie Apigee-SSO installiert haben) Aktualisieren Sie die Apigee-SSO auf Maschine 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    Dabei ist sso_config_file die Konfigurationsdatei, die Sie bei der Installation der SSO erstellt haben.

  9. 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 bei einer Installation mit fünf Knoten die folgenden Komponenten:

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

  1. Aktualisieren Sie Cassandra und ZooKeeper auf Computer 1, 2 und 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Postgres auf Computer 4 aktualisieren: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. Postgres auf Computer 5 aktualisieren: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. LDAP auf Gerät 1 aktualisieren: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Aktualisieren Sie Edge-Komponenten auf Maschine 4, 5, 1, 2, 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. Qpid auf Computer 4 aktualisieren: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. Qpid auf Computer 5 aktualisieren: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. Aktualisieren Sie die Edge-Benutzeroberfläche:
    • Klassische UI: Wenn Sie die klassische UI verwenden, aktualisieren Sie die Komponente ui 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 (nicht Computer 1): 
      /opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
  9. (Wenn Sie apigee-adminapi installiert haben) Das Dienstprogramm apigee-adminapi auf Computer 1 wurde aktualisiert: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  10. (Wenn Sie Apigee-SSO installiert haben) Aktualisieren Sie die Apigee-SSO auf Maschine 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    Dabei ist sso_config_file die Konfigurationsdatei, die Sie bei der Installation der SSO erstellt haben.

  11. Starten Sie die UI-Komponente neu:
    • Klassische UI: Wenn Sie die klassische UI verwenden, starten Sie die Komponente edge-ui 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 (möglicherweise nicht Computer 1): 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

Clusterupgrade mit 9 Knoten

Aktualisieren Sie bei einer Installation mit 9 Knoten die folgenden Komponenten:

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

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

    Dabei ist sso_config_file die Konfigurationsdatei, die Sie bei der Installation der SSO erstellt haben.

  10. Starten Sie die UI-Komponente neu:
    • Klassische UI: Wenn Sie die klassische UI verwenden, starten Sie die Komponente edge-ui 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 (möglicherweise nicht Computer 1): 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

Clusterupgrade mit 13 Knoten

Aktualisieren Sie bei einer Installation mit 13 Knoten die folgenden Komponenten:

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

  1. Aktualisieren Sie Cassandra und ZooKeeper auf den Computern 1, 2 und 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Postgres auf Computer 8 aktualisieren: 
    /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 Gerät 4 und 5 aktualisieren: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Aktualisieren Sie die Edge-Komponenten auf den Maschinen 12, 13, 8, 9, 6, 7, 10 und 11 in dieser Reihenfolge: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. Qpid auf den Geräten 12 und 13 aktualisieren: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. Aktualisieren Sie entweder die neue UI (ue) oder die klassische UI (ui) auf den Maschinen 6 und 7: 
    /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  8. (Wenn Sie apigee-adminapi installiert haben) Das Dienstprogramm apigee-adminapi auf den Maschinen 6 und 7 wurde aktualisiert: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  9. (Wenn Sie Apigee-SSO installiert haben) Aktualisieren Sie die Apigee-SSO auf den Computern 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 bei der Installation der SSO erstellt haben.

  10. Starten Sie die UI-Komponente neu:
    • Klassische UI: Wenn Sie die klassische UI verwenden, starten Sie die Komponente edge-ui 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 Komponente edge-management-ui auf den Computern 6 und 7 neu: 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

Clusterupgrade mit 12 Knoten

Aktualisieren Sie bei einer Installation mit 12 Knoten die folgenden Komponenten:

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

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

      3. Dabei ist sso_config_file die Konfigurationsdatei, die Sie bei der Installation der SSO erstellt haben.

  9. Starten Sie die neue Edge-UI-Komponente (edge-management-ui) oder die klassische Edge-UI-Komponente (edge-ui) auf den Computern 1 und 7 neu: 
    /opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart

Für eine nicht standardmäßige Konfiguration

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

  1. ZooKeeper
  2. Cassandra
  3. ps
  4. LDAP
  5. Edge, d. h. das Profil „-c Edge“ auf allen Knoten in der Reihenfolge: Knoten mit Qpid-Server, Edge Postgres-Server, Verwaltungsserver, Message Processor und Router.
  6. QPID
  7. Edge-Benutzeroberfläche (entweder klassisch oder neu)
  8. apigee-adminapi
  9. Apigee-SSO

Achten Sie nach dem Update darauf, die Edge-UI-Komponente auf allen Rechnern neu zu starten, auf denen sie ausgeführt wird.