Diese Seite wurde von der Cloud Translation API übersetzt.

Rollback für Apigee Edge 4.52.01 durchführen

Wenn während eines Updates auf Edge 4.52.01 ein Fehler auftritt, können Sie ein Rollback der Komponente, die den Fehler verursacht hat, und wiederholen Sie dann die Aktualisierung.

Sie können ein Rollback von Edge 4.52.01 auf die folgenden Hauptversionen durchführen:

Version 4.52.00
Version 4.51.00

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

Rollback auf eine vorherige Haupt- oder Nebenversion durchführen: Zum Beispiel von 4.52.01 bis 4.52.00.
Rollback auf eine frühere Patch-Version im selben veröffentlichen. Beispiel: von 4.52.00.02 bis 4.52.00.01.

Weitere Informationen finden Sie im Apigee Edge-Releaseprozess.

Wer ein Rollback durchführen kann

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

Standardmäßig werden Edge-Komponenten als Nutzer „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.

Komponenten mit gemeinsamem Code

Die folgenden Edge-Komponenten verwenden denselben Code. Wenn Sie also eine dieser Komponenten auf einem Knoten rückgängig machen möchten, müssen Sie alle diese Komponenten auf diesem Knoten rückgängig machen.

edge-management-server (Verwaltungsserver)
edge-message-processor (Nachrichtenverarbeiter)
edge-router (Router)
edge-postgres-server (Postgres-Server)
edge-qpid-server (Qpid-Server)

Wenn Sie beispielsweise den Verwaltungsserver, den Router und den Message Processor auf Knoten ausführen. Um für einen von ihnen ein Rollback durchzuführen, müssen Sie für alle drei ein Rollback durchführen.

Rollback auf eine vorherige Haupt- oder Nebenversion durchführen

Um ein Rollback auf eine vorherige Haupt- oder Nebenversion durchzuführen, führen Sie auf jedem Knoten, auf dem die Komponente:

Laden Sie die Datei bootstrap.sh für die Version herunter, auf die Sie umstellen möchten. zurück:
- Lade bootstrap_4.51.00.sh herunter, um ein Rollback auf Version 4.51.00 durchzuführen:
```
curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh 
```

Stoppen Sie die Komponente für ein Rollback:

So führen Sie ein Rollback für eine der Komponenten mit gemeinsamem Code auf der müssen Sie sie alle beenden, wie im folgenden Beispiel gezeigt:

/opt/apigee/apigee-service/bin/apigee-service edge-management-server stop
/opt/apigee/apigee-service/bin/apigee-service edge-router stop
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor stop
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop

Für ein Rollback einer beliebigen anderen Komponente auf dem Knoten müssen Sie nur diese Komponente beenden:
- ```
/opt/apigee/apigee-service/bin/apigee-service component stop
```

Wenn Sie die Monetarisierung rückgängig machen möchten, deinstallieren Sie sie auf allen Management-Server- und Message-Processor-Knoten:
```
/opt/apigee/apigee-service/bin/apigee-service edge-mint-gateway uninstall
```
Deinstallieren Sie die Komponente, um den Knoten rückgängig zu machen:
1. Wenn Sie eine der Komponenten mit gemeinsamem Code auf dem Knoten rückgängig machen möchten, müssen Sie alle Komponenten entfernen, indem Sie die edge-gateway-Komponentengruppe deinstallieren, wie im folgenden Beispiel gezeigt:
```
/opt/apigee/apigee-service/bin/apigee-service edge-gateway uninstall
```
2. Wenn Sie für eine andere Komponente auf dem Knoten ein Rollback durchführen möchten, deinstallieren Sie nur diese Komponente, da der Folgendes Beispiel zeigt:
```
/opt/apigee/apigee-service/bin/apigee-service component uninstall
```
  Dabei ist component der Name der Komponente.
3. Wenn Sie den Edge-Router rücksetzen möchten, müssen Sie nicht nur die edge-gateway-Komponentengruppe deinstallieren, sondern auch den Inhalt der Datei /opt/nginx/conf.d löschen:
```
cd /opt/nginx/conf.d
rm -rf *
```

Deinstallieren Sie Version 4.52.01 von apigee-setup:

/opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall

Version 4.51.00 von apigee-service installieren Dienstprogramms und seiner Abhängigkeiten. Im folgenden Beispiel wird die Version 4.51.00 der apigee-service installiert:
```
sudo bash /tmp/bootstrap_4.51.00.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 aufgefordert, ihn einzugeben.

Wenn ein Fehler auftritt, prüfen Sie, ob Sie in Schritt die Datei bootstrap.sh heruntergeladen haben 1.

Installieren Sie apigee-setup:

/opt/apigee/apigee-service/bin/apigee-service apigee-setup install

Installieren Sie die ältere Version der Komponente:
```
/opt/apigee/apigee-setup/bin/setup.sh -p component -f configFile
```
Dabei ist component die zu installierende Komponente und configFile die Konfigurationsdatei für die ältere Version.
Wenn Sie ein Rollback für Qpid durchführen, leeren Sie iptables:
```
sudo iptables -F
```
Wiederholen Sie diesen Vorgang für jeden Knoten, auf dem die Komponente gehostet wird, für die Sie das Rollback durchführen.

Rollback auf einen vorherigen Patchrelease durchführen

Führen Sie für jeden Knoten die folgenden Schritte aus, um für eine Komponente ein Rollback auf einen bestimmten Patchrelease durchzuführen auf dem die Komponente gehostet wird:

Laden Sie die jeweilige Komponentenversion herunter:
```
/opt/apigee/apigee-service/bin/apigee-service component_version install
```
Dabei ist component_version die Komponente und der Patchrelease, die installiert werden sollen. Beispiel:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui-4.51.05-0.0.3749 install
```
Wenn Sie das Apigee-Online-Repository verwenden, können Sie die verfügbare Komponente ermitteln. Versionen mit dem folgenden Befehl:
```
yum --showduplicates list comp
```
Beispiel:
```
yum --showduplicates list edge-ui
```
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 bei der Installation nur den Namen der Komponente angeben, nicht die Version.
Wiederholen Sie diesen Vorgang für jeden Knoten, auf dem die Komponente gehostet wird, für die Sie das Rollback durchführen.

Rollback des Updates für Postgres 10.17 durchführen

Wenn Sie von Version 4.50.00 oder 4.51.00 auf 4.52.01 aktualisiert haben, müssen Sie für Ihre Postgres wird zusätzlich zu den Edge-Komponenten aktualisiert.

So führen Sie ein Rollback des Postgres-Updates aus, wenn Sie Postgres in einer Master-Standby-Konfiguration aktualisieren:

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. Anschließend können Sie 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:
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“. Der Standardwert ist „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
```
Wenn Sie den alten Standby-Knoten bereits auf die neuere Version aktualisiert haben, müssen Sie zuerst ein Downgrade der Apigee-Software auf den alten Standby-Knoten durchführen. Wenn Sie noch die ältere Version verwenden Standby-Knoten haben, können Sie diesen Schritt überspringen und mit Schritt 6 fortfahren.
1. Beenden Sie Postgres auf dem alten Standby-Knoten:
```
apigee-service apigee-postgresql stop
apigee-service edge-postgres-server stop
```
2. Deinstallieren Sie Postgres vom alten Standby-Knoten:
```
apigee-service apigee-postgresql uninstall
apigee-service edge-postgres-server uninstall
```
3. Löschen Sie das Postgres-Datenverzeichnis aus dem alten Standby-Knoten:
```
cd /opt/apigee/data/apigee-postgresql/pgdata > rm -rf *
```
4. Laden Sie die ältere Version des Bootstrap (für die Apigee-Version, die Sie gerade ausführen) herunter und führen Sie sie aus auf dem alten Standby-Knoten. Die genaue Vorgehensweise hängt davon ab, ob Sie oder offline installiert werden. Wenn Sie die ältere Version des Apigee-Bootstraps ausführen, werden die Yum-Repositories mit den älteren Apigee-Daten eingerichtet.
5. Richten Sie Postgres-Komponenten auf dem alten Standby-Knoten ein:
```
/opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
```
6. Postgres-Komponenten auf dem alten Standby-Knoten prüfen und bestätigen wurden auf die ältere Version zurückgesetzt:
```
apigee-service apigee-postgresql version
apigee-service edge-postgres-server version
```
Wiederherstellen des alten Standby-Knotens:
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. Prüfen Sie, ob Postgres auf dem alten Standby-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-service edge-postgres-server start
```
Prüfen Sie, ob der neue Standby-Knoten hinzugefügt wurde, indem Sie die Datei /opt/apigee/apigee-postgresql/conf/pg_hba.conf auf dem neuen Master aufrufen.

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 und den Namen der Zielgruppe im Feld name unter consumer-groups zurück. 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 für dem alten Masterknoten:
```
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 edge-postgres-server-Dienst muss ausgeführt werden soll. 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 den alten Master und die 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
```
Dabei sind 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 den alten Master und die 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

Das Attribut 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
```
Die UUIDs der neuen Master- und Standby-Knoten sollten in der Analysegruppe aufgeführt sein und die 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

Prüfen Sie den Replikationsstatus, indem Sie die folgenden Scripts auf beiden Servern ausführen. Das System sollte auf beiden Servern identische Ergebnisse anzeigen, um eine erfolgreiche Replikation zu gewährleisten:
Führen Sie auf dem neuen Master Folgendes aus:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
```
Überprüfen Sie, ob 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 Außerbetriebnahme Postgres-Knoten.
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 Installieren Sie Qpid auf dem neuen Masterknoten. Nach der Deinstallation von Qpid können Sie den alten Masterknotens.

Rollback für mTLS durchführen

Führen Sie die folgenden Schritte auf allen Hosts aus, um ein Rollback der mTLS-Aktualisierung durchzuführen:

Beenden Sie Apigee:
```
apigee-all stop
```
Beenden Sie mTLS:
```
apigee-service apigee-mtls uninstall
```

mTLS neu installieren:

apigee-service apigee-mtls install
apigee-service apigee-mtls setup -f /opt/silent.conf