Aktualisieren Sie Apigee Edge 4.19.06 oder 4.50.00 auf 4.51.00.

In diesem Abschnitt wird beschrieben, wie Sie ein Upgrade von Apigee Edge 4.19.06 oder 4.50.00 auf 4.51.00 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 ein Person, die als Root tätig ist.

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 enthält aus verschiedenen Versionen.

Automatische Weitergabe von Property-Einstellungen

Wenn Sie Eigenschaften durch Bearbeiten von .properties-Dateien festgelegt haben in /opt/apigee/customer/application verwenden, werden diese Werte bei der Aktualisierung beibehalten.

Erforderliches Upgrade auf Postgres 10.17

Diese Version von Edge enthält ein Upgrade auf Postgres 10.17. Im Rahmen dieser Umstellung Postgres-Daten werden zu Postgres 10.17 migriert.

Die meisten Edge-Produktionssysteme verwenden zwei Postgres-Knoten, die für die Master-Standby-Replikation konfiguriert sind. Während des Aktualisierungsprozesses, während die Postgres-Knoten für die Aktualisierung nicht verfügbar sind, sind die Analysedaten immer noch in die Qpid-Knoten geschrieben. Nachdem die Postgres-Knoten aktualisiert wurden und wieder online sind, werden die auf die Postgres-Knoten übertragen.

Wie Sie die Postgres-Aktualisierung durchführen, hängt davon ab, wie Sie die Datenspeicherung für Ihr Postgres-Knoten:

  • Wenn Sie lokalen Datenspeicher für Ihre Postgres-Knoten verwenden, müssen Sie einen neuen Postgres-Standby-Knoten für die Dauer des Upgrades installieren Nach dem abgeschlossen ist, können Sie den neuen Postgres-Standby-Knoten außer Betrieb nehmen.

    Der zusätzliche Postgres-Standby-Knoten ist erforderlich, wenn Sie für das Update ein Rollback durchführen müssen egal aus welchem Grund. Wenn Sie für das Update ein Rollback durchführen müssen, wird der neue Postgres-Standby-Knoten wird nach dem Rollback zum Master-Postgres-Knoten. Daher sollten Sie bei der Installation des neuer Postgres-Standby-Knoten befindet, sollte er sich auf einem Knoten befinden, der die gesamte Hardware Anforderungen eines Postgres-Servers, wie im Edge- Voraussetzungen für die Installation

    In einer Konfiguration mit einem und zwei Knoten von Edge, Topologien, die für Prototyping und Tests verwendet werden, nur einen Postgres-Knoten haben. Sie können diese Postgres-Knoten direkt aktualisieren, um einen neuen Postgres-Knoten zu erstellen.

  • Wenn Sie Netzwerkspeicher für Ihre Postgres-Knoten verwenden, wie empfohlen wird, müssen Sie keinen neuen Postgres-Knoten installieren. Im können Sie die Schritte zum Installieren und zur späteren Außerbetriebnahme eines neuen Postgres-Standby-Knoten.

    Bevor Sie mit dem Aktualisierungsprozess beginnen, erstellen Sie einen Netzwerk-Snapshot des Datenspeichers, der von Postgres. Wenn dann während der Aktualisierung Fehler auftreten und Sie zu einem Rollback gezwungen werden, können Sie den Postgres-Knoten aus diesem Snapshot wiederherstellen.

Neues Postgres installieren Standby-Knoten

Mit diesem Verfahren wird ein Postgres-Standby-Server auf einem neuen Knoten erstellt. Installieren Sie ein neues Postgres-Standby-Server für Ihre vorhandene Version von Edge (4.19.06 oder 4.50.00), nicht für Version 4.51.00.

Verwenden Sie für die Installation dieselbe Konfigurationsdatei, die Sie bei der Installation der aktuellen Version verwendet haben. von Edge.

So erstellen Sie einen neuen Postgres-Standby-Knoten:

  1. Bearbeiten Sie im aktuellen Postgres-Master den /opt/apigee/customer/application/postgresql.properties. -Datei, um das folgende Token festzulegen. Sollte die Datei nicht vorhanden sein, erstellen Sie sie:
    conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust\ \nhost replication apigee new_standby_ip/32 trust

    Dabei ist existing_standby_ip die IP-Adresse des aktuellen Postgres. Standby-Server und new_standby_ip ist die IP-Adresse des neuen Standby-Knotens.

  2. Starten Sie apigee-postgresql auf dem Postgres-Master neu:
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
  3. Überprüfen Sie in der /opt/apigee/apigee-postgresql/conf/pg_hba.conf-Datei auf dem Master. Sie sollten Folgendes sehen: die folgenden Zeilen in diese Datei:
    host replication apigee existing_standby_ip/32 trust
    host replication apigee new_standby_ip/32 trust
  4. Installieren Sie den neuen Postgres-Standby-Server: <ph type="x-smartling-placeholder">
      </ph>
    1. Bearbeiten Sie die Konfigurationsdatei, die Sie zum Installieren der aktuellen Version von Edge verwendet haben, um anzugeben, Folgendes:
      # IP address of the current master:
      PG_MASTER=192.168.56.103
      # IP address of the new standby node
      PG_STANDBY=192.168.56.102
    2. Deaktivieren Sie SELinux wie in Installieren Sie das Dienstprogramm Edge für die Einrichtung von Apigee.
    3. Führen Sie einen der folgenden Schritte aus, je nachdem, von welcher Edge-Version Sie ein Upgrade ausführen: <ph type="x-smartling-placeholder">
        </ph>
      • Wenn Sie ein Upgrade von Edge 4.19.06 ausführen, die Datei Edge bootstrap_4.19.06.sh in /tmp/bootstrap_4.19.06.sh :
        curl https://software.apigee.com/bootstrap_4.19.06.sh -o /tmp/bootstrap_4.19.06.sh

        Installieren Sie als Nächstes das Edge-Dienstprogramm apigee-service und die Abhängigkeiten:

        sudo bash /tmp/bootstrap_4.19.06.sh apigeeuser=uName apigeepassword=pWord
      • Wenn Sie ein Upgrade von Edge 4.50.00 ausführen, die Datei Edge bootstrap_4.50.00.sh in /tmp/bootstrap_4.50.00.sh :
        curl https://software.apigee.com/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.00.sh

        Installieren Sie als Nächstes das Edge-Dienstprogramm apigee-service und die Abhängigkeiten:

        sudo bash /tmp/bootstrap_4.50.00.sh apigeeuser=uName apigeepassword=pWord
    4. Verwenden Sie apigee-service, um das apigee-setup-Dienstprogramm zu installieren:
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    5. Installieren Sie Postgres:
      /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
    6. Führen Sie auf dem neuen Standby-Knoten den folgenden Befehl aus:
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      Prüfen Sie, ob es sich um den Standby-Modus handelt.

Direktes Upgrade von Postgres ausführen

Führen Sie die folgenden Schritte aus, um ein direktes Upgrade auf Postgres 10.17 durchzuführen:

  1. Postgres auf dem Master-Host aktualisieren
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
  2. Führen Sie den Setup-Befehl auf dem Master-Host aus:
    apigee-service apigee-postgresql setup -f /opt/silent.conf
  3. Führen Sie den Befehl „configure“ auf dem Master-Host aus:
    apigee-service apigee-postgresql configure
  4. Starten Sie den Master-Host neu:
    apigee-service apigee-postgresql restart
  5. Konfigurieren Sie es als Master:
    apigee-service apigee-postgresql setup-replication-on-master -f /opt/silent.conf
  6. Vergewissern Sie sich, dass der Master-Host gestartet wurde:
    apigee-service apigee-postgresql wait_for_ready
  7. Beenden Sie den Standby-Modus:
    apigee-service apigee-postgresql stop
  8. Führen Sie ein Upgrade für den Standby-Modus durch.

    Hinweis:Wenn dieser Schritt fehlschlägt oder fehlschlägt, kann er ignoriert werden. update.sh wird es versuchen um den Stand-by-Server mit falscher Konfiguration zu starten. Hat die Postgres bereitgestellt auf 10.17 aktualisiert wurde, kann der Fehler ignoriert werden.

    /opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
  9. Achten Sie darauf, dass der Standby-Modus beendet ist:
    apigee-service apigee-postgresql stop
  10. Entfernen Sie die alte Standby-Konfiguration:
    rm -rf /opt/apigee/data/apigee-postgresql/
  11. Richten Sie die Replikation auf dem Stand-by-Server ein:
    apigee-service apigee-postgresql setup-replication-on-standby -f /opt/silent.conf

Nach Abschluss dieses Vorgangs wird der Standby-Modus erfolgreich gestartet.

Postgres-Knoten außer Betrieb nehmen

Fahren Sie nach Abschluss der Aktualisierung den neuen Standby-Knoten außer Betrieb:

  1. Stellen Sie sicher, dass Postgres ausgeführt wird:
    /opt/apigee/apigee-service/bin/apigee-all status

    Wenn Postgres nicht ausgeführt wird, starten Sie es:

    /opt/apigee/apigee-service/bin/apigee-all start
  2. Rufen Sie die UUID des neuen Standby-Knotens ab, indem Sie den folgenden curl-Befehl auf dem neuen Standby-Knoten:
    curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self

    Die UUID des Knotens sollte am Ende der Ausgabe in folgendem Format angezeigt werden:

    "type" : [ "postgres-server" ],
    "uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
  3. Beenden Sie den neuen Standby-Knoten, indem Sie den folgenden Befehl auf dem neuen Standby-Knoten ausführen:
    /opt/apigee/apigee-service/bin/apigee-all stop
  4. Bearbeiten Sie /opt/apigee/customer/application/postgresql.properties auf dem Postgres-Masterknoten. So entfernen Sie den neuen Standby-Knoten aus conf_pg_hba_replication.connection:
    conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust
  5. Starten Sie Apigee-postgresql auf dem Postgres-Master neu:
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
  6. Überprüfen Sie in der /opt/apigee/apigee-postgresql/conf/pg_hba.conf-Datei auf dem Master. Sie sollten Folgendes sehen: nur die folgende Zeile in dieser Datei:
    host replication apigee existing_standby_ip/32 trust
  7. Löschen Sie die UUID des Standby-Knotens aus ZooKeeper, indem Sie die folgende Edge-Verwaltung ausführen: API-Aufruf auf dem Knoten des Verwaltungsservers:
    curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/new_standby_uuid

Voraussetzungen aktualisieren

Erfüllen Sie die folgenden Voraussetzungen, bevor Sie ein Upgrade von Apigee Edge ausführen:

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

    So haben Sie einen Sicherungsplan für den Fall, dass das Update auf eine neue Version ordnungsgemäß funktioniert. Weitere Informationen zum Sichern finden Sie unter Sicherung 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

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. Sie können das Update mehrmals ausführen, damit es fortgesetzt wird. 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 können Sie ein Rollback auf Version 4.51.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 (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.19.06 oder 4.50.00 verwendet haben.

Aktualisieren auf 4.51.00 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. Edge 4.51.00-Datei bootstrap_4.51.00.sh herunterladen nach /tmp/bootstrap_4.51.00.sh:
    curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
  8. Installieren Sie das Edge 4.51.00-Dienstprogramm apigee-service und die Abhängigkeiten, indem Sie und führen Sie den folgenden Befehl aus:
    sudo bash /tmp/bootstrap_4.51.00.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.
  9. 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
  10. Aktualisieren Sie das Dienstprogramm apigee-validate auf dem Verwaltungsserver so: Das Beispiel zeigt:
    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  11. Aktualisieren Sie das Dienstprogramm apigee-provision auf dem Verwaltungsserver so: Das Beispiel zeigt:
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  12. 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: <ph type="x-smartling-placeholder">
        </ph>
      • 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.19.06 oder 4.50.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
  13. 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
  14. 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.51.00 durchführen.

Von einem lokalen Repository auf 4.51.00 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 von einem lokalen Repository aus durchführen, oder Spiegel des Apigee-Repositorys.

Nachdem Sie ein lokales Edge-Repository erstellt haben, haben Sie zwei Möglichkeiten, um Edge über die Lokales Repository:

  • Erstellen Sie eine TAR-Datei des Repositorys, kopieren Sie die TAR-Datei auf einen Knoten und aktualisieren Sie dann Edge vom TAR-Datei.
  • Installieren Sie auf dem Knoten mit dem lokalen Repository einen Webserver, damit andere Knoten darauf zugreifen können. Apigee stellt Ihnen den NGINX-Webserver zur Verfügung. Sie können aber auch Ihren eigenen verwenden. Webserver.

So führen Sie ein Update von einem lokalen 4.51.00-Repository aus:

  1. Erstellen Sie ein lokales 4.51.00-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: <ph type="x-smartling-placeholder">
      </ph>
    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.51.00.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.51.00.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.51.00.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: <ph type="x-smartling-placeholder">
      </ph>
    1. Konfigurieren Sie den NGINX-Webserver wie unter „Installation aus dem Repository mithilfe von NGINX“ beschrieben. webserver&quot; unter Install the Edge apigee-setup-Dienstprogramm.
    2. Laden Sie auf dem Remote-Knoten die Edge-Datei bootstrap_4.51.00.sh herunter, um /tmp/bootstrap_4.51.00.sh:
      /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.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.51.00.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: <ph type="x-smartling-placeholder">
        </ph>
      • 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 in Version 4.19.06 oder 4.50.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.51.00 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.51.00 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. Aktualisieren Sie Qpid und Postgres auf Computer 2:
    /opt/apigee/apigee-setup/bin/update.sh -c qpid,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 die Benutzeroberfläche auf Computer 1:
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  6. (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
  7. (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).

  8. 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. Aktualisieren Sie Qpid und Postgres auf Computer 4:
    /opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile
  3. Aktualisieren Sie Qpid und Postgres auf Computer 5:
    /opt/apigee/apigee-setup/bin/update.sh -c qpid, 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 4, 5, 1, 2, 3:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. Aktualisieren Sie die Edge-Benutzeroberfläche: <ph type="x-smartling-placeholder">
      </ph>
    • 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
  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 UI-Komponente neu: <ph type="x-smartling-placeholder">
      </ph>
    • 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. Aktualisieren Sie Qpid auf den Geräten 6 und 7:
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  3. Postgres auf Computer 8 aktualisieren:
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. Postgres auf Computer 9 aktualisieren:
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  5. LDAP auf Gerät 1 aktualisieren:
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. Aktualisieren Sie die Edge-Komponenten auf den Rechnern 6, 7, 8, 9, 1, 4 und 5 in dieser Reihenfolge:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. Aktualisieren Sie entweder die neue UI (ue) oder die klassische Benutzeroberfläche (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: <ph type="x-smartling-placeholder">
      </ph>
    • 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 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. Aktualisieren Sie die Qpid auf den Geräten 12 und 13:
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  3. Postgres auf Computer 8 aktualisieren:
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. Postgres auf Computer 9 aktualisieren:
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  5. LDAP auf Geräten 4 und 5 aktualisieren:
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. 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
  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: <ph type="x-smartling-placeholder">
      </ph>
    • Klassische Benutzeroberfläche: Wenn Sie die klassische Benutzeroberfläche verwenden, starten Sie die 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 Maschinen 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: <ph type="x-smartling-placeholder">
      </ph>
    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. qpidd aktualisieren: <ph type="x-smartling-placeholder">
      </ph>
    1. Maschinen 4, 5 in Rechenzentrum 1 <ph type="x-smartling-placeholder">
        </ph>
      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 <ph type="x-smartling-placeholder">
        </ph>
      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
  3. Postgres aktualisieren: <ph type="x-smartling-placeholder">
      </ph>
    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
  4. LDAP aktualisieren: <ph type="x-smartling-placeholder">
      </ph>
    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
  5. Aktualisieren Sie die Edge-Komponenten: <ph type="x-smartling-placeholder">
      </ph>
    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
  6. Aktualisieren Sie entweder die neue Benutzeroberfläche (ue) oder die klassische Benutzeroberfläche (ui): <ph type="x-smartling-placeholder">
      </ph>
    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: <ph type="x-smartling-placeholder">
      </ph>
    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: <ph type="x-smartling-placeholder">
      </ph>
    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. qpidd, 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. Edge-Benutzeroberfläche (entweder klassisch oder neu)
  7. apigee-adminapi
  8. Apigee-SSO

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