Apigee Edge 4.16.09 auf 4.17.01 aktualisieren

Edge for Private Cloud Version 4.17.01

Welche Edge-Versionen können Sie auf 4.17.01 aktualisieren

Mit diesem Verfahren können Sie die Apigee Edge-Version 4.16.09.0x auf 4.17.01 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.

Erforderliches Upgrade auf Qpid 1.35

Diese Version enthält ein erforderliches Update für Qpid 1.35. Zum Aktualisieren eines Qpid-Knotens müssen Sie:

• Verhindern Sie vorübergehend, dass Router und Nachrichtenprozessoren in den Qpid-Knoten schreiben, indem Sie Port 5672 auf dem Qpid-Knoten blockieren. Mit dem folgenden Befehl können Sie diesen Port auf dem Qpid-Knoten blockieren:
  > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s "Hostname" -i eth0 -j DROP
• Warten Sie, bis die Qpid-Warteschlange keine Nachrichten mehr enthält, um sicherzustellen, dass der Qpid-Knoten vor der Aktualisierung alle Nachrichten verarbeitet hat. Sorgen Sie mit dem folgenden Befehl dafür, dass die Qpid-Nachrichtenwarteschlange leer ist:
  > qpid-stat -q
• Aktualisieren Sie den Qpid-Knoten.
• Heben Sie die Blockierung von Port 5672 auf dem Qpid-Knoten auf, um den Zugriff von Routern und Message Processorn zu ermöglichen. Mit dem folgenden Befehl können Sie die Blockierung dieses Ports aufheben:
  > sudo iptables -F
  
  Wenn Sie iptables für andere Regeln verwenden, können Sie die entsprechende Änderung mit der Option „-D“ rückgängig machen:
  > sudo iptables -D INPUT -p tcp --destination-port 5672 ! -s "Hostname" -i eth0 -j DROP

Dieser Prozess wird unten für jede Edge-Topologie detailliert beschrieben.

Zum Aktivieren des EPEL-Repositorys erforderlich

Sie müssen Extra Packages for Enterprise Linux (oder EPEL) aktivieren, um Edge zu installieren oder zu aktualisieren. Welchen Befehl Sie verwenden, hängt von Ihrer Version von RedHat/CentOS ab:

• Für RedHat/CentOS 7.x:
  > wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm; rpm -ivh epel-release-latest-7.noarch.rpm
• Für RedHat/CentOS 6.x:
  wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm; rpm -ivh epel-release-latest-6.noarch.rpm

Erforderlich, wenn bei Verwendung einer externen Authentifizierung ein Update durchgeführt wird

Sie können einen externen Verzeichnisdienst in eine vorhandene Apigee Edge Private Cloud-Installation einbinden. Dieses Feature ist für jeden Verzeichnisdienst geeignet, der LDAP unterstützt, z. B. Active Directory oder OpenLDAP. Mit einer externen LDAP-Lösung können Systemadministratoren Nutzeranmeldedaten über einen zentralen Verzeichnisverwaltungsdienst außerhalb von Systemen wie Apigee Edge verwalten, die sie verwenden.

Weitere Informationen finden Sie unter Externe Authentifizierungskonfiguration.

Wenn die externe Authentifizierung aktiviert ist, verwenden die meisten Kunden das Feld für den Namen des Active Directory-SAM-Kontonamens als Nutzernamen für die Authentifizierung und nicht eine E-Mail-Adresse, die vom Edge-OpenLDAP-Server verwendet wird.

Wenn Sie einen externen Verzeichnisdienst integriert haben, fügen Sie Ihrer Konfigurationsdatei die folgende Zeile hinzu, wenn Sie Edge auf 4.17.01 aktualisieren:

IS_EXTERNAL_AUTH="true"

Mit dieser Zeile wird Edge so konfiguriert, dass ein Kontoname anstelle einer E-Mail-Adresse als Nutzername unterstützt wird.

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.

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 Sicherung und Wiederherstellung.
• 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 der Aktualisierung auf die vorherige Version erfordert, finden Sie weitere Informationen unter 4.17.01 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 zum Installieren von Edge 4.16.01 oder 4.16.05 verwendet haben.

Verfahren zum Aktualisieren auf 4.17.01 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 Apigee-Einrichtung installieren beschrieben.
4. Laden Sie die Datei Edge 4.17.01 bootstrap_4.17.01.sh in /tmp/bootstrap_4.17.01.sh herunter:
   > curl https://software.apigee.com/bootstrap_4.17.01.sh -o /tmp/bootstrap_4.17.01.sh
5. Installieren Sie das Edge 4.17.01-Dienstprogramm apigee-service und Abhängigkeiten:
   > sudo bash /tmp/bootstrap_4.17.01.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 der Anleitung unter 4.16.09 Rollback-Prozess.

Verfahren zur Aktualisierung auf 4.17.01 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 führen Sie ein Update von einem lokalen 4.17.01-Repository aus:

1. Erstellen Sie ein lokales 4.17.01-Repository, wie in „Lokales Apigee-Repository erstellen“ unter Dienstprogramm für Edge-Apigee-Setup installieren beschrieben.
   Hinweis: Wenn Sie bereits ein 4.16.09-Repository haben, können Sie das 4.17.01-Repository hinzufügen, wie unter „Lokales Apigee-Repository aktualisieren“ unter Edge-Dienstprogramm für 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 namens /opt/apigee/data/apigee-mirror/apigee-4.17.01.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.01.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-Dienstprogramm und die Abhängigkeiten aus /tmp/repos:
      > sudo bash /tmp/repos/bootstrap_4.17.01.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.01.sh in /tmp/bootstrap_4.17.01.sh herunter:
      > /usr/bin/curl http://uName:pWord@remoteRepo:3939/shbootstrap_name. re-Word1.0. Für DNS-Name:reWord1.
      
      
   3. Installieren Sie auf dem Remote-Knoten das Dienstprogramm Edge Apigee-Dienst und die Abhängigkeiten:
      > sudo bash /tmp/bootstrap_4.17.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeepassword=pWord apigeeprotocol=http://
      sind
      , wobei ApigeeuName:der Benutzername ist
      .
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.

# For a single data center, specify the same value as BAAS_CASS_LOCALDC.
BAAS_CASS_DC_LIST="dc-1"

# Defines the initial contact points for members of the BaaS cluster. 
# Specify the IP address of no more than two Stack nodes. 
BAAS_CLUSTER_SEEDS="dc-1:$IP4,dc-1:$IP5"

# For a single data center, specify the same value as BAAS_CASS_LOCALDC.
BAAS_CASS_DC_LIST="dc-1"

# Defines the initial contact points for members of the BaaS cluster. 
# Specify the IP address of no more than two Stack nodes. 
BAAS_CLUSTER_SEEDS="dc-1:$IP4,dc-1:$IP5"