Komponenten neu installieren und wiederherstellen

In diesem Dokument erfahren Sie, wie Sie eine Edge-Komponente neu installieren und wiederherstellen. Gehen Sie folgendermaßen vor: wenn Sie die Edge-Komponente vor dem Wiederherstellen der Sicherung neu installieren müssen.

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. Installieren Sie ZooKeeper neu:

   /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 nicht den Verzeichnispfad zur Sicherung angeben. noch geben Sie den "backup-" oder das Präfix ".tar.gz" . Sie geben nur die Teil des Namens der Sicherungsdatei mit Datum/Uhrzeit.

   Sie können die Sicherungsdatei im restore-Befehl optional weglassen. Edge wird dann Die neueste Sicherungsdatei im Sicherungsverzeichnis der Komponente verwenden.

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 denselben Hostnamen bzw. dieselbe IP-Adresse an und installieren Sie ZooKeeper neu. Wenn der neue ZooKeeper-Knoten mit dem ZooKeeper-Ensemble erhält die neuesten Snapshots vom Leader und beginnt mit dem Kundendienst. Sie müssen Daten in dieser Instanz nicht wiederherstellen.

1. Installieren Sie ZooKeeper neu:

   /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 Sie bei der Installation des Ursprünglicher Knoten:

   /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 wie oben für einen einzelnen Knoten wieder her.
3. Starten Sie den ZooKeeper-Cluster.
4. Starten Sie alle Komponenten neu.

Apache Cassandra

Einen eigenständigen Knoten wiederherstellen

1. Haltestelle Cassandra:

   /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 nicht den Verzeichnispfad zur Sicherung angeben. noch geben Sie den "backup-" oder das Präfix ".tar.gz" . Sie geben nur die Teil des Namens der Sicherungsdatei mit Datum/Uhrzeit.

   Sie können die Sicherungsdatei im restore-Befehl optional weglassen. Edge wird dann Die neueste Sicherungsdatei im Sicherungsverzeichnis der Komponente verwenden.

5. Starten Sie alle Komponenten neu:
   

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

Einen Clusterknoten wiederherstellen

Wenn ein einzelner Cassandra-Knoten ausfällt, der zu einem Ensemble gehört, können Sie einen neuen Knoten mit demselben Hostnamen bzw. derselben IP-Adresse erstellen. Sie müssen lediglich Cassandra neu installieren und einige zusätzliche Schritte ausführen. Sie müssen die Daten aus Sicherungen nicht wiederherstellen. Replikate, die auf anderen Knoten verfügbar sind, können verwendet werden, um Daten auf dem ausgefallenen Knoten wiederherzustellen. Diese Schritte können in der Regel angewendet werden, 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 den Knoten und isolieren Sie sein Netzwerk, damit er nicht versehentlich wieder dem Cassandra-Cluster beitreten kann. 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 verfügbar 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 auf dem 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 Knoten haben, der fehlgeschlagen ist und zur Installation der Apigee-Software bereit ist. Führen Sie diese Schritte aus:

1. Identifizieren Sie die Startknoten des Rechenzentrums.
   1. Führen Sie auf einem beliebigen operativen Cassandra-Knoten in demselben Rechenzentrum, in dem sich auch der wiederherzustellende Knoten befindet, den folgenden Befehl aus:

      apigee-service apigee-cassandra configure -search conf_cassandra_seeds

   2. Die Ausgabe sieht ungefähr 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 in der Ausgabe an. Die aufgeführten durch Kommas getrennten IP-Adressen sind die Startknoten, die von Knoten in diesem Rechenzentrum verwendet werden.
2. Erstellen oder bearbeiten Sie auf dem neu 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>"

   <ph type="x-smartling-placeholder">
   </ph>
   1. Im Beispiel oben hat die Quellliste beispielsweise zwei IP-Adressen: 10.1.0.1 & 10.1.0.2. Wenn der wiederhergestellte 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 vergewissern Sie sich, dass sie Eigentümer und lesbar für den Apigee-Nutzer:
   

   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 Setup wird intern versucht, den Cassandra-Dienst zu starten. Dies kann viel Zeit in Anspruch nehmen, je nachdem, wie viele Daten von anderen Knoten gestreamt werden können, welchen Netzwerkdurchsatz er hat.
9. [Erweiterte Option] Sie können das Streaming der Daten beschleunigen, indem Sie die folgenden nodetool-Befehle auf dem Knoten ausführen:
   

   nodetool setstreamthroughput <value>
   nodetool setcompactionthroughput <value>

10. Sobald der Cassandra-Knoten wiederhergestellt ist, können Sie mit den folgenden Standardbefehlen prüfen, ob der Knoten erfolgreich mit dem Ring verbunden wurde:
    

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

11. Nachdem Sie geprü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

PosgreSQL wird eigenständig ausgeführt oder als Master

1. Stoppen Sie den Verwaltungsserver, 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. Installieren Sie die PostgreSQL-Datenbank neu:

   /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 nicht den Verzeichnispfad zum Sicherungsdatei erstellen und die ".dump"-Datei . Sie geben nur die Teil des Namens der Sicherungsdatei mit Datum/Uhrzeit.

   Sie können die Sicherungsdatei im restore-Befehl optional weglassen. Edge wird dann Die neueste Sicherungsdatei im Sicherungsverzeichnis der Komponente verwenden.

5. Starten Sie den Verwaltungsserver, 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

PosgreSQL 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 Server-Verzeichnisse:

   /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 nicht den Verzeichnispfad zur Sicherung angeben. noch geben Sie den "backup-" oder das Präfix ".tar.gz" . Sie geben nur die Teil des Namens der Sicherungsdatei mit Datum/Uhrzeit.

   Sie können die Sicherungsdatei im restore-Befehl optional weglassen. Edge wird dann Die neueste Sicherungsdatei im Sicherungsverzeichnis der Komponente verwenden.

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 nicht den Verzeichnispfad zur Sicherung angeben. noch geben Sie den "backup-" oder das Präfix ".tar.gz" . Sie geben nur die Teil des Namens der Sicherungsdatei mit Datum/Uhrzeit.

   Sie können die Sicherungsdatei im restore-Befehl optional weglassen. Edge wird dann Die neueste Sicherungsdatei im Sicherungsverzeichnis der Komponente verwenden.

5. Qpidd starten:

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

6. Installieren Sie den Qpid-Server neu:

   /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 nicht den Verzeichnispfad zur Sicherung angeben. noch geben Sie den "backup-" oder das Präfix ".tar.gz" . Sie geben nur die Teil des Namens der Sicherungsdatei mit Datum/Uhrzeit.

   Sie können die Sicherungsdatei im restore-Befehl optional weglassen. Edge wird dann Die neueste Sicherungsdatei im Sicherungsverzeichnis der Komponente verwenden.

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

OpenLDAP

1. OpenLDAP beenden:

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

2. Installieren Sie OpenLDAP neu:

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

3. Entfernen Sie alte OpenLDAP-Verzeichnisse:

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

4. OpenLDAP 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 nicht den Verzeichnispfad zur Sicherung angeben. noch geben Sie den "backup-" oder das Präfix ".tar.gz" . Sie geben nur die Teil des Namens der Sicherungsdatei mit Datum/Uhrzeit.

   Sie können die Sicherungsdatei im restore-Befehl optional weglassen. Edge wird dann Die neueste Sicherungsdatei im Sicherungsverzeichnis der Komponente verwenden.

5. Starten Sie OpenLDAP 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 beenden:

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

2. Entfernen Sie alte Verwaltungsserver-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 Verwaltungsserver 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 nicht den Verzeichnispfad zur Sicherung angeben. noch geben Sie den "backup-" oder das Präfix ".tar.gz" . Sie geben nur die Teil des Namens der Sicherungsdatei mit Datum/Uhrzeit.

   Sie können die Sicherungsdatei im restore-Befehl optional weglassen. Edge wird dann Die neueste Sicherungsdatei im Sicherungsverzeichnis der Komponente verwenden.

5. Starten Sie den Verwaltungsserver neu:

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

Message Processor

1. Message Processor anhalten:

   /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. Installieren Sie Message Processor neu:

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

4. Stellen Sie 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 nicht den Verzeichnispfad zur Sicherung angeben. noch geben Sie den "backup-" oder das Präfix ".tar.gz" . Sie geben nur die Teil des Namens der Sicherungsdatei mit Datum/Uhrzeit.

   Sie können die Sicherungsdatei im restore-Befehl optional weglassen. Edge wird dann Die neueste Sicherungsdatei im Sicherungsverzeichnis der Komponente verwenden.

5. Starten Sie Message Processor neu:

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

Router

1. Stoppen Sie den Router:

   /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. Installieren Sie den Router neu:
   

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

4. Stellen Sie den Router aus der Sicherungsdatei wieder her:

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

   Beachten Sie, dass Sie beim Wiederherstellen einer Komponente nicht den Verzeichnispfad zur Sicherung angeben. noch geben Sie den "backup-" oder das Präfix ".tar.gz" . Sie geben nur die Teil des Namens der Sicherungsdatei mit Datum/Uhrzeit.

   Sie können die Sicherungsdatei im restore-Befehl optional weglassen. Edge wird dann Die neueste Sicherungsdatei im Sicherungsverzeichnis der Komponente verwenden.

5. Starten Sie den Router neu:
   

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

Edge-Benutzeroberfläche

1. UI 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. Stellen Sie die Benutzeroberfläche aus der Sicherungsdatei wieder her:

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

   Beachten Sie, dass Sie beim Wiederherstellen einer Komponente nicht den Verzeichnispfad zur Sicherung angeben. noch geben Sie den "backup-" oder das Präfix ".tar.gz" . Sie geben nur die Teil des Namens der Sicherungsdatei mit Datum/Uhrzeit.

   Sie können die Sicherungsdatei im restore-Befehl optional weglassen. Edge wird dann Die neueste Sicherungsdatei im Sicherungsverzeichnis der Komponente verwenden.

5. Benutzeroberfläche neu starten:
   

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

Vollständige Wiederherstellung der Website

1. Stoppen Sie alle Komponentenknoten. Beachten Sie, dass die Reihenfolge beim Beenden der Subsysteme wichtig ist: zuerst Beenden Sie alle Edge-Knoten und anschließen alle Datenspeicherknoten.
2. Stellen Sie alle Komponenten wie oben beschrieben wieder her.
3. Starten Sie nun alle Komponenten in der folgenden Reihenfolge. Beachten Sie, dass die Reihenfolge, in der ist wichtig: <ph type="x-smartling-placeholder">
   </ph>
   1. ZooKeeper-Cluster starten
   2. Cassandra-Cluster starten
   3. Prüfen, ob OpenLDAP ausgeführt wird
   4. qpid starten
   5. Verfügbarkeit der PostgreSQL-Datenbank sicherstellen
   6. Verwaltungsserver starten
   7. Router und Nachrichtenprozessoren starten
   8. Qpid-Server starten
   9. Postgres-Server starten
   10. Apigee-UI starten