Aktualisieren Sie Apigee Edge 4.51.00, 4.52.00 oder 4.52.01 auf 4.52.02

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

Wer kann das Update ausführen?

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

Nachdem Sie die Edge-RPMs installiert haben, kann jeder sie konfigurieren.

Welche Komponenten müssen Sie aktualisieren?

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

Voraussetzungen für die Aktualisierung

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

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

    So haben Sie einen Notfallplan für den Fall, dass das Update auf eine neue Version nicht richtig funktioniert. Weitere Informationen zur Sicherung finden Sie unter Sichern und Wiederherstellen.

  • Prüfen, ob Edge ausgeführt wird
    Prüfen Sie mit dem Befehl, ob Edge während des Aktualisierungsvorgangs ausgeführt wird: 
    /opt/apigee/apigee-service/bin/apigee-all status
  • Die Cassandra-Komprimierungsstrategie muss LeveledCompactionStrategy
    sein. Nehmen Sie je nach aktueller Version die erforderlichen Änderungen an der Cassandra-Komprimierungsstrategie vor. Führen Sie die folgenden Schritte aus und kehren Sie dann zum Hauptupgradeverfahren zurück:

Besondere Schritte für die Umstellung

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

Aktuelle Version Software, für die spezielle Schritte für das Upgrade auf 4.52.02 erforderlich sind Referenz
4.52.01 Cassandra Cassandra-Komprimierungsstrategie ändern
4.52.00 Cassandra, Zookeeper, Qpid Cassandra-Komprimierungsstrategie ändern
4.51.00 Cassandra, Zookeeper, Qpid, Postgres Cassandra-Komprimierungsstrategie ändern

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

Automatische Übernahme von Hoteleigenschaften

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

Erforderliches Upgrade auf Cassandra 3.11.16

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

Da es sich um ein größeres Upgrade handelt, waren bestimmte Änderungen am Apigee-Datenmodell in Cassandra erforderlich, um eine optimale Leistung in neueren Versionen zu gewährleisten. Obwohl diese Änderungen minimal sind, wirkt sich das Upgrade auf bestimmte Verwaltungs-APIs aus, was sich sowohl auf die Apigee-Benutzeroberfläche als auch auf das Entwicklerportal auswirkt. Im folgenden Dokument werden die genauen APIs angegeben, die nicht funktionieren, und die Schritte während des Upgrades beschrieben, wann die Störung beginnt und endet. Während des Upgrades darf es keine Unterbrechungen des Laufzeittraffics geben.

Rollback auf oberster Ebene

Wenden Sie Cassandra-Upgrades nacheinander auf die einzelnen Knoten an. Sobald ein Knoten aktualisiert wird, werden bestimmte Schemaänderungen wirksam, die nicht direkt rückgängig gemacht werden können. Lesen Sie den Abschnitt zum Rollback sorgfältig durch, da je nach Umfang des Upgrades unterschiedliche Verfahren verwendet werden können.

Wenn Sie das Upgrade rückgängig machen möchten, nachdem der gesamte Cassandra-Cluster aktualisiert wurde, ist die einzige Option, Sicherungen wiederherzustellen. Bereiten Sie sich darauf vor und machen Sie sich mit der Wiederherstellung von Cassandra-Sicherungen 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 für das Cassandra-Update 3.11.16 durchführen.

APIs im Entwicklerportal dokumentieren

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

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

In den folgenden Abschnitten verwendete Terminologie

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

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

In den einzelnen Schritten unten wird der Status der Laufzeit und Verwaltung beschrieben, während Sie die verschiedenen Phasen des Upgrade-Vorgangs durchlaufen. Während des Upgrades hat das Upgrade keine Auswirkungen auf den Laufzeittraffic. Es kommt jedoch zu Störungen bei einer kleinen Teilmenge der Verwaltungs-APIs und Entwicklerportalfunktionen.

Schritt 0: Startstatus

  1. Cassandra in Apigee wird mit Version 2.1.22 ausgeführt.
  2. Komponenten von Edge for Private Cloud 4.52.02:
    • Verwaltungsserver, der über das ältere Thrift-Protokoll mit Cassandra kommuniziert.
    • Laufzeitserver (Message Processors und Router), die über das ältere Thrift-Protokoll mit Cassandra kommunizieren.
Laufzeitstatus in dieser Phase Verwaltungsstatus in dieser Phase
Laufzeit vollständig funktionsfähig Verwaltung vollständig funktionsfähig

Schritt 1: Upgrade vorbereiten

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

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

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

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

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

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

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

Schritt 2: Alle Cassandra-Knoten aktualisieren

  1. Führen Sie ein Upgrade aller Cassandra-Knoten in allen Regionen nacheinander durch. Führen Sie die folgenden Befehle auf jedem Knoten aus: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  2. Führen Sie nach der Aktualisierung eines Knotens den folgenden Befehl auf dem Knoten aus, um einige Validierungen auszuführen, bevor Sie fortfahren: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra validate_upgrade -f configFile
  3. Die Ausgabe sieht in etwa so aus: 
    Cassandra version is verified - [cqlsh 5.0.1 | Cassandra 3.11.16 | CQL spec 3.4.4 | Native protocol v3] Metadata is verified
Laufzeitstatus in dieser Phase Verwaltungsstatus in dieser Phase
Laufzeit vollständig funktionsfähig Die folgende Verwaltungsfunktion ist nach dem Upgrade von Cassandra eingeschränkt:

Schritt 3: Alle Verwaltungsknoten aktualisieren

Führen Sie ein Upgrade für alle Verwaltungsknoten in allen Regionen einzeln durch:

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

Schritt 3a: [Optional] Zuvor exportierte SmartDocs importieren

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

Laufzeitstatus Verwaltungsstatus
Laufzeit vollständig funktionsfähig Verwaltung vollständig funktionsfähig

Schritt 4: Alle Runtime-Knoten aktualisieren

Führen Sie ein Upgrade für alle Router und Message Processor-Knoten in allen Regionen einzeln durch:

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

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

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

Wenn Sie in dieser Phase ein Upgrade von einer Version vor Edge for Private Cloud 4.52.01 ausführen und zusätzliche Schritte für das Upgrade von Qpid oder Postgres ausführen, folgen Sie den entsprechenden Schritten für das Upgrade.

Laufzeitstatus Verwaltungsstatus
Laufzeit vollständig funktionsfähig Verwaltung vollständig funktionsfähig

Schritt 6: Nach dem Upgrade

Führen Sie nach Abschluss des Upgrades den folgenden Befehl nacheinander auf jedem Cassandra-Knoten 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 Sie bestimmte Funktionen von Cassandra nicht verwenden, z. B. die Einrichtung einer neuen Authentifizierung. Alte Authentifizierungsmechanismen funktionieren jedoch weiterhin. Dieser Befehl kann nur auf einem Knoten im Cluster ausgeführt werden:

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

Führen Sie Schritt 3a aus, falls Sie das noch nicht getan haben.

Laufzeitstatus Verwaltungsstatus
Laufzeit vollständig funktionsfähig Verwaltung vollständig funktionsfähig

Erforderliches Upgrade auf Zookeeper 3.8.3

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

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

Erforderliches Upgrade auf Postgres 14

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

Erforderliches Upgrade auf Qpid J-Broker

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

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

Neue Edge-Benutzeroberfläche

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

Edge-Benutzeroberfläche installieren

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

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

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

Edge-Benutzeroberfläche aktualisieren

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

Mit Apigee mTLS aktualisieren

So aktualisieren Sie Apigee mTLS:

Aktualisierung rückgängig machen

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

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

Informationen zum Logging von Updates

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

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

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

Wenn die Person keinen Zugriff auf /tmp hat, schlägt das update.sh-Dienstprogramm fehl.

Aktualisierung ohne Ausfallzeiten

Mit einem Update ohne Ausfallzeit oder einem Rolling Update können Sie Ihre Edge-Installation aktualisieren, ohne dass Edge heruntergefahren werden muss.

Aktualisierungen ohne Ausfallzeit sind nur mit einer Konfiguration mit mindestens fünf Knoten möglich.

Der Schlüssel zu einem Upgrade ohne Ausfallzeit besteht darin, jeden Router einzeln aus dem Load Balancer zu entfernen. Aktualisieren Sie dann den Router und alle anderen Komponenten auf demselben Computer wie den Router und fügen Sie den Router dem Load Balancer wieder hinzu.

  1. Aktualisieren Sie die Maschinen in der richtigen Reihenfolge für Ihre Installation, wie unter Reihenfolge der Maschinenaktualisierung beschrieben.
  2. Wenn es an der Zeit ist, die Router zu aktualisieren, wählen Sie einen beliebigen Router aus und machen Sie ihn unerreichbar, wie unter Aktivieren/Deaktivieren der Verfügbarkeit des Servers (Nachrichtenprozessors/Routers) beschrieben.
  3. Aktualisieren Sie den ausgewählten Router und alle anderen Edge-Komponenten auf demselben Computer wie der Router. Alle Edge-Konfigurationen zeigen einen Router und einen Message Processor auf demselben Knoten an.
  4. Sorgen Sie dafür, dass der Router wieder erreichbar ist.
  5. Wiederholen Sie die Schritte 2 bis 4 für die übrigen Router.
  6. Fahren Sie mit dem Update für alle verbleibenden Computer in Ihrer Installation fort.

Beachten Sie vor und nach dem Update Folgendes:

Silent-Konfigurationsdatei verwenden

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

Auf einem Knoten mit einer externen Internetverbindung auf Version 4.52.02 aktualisieren

So aktualisieren Sie die Edge-Komponenten auf einem Knoten:

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

  7. Wenn Sie derzeit Edge 4.51.00 verwenden:

    1. Laden Sie die Edge-bootstrap_4.52.02.sh-Datei auf /tmp/bootstrap_4.52.02.sh herunter: 
      curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
    2. Installieren Sie das Dienstprogramm apigee-service und die Abhängigkeiten für Edge 4.52.02 mit dem folgenden Befehl: 
      sudo bash /tmp/bootstrap_4.52.02.sh apigeeuser=uName apigeepassword=pWord

      Dabei sind uName:pWord der Nutzername und das Passwort, die Sie von Apigee erhalten haben. Wenn Sie pWord weglassen, werden Sie aufgefordert, sie einzugeben.

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

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

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

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

      Wobei:

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

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

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

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

Über ein lokales Repository auf Version 4.52.02 aktualisieren

Wenn sich Ihre Edge-Knoten hinter einer Firewall befinden oder auf andere Weise nicht über das Internet auf das Apigee-Repository zugreifen können, können Sie das Update über ein lokales Repository oder einen Mirror des Apigee-Repositories ausführen.

Nachdem Sie ein lokales Edge-Repository erstellt haben, haben Sie zwei Möglichkeiten, Edge aus dem lokalen Repository zu aktualisieren:

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

So aktualisieren Sie über ein lokales 4.52.02-Repository:

  1. Erstellen Sie ein lokales 4.52.02-Repository, wie unter Installieren Sie das Hilfsprogramm für das Edge-Apigee-Setup im Abschnitt „Create a local Apigee repository“ (Lokales Apigee-Repository erstellen) beschrieben.
  2. So installieren Sie apigee-service aus einer .tar-Datei:
    1. Verpacken Sie das lokale Repository auf dem Knoten mit dem lokalen Repository mit dem folgenden Befehl in einer einzelnen TAR-Datei mit dem Namen /opt/apigee/data/apigee-mirror/apigee-4.52.02.tar.gz: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
    2. Kopieren Sie die .tar-Datei auf den Knoten, auf dem Sie Edge aktualisieren möchten. Kopieren Sie sie beispielsweise in das Verzeichnis /tmp auf dem neuen Knoten.
    3. Entpacken Sie die Datei auf dem neuen Knoten im Verzeichnis /tmp: 
      tar -xzf apigee-4.52.02.tar.gz

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

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

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

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

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

    3. Installieren Sie auf dem Remote-Knoten das Edge-Hilfsprogramm 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 für das Repository.

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

    Wobei:

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

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

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

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

Reihenfolge der Maschinenaktualisierung

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

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

Eigenständiges Upgrade für 1 Knoten

So führen Sie ein Upgrade einer eigenständigen Konfiguration mit einem Knoten auf 4.52.02 durch:

  1. Alle Komponenten aktualisieren: 
    /opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
  2. (Wenn Sie apigee-adminapi installiert haben) apigee-adminapi-Dienstprogramm aktualisiert: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

Eigenständiges Upgrade für 2 Knoten

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

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

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

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

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

Upgrade mit 5 Knoten

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

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

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

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

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

Upgrade eines Clusters mit 9 Knoten

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

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

  1. Aktualisieren Sie Cassandra und ZooKeeper auf den Maschinen 1, 2 und 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Aktualisieren Sie Postgres auf Computer 8: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. Aktualisieren Sie Postgres auf Computer 9: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. LDAP auf Computer 1 aktualisieren: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Aktualisieren Sie die Edge-Komponenten auf den Maschinen 6, 7, 8, 9, 1, 4 und 5 in dieser Reihenfolge: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. Qpid auf den Maschinen 6 und 7 aktualisieren: 
    /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 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 Apigee SSO auf Computer 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

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

Clusterupgrade mit 13 Knoten

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

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

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

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

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

Cluster mit 12 Knoten upgraden

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

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

  1. Aktualisieren Sie Cassandra und ZooKeeper:
    1. Auf den Maschinen 1, 2 und 3 in Rechenzentrum 1: 
      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
    2. Auf den Maschinen 7, 8 und 9 in Rechenzentrum 2 
      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Aktualisiere Postgres:
    1. Maschine 6 in Rechenzentrum 1 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    2. Maschine 12 im 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 und 3 im Rechenzentrum 1 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
    2. Maschinen 10, 11, 12, 7, 8 und 9 im Rechenzentrum 2 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  5. Aktualisieren Sie qpidd:
    1. Maschinen 4 und 5 in Rechenzentrum 1
      1. qpidd auf Computer 4 aktualisieren: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. qpidd auf Maschine 5 aktualisieren: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
    2. Maschinen 10 und 11 in Rechenzentrum 2
      1. qpidd auf Computer 10 aktualisieren: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. qpidd auf Computer 11 aktualisieren: 
        /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 im Rechenzentrum 2: 
      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  7. (Wenn Sie apigee-adminapi installiert haben) apigee-adminapi-Dienstprogramm 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 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 beim Installieren von SSO erstellt haben.

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

Für eine nicht standardmäßige Konfiguration

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

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

Nach Abschluss der Aktualisierung müssen Sie die Edge-UI-Komponente auf allen Computern neu starten, auf denen sie ausgeführt wird.