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.

  • 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:
    /opt/apigee/apigee-service/bin/apigee-all status
  • Darauf achten, dass die Cassandra-Verdichtungsstrategie LeveledCompactionStrategy
    ist 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 durch, 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, Führen Sie einen Export Ihrer Modelle durch, 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 Weitere Informationen zu den 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 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

Nach Abschluss der Erstinstallation empfiehlt Apigee die Installation der Edge-Benutzeroberfläche, eine verbesserte Benutzeroberfläche für Entwickler und Administratoren von Apigee Edge for Private Cloud.

Beachten Sie, dass Sie für die Edge-Benutzeroberfläche die Basisauthentifizierung deaktivieren und ein IDP, z. B. SAML oder LDAP.

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, die Sie ein Upgrade ausführen von:

Mit Apigee mTLS aktualisieren

So aktualisieren Sie Apigee mTLS: Schritte:

Aktualisierung rückgängig machen

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

Wenn aufgrund des Fehlers ein Rollback des Updates auf die vorherige Version durchgeführt werden muss, lesen Sie den Abschnitt Für detaillierte Anleitungen kannst du ein Rollback auf Version 4.52.00 durchführen.

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 schreibt er das Protokoll ins Verzeichnis /tmp als Datei namens update_username.log

Wenn die Person keinen Zugriff auf /tmp hat, gibt das update.sh-Dienstprogramm 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.

  1. Aktualisieren Sie die Computer wie beschrieben in der richtigen Reihenfolge für Ihre Installation. Reihenfolge des Maschinenupdates.
  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 Server aktivieren/deaktivieren Erreichbarkeit (Message Processor/Router).
  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 dieselbe sein, die Sie bei der Installation von Edge 4.50.00 oder 4.51.00 verwendet haben.

Aktualisieren 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 alle cron-Jobs, die für die Ausführung eines Reparaturvorgangs konfiguriert sind (falls vorhanden). Cassandra, bis das Update 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 Installation von das Dienstprogramm „Edge Apigee-Setup“.
  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 auf AWS installieren, führen Sie folgenden Befehl aus: yum-configure-manager-Befehle:
    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-Datei bootstrap_4.52.02.sh herunter in /tmp/bootstrap_4.52.02.sh:
      curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
    2. Installieren Sie das Edge 4.52.02-Dienstprogramm apigee-service und die Abhängigkeiten, indem Sie und führen Sie den folgenden Befehl aus:
      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. Wenn Sie dies nicht tun, installiert.

      Mit der Option JAVA_FIX können Sie festlegen, wie die Verarbeitung erfolgen soll. Java-Installation. 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 zu aktualisieren, da: Folgendes Beispiel zeigt:
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
    4. Aktualisieren Sie das Dienstprogramm apigee-validate auf dem Verwaltungsserver so: Das Beispiel zeigt:
      /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
    5. Aktualisieren Sie das Dienstprogramm apigee-provision auf dem Verwaltungsserver so: Das Beispiel zeigt:
      /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 im Abschnitt Reihenfolge des Geräts beschriebenen Reihenfolge durch“ aus. aktualisieren.

      Wobei:

      • component ist die zu aktualisierende Edge-Komponente. Mögliche Werte sind:
        • cs: Cassandra
        • edge: Alle Edge-Komponenten außer Edge-UI: Verwaltungsserver, Nachricht Prozessor, 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, die Sie zuvor verwendet haben. definiere deine Kante während der Installation von Version 4.50.00 oder 4.51.00.

      Sie können update.sh für alle Komponenten ausführen, indem Sie component festlegen auf „all“ festlegen, aber nur, wenn Sie ein Edge all-in-one (AIO)-Installationsprofil haben. Beispiel:

      /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
    7. Starten Sie die Edge-Benutzeroberflächenkomponente 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 apigee-validate-Dienstprogramm unter „Verwaltung“ ausführen Server, wie unter Installation testen beschrieben.

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

Von einem lokalen Repository auf 4.52.02 aktualisieren

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 aus einem lokalen Repository 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 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“ beschrieben bei Installieren Sie das Dienstprogramm Edge für die Einrichtung von Apigee.
  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 zu verpacken in eine einzelne TAR-Datei mit dem Namen /opt/apigee/data/apigee-mirror/apigee-4.52.02.tar.gz auf:
      /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. Sie können sie zum Beispiel das Verzeichnis /tmp auf dem neuen Knoten.
    3. Entpacken Sie die Datei auf dem neuen Knoten im Verzeichnis /tmp:
      tar -xzf apigee-4.52.02.tar.gz

      Mit diesem Befehl wird ein neues Verzeichnis namens repos im Verzeichnis erstellt mit der TAR-Datei. 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 Repository-Verzeichnis angeben.

  3. So installieren Sie den Apigee-Dienst mit dem Nginx-Webserver:
    1. Konfigurieren Sie den Nginx-Webserver wie unter „Aus dem Repository mithilfe von Nginx installieren“ beschrieben. Webserver unter Install the Edge apigee-setup-Dienstprogramm.
    2. Laden Sie auf dem Remote-Knoten die Edge-Datei bootstrap_4.52.02.sh herunter, um /tmp/bootstrap_4.52.02.sh:
      /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 und remoteRepo ist 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 zu aktualisieren, da: Folgendes Beispiel zeigt:
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update 
  5. Aktualisieren Sie das Dienstprogramm apigee-validate auf dem Verwaltungsserver so: Das Beispiel zeigt:
    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  6. Aktualisieren Sie das Dienstprogramm apigee-provision auf dem Verwaltungsserver so: Das Beispiel zeigt:
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  7. Führen Sie das Dienstprogramm update auf Ihren Knoten in der im folgenden Abschnitt beschriebenen Reihenfolge aus: Reihenfolge des Maschinenupdates:
    /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

    Wobei:

    • component ist die zu aktualisierende Edge-Komponente. In der Regel aktualisieren Sie 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, die Sie zuvor verwendet haben. Edge-Komponenten definieren während der Installation von Version 4.50.00 oder 4.51.00.

    Sie können update.sh für alle Komponenten ausführen, indem Sie component festlegen auf „all“ festlegen, aber nur, wenn Sie ein Edge all-in-one (AIO)-Installationsprofil 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 wird, 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 unter „Verwaltung“ ausführen Server, wie unter Installation testen beschrieben.

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

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 irgendwelche anderen Knoten.
  • Für jede Maschine mit mehreren Edge-Komponenten (Verwaltungsserver, Nachrichtenprozessor, Router, QPID-Server, aber nicht Postgres-Server), verwenden Sie zum Aktualisieren die Option -c edge. alle gleichzeitig.
  • Wenn ein Schritt angibt, dass er auf mehreren Rechnern ausgeführt werden soll, führen Sie ihn im angegebene Reihenfolge der Maschine.
  • Es gibt keinen separaten Schritt, um die Monetarisierung zu aktualisieren. Sie wird aktualisiert, wenn Sie die Option -c edge.

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. Aktualisieren Sie alle Komponenten:
    /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 Maschine 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. Aktualisieren Sie Qpid auf Computer 2:
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  6. Aktualisieren Sie die Benutzeroberfläche auf Computer 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 Erstellung installierte Einmalanmeldung (SSO).

  9. Starten Sie die Edge-Benutzeroberflächenkomponente auf Maschine 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 Maschine 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 die Edge-Komponenten auf Rechner 4, 5, 1, 2, 3:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. Aktualisieren Sie Qpid auf Computer 4:
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. Aktualisieren Sie Qpid auf Computer 5:
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. Aktualisieren Sie die Edge-Benutzeroberfläche:
    • Klassische Benutzeroberfläche: Wenn Sie die klassische Benutzeroberfläche verwenden, aktualisieren Sie die ui-Komponente auf Maschine 1, wie das folgende Beispiel zeigt:
      /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 Maschine 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 Erstellung installierte Einmalanmeldung (SSO).

  11. Starten Sie die UI-Komponente neu:
    • Klassische Benutzeroberfläche: Wenn Sie die klassische Benutzeroberfläche verwenden, starten Sie die edge-ui-Komponente auf Maschine 1, wie das folgende Beispiel zeigt:
      /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 den edge-management-ui-Komponente auf dem entsprechenden Gerät (möglicherweise keine 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 Computer 1:
    /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -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 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 Erstellung installierte Einmalanmeldung (SSO).

  10. Starten Sie die UI-Komponente neu:
    • Klassische Benutzeroberfläche: Wenn Sie die klassische Benutzeroberfläche verwenden, starten Sie das edge-ui-Komponente auf Maschine 1, wie das folgende Beispiel zeigt:
      /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 den edge-management-ui-Komponente auf dem entsprechenden Gerät (möglicherweise keine 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äten 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. Aktualisieren Sie die Qpid auf den Geräten 12 und 13:
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. Aktualisieren Sie entweder die neue Benutzeroberfläche (ue) oder die klassische Benutzeroberfläche (ui) auf den Computern 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 wurde auf den Maschinen 6 und 7 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 Erstellung installierte Einmalanmeldung (SSO).

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

Clusterupgrade mit 12 Knoten

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

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

  1. Aktualisieren Sie Cassandra und ZooKeeper:
    1. Auf den Geräten 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. Postgres aktualisieren:
    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. LDAP aktualisieren:
    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. qpidd aktualisieren:
    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 Benutzeroberfläche (ue) oder die klassische Benutzeroberfläche (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 Erstellung installierte Einmalanmeldung (SSO).

  9. Starten Sie die neue Edge-Benutzeroberfläche (edge-management-ui) oder die klassische Edge-Benutzeroberfläche neu. (edge-ui)-Komponente der Rechner 1 und 7:
    /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 wie folgt Auftrag:

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

Nachdem Sie das Update abgeschlossen haben, müssen Sie die Edge-Benutzeroberflächenkomponente auf allen laufenden Rechnern neu starten .