Diese Seite wurde von der Cloud Translation API übersetzt.

4.18.01 Rollback-Prozess

Edge for Private Cloud v4.18.01

Tritt während eines Updates auf Edge 4.18.01 ein Fehler auf, können Sie ein Rollback der Komponente durchführen. die den Fehler verursacht hat, und versuchen Sie es noch einmal. Wenn z. B. das Update auf Postgres 9.6 schlägt er fehl, können Sie nur für die Postgres-Knoten ein Rollback durchführen und die Aktualisierung erneut versuchen.

Es gibt zwei Szenarien, in denen Sie möglicherweise ein Rollback durchführen möchten:

Rollback auf einen älteren Release durchführen. Beispiel: von 4.18.01 bis 4.17.01.
Rollback auf eine ältere Version im selben Release.

Gehen Sie wie unten beschrieben vor, um für beide Szenarien ein Rollback durchzuführen.

Wer das Rollback durchführen kann

Der Nutzer, der das Rollback durchführt, sollte mit dem Benutzer identisch sein, der Edge ursprünglich aktualisiert hat, oder ein Nutzer, der als Root ausgeführt wird.

Standardmäßig werden Edge-Komponenten als der Benutzer „apigee“ ausgeführt. In einigen Fällen führen Sie möglicherweise Edge aus, als unterschiedliche Nutzende. Wenn der Router beispielsweise auf privilegierte Ports wie unter 1.000 liegen, muss der Router als Root oder als Nutzer mit Zugriff darauf ausgeführt werden. Ports. Oder Sie führen eine Komponente als ein Nutzer und eine andere Komponente als ein anderer Nutzer aus.

Für welche Komponenten ein Rollback durchgeführt werden kann

Beachten Sie die folgenden Bedingungen, wenn Sie ein Rollback durchführen:

Die fünf unten aufgeführten Edge-Komponenten verwenden denselben Code. Wenn Sie also für einen der einer der fünf Komponenten auf einem Knoten müssen Sie für jede der fünf auf dem Knoten installierten Komponenten ein Rollback durchführen. Für Wenn Sie beispielsweise den Verwaltungsserver, den Router und den Message Processor auf der Wenn Sie für einen von ihnen ein Rollback durchführen möchten, müssen Sie für alle drei ein Rollback durchführen.

Die fünf Komponenten, die Code gemeinsam nutzen, sind:
- Verwaltungsserver
- Router
- Message Processor
- QPID-Server
- Postgres-Server
Wenn Sie eine Aktualisierung von Edge 4.16.01 durchführen, führen Sie kein Rollback von Cassandra durch. Dieses von Edge eine aktualisierte Version von Cassandra enthält. Wenn Sie für Komponenten ein Rollback durchführen, Cassandra mit der Version 4.18.01.

Rollback auf Version 4.18.01

In diesem Abschnitt wird das Verfahren für ein Rollback von Edge 4.18.01 auf eine frühere Version beschrieben. Dieses ist in zwei Teile gegliedert:

Rollback des Postgres-Updates
Der letzte Teil jedes Aktualisierungsverfahrens ist die Aktualisierung der Postgres-Knoten auf Version 9.6. Wenn das eine Aktualisierung fehlschlägt, können Sie mit diesem Verfahren ein Rollback der Aktualisierung durchführen.
Rollback aller anderen Edge-Komponenten
Verwenden Sie dieses Verfahren, um ein Rollback für alle anderen Edge-Komponenten durchzuführen.

Rollback des Postgres 9.6-Updates durchführen

So führen Sie ein Rollback des Postgres-Updates beim Aktualisieren von Postgres in einer Master-Standby-Konfiguration durch: Ich:

Stufen Sie den neuen Standby-Knoten zum Postgres-Master hoch. Der neue Postgres-Master ist dieselbe Version wie bei der vorherigen Edge-Installation.
Konfigurieren Sie den alten Standby-Knoten als Standby-Knoten des neuen Masters. Den alten Standby-Knoten haben dieselbe Version wie bei der vorherigen Edge-Installation.
Registrieren Sie die neuen Master- und Standby-Knoten bei den Analyse- und Nutzergruppen.

Wenn Sie mit dem Rollback fertig sind, ist der alte Masterknoten nicht mehr erforderlich. Sie können und den alten Masterknoten außer Betrieb nehmen.

Achten Sie darauf, dass der neue Standby-Postgres-Knoten 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
```

Stellen Sie sicher, dass Postgres auf dem alten Master-Knoten und dem alten Standby-Knoten beendet wurde:

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

Wenn Postgres ausgeführt wird, beenden Sie es:

> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop

Wenn installiert, starten Sie Qpid auf dem alten Standby-Knoten:
```
> /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
```
Hinweis: In vielen Konfigurationen wird der alte Stand-by-Knoten Sie hosten nur Postgres, aber nicht Qpid.
Stufen Sie den neuen Standby-Knoten als Postgres-Master hoch: <ph type="x-smartling-placeholder">
1. Stufen Sie den neuen Standby-Knoten zum neuen Master hoch:
```
> apigee-service apigee-postgresql promote-standby-to-master new_standby_IP
```
  Geben Sie bei Aufforderung das Postgres-Passwort für „apigee“ ein „Nutzer“, was standardmäßig auf „postgres“.
2. Bearbeiten Sie die Konfigurationsdatei, die Sie zum Installieren der aktuellen Version von Edge verwendet haben, um anzugeben, Folgendes:
```
# IP address of the new master:
PG_MASTER=new_standby_IP
# IP address of the old standby node
PG_STANDBY=old_standby_IP
```
3. Konfigurieren Sie den neuen Master:
```
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-master -f configFile
```
Erstellen Sie den alten Standby-Knoten neu: <ph type="x-smartling-placeholder">
1. Bearbeiten Sie die Konfigurationsdatei, die Sie zum Installieren der aktuellen Version von Edge verwendet haben, um anzugeben, Folgendes:
```
# IP address of the new master:
PG_MASTER=new_standby_IP
# IP address of the old standby node
PG_STANDBY=old_standby_IP
```
2. Entfernen Sie das Datenverzeichnis auf dem alten Standby-Knoten:
```
> cd /opt/apigee/data/apigee-postgresql/pgdata > rm -rf *
```
3. Konfigurieren Sie den alten Standby-Knoten zu einem Standby-Knoten des neuen Masters:
```
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
```
4. Stellen Sie sicher, dass Postgres auf dem alten Standby-Knoten ausgeführt wird:
```
> /opt/apigee/apigee-service/bin/apigee-all status
```
  Wenn er nicht ausgeführt wird, starten Sie ihn:
```
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
```
Überprüfen Sie in der Datei /opt/apigee/apigee-postgresql/conf/pg_hba.conf auf der neuen Masterinstanz.

Sehen Sie sich die aktuellen Analyse- und Nutzergruppeninformationen an, indem Sie den folgenden Befehl ausführen auf dem Verwaltungsserver:

> curl -u sysAdminEmail:password http://ms_IP:8080/v1/analytics/groups/ax

Dieser Befehl gibt den Namen der Analysegruppe im Feld name zurück und der Name der Verbrauchergruppe im Feld name unter consumer-groups. Außerdem gibt die UUIDs der alten Postgres-Master- und Standby-Knoten im postgres-server und im Feld datastores. Sie sollten Folgendes sehen: -Ausgabe im Format:

{
  "name" : "axgroup-001",
  "properties" : {
  },
  "scopes" : [ "VALIDATE~test", "sgilson~prod" ],
  "uuids" : {
    "qpid-server" : [ "8381a053-433f-4382-bd2a-100fd37a1592", "4b6856ec-ef05-498f-bac6-ef5f0d5f6521" ],
    "postgres-server" : [
      "ab1158bd-1d59-4e2a-9c95-24cc2cfa6edc:27f90844-efab-4b32-8a23-8f85cdc9a256"
    ]
  },
  "consumer-groups" : [ {
    "name" : "consumer-group-001",
    "consumers" : [ "8381a053-433f-4382-bd2a-100fd37a1592", "4b6856ec-ef05-498f-bac6-ef5f0d5f6521" ],
    "datastores" :
      [ "ab1158bd-1d59-4e2a-9c95-24cc2cfa6edc:27f90844-efab-4b32-8a23-8f85cdc9a256" ],
      "properties" : {     }
    }
  ],
  "data-processors" : {
  }
}

Rufen Sie die UUID-Adresse des alten Masters ab, indem Sie den folgenden cURL-Befehl auf der alten Master-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"
```
Hinweis: Der Dienst edge-postgres-server muss eine ausgeführt wird. Wenn der Postgres-Server nicht ausgeführt wird, können Sie den folgenden Befehl auf der Verwaltungsserver zum Ermitteln der UUID:
```
> curl -u sysAdminEmail:password http://ms_IP:8080/v1/servers?pod=analytics
```
Die Ausgabe dieses Befehls listet die UUID für die IP-Adresse jedes Postres-Knotens auf.
Wiederholen Sie den vorherigen Schritt, um die IP-Adressen des alten und des neuen Standby-Knotens abzurufen. Master.
Entfernen Sie alte Master- und Standby-Knoten aus der Nutzergruppe:
```
> curl -u sysAdminEmail:password -X DELETE
  "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/consumer-groups/consumer-group-001/datastores/masterUUID,standbyUUID" -v
```
wobei axgroup-001 und consumer-group-001 die Standardnamen der Analysen und Nutzergruppen. masterUUID,standbyUUID befinden sich in derselben Reihenfolge wie sie oben angezeigt, wenn Sie sich die aktuellen Informationen zu Analysen und Nutzergruppen oben angesehen haben. Ich müssen sie möglicherweise als standbyUUID,masterUUID angeben.

Die Eigenschaft datastores für consumer-groups sollte jetzt leer.

Entfernen Sie die alten Master- und Standby-Knoten aus der Analysegruppe:

> curl -u sysAdminEmail:password -X DELETE
  "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/servers?uuid=masterUUID,standbyUUID&type=postgres-server" -v

Die Eigenschaft postgres-server unter uuids sollte jetzt leer sein.

Registrieren Sie neue PG-Master- und Standby-Knoten bei den Analyse- und Nutzergruppen:

> curl -u sysAdminEmail:password -X POST -H "Content-Type: application/json" -d ''
  "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/servers?uuid=masterUUID,standbyUUID&type=postgres-server" -v
> curl -u sysAdminEmail:password -X POST -H "Content-Type:application/json" -d ''
  "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/consumer-groups/consumer-group-001/datastores?uuid=masterUUID,standbyUUID" -v

Validieren Sie die Analysegruppe:
```
> curl -u sysAdminEmail:password http://ms_IP:8080/v1/analytics/groups/ax
```
Sie sollten die UUIDs der neuen Master- und Standby-Knoten in der Analysegruppe sehen und Nutzergruppe.

Starten Sie den Edge-Verwaltungsserver neu:

> /opt/apigee/apigee-service/bin/apigee-service edge-management-server restart

Starten Sie alle Qpid-Server neu:

> /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart

Starten Sie alle Postgres-Server neu:

> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server restart

Überprüfen Sie den Replikationsstatus, indem Sie die folgenden Skripts auf beiden Servern ausgeben. Das System sollte auf beiden Servern identische Ergebnisse anzeigen, um eine erfolgreiche Replikation zu gewährleisten:

Führen Sie auf dem neuen Master folgenden Befehl aus:
```
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
```
Validieren, dass es sich um den Master handelt. Auf dem alten Standby-Knoten:
```
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
```
Prüfen Sie, ob es sich um den Standby-Modus handelt.
Wiederholen Sie den vorherigen Schritt, nachdem Sie mehrere API-Anfragen gestellt haben, um sicherzustellen, dass sich die Knoten in synch.
Fahren Sie den alten Postgres-Master mit dem Verfahren in Apigee Edge aktualisieren 4.16.01/4.16.05 bis 4.17.09.
Hinweis: Wenn auf dem alten Master-Knoten Qpid ausgeführt wurde, können Sie diesen Server zum Ausführen von Qpid belassen. Prüfen Sie, ob sie ausgeführt wird. Falls nicht, starten Sie ihn so:
```
> /opt/apigee/apigee-service/bin/apigee-service edge-management-server start
```
Alternativ können Sie Qpid von der alten Master-Instanz deinstallieren und auf der neuen Master-Instanz installieren. wie unten beschrieben. Nach der Deinstallation von Qpid können Sie den alten Master außer Betrieb nehmen. Knoten.

Qpid wird vom alten Master nicht installiert und Qpid auf der neuen Master-Instanz installiert.

Gehen Sie wie folgt vor, um Qpid vom alten Master zu deinstallieren und auf dem neuen Master:

Blockieren des Zugriffs auf Qpid-Port 5672 auf dem alten Master durch Message Processor durch und führen Sie den folgenden Befehl für alle Message Processors aus:
```
> iptables -A OUTPUT -p tcp -d 10.233.147.20 --dport 5672 -j DROP
```
Stellen Sie sicher, dass die Qpid-Nachrichtenwarteschlange leer ist, indem Sie den folgenden Befehl ausführen. Sie können nicht deinstalliere Qpid, bis alle ausstehenden Nachrichten verarbeitet wurden:
```
> qpid-stat -q
```
Mit diesem Befehl wird eine Tabelle mit einer Anzahl für msg, msgIn, and msgOut angezeigt. Alle Nachrichten wurden verarbeitet, wenn msg=0, und msgIn=msgOut.
Ermitteln Sie die UUID des Qpid-Servers auf dem alten Master, indem Sie den folgenden Befehl auf ausführen: dem alten Meister. Speichern Sie diese Informationen für später:
```
> curl -u sysAdminEmail:password http://node_IP::8083/v1/servers/self
```

Beenden Sie Qpid auf der alten Master-Instanz:

> /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
> /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd stop

Qpid-Server deinstallieren:

> /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server uninstall
> /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd uninstall

Entfernen Sie den alten Qpid-Server aus den Analyse- und Nutzergruppen:

> curl -u sysAdminEmail:password -X DELETE -H "Content-Type: application/json" -d ''
  "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/consumer-groups/consumer-group-001/consumers/qpid_UUID" -v
> curl -u sysAdminEmail:password -X DELETE
  "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/servers?uuid=qpid_UUID&type=qpid-server" -v

Entfernen Sie den alten Qpid-Server aus Zookeeper:

> curl -u sysAdminEmail:password -X DELETE
  http://ms_IP:8080/v1/servers/qpid_UUID

Installieren Sie Qpid auf dem neuen Master:

> /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile

Ermitteln Sie die UUID des Qpid-Servers auf dem neuen Master, indem Sie den folgenden Befehl auf ausführen: dem neuen Master an. Speichern Sie diese Informationen für später:
```
> curl -u sysAdminEmail:password
  http://node_IP::8083/v1/servers/self
```

Registrieren Sie den neuen Qpid-Server bei den Analyse- und Nutzergruppen:

> curl -u sysAdminEmail:password -X POST -H "Content-Type: application/json" -d ''
  "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/servers?uuid=qpid_UUID&type=qpid-server" -v
> curl -u sysAdminEmail:password -X POST -H "Content-Type:application/json" -d ''
  "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/consumer-groups/consumer-group-001/consumers?uuid=qpid_UUID" -v

Starten Sie alle Message Processors neu:

> /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart

Führen Sie den folgenden Befehl auf dem neuen Qpid-Server aus, um zu prüfen, ob Warteschlangen erstellt wurden:
```
> qpid-stat -q
```
Stellen Sie sicher, dass msg, msgIn und msgOut als QPID-Server aktualisiert wird. Nachrichten verarbeitet.

So führen Sie ein Rollback für einzelne Komponenten 4.18.01

Im Rahmen des Rollbacks müssen Sie die Datei bootstrap.sh für Ihr Aktuelle Version von Edge:

Für ein Rollback auf Version 4.17.09 musst du bootstrap_4.17.09.sh herunterladen
Für ein Rollback auf Version 4.17.05 musst du bootstrap_4.17.05.sh herunterladen
Für ein Rollback auf Version 4.17.01 musst du bootstrap_4.17.01.sh herunterladen
Für ein Rollback auf Version 4.16.09 musst du bootstrap_4.16.09.sh herunterladen
Für ein Rollback auf Version 4.16.05 musst du bootstrap_4.16.05.sh herunterladen
Für ein Rollback auf Version 4.16.01 musst du bootstrap.sh herunterladen

Führen Sie für jeden Knoten, auf dem eine Komponente gehostet wird, ein Rollback durch:

Beenden Sie die Komponente für ein Rollback: <ph type="x-smartling-placeholder">
1. Wenn Sie eine der folgenden Komponenten auf dem Knoten zurücksetzen, müssen Sie Halten Sie sie alle an: Management Server, Router, Message Processor, Qpid Server oder Postgres. Server: <ph type="x-smartling-placeholder">
  - ```
  > apigee-service edge-management-server stop
```
- ```
> apigee-service edge-router stop
```
  - ```
  > apigee-service edge-message-processor stop
```
- ```
> apigee-service edge-qpid-server stop
```
  - ```
  > apigee-service edge-postgres-server stop
```
2. Wenn Sie eine andere Komponente auf dem Knoten zurücksetzen, stoppen Sie nur diese Komponente Komponente: <ph type="x-smartling-placeholder">
  - ```
  > apigee-service comp stop
```
Wenn du ein Rollback der Monetarisierung durchführst, deinstalliere sie auf allen Verwaltungsservern und Nachrichten Prozessorknoten:
```
> apigee-service edge-mint-gateway uninstall
```
Deinstallieren Sie die Komponente, um ein Rollback auf dem Knoten durchzuführen: <ph type="x-smartling-placeholder">
1. Wenn Sie eine der folgenden Komponenten auf dem Knoten rückgängig machen, Deinstallieren Sie sie alle: Management Server, Router, Message Processor, Qpid Server oder Postgres. Server:
```
> apigee-service edge-gateway uninstall
```
2. Wenn Sie eine andere Komponente auf dem Knoten zurücksetzen, deinstallieren Sie nur diese Komponente:
```
> apigee-service comp uninstall
```
3. Wenn Sie ein Rollback des Routers durchführen, löschen Sie die Inhalte von /opt/nginx/conf.d:
```
> cd /opt/nginx/conf.d
> rm -rf *
```
So führen Sie ein Rollback der Komponente durch: <ph type="x-smartling-placeholder">
1. Deinstallieren Sie Version 4.18.01 von apigee-setup:
```
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall
```
2. Laden Sie bootstrap.sh für die gewünschte Version herunter, z. B. für 4.16.09:
```
> curl https://software.apigee.com/bootstrap_4.16.09.sh -o /tmp/bootstrap_4.16.09.sh 
```
3. Installieren Sie das apigee-service-Dienstprogramm 4.16.01, 4.16.05 oder 4.16.09 und Abhängigkeiten. Zum Beispiel für 4.16.09:
```
> sudo bash /tmp/bootstrap_4.16.09.sh apigeeuser=uName apigeepassword=pWord
```
  Dabei sind uName und pWord der Nutzername und das Passwort, die Sie erhalten haben. von Apigee. Wenn Sie pWord weglassen, werden Sie zur Eingabe .
4. Installieren Sie apigee-setup:
```
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
```
5. Installieren Sie die gewünschte Version der Komponente:
```
> /opt/apigee/apigee-setup/bin/setup.sh -p comp -f configFile
```
  Dabei ist comp die zu installierende Komponente und configFile die Konfigurationsdatei für die gewünschte Version.
6. Wenn Sie ein Rollback für Qpid durchführen, leeren Sie iptables:
```
> sudo iptables -F
```
So führen Sie ein Rollback der Komponente auf eine bestimmte Version der Version 4.18.01 durch: <ph type="x-smartling-placeholder">
1. Laden Sie die jeweilige Komponentenversion herunter:
```
> /opt/apigee/apigee-service/bin/apigee-service comp-version install
```
  Dabei ist comp-version die zu installierende Komponente und die zu installierende Version. Beispiel:
```
> /opt/apigee/apigee-service/bin/apigee-service edge-ui-4.17.09-0.0.3749 install
```
  Wenn Sie das Apigee-Online-Repository verwenden, können Sie die verfügbaren Komponentenversionen ermitteln. indem Sie den folgenden Befehl verwenden:
```
> yum --showduplicates list comp
```
  Beispiel:
```
> yum --showduplicates list edge-ui
```
2. Verwenden Sie apigee-setup, um die Komponente zu installieren:
```
> /opt/apigee/apigee-setup/bin/setup.sh -p comp -f configFile
```
  Beispiel:
```
> /opt/apigee/apigee-setup/bin/setup.sh -p ui -f configFile
```
  Beachten Sie, dass Sie den Komponentennamen nur bei der Installation angeben.

Wenden Sie sich an den Apigee Edge-Support, wenn beim Rollback Probleme auftreten.