Komponenten neu installieren und wiederherstellen

In diesem Dokument wird die Neuinstallation und Wiederherstellung einer Edge-Komponente beschrieben. Verwenden Sie diese Vorgehensweise, wenn Sie die Edge-Komponente neu installieren müssen, bevor Sie die Sicherung wiederherstellen.

Apache ZooKeeper

Einen eigenständigen Knoten wiederherstellen

1. ZooKeeper beenden:

   /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop

2. Entfernen Sie alte ZooKeeper-Verzeichnisse:

   /opt/apigee/data/apigee-zookeeper
   /opt/apigee/etc/apigee-zookeeper.d

3. ZooKeeper neu installieren:

   /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper install

4. ZooKeeper wiederherstellen:

   /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper restore 2019.03.17,14.40.41

   Beachten Sie, dass Sie beim Wiederherstellen einer Komponente weder den Verzeichnispfad zur Sicherungsdatei noch das Präfix „backup-“ oder das Suffix „.tar.gz“ angeben. Sie geben nur den Datums-/Uhrzeit-Teil des Namens der Sicherungsdatei an.

   Sie können die Sicherungsdatei im Befehl restore optional weglassen. Edge verwendet dann die neueste Sicherungsdatei im Sicherungsverzeichnis der Komponente.

5. Starten Sie alle Komponenten neu:

   /opt/apigee/apigee-service/bin/apigee-all restart

Einen Clusterknoten wiederherstellen

Wenn ein einzelner ZooKeeper-Knoten ausfällt, der Teil eines Ensembles ist, können Sie einen neuen Knoten mit demselben Hostnamen/derselben IP-Adresse erstellen und ZooKeeper neu installieren. Wenn der neue ZooKeeper-Knoten dem ZooKeeper-Ensemble beitritt, erhält er die neuesten Snapshots vom Leader und beginnt, Clients zu bedienen. Sie müssen in diesem Fall keine Daten wiederherstellen.

1. ZooKeeper neu installieren:

   /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper install

2. Führen Sie die Einrichtung auf dem ZooKeeper-Knoten mit derselben Konfigurationsdatei aus, die bei der Installation des ursprünglichen Knotens verwendet wurde:

   /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper setup -f configFile

3. Starten Sie ZooKeeper:

   /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper start

Vollständigen Cluster wiederherstellen

1. Beenden Sie den gesamten Cluster.
2. Stellen Sie alle ZooKeeper-Knoten aus der Sicherungsdatei wieder her, wie oben für einen einzelnen Knoten beschrieben.
3. Starten Sie den ZooKeeper-Cluster.
4. Starten Sie alle Komponenten neu.

Apache Cassandra

Einen eigenständigen Knoten wiederherstellen

1. Cassandra beenden:

   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop

2. Entfernen Sie das alte Cassandra-Verzeichnis:

   /opt/apigee/data/apigee-cassandra

3. Installieren Sie Cassandra neu:

   /apigee/apigee-service/bin/apigee-service apigee-cassandra install

4. Cassandra wiederherstellen:

   /apigee/apigee-service/bin/apigee-service apigee-cassandra restore 2019.03.17,14.40.41

   Beachten Sie, dass Sie beim Wiederherstellen einer Komponente weder den Verzeichnispfad zur Sicherungsdatei noch das Präfix „backup-“ oder das Suffix „.tar.gz“ angeben. Sie geben nur den Datums-/Uhrzeit-Teil des Namens der Sicherungsdatei an.

   Sie können die Sicherungsdatei im restore-Befehl optional weglassen. Edge verwendet dann die letzte Sicherungsdatei im Sicherungsverzeichnis der Komponente.

5. Alle Komponenten neu starten:
   

   /apigee/apigee-service/bin/apigee-all restart

Einen Clusterknoten wiederherstellen

Wenn ein einzelner Cassandra-Knoten, der Teil eines Ensembles ist, ausfällt, können Sie einen neuen Knoten mit demselben Hostnamen bzw. derselben IP-Adresse erstellen. Sie müssen Cassandra nur neu installieren und einige zusätzliche Schritte ausführen. Sie müssen die Daten nicht aus Sicherungen wiederherstellen. Replikate, die auf anderen Knoten verfügbar sind, können verwendet werden, um Daten auf dem ausgefallenen Knoten wiederherzustellen. Diese Schritte sind in der Regel anwendbar, wenn ein Knoten in Ihrem Cassandra-Cluster aufgrund von Hardwarefehlern usw. abstürzt.

Wenn der ausgefallene Knoten nicht mehr zugänglich ist, zerstören Sie ihn und isolieren Sie sein Netzwerk, damit er nicht versehentlich wieder dem Cassandra-Cluster beitritt. Rufen Sie dann einen neuen Knoten mit derselben IP-Adresse wie der ursprüngliche Knoten auf und führen Sie die üblichen Apigee-Bootstrap-Schritte darauf aus.

Wenn der Knoten noch zugänglich ist und Sie ihn wiederverwenden möchten, führen Sie die folgenden Schritte aus:

1. Beenden Sie den Cassandra-Prozess auf dem Knoten:
   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop
2. Deinstallieren Sie die Cassandra-Software vom Knoten:
   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra uninstall
3. Löschen Sie das Datenverzeichnis vom Knoten:
   rm -rf /opt/apigee/data/apigee-cassandra

Nachdem Sie die oben genannten Schritte ausgeführt haben, sollten Sie einen Knoten mit derselben IP-Adresse wie der ausgefallene Knoten haben, der für die Installation der Apigee-Software bereit ist. Führen Sie diese Schritte aus:

1. Identifizieren Sie die Seed-Knoten des Rechenzentrums.
   1. Führen Sie auf einem beliebigen betriebsbereiten Cassandra-Knoten im selben Rechenzentrum wie der wiederherzustellende Knoten den folgenden Befehl aus:

      apigee-service apigee-cassandra configure -search conf_cassandra_seeds

   2. Die Ausgabe sieht in etwa so aus:

      Found key conf_cassandra_seeds, with value, "127.0.0.1", in /opt/apigee/apigee-cassandra/token/default.properties
      Found key conf_cassandra_seeds, with value, 127.0.0.1, in /opt/apigee/apigee-cassandra/token/application/cassandra.properties
      Found key conf_cassandra_seeds, with value, "10.1.0.1,10.1.0.2", in /opt/apigee/token/application/cassandra.properties
      apigee-configutil: apigee-cassandra: # OK

   3. Sehen Sie sich die letzte Zeile der Ausgabe an. Die aufgeführten, kommagetrennten IP-Adressen sind die Seed-Knoten, die von Knoten in diesem Rechenzentrum verwendet werden.
2. Erstellen oder bearbeiten Sie auf dem wiederhergestellten Knoten die folgende Datei:
   

   vi /opt/apigee/customer/application/cassandra.properties
   

3. Add the following line:
   

   conf_jvm_options_custom_settings=-Dcassandra.replace_address=<ip-address-of-dead-node>

4. Wenn dieser Knoten einer der Seed-Knoten ist (die IP-Adresse des Knotens wird in der Seed-Knotenliste aus Schritt 1 angezeigt), fügen Sie der Datei eine weitere Zeile hinzu:
   

   conf_cassandra_seeds="<comma-separated-seed-list-except-this-node’s-ip>"

   1. Im obigen Beispiel enthält die Quellliste zwei IP-Adressen: 10.1.0.1 und 10.1.0.2. Wenn der wiederherzustellende Knoten 10.1.0.1 ist, fügen Sie eine Zeile wie diese hinzu:
      

      conf_cassandra_seeds="10.1.0.2"

5. Speichern Sie die Datei und sorgen Sie dafür, dass sie dem Apigee-Nutzer gehört und von ihm gelesen werden kann:
   

   chown apigee:apigee /opt/apigee/customer/application/cassandra.properties

6. Installieren Sie die Cassandra-Software:
   

   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra install

7. Führen Sie die Cassandra-Einrichtung aus:
   

   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra setup -f <configFile>

8. Bei der Einrichtung wird intern versucht, den Cassandra-Dienst zu bootstrappen. Je nachdem, wie viele Daten von anderen Knoten gestreamt werden müssen, wie hoch Ihr Netzwerkdurchsatz ist usw., kann das eine Weile dauern.
9. [Erweiterte Option] Sie können das Streamen von Daten beschleunigen, indem Sie die folgenden nodetool-Befehle auf dem Knoten ausführen:
   

   nodetool setstreamthroughput <value>
   nodetool setcompactionthroughput <value>

10. Sobald der Cassandra-Knoten wieder aktiv ist, können Sie mit Standardbefehlen wie dem folgenden prüfen, ob der Knoten dem Ring erfolgreich beigetreten ist:
    

    /opt/apigee/apigee-cassandra/bin/nodetool ring
    /opt/apigee/apigee-cassandra/bin/nodetool status

11. Nachdem Sie überprüft haben, ob der Knoten erfolgreich ausgeführt wird, bearbeiten Sie die Datei /opt/apigee/customer/application/cassandra.properties noch einmal und entfernen Sie die Zeilen, die Sie zuvor in den Schritten 3 und 4 hinzugefügt haben.
12. Starten Sie den Cassandra-Dienst auf dem Knoten neu:
    

    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart

Vollständigen Cluster wiederherstellen

1. Beenden Sie den gesamten Cluster.
2. Stellen Sie alle Cassandra-Knoten aus der Sicherungsdatei wieder her.
3. Starten Sie den Cassandra-Cluster.
4. Starten Sie alle Komponenten neu.

PostgreSQL-Datenbank

PostgreSQL, das eigenständig oder als Master ausgeführt wird

1. Beenden Sie den Management Server, den Qpid-Server und den Postgres-Server auf allen Knoten:

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

2. PostgreSQL-Datenbank neu installieren:

   /apigee/apigee-service/bin/apigee-service apigee-postgresql install 

3. Starten Sie PostgreSQL:

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start

4. Stellen Sie die PostgreSQL-Datenbank aus der Sicherungsdatei wieder her:

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restore 2019.03.17,14.40.41

   Beachten Sie, dass Sie beim Wiederherstellen der PostgreSQL-Komponente weder den Verzeichnispfad zur Sicherungsdatei noch das Suffix „.dump“ angeben. Sie geben nur den Datums-/Uhrzeit-Teil des Namens der Sicherungsdatei an.

   Sie können die Sicherungsdatei im Befehl restore optional weglassen. Edge verwendet dann die neueste Sicherungsdatei im Sicherungsverzeichnis der Komponente.

5. Starten Sie den Management Server, den Qpid Server und den Postgres Server auf allen Knoten:

   /opt/apigee/apigee-service/bin/apigee-service edge-management-server start
   /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
   /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start

PostgreSQL wird als Standby ausgeführt

1. Installieren Sie die PostgreSQL-Datenbank neu:

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql install

2. Konfigurieren Sie die PostgreSQL-Datenbank mit derselben Konfigurationsdatei neu, die Sie für die Installation verwendet haben:
   

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup -f configFile

3. Starten Sie PostgreSQL:

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start 

Postgres-Server

1. Beenden Sie den Postgres-Server auf allen Master- und Standby-Knoten:

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

2. Entfernen Sie alte Postgres-Serververzeichnisse:

   /opt/apigee/data/edge-postgres-server /opt/apigee/etc/edge-postgres-server.d

3. Installieren Sie den Postgres-Server neu:

   /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server install

4. Stellen Sie den Postgres-Server aus der Sicherungsdatei wieder her:

   /opt/apigee/apigee-service/bin/apigee-service edge-postgre-server restore 2019.03.17,14.40.41

   Beachten Sie, dass Sie beim Wiederherstellen einer Komponente weder den Verzeichnispfad zur Sicherungsdatei noch das Präfix „backup-“ oder das Suffix „.tar.gz“ angeben. Sie geben nur den Datums-/Uhrzeit-Teil des Namens der Sicherungsdatei an.

   Sie können die Sicherungsdatei im Befehl restore optional weglassen. Edge verwendet dann die neueste Sicherungsdatei im Sicherungsverzeichnis der Komponente.

5. Starten Sie den Postgres-Server auf allen Master- und Standby-Knoten:

   /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start

Qpid-Server und Qpidd

1. Beenden Sie Qpidd, Qpid Server und Postgres Server auf allen Knoten:
   

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

2. Entfernen Sie die alten Qpid Server- und Qpidd-Verzeichnisse:

   /opt/apigee/data/edge-qpid-server
   /opt/apigee/etc/edge-qpid-server.d
   /opt/apigee/data/apigee-qpidd
   /opt/apigee/etc/apigee-qpidd.d 

3. Installieren Sie Qpidd neu:

   /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd install 

4. Qpidd wiederherstellen:

   /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd restore 2019.03.17,14.40.41

   Beachten Sie, dass Sie beim Wiederherstellen einer Komponente weder den Verzeichnispfad zur Sicherungsdatei noch das Präfix „backup-“ oder das Suffix „.tar.gz“ angeben. Sie geben nur den Datums-/Uhrzeit-Teil des Namens der Sicherungsdatei an.

   Sie können die Sicherungsdatei im restore-Befehl optional weglassen. Edge verwendet dann die letzte Sicherungsdatei im Sicherungsverzeichnis der Komponente.

5. Starten Sie Qpidd:

   /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd start 

6. Qpid-Server neu installieren:

   /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server install

7. Qpid-Server wiederherstellen:

   /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restore 2019.03.17,14.40.41

   Beachten Sie, dass Sie beim Wiederherstellen einer Komponente weder den Verzeichnispfad zur Sicherungsdatei noch das Präfix „backup-“ oder das Suffix „.tar.gz“ angeben. Sie geben nur den Datums-/Uhrzeit-Teil des Namens der Sicherungsdatei an.

   Sie können die Sicherungsdatei im restore-Befehl optional weglassen. Edge verwendet dann die letzte Sicherungsdatei im Sicherungsverzeichnis der Komponente.

8. Starten Sie Qpid Server, Qpidd und Postgres Server auf allen Knoten neu:

   /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd restart
   /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart
   /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server restart

SymasLDAP

1. Beenden Sie SymasLDAP:

   /opt/apigee/apigee-service/bin/apigee-service apigee-openldap stop

2. Installieren Sie SymasLDAP neu:

   /opt/apigee/apigee-service/bin/apigee-service apigee-openldap install

3. Entfernen Sie alte SymasLDAP-Verzeichnisse:

   /opt/apigee/data/apigee-openldap /opt/apigee/etc/apigee-openldap.d

4. SymasLDAP wiederherstellen:

   /opt/apigee/apigee-service/bin/apigee-service apigee-openldap restore 2019.03.17,14.40.41

   Beachten Sie, dass Sie beim Wiederherstellen einer Komponente weder den Verzeichnispfad zur Sicherungsdatei noch das Präfix „backup-“ oder das Suffix „.tar.gz“ angeben. Sie geben nur den Datums-/Uhrzeit-Teil des Namens der Sicherungsdatei an.

   Sie können die Sicherungsdatei im restore-Befehl optional weglassen. Edge verwendet dann die letzte Sicherungsdatei im Sicherungsverzeichnis der Komponente.

5. Starten Sie SymasLDAP neu:

   /opt/apigee/apigee-service/bin/apigee-service apigee-openldap start

6. Starten Sie alle Management Server neu:

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

Verwaltungsserver

1. Verwaltungsserver beenden:

   /opt/apigee/apigee-service/bin/apigee-service edge-management-server stop

2. Entfernen Sie alte Management Server-Verzeichnisse:

   /opt/apigee/data/edge-management-server /opt/apigee/etc/edge-management-server.d

3. Verwaltungsserver neu installieren:

   /opt/apigee/apigee-service/bin/apigee-service edge-management-server install

4. Stellen Sie den Management Server aus der Sicherungsdatei wieder her:

   /opt/apigee/apigee-service/bin/apigee-service edge-management-server restore 2019.03.17,14.40.41

   Beachten Sie, dass Sie beim Wiederherstellen einer Komponente weder den Verzeichnispfad zur Sicherungsdatei noch das Präfix „backup-“ oder das Suffix „.tar.gz“ angeben. Sie geben nur den Datums-/Uhrzeit-Teil des Namens der Sicherungsdatei an.

   Sie können die Sicherungsdatei im Befehl restore optional weglassen. Edge verwendet dann die neueste Sicherungsdatei im Sicherungsverzeichnis der Komponente.

5. Starten Sie den Verwaltungsserver neu:

   /opt/apigee/apigee-service/bin/apigee-service edge-management-server start

Message Processor

1. Message Processor beenden:

   /opt/apigee/apigee-service/bin/apigee-service edge-message-processor stop

2. Entfernen Sie alte Message Processor-Verzeichnisse:

   /opt/apigee/data/edge-message-processor
   /opt/apigee/etc/edge-message-processor.d

3. Message Processor neu installieren:

   /opt/apigee/apigee-service/bin/apigee-service edge-message-processor install

4. Stellen Sie den Message Processor aus der Sicherungsdatei wieder her:

   /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restore 2019.03.17,14.40.41

   Beachten Sie, dass Sie beim Wiederherstellen einer Komponente weder den Verzeichnispfad zur Sicherungsdatei noch das Präfix „backup-“ oder das Suffix „.tar.gz“ angeben. Sie geben nur den Datums-/Uhrzeit-Teil des Namens der Sicherungsdatei an.

   Sie können die Sicherungsdatei im restore-Befehl optional weglassen. Edge verwendet dann die letzte Sicherungsdatei im Sicherungsverzeichnis der Komponente.

5. Message Processor neu starten:

   /opt/apigee/apigee-service/bin/apigee-service edge-message-processor start

Router

1. Router beenden:

   /opt/apigee/apigee-service/bin/apigee-service edge-router stop

2. Entfernen Sie alte Router-Verzeichnisse:

   /opt/apigee/data/edge-router
   /opt/apigee/etc/edge-router.d

3. Router neu installieren:
   

   /opt/apigee/apigee-service/bin/apigee-service edge-router install

4. Router aus der Sicherungsdatei wiederherstellen:

   /opt/apigee/apigee-service/bin/apigee-service edge-router restore 2019.03.17,14.40.41

   Beachten Sie, dass Sie beim Wiederherstellen einer Komponente weder den Verzeichnispfad zur Sicherungsdatei noch das Präfix „backup-“ oder das Suffix „.tar.gz“ angeben. Sie geben nur den Datums-/Uhrzeit-Teil des Namens der Sicherungsdatei an.

   Sie können die Sicherungsdatei im Befehl restore optional weglassen. Edge verwendet dann die neueste Sicherungsdatei im Sicherungsverzeichnis der Komponente.

5. Router neu starten:
   

   /opt/apigee/apigee-service/bin/apigee-service edge-router start

Neue Edge-Benutzeroberfläche

1. Neue Edge-Benutzeroberfläche beenden:

   /opt/apigee/apigee-service/bin/apigee-service edge-management-ui stop

2. Entfernen Sie alte New Edge-UI-Verzeichnisse:

   /opt/apigee/data/edge-management-ui
   /opt/apigee/etc/edge-management-ui.d

3. New Edge-Benutzeroberfläche neu installieren:

   /opt/apigee/apigee-service/bin/apigee-service edge-management-ui install
   /opt/apigee/apigee-service/bin/apigee-service edge-management-ui-static install

4. Stellen Sie die New Edge-Benutzeroberfläche aus der Sicherungsdatei wieder her:

   /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restore 2019.03.17,14.40.41

   Beachten Sie, dass Sie beim Wiederherstellen einer Komponente weder den Verzeichnispfad zur Sicherungsdatei noch das Präfix „backup-“ oder das Suffix „.tar.gz“ angeben. Sie geben nur den Datums-/Uhrzeit-Teil des Namens der Sicherungsdatei an.

   Sie können die Sicherungsdatei im Befehl restore optional weglassen. Edge verwendet dann die neueste Sicherungsdatei im Sicherungsverzeichnis der Komponente.

5. Starten Sie die neue Edge-Benutzeroberfläche neu:

   /opt/apigee/apigee-service/bin/apigee-service edge-management-ui start

Vollständige Websitewiederherstellung

1. Beenden Sie alle Komponentenknoten. Beachten Sie, dass die Reihenfolge beim Beenden der Subsysteme wichtig ist: Beenden Sie zuerst alle Edge-Knoten und dann alle Datenspeicherknoten.
2. Stellen Sie alle Komponenten wie oben beschrieben wieder her.
3. Starten Sie nun alle Komponenten in der folgenden Reihenfolge. Die Reihenfolge, in der die Subsysteme gestartet werden, ist wichtig:
   1. ZooKeeper-Cluster starten
   2. Cassandra-Cluster starten
   3. Prüfen, ob SymasLDAP ausgeführt wird
   4. Qpid starten
   5. Prüfen, ob die PostgreSQL-Datenbank ausgeführt wird
   6. Verwaltungsserver starten
   7. Router und Message Processors starten
   8. Qpid-Server starten
   9. Postgres-Server starten
   10. Neue Edge-Benutzeroberfläche starten