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 einzelnen 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 restore-Befehl optional weglassen. Edge verwendet dann die letzte Sicherungsdatei im Sicherungsverzeichnis der Komponente.

5. Alle Komponenten neu starten:

   /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 mit der Bereitstellung für Clients. Sie müssen keine Daten in dieser Instanz 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. ZooKeeper starten:

   /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 einzelnen 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/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. Mit Replikaten, die auf anderen Knoten verfügbar sind, können Daten auf dem ausgefallenen Knoten wiederhergestellt werden. Diese Schritte sind in der Regel anwendbar, wenn ein Knoten in Ihrem Cassandra-Cluster aufgrund von Hardwarefehlern usw. abstürzt.

Wenn auf den ausgefallenen Knoten nicht mehr zugegriffen werden kann, zerstören Sie ihn und isolieren Sie sein Netzwerk, damit er nicht versehentlich wieder dem Cassandra-Cluster beitreten kann. Stellen Sie dann einen neuen Knoten mit derselben IP-Adresse wie der ursprüngliche Knoten bereit 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, sollte ein Knoten mit derselben IP-Adresse wie der fehlgeschlagene Knoten vorhanden sein, 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 durch Kommas getrennten 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 Startknoten ist (die IP-Adresse des Knotens wird in der Startknotenliste aus Schritt 1 angezeigt), fügen Sie eine weitere Zeile in die Datei ein:
   

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

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

      conf_cassandra_seeds="10.1.0.2"

5. Speichern Sie die Datei und prüfen Sie, ob 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. Beim Einrichten wird intern versucht, den Cassandra-Dienst zu starten. Je nachdem, wie viele Daten von anderen Knoten gestreamt werden müssen, wie hoch der Netzwerkdurchsatz ist usw., kann dies lange 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 unten 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. Wenn Sie bestätigt haben, dass 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 diesem Verfahren 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 wird eigenständig oder als Master ausgeführt.

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. PostgreSQL-Datenbank aus der Sicherungsdatei wiederherstellen:

   /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 restore-Befehl optional weglassen. Edge verwendet dann die letzte 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. PostgreSQL-Datenbank neu installieren:

   /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. Postgres-Server neu installieren:

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

4. Postgres-Server aus der Sicherungsdatei wiederherstellen:

   /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 restore-Befehl optional weglassen. Edge verwendet dann die letzte 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 den Qpid-Server (Qpidd) und die 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. SymasLDAP beenden:

   /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 Verwaltungsserver neu:

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

Verwaltungsserver

1. Verwaltungsserver anhalten:

   /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. Management Server aus der Sicherungsdatei wiederherstellen:

   /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 restore-Befehl optional weglassen. Edge verwendet dann die letzte 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. Nachrichtenprozessor 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. Nachrichtenprozessor neu installieren:

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

4. Message Processor aus der Sicherungsdatei wiederherstellen:

   /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 stoppen:

   /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 restore-Befehl optional weglassen. Edge verwendet dann die letzte Sicherungsdatei im Sicherungsverzeichnis der Komponente.

5. Router neu starten:
   

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

Edge-Benutzeroberfläche

1. Benutzeroberfläche zum Beenden:

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

2. Entfernen Sie alte UI-Verzeichnisse:

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

3. UI neu installieren:
   

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

4. Benutzeroberfläche aus der Sicherungsdatei wiederherstellen:

   /opt/apigee/apigee-service/bin/apigee-service edge-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 restore-Befehl optional weglassen. Edge verwendet dann die letzte Sicherungsdatei im Sicherungsverzeichnis der Komponente.

5. UI neu starten:
   

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

Vollständige Websitewiederherstellung

1. Beenden Sie alle Komponentenknoten. Die Reihenfolge, in der die Subsysteme beendet werden, ist wichtig: Beenden Sie zuerst alle Edge-Knoten und dann alle Datenspeicher-Knoten.
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 Sie, ob die PostgreSQL-Datenbank betriebsbereit ist.
   6. Verwaltungsserver starten
   7. Router und Message Processors starten
   8. Qpid-Server starten
   9. Postgres-Server starten
   10. Apigee-Benutzeroberfläche starten