Apigee Edge 4.17.01 auf 4.17.05 aktualisieren

Edge for Private Cloud Version 4.17.05

Welche Edge-Versionen können Sie auf 4.17.05 aktualisieren

Mit diesem Verfahren können Sie die Apigee Edge-Version 4.17.01.0x auf 4.17.05 aktualisieren.

Wenn Sie eine ältere Edge-Version als 4.16.01 haben, müssen Sie zuerst zu Version 4.16.01.x migrieren und dann auf Version 4.17.01 aktualisieren.

Wer kann das Update durchführen?

Der Nutzer, der das Update ausführt, sollte der Nutzer sein, der Edge ursprünglich installiert hat, oder ein Nutzer, der als Root ausgeführt wird.

Nachdem Sie die Edge-RPMs installiert haben, können sie von jedem Benutzer 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.

Automatische Weitergabe von Property-Einstellungen

Wenn Sie Attribute durch Bearbeiten von .properties-Dateien in /opt/apigee/customer/application festgelegt haben, werden diese Werte durch die Aktualisierung beibehalten.

Erforderliches Hinzufügen des Konfigurationsparameters SMTMAILFROM

Edge 4.17.05 hat der Konfigurationsdatei, die beim Aktivieren eines SMTP-Servers verwendet wird, einen neuen erforderlichen Parameter hinzugefügt. Sie müssen jetzt SMTPMAILFROM in der Konfigurationsdatei festlegen, wenn Sie den SMTP-Server aktivieren. Dieser Parameter hat das folgende Format:

SMTPMAILFROM="My Company <myco@company.com>"

Voraussetzungen für Updates

Beachten Sie vor dem Upgrade von Apigee Edge die folgenden Voraussetzungen:

  • Alle Knoten sichern
    Vor der Aktualisierung wird aus Sicherheitsgründen empfohlen, eine vollständige Sicherung aller Knoten durchzuführen. Führen Sie die Sicherung anhand des Verfahrens für Ihre aktuelle Edge-Version aus.

    So haben Sie einen Sicherungsplan für den Fall, dass das Update auf eine neue Version nicht ordnungsgemäß funktioniert. Weitere Informationen zur Sicherung finden Sie unter Sichern und Wiederherstellen.
  • Achten Sie darauf, dass Edge ausgeführt wird
    Stellen Sie sicher, dass Edge während des Aktualisierungsprozesses ausgeführt wird. Verwenden Sie dazu den folgenden Befehl:

    > /opt/apigee/apigee-service/bin/apigee-all status

Umgang mit einer fehlgeschlagenen Aktualisierung

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

Wenn der Fehler ein Rollback des Updates auf die vorherige Version erfordert, finden Sie weitere Informationen unter 4.17.05 Rollback-Prozess.

Informationen zum Logging-Update

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

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

Wenn der Nutzer, der das Dienstprogramm update.sh ausführt, keinen Zugriff auf dieses Verzeichnis hat, wird das Log in das Verzeichnis /tmp als Datei namens update_username.log geschrieben.

Wenn der Nutzer keinen Zugriff auf /tmp hat, schlägt das Dienstprogramm update.sh fehl.

Update ohne Ausfallzeiten

Mit einem Update ohne Ausfallzeiten oder einem Rolling Update können Sie Ihre Edge-Installation aktualisieren, ohne Edge herunterzufahren.

Updates ohne Ausfallzeiten sind nur ab einer Konfiguration mit 5 Knoten möglich.

Der Schlüssel für ein Upgrade 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 ihn dann wieder dem Load-Balancer hinzu.

  1. Aktualisieren Sie die Maschinen in der richtigen Reihenfolge für Ihre Installation, wie unten unter „Reihenfolge des Maschinenupdates“ beschrieben.
  2. Wenn es an der Zeit ist, die Router zu aktualisieren, wählen Sie einen beliebigen Router aus und machen Sie ihn unerreichbar, wie unter Erreichbarkeit des Servers (Message Processor/Router) aktivieren/deaktivieren beschrieben.
  3. Aktualisieren Sie den ausgewählten Router und alle anderen Edge-Komponenten auf demselben Computer wie der Router. Alle Edge-Konfigurationen zeigen einen Router und einen Message Processor auf demselben Knoten an.
  4. Machen Sie den Router wieder erreichbar.
  5. Wiederholen Sie die Schritte 2 bis 4 für die verbleibenden Router.
  6. Fahren Sie für alle in Ihrer Installation verbleibenden Maschinen fort.

Beachten Sie vor/nach dem Update Folgendes:

  • Auf dem kombinierten Router- und Message Processor-Knoten:
    • Führen Sie vor der Aktualisierung die folgenden Schritte aus:
      1. Machen Sie den Router unerreichbar.
      2. Machen Sie den Message Processor unerreichbar.
    • Führen Sie nach der Aktualisierung Folgendes aus:
      1. Machen Sie den Message Processor erreichbar.
      2. Sorgen Sie dafür, dass der Router erreichbar ist.
  • Auf einem einzelnen Routerknoten:
    • Sorgen Sie dafür, dass der Router vor dem Update nicht erreichbar ist.
    • Sorgen Sie dafür, dass der Router nach dem Update erreichbar ist.
  • Auf einem einzelnen Message Processor-Knoten:
    • Machen Sie den Message Processor vor der Aktualisierung unerreichbar.
    • Machen Sie den Message Processor nach der Aktualisierung erreichbar.

Konfigurationsdatei im Hintergrund verwenden

Sie müssen eine unbeaufsichtigte Konfigurationsdatei an den Aktualisierungsbefehl übergeben. Die stille Konfigurationsdatei sollte mit der Datei identisch sein, die Sie bei der Installation von Edge 4.17.01 verwendet haben.

Verfahren zum Aktualisieren auf 4.17.05 auf einem Knoten mit einer externen Internetverbindung

Aktualisieren Sie mit dem folgenden Verfahren die Edge-Komponenten auf einem Knoten:

  1. Deaktivieren Sie gegebenenfalls alle CRON-Jobs, die für die Durchführung eines Reparaturvorgangs für Cassandra konfiguriert sind, bis die Aktualisierung abgeschlossen ist.
  2. Melden Sie sich bei Ihrem Knoten als Root an, um die Edge-RPMs zu installieren.
    Hinweis: Für die RPM-Installation ist Root-Zugriff erforderlich. Sie können die Edge-Konfiguration aber auch ohne Root-Zugriff durchführen.
  3. Deaktivieren Sie SELinux wie unter Das Edge-Dienstprogramm für die Apigee-Einrichtung installieren beschrieben.
  4. Laden Sie die Edge 4.17.05-Datei bootstrap_4.17.05.sh in /tmp/bootstrap_4.17.05.sh herunter:
    > curl https://software.apigee.com/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.05.sh
  5. Installieren Sie das Edge 4.17.05-Dienstprogramm apigee-service und Abhängigkeiten:
    > sudo bash /tmp/bootstrap_4.17.05.sh apigeeuser=uName apigeepassword=pWord

    Dabei sind uName:pWord der Benutzername und das Passwort, die Sie von Apigee erhalten haben. Wenn Sie pWord auslassen, werden Sie aufgefordert, ihn einzugeben.

    Das Installationsprogramm prüft standardmäßig, ob Java 1.8 installiert ist. Andernfalls wird die App automatisch installiert. Verwenden Sie die Option JAVA_FIX, um anzugeben, wie die Java-Installation zu behandeln ist. Für JAVA_FIX werden folgende Werte verwendet:

    I = Install OpenJDK 1.8 (Standard)
    C = Weiter ohne Java-Installation
    Q = Beenden. Dazu müssen Sie Java selbst installieren.
  6. (Nur CentOS-6.x und RedHat-6.x) Führen Sie auf allen Qpid-Knoten den folgenden Befehl aus, damit Sie die richtige Qpid-Version herunterladen:
    > yum install apigee-qpidd --disablerepo=epel
  7. Verwenden Sie apigee-service, um das Dienstprogramm apigee-setup zu aktualisieren:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  8. Aktualisieren Sie das Dienstprogramm apigee-validate auf dem Management Server:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  9. Aktualisieren Sie das Dienstprogramm apigee-provision:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  10. Führen Sie das Update-Dienstprogramm auf Ihren Knoten in der unten unter Reihenfolge der Maschinenaktualisierung beschriebenen Reihenfolge aus:
    > /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

    Die einzige Anforderung an die Konfigurationsdatei ist, dass die Konfigurationsdatei für den Benutzer „apigee“ zugänglich sein oder gelesen werden muss.

    Verwenden Sie die Option „-c“, um die zu aktualisierende Komponente anzugeben. Die Liste der möglichen Komponenten umfasst:
    ldap = OpenLDAP
    cs = Cassandra
    zk = Zookeeper
    qpid = qpidd
    ps = postgresql
    edge = All Edge-Komponenten außer Edge UI: Management Server, Message Processor, Router, QPID = Elastic API, Message Processor, Router und QPID = Edge API auf einem Elastic API als Basis-API auf Basis von Elastic = Stacks = E-Book „Message Processor , Message Processor“, „Router, QPID-Server und Postui-Portal für alle Stacks API auf dem Edge-Server und Postui-Portal





  11. Testen Sie die Aktualisierung, indem Sie das Dienstprogramm Apigee-validierung auf dem Management Server ausführen, wie unter Installation testen beschrieben.

Für ein späteres Rollback der Aktualisierung folgen Sie dem unter 4.17.05 Rollback-Prozess beschriebenen Verfahren.

Verfahren zur Aktualisierung auf 4.17.05 von einem lokalen Repository

Wenn sich Ihre Edge-Knoten hinter einer Firewall befinden oder auf andere Weise nicht über das Internet auf das Apigee-Repository zugreifen können, können Sie die Aktualisierung über ein lokales Repository oder einen 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 über die TAR-Datei.
  • Installieren Sie einen Webserver auf dem Knoten mit dem lokalen Repository, damit andere Knoten darauf zugreifen können. Apigee stellt Ihnen den Nginx-Webserver zur Verfügung, den Sie nutzen können, oder Sie können Ihren eigenen Webserver verwenden.

So aktualisieren Sie ein lokales 4.17.05-Repository:

  1. Erstellen Sie ein lokales 4.17.05-Repository, wie in „Lokales Apigee-Repository erstellen“ unter Dienstprogramm für Edge-Apigee-Setup installieren beschrieben.
    Hinweis: Wenn Sie bereits ein Repository mit der Version 4.17.01 haben, können Sie das Repository 4.17.05 hinzufügen, wie unter „Lokales Apigee-Repository aktualisieren“ unter Dienstprogramm für Edge Apigee-Setup 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.17.05.tar.gz zu verpacken:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror-Paket
    2. Kopieren Sie die TAR-Datei auf den Knoten, in dem Sie Edge aktualisieren möchten. Kopieren Sie ihn beispielsweise in das Verzeichnis /tmp auf dem neuen Knoten.
    3. Entpacken Sie die Datei auf dem neuen Knoten in das /tmp-Verzeichnis:
      > tar -xzf apigee-4.17.05.tar.gz

      Dieser Befehl erstellt ein neues Verzeichnis namens repos in dem Verzeichnis, das die .tar-Datei enthält. Beispiel: /tmp/repos.
    4. Installieren Sie das Edge-Apigee-Dienst-Dienstprogramm und die Abhängigkeiten aus /tmp/repos:
      > sudo bash /tmp/repos/bootstrap_4.17.05.sh apigee="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 „Vom Repository mithilfe des Nginx-Webservers installieren“ unter Das Edge-Dienstprogramm Apigee-Setup installieren beschrieben.
    2. Laden Sie auf dem Remote-Knoten die Edge-Datei bootstrap_4.17.05.sh in /tmp/bootstrap_4.17.05.sh herunter:
      > /usr/bin/curl http://uName:pWord@remoteRepo:3939/shbootstrap_4.17.0 sind remoteRepo:3939/shbootstrap_4.17.0.

    3. Installieren Sie auf dem Remote-Knoten das Edge-Apigee-Dienst-Dienstprogramm und die Abhängigkeiten:
      > sudo bash /tmp/bootstrap_4.17.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeepassword=pWord apigeeprotocol=http://
      sind
      , wobei u.p
  4. Verwenden Sie apigee-service, um das Dienstprogramm apigee-setup zu aktualisieren:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  5. Aktualisieren Sie das Dienstprogramm apigee-validate auf dem Management Server.
    > /opt/apigee/apigee-service/bin/apigee-service, apigee-validate, Update
  6. Aktualisieren Sie das Dienstprogramm apigee-provision:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  7. Führen Sie das Aktualisierungsdienstprogramm auf Ihren Knoten in der unten unter „Reihenfolge der Maschinenaktualisierung“ beschriebenen Reihenfolge aus:
    > /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

    Die einzige Anforderung für die Konfigurationsdatei ist, dass die Konfigurationsdatei für den Benutzer „apigee“ zugänglich sein oder gelesen werden muss.

    Verwenden Sie die Option „-c“, um die zu aktualisierende Komponente anzugeben. Die Liste der möglichen Komponenten umfasst:
    ldap = OpenLDAP
    cs = Cassandra
    zk = Zookeeper
    qpid = qpidd
    ps = postgresql
    edge = All Edge-Komponenten außer Edge UI: Management Server, Message Processor, Router, QPID = Elastic API, Message Processor, Router und QPID = Edge API auf einem Elastic API als Basis-API auf Basis von Elastic = Stacks = E-Book „Message Processor , Message Processor“, „Router, QPID-Server und Postui-Portal für alle Stacks API auf dem Edge-Server und Postui-Portal





  8. Testen Sie die Aktualisierung, indem Sie das Dienstprogramm Apigee-validierung auf dem Management Server ausführen, wie unter Installation testen beschrieben.

Für ein späteres Rollback der Aktualisierung folgen Sie dem unter 4.17.05 Rollback-Prozess beschriebenen Verfahren.

Reihenfolge des Maschinenupdates

Die Reihenfolge, in der Sie die Maschinen in einer Edge-Installation aktualisieren, ist wichtig. Die wichtigsten Überlegungen bei einem Update sind:

  • Sie müssen alle Cassandra- und ZooKeeper-Knoten aktualisieren, bevor Sie andere Knoten aktualisieren.
  • Verwenden Sie für alle Maschinen mit mehreren Edge-Komponenten (Management Server, Message Processor, Router, QPID-Server, aber nicht Postgres-Server) die Option „-c Edge“, um alle gleichzeitig zu aktualisieren.
  • Wenn für einen Schritt festgelegt ist, dass er auf mehreren Computern ausgeführt werden soll, führen Sie ihn in der angegebenen Maschinenreihenfolge aus.
  • Für die Monetarisierung ist kein separater Schritt erforderlich. Sie wird aktualisiert, wenn Sie die Option „-c Edge“ angeben.
  • (Nur CentOS-6.x und RedHat-6.x) Achten Sie auf allen Qpid-Knoten mit einer externen Internetverbindung darauf, dass Sie den folgenden Befehl zum Herunterladen der richtigen Qpid-Version wie oben gezeigt ausgeführt haben:
    > yum install apigee-qpidd --disablerepo=epel

Für eine eigenständige Installation mit einem Host

  1. Legen Sie SMTPMAILFROM in Ihrer Konfigurationsdatei fest, wenn Sie SMTP in Edge aktiviert haben. Dieser Parameter hat das Format:
    SMTPMAILFROM="Mein Unternehmen <myco@company.com>"
  2. Aktualisieren Sie Cassandra und ZooKeeper:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Aktualisieren Sie Qpid und Postgres:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
  4. Starten Sie postgresql:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  5. LDAP aktualisieren:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. Aktualisieren Sie die verbleibenden Edge-Komponenten:
    > /opt/apigee/apigee-setup/bin/update.sh -cedge -f configFile
  7. Aktualisieren der Edge-Benutzeroberfläche:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

Für eine eigenständige Installation mit zwei Hosts

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

  1. Legen Sie SMTPMAILFROM in Ihrer Konfigurationsdatei fest, wenn Sie SMTP in Edge aktiviert haben. Dieser Parameter hat das Format:
    SMTPMAILFROM="Mein Unternehmen <myco@company.com>"
  2. Aktualisieren Sie Cassandra und ZooKeeper auf Maschine 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Aktualisieren Sie Qpid und Postgres auf Maschine 2:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
  4. Starten Sie postgresql auf Maschine 2:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  5. Aktualisieren Sie LDAP auf Maschine 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. Aktualisieren Sie Edge-Komponenten auf Maschine 2 und 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  7. Aktualisieren der UI auf Maschine 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

Für eine geclusterte Installation mit 5 Hosts

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

  1. Legen Sie SMTPMAILFROM in Ihrer Konfigurationsdatei fest, wenn Sie SMTP in Edge aktiviert haben. Dieser Parameter hat das Format:
    SMTPMAILFROM="Mein Unternehmen <myco@company.com>"
  2. Aktualisieren Sie Cassandra und ZooKeeper auf Maschinen 1, 2 und 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Aktualisieren Sie Qpid und Postgres auf Maschine 4:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
  4. Starten Sie postgresql auf Maschine 4:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  5. Wiederholen Sie die Schritte 3 und 4 auf Gerät 5.
  6. Aktualisieren Sie LDAP auf Maschine 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  7. Aktualisieren Sie Edge-Komponenten auf Maschinen 4, 5, 1, 2, 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  8. Aktualisieren der UI auf Maschine 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

Für eine geclusterte Installation mit 9 Hosts

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

  1. Legen Sie SMTPMAILFROM in Ihrer Konfigurationsdatei fest, wenn Sie SMTP in Edge aktiviert haben. Dieser Parameter hat das Format:
    SMTPMAILFROM="Mein Unternehmen <myco@company.com>"
  2. Aktualisieren Sie Cassandra und ZooKeeper auf Maschinen 1, 2 und 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Aktualisieren Sie Qpid und Postgres auf Maschine 6:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
  4. Starten Sie postgresql auf Maschine 6:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  5. Wiederholen Sie die Schritte 3 und 4 auf Gerät 7.
  6. Aktualisieren Sie LDAP auf Maschine 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  7. Aktualisieren Sie Edge-Komponenten auf den Maschinen 6, 7, 8, 9, 1, 4 und 5 in dieser Reihenfolge:
    > /opt/apigee/apigee-setup/bin/update.sh -cedge -f configFile
  8. Aktualisieren der UI auf Maschine 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

Für eine geclusterte Installation mit 13 Hosts

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

  1. Legen Sie SMTPMAILFROM in Ihrer Konfigurationsdatei fest, wenn Sie SMTP in Edge aktiviert haben. Dieser Parameter hat das Format:
    SMTPMAILFROM="Mein Unternehmen <myco@company.com>"
  2. Aktualisieren Sie Cassandra und ZooKeeper auf Maschinen 1, 2 und 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Aktualisieren Sie Qpid und Postgres auf Maschine 12:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
  4. Starten Sie postgresql auf Maschine 12:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  5. Wiederholen Sie die Schritte 3 und 4 auf Gerät 13.
  6. Aktualisieren Sie LDAP auf Computer 4 und 5:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  7. 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
  8. Aktualisieren Sie die UI auf Maschine 6 und 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

Für eine geclusterte Installation mit 12 Hosts

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

  1. Legen Sie SMTPMAILFROM in Ihrer Konfigurationsdatei fest, wenn Sie SMTP in Edge aktiviert haben. Dieser Parameter hat das Format:
    SMTPMAILFROM="Mein Unternehmen <myco@company.com>"
  2. Aktualisieren Sie Cassandra und ZooKeeper:
    1. Auf Maschinen 1, 2 und 3 im Rechenzentrum 1:
      > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
    2. Auf den Maschinen 7, 8 und 9 im Rechenzentrum 2
      > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Aktualisieren Sie qpidd:
    1. Maschinen 4, 5 im Rechenzentrum 1
      1. Aktualisieren Sie qpidd auf Maschine 4:
        > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. Wiederholen Sie Schritt 1 auf Gerät 5.
    2. Maschinen 10, 11 im Rechenzentrum 2
      1. Aktualisieren Sie qpidd auf Maschine 10:
        > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. Wiederholen Sie Schritt 1 auf Gerät 11.
  4. Aktualisieren Sie postgresql:
    1. Maschinen 6 im Rechenzentrum 1
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql Start
    2. Maschinen 12 im Rechenzentrum 2
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  5. LDAP aktualisieren:
    1. Maschinen 1 in Rechenzentrum 1
      > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
    2. Maschinen 7 im Rechenzentrum 2
      > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. Aktualisieren Sie Edge-Komponenten:
    1. Maschinen 4, 5, 6, 1, 2, 3 im Rechenzentrum 1
      > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
    2. Maschinen 10, 11, 12, 7, 8, 9 im Rechenzentrum 2
      > /opt/apigee/apigee-setup/bin/update.sh -cedge -f configFile
  7. UI aktualisieren:
    1. Maschine 1 im Rechenzentrum 1:
      > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
    2. Maschine 7 im Rechenzentrum 2:
      > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

Für eine API-Installation mit 7 Hosts

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

  1. Aktualisieren Sie Cassandra auf Maschinen 5, 6 und 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile

  2. Aktualisieren Sie den ElasticSearch- und API-BaaS-Stack auf Maschinen 1, 2 und 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c e,b -f configFile

  3. Aktualisieren Sie das API-BaaS-Portal auf Maschine 4:
    > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

Für eine API-Installation mit 10 Hosts

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

  1. Aktualisieren Sie Cassandra auf Maschinen 8, 9 und 10:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  2. Aktualisieren Sie ElasticSearch auf Maschinen 1, 2 und 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
  3. Aktualisieren Sie den API-BaaS-Stack auf Maschinen 4, 5 und 6:
    > /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
  4. Aktualisieren Sie das API-BaaS-Portal auf Maschine 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

Für eine API-Baas-Installation in zwei Rechenzentren

Für dieses Verfahren müssen die Cassandra-Knoten in beiden Rechenzentren aktualisiert werden. Wenn Sie diese Cassandra-Knoten mit Edge teilen, aktualisieren Sie diese Knoten in der Regel im Rahmen des Edge-Updates.

  1. Aktualisieren Sie die Cassandra-Schlüsselbereiche mit dem korrekten Replikationsfaktor für die beiden Rechenzentren. Sie müssen diesen Schritt nur einmal auf einem Cassandra-Server in einem der beiden Rechenzentren ausführen:

    Hinweis: Die folgenden Befehle setzen den Replikationsfaktor auf „3“, was drei Cassandra-Knoten im Cluster angibt. Ändern Sie diesen Wert bei Bedarf für Ihre Installation.
    1. Starten Sie das Dienstprogramm Cassandra cqlsh:
      > /opt/apigee/apigee-cassandra/bin/cqlsh cassandraIP
    2. Führen Sie die folgenden CQL-Befehle in der Eingabeaufforderung "cqlsh>" aus, um die Replikationsebenen für Cassandra-Schlüsselbereiche festzulegen:
      1. cqlsh> ALTER KEYSPACE "Apigee_Baas_dc_1" WITH Replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      2. cqlsh> ALTER KEYSPACE "Apigee_Baas" WITH Replikation = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      3. cqlsh> ALTER KEYSPACE "Apigee_Baas_Locks" WITH Replikation = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      4. cqlsh> ALTER KEYSPACE "system_traces" WITH Replikation = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      5. cqlsh> ALTER KEYSPACE "Apigee_Baas_dc_2" WITH Replikation = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      6. Rufen Sie die Schlüsselbereiche mit folgendem Befehl auf:
        cqlsh> select * from system.schema_keyspaces;.
      7. Beenden Sie „cqlsh“:
        cqlsh> exit
  2. (Nur, wenn Sie Cassandra nicht im Rahmen der Aktualisierung von Edge aktualisiert haben) Aktualisieren Sie Cassandra-Knoten in Rechenzentrum 1, jeweils eine Maschine:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  3. (Nur wenn Sie Cassandra nicht im Rahmen der Aktualisierung von Edge aktualisiert haben) Aktualisieren Sie Cassandra-Knoten in Rechenzentrum 2, jeweils eine Maschine:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  4. Aktualisieren Sie ElasticSearch auf Maschinen in Rechenzentrum 1, eine Maschine nach der anderen:
    > /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
  5. Aktualisieren Sie ElasticSearch auf Maschinen in Rechenzentrum 2, jeweils eine Maschine nach der anderen:
    > /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
  6. API-BaaS-Stack auf Maschinen in Rechenzentrum 1 aktualisieren, eine Maschine nach der anderen:
    > /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
  7. API-BaaS-Stack auf Maschinen in Rechenzentrum 2 aktualisieren, eine Maschine nach der anderen:
    > /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
  8. Aktualisieren Sie das API-BaaS-Portal auf Maschinen in Rechenzentrum 1, eine Maschine nach der anderen:
    > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile
  9. Aktualisieren Sie das API-BaaS-Portal auf Maschinen in Rechenzentrum 2, eine Maschine nach der anderen:
    > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile
  10. BaaS-Schlüsselraumwerte aktualisieren. Dieser Schlüsselbereich muss für die Replikation bei der Installation festgelegt werden, aber nicht während der Laufzeit. Durch das Entfernen der Replikation wird auch Cassandra-Arbeitsspeicher gespart.

    Sie müssen diesen Schritt nur einmal auf einem Cassandra-Server in einem der beiden Rechenzentren ausführen:
    1. Starten Sie das Cassandra-Dienstprogramm cqlsh:
      > /opt/apigee/apigee-cassandra/bin/cqlsh cassandraIP
    2. Führen Sie die folgenden CQL-Befehle aus, um die Replikationsebenen für Cassandra-Schlüsselbereiche festzulegen:
      1. cqlsh> ALTER KEYSPACE "Apigee_Baas_dc_1" WITH Replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3' };
      2. cqlsh> ALTER KEYSPACE "Apigee_Baas_dc_2" WITH Replikation = { 'class': 'NetworkTopologyStrategy', 'dc-2': '3' };
      3. Rufen Sie mit folgendem Befehl die Schlüsselbereiche auf:
        cqlsh> select * from system.schema_keyspaces;
      4. cqlsh beenden:
        cqlsh> beenden

Für eine nicht standardmäßige Installation

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

  1. ZooKeeper
  2. Cassandra
  3. QPIdd, PS
  4. LDAP
  5. Edge, d. h. das Profil "-c" auf allen Knoten in der Reihenfolge: Knoten mit Qpid-Server, Postgres-Server, Management Server, Message Processor und Router.
    Hinweis: Wenn auf dem Knoten sowohl der Qpid-Server als auch der Postgres-Server installiert sind, führen Sie den Profilschritt „-c Edge“ aus.
  6. Edge-Benutzeroberfläche