Réinstaller et restaurer des composants

Ce document couvre la réinstallation et la restauration d'un composant Edge. Suivez cette procédure si vous devez réinstaller le composant Edge avant de restaurer la sauvegarde.

Apache ZooKeeper

Restaurer un nœud autonome

1. Arrêtez ZooKeeper:

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

2. Supprimez les anciens répertoires ZooKeeper:

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

3. Réinstallez ZooKeeper:

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

4. Restaurez ZooKeeper:

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

   Notez que lors de la restauration d'un composant, vous ne spécifiez pas le chemin d'accès au répertoire et vous ne spécifiez pas la partie "backup-" ou ".tar.gz" . Vous spécifiez uniquement la date et l'heure du nom du fichier de sauvegarde.

   Vous pouvez éventuellement omettre le fichier de sauvegarde dans la commande restore et Edge utilisez le fichier de sauvegarde le plus récent dans le répertoire de sauvegarde du composant.

5. Redémarrez tous les composants:

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

Restaurer un nœud de cluster

Si un nœud ZooKeeper unique est défaillant dans un ensemble, vous pouvez créer un nouveau nœud avec avec le même nom d'hôte/adresse IP, puis réinstallez ZooKeeper. Lorsque le nouveau nœud ZooKeeper rejoint le L'ensemble ZooKeeper récupère les derniers instantanés du leader et commence à répondre aux besoins des clients. Vous n'avez pas besoin de restaurer les données dans cette instance.

1. Réinstallez ZooKeeper:

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

2. Exécutez la configuration sur le nœud ZooKeeper avec le même fichier de configuration que celui utilisé lors de l'installation de nœud d'origine:

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

3. Démarrez ZooKeeper:

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

Restaurer un cluster complet

1. Arrêtez le cluster complet.
2. Restaurez tous les nœuds ZooKeeper à partir du fichier de sauvegarde, comme décrit ci-dessus pour un seul nœud.
3. Démarrez le cluster ZooKeeper.
4. Redémarrez tous les composants.

Apache Cassandra

Restaurer un nœud autonome

1. Arrêtez Cassandra:

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

2. Supprimez l'ancien répertoire Cassandra:

   /opt/apigee/data/apigee-cassandra

3. Réinstallez Cassandra:

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

4. Restaurez Cassandra:

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

   Notez que lors de la restauration d'un composant, vous ne spécifiez pas le chemin d'accès au répertoire et vous ne spécifiez pas la partie "backup-" ou ".tar.gz" . Vous spécifiez uniquement la date et l'heure du nom du fichier de sauvegarde.

   Vous pouvez éventuellement omettre le fichier de sauvegarde dans la commande restore et Edge utilisez le fichier de sauvegarde le plus récent dans le répertoire de sauvegarde du composant.

5. Redémarrez tous les composants:
   

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

Restaurer un nœud de cluster

Si un nœud Cassandra unique faisant partie d'un ensemble échoue, vous pouvez créer un autre nœud avec le même nom d'hôte ou la même adresse IP. Il vous suffit de réinstaller Cassandra et de suivre quelques étapes supplémentaires. Vous n'avez pas besoin de restaurer les données à partir de sauvegardes. Les instances répliquées disponibles dans d'autres nœuds peuvent être utilisées pour restaurer les données sur le nœud défaillant. Ces étapes s'appliquent généralement si un nœud de votre cluster Cassandra plante en raison d'un dysfonctionnement matériel, etc.

Si le nœud défaillant n'est plus accessible, détruisez-le et isolez son réseau pour vous assurer qu'il ne pourra pas réintégrer accidentellement le cluster Cassandra. Ensuite, affichez un nouveau nœud avec la même adresse IP que le nœud d'origine et exécutez les étapes d'amorçage habituelles d'Apigee sur celui-ci.

Si le nœud est toujours accessible et que vous souhaitez le réutiliser, procédez comme suit:

1. Arrêtez le processus Cassandra sur le nœud:
   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop
2. Désinstallez le logiciel Cassandra du nœud:
   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra uninstall
3. Supprimez le répertoire de données du nœud:
   rm -rf /opt/apigee/data/apigee-cassandra

Une fois les étapes ci-dessus effectuées, vous devriez avoir un nœud avec la même adresse IP que le nœud qui a échoué et qui est prêt pour l'installation du logiciel Apigee. Procédez comme suit :

1. Identifier les nœuds sources du centre de données.
   1. Sur n'importe quel nœud Cassandra opérationnel situé dans le même centre de données que le nœud en cours de restauration, exécutez la commande suivante:

      apigee-service apigee-cassandra configure -search conf_cassandra_seeds

   2. Le résultat devrait ressembler à ceci:

      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. Reportez-vous à la dernière ligne du résultat. Les adresses IP répertoriées, séparées par des virgules, correspondent aux nœuds source utilisés par les nœuds dans ce centre de données.
2. Sur le nouveau nœud à restaurer, créez ou modifiez le fichier suivant:
   

   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. Si ce nœud est l'un des nœuds source (l'adresse IP du nœud apparaît dans la liste des nœuds sources de l'étape 1), ajoutez une autre ligne dans le fichier:
   

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

   <ph type="x-smartling-placeholder">
   </ph>
   1. Par exemple, dans l'exemple ci-dessus, la liste source comporte deux adresses IP : 10.1.0.1 et 10.1.0.2. Si le nœud restauré est à la version 10.1.0.1, ajoutez une ligne comme suit:
      

      conf_cassandra_seeds="10.1.0.2"

5. Enregistrez le fichier et vérifiez que vous en êtes le propriétaire et lisibles par l'utilisateur Apigee:
   

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

6. Installez le logiciel Cassandra:
   

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

7. Exécutez la configuration Cassandra:
   

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

8. Le processus de configuration tentera d'amorcer le service Cassandra en interne. Cette opération peut prendre beaucoup de temps en fonction de la quantité de données à diffuser par les autres nœuds, du débit du réseau, etc.
9. [Option avancée] Vous pouvez accélérer le flux de données en exécutant les commandes nodetool suivantes sur le nœud:
   

   nodetool setstreamthroughput <value>
   nodetool setcompactionthroughput <value>

10. Une fois le nœud Cassandra rétabli, utilisez les commandes standards comme ci-dessous pour vérifier que le nœud a bien rejoint l'anneau:
    

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

11. Après avoir vérifié que le nœud est opérationnel, modifiez à nouveau le fichier /opt/apigee/customer/application/cassandra.properties et supprimez les lignes que vous avez ajoutées précédemment dans cette procédure aux étapes 3 et 4.
12. Redémarrez le service Cassandra sur le nœud:
    

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

Restaurer un cluster complet

1. Arrêtez le cluster complet.
2. Restaurez tous les nœuds Cassandra à partir du fichier de sauvegarde.
3. Démarrez le cluster Cassandra.
4. Redémarrez tous les composants.

Base de données PostgreSQL

PosgreSQL s'exécute de façon autonome en tant que maître

1. Arrêtez le serveur de gestion, le serveur Qpid et le serveur Postgres sur tous les nœuds:

   /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. Réinstallez la base de données PostgreSQL:

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

3. Démarrez PostgreSQL:

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

4. Restaurez la base de données PostgreSQL à partir du fichier de sauvegarde:

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

   Notez que lors de la restauration du composant PostgreSQL, vous ne spécifiez pas le chemin d'accès au répertoire le fichier de sauvegarde, ni l'option ".dump" . Vous spécifiez uniquement la date et l'heure du nom du fichier de sauvegarde.

   Vous pouvez éventuellement omettre le fichier de sauvegarde dans la commande restore et Edge utilisez le fichier de sauvegarde le plus récent dans le répertoire de sauvegarde du composant.

5. Démarrez le serveur de gestion, le serveur Qpid et le serveur Postgres sur tous les nœuds:

   /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 exécuté en mode veille

1. Réinstallez la base de données PostgreSQL:

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

2. Reconfigurez la base de données PostgreSQL à l'aide du fichier de configuration que vous avez utilisé pour l'installer:
   

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

3. Démarrez PostgreSQL:

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

Serveur Postgres

1. Arrêtez le serveur Postgres sur tous les nœuds maîtres et de secours:

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

2. Supprimez les anciens répertoires Postgres Server:

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

3. Réinstallez le serveur Postgres:

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

4. Restaurez le serveur Postgres à partir du fichier de sauvegarde:

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

   Notez que lors de la restauration d'un composant, vous ne spécifiez pas le chemin d'accès au répertoire et vous ne spécifiez pas la partie "backup-" ou ".tar.gz" . Vous spécifiez uniquement la date et l'heure du nom du fichier de sauvegarde.

   Vous pouvez éventuellement omettre le fichier de sauvegarde dans la commande restore et Edge utilisez le fichier de sauvegarde le plus récent dans le répertoire de sauvegarde du composant.

5. Démarrez le serveur Postgres sur tous les nœuds maîtres et de secours:

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

Qpid Server et Qpidd

1. Arrêtez Qpidd, Qpid Server et Postgres Server sur tous les nœuds:
   

   /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. Supprimez les anciens répertoires Qpid Server et Qpidd:

   /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. Réinstallez Qpidd:

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

4. Restaurer Qpidd:

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

   Notez que lors de la restauration d'un composant, vous ne spécifiez pas le chemin d'accès au répertoire et vous ne spécifiez pas la partie "backup-" ou ".tar.gz" . Vous spécifiez uniquement la date et l'heure du nom du fichier de sauvegarde.

   Vous pouvez éventuellement omettre le fichier de sauvegarde dans la commande restore et Edge utilisez le fichier de sauvegarde le plus récent dans le répertoire de sauvegarde du composant.

5. Lancez Qpidd:

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

6. Réinstallez le serveur Qpid:

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

7. Restaurez le serveur Qpid:

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

   Notez que lors de la restauration d'un composant, vous ne spécifiez pas le chemin d'accès au répertoire et vous ne spécifiez pas la partie "backup-" ou ".tar.gz" . Vous spécifiez uniquement la date et l'heure du nom du fichier de sauvegarde.

   Vous pouvez éventuellement omettre le fichier de sauvegarde dans la commande restore et Edge utilisez le fichier de sauvegarde le plus récent dans le répertoire de sauvegarde du composant.

8. Redémarrez les serveurs Qpid Server, Qpidd et Postgres sur tous les nœuds:

   /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. Arrêtez OpenLDAP:

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

2. Réinstallez OpenLDAP:

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

3. Supprimez les anciens annuaires OpenLDAP:

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

4. Restaurez OpenLDAP:

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

   Notez que lors de la restauration d'un composant, vous ne spécifiez pas le chemin d'accès au répertoire et vous ne spécifiez pas la partie "backup-" ou ".tar.gz" . Vous spécifiez uniquement la date et l'heure du nom du fichier de sauvegarde.

   Vous pouvez éventuellement omettre le fichier de sauvegarde dans la commande restore et Edge utilisez le fichier de sauvegarde le plus récent dans le répertoire de sauvegarde du composant.

5. Redémarrez OpenLDAP:

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

6. Redémarrez tous les serveurs de gestion:

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

Serveur de gestion

1. Arrêter le serveur de gestion:

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

2. Supprimez les anciens répertoires du serveur de gestion:

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

3. Réinstallez le serveur de gestion:

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

4. Restaurez le serveur de gestion à partir du fichier de sauvegarde:

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

   Notez que lors de la restauration d'un composant, vous ne spécifiez pas le chemin d'accès au répertoire et vous ne spécifiez pas la partie "backup-" ou ".tar.gz" . Vous spécifiez uniquement la date et l'heure du nom du fichier de sauvegarde.

   Vous pouvez éventuellement omettre le fichier de sauvegarde dans la commande restore et Edge utilisez le fichier de sauvegarde le plus récent dans le répertoire de sauvegarde du composant.

5. Redémarrez le serveur de gestion:

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

Processeur de messages

1. Arrêter le processeur de messages:

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

2. Supprimez les anciens répertoires du processeur de messages:

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

3. Réinstallez le processeur de messages:

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

4. Restaurez le processeur de messages à partir du fichier de sauvegarde:

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

   Notez que lors de la restauration d'un composant, vous ne spécifiez pas le chemin d'accès au répertoire et vous ne spécifiez pas la partie "backup-" ou ".tar.gz" . Vous spécifiez uniquement la date et l'heure du nom du fichier de sauvegarde.

   Vous pouvez éventuellement omettre le fichier de sauvegarde dans la commande restore et Edge utilisez le fichier de sauvegarde le plus récent dans le répertoire de sauvegarde du composant.

5. Redémarrez le processeur de messages:

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

Routeur

1. Arrêtez le routeur:

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

2. Supprimez les anciens répertoires de routeurs:

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

3. Réinstallez le routeur:
   

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

4. Restaurez le routeur à partir du fichier de sauvegarde:

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

   Notez que lors de la restauration d'un composant, vous ne spécifiez pas le chemin d'accès au répertoire et vous ne spécifiez pas la partie "backup-" ou ".tar.gz" . Vous spécifiez uniquement la date et l'heure du nom du fichier de sauvegarde.

   Vous pouvez éventuellement omettre le fichier de sauvegarde dans la commande restore et Edge utilisez le fichier de sauvegarde le plus récent dans le répertoire de sauvegarde du composant.

5. Redémarrez le routeur:
   

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

Interface utilisateur périphérique

1. Arrêter l'interface utilisateur:

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

2. Supprimez les anciens répertoires de l'interface utilisateur:

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

3. Réinstaller l'interface utilisateur:
   

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

4. Restaurez l'interface utilisateur à partir du fichier de sauvegarde:

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

   Notez que lors de la restauration d'un composant, vous ne spécifiez pas le chemin d'accès au répertoire et vous ne spécifiez pas la partie "backup-" ou ".tar.gz" . Vous spécifiez uniquement la date et l'heure du nom du fichier de sauvegarde.

   Vous pouvez éventuellement omettre le fichier de sauvegarde dans la commande restore et Edge utilisez le fichier de sauvegarde le plus récent dans le répertoire de sauvegarde du composant.

5. Redémarrage de l'interface utilisateur:
   

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

Terminer la récupération du site

1. Arrêtez tous les nœuds des composants. Notez que l'ordre d'arrêt des sous-systèmes est important: d'abord arrêter tous les nœuds périphériques, puis puis arrêter tous les nœuds du datastore ;
2. Restaurez tous les composants comme décrit ci-dessus.
3. Démarrez maintenant tous les composants dans l'ordre suivant. Notez que l'ordre de début sous-systèmes est important: <ph type="x-smartling-placeholder">
   </ph>
   1. Démarrer le cluster ZooKeeper
   2. Démarrer le cluster Cassandra
   3. S'assurer qu'OpenLDAP est opérationnel
   4. Démarrer Qpid
   5. Vérifier que la base de données PostgreSQL est opérationnelle
   6. Démarrer le serveur de gestion
   7. Démarrer les routeurs et les processeurs de messages
   8. Démarrer le serveur Qpid
   9. Démarrer le serveur Postgres
   10. Démarrer l'interface utilisateur d'Apigee