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êter 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. Restaurer ZooKeeper :

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

   Notez que lorsque vous restaurez un composant, vous ne spécifiez pas le chemin d'accès au répertoire du fichier de sauvegarde, ni le préfixe "backup-" ou le suffixe ".tar.gz". Vous ne spécifiez que la partie date/heure du nom du fichier de sauvegarde.

   Vous pouvez éventuellement omettre le fichier de sauvegarde dans la commande restore. Edge utilisera alors 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

En cas d'échec d'un nœud ZooKeeper faisant partie d'un ensemble, vous pouvez créer un nœud avec le même nom d'hôte ou la même adresse IP, puis réinstaller ZooKeeper. Lorsque le nouveau nœud ZooKeeper rejoint l'ensemble ZooKeeper, il reçoit les derniers instantanés de la variante optimale et commence à servir les 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 à l'aide du même fichier de configuration que celui utilisé lors de l'installation du 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 pour un nœud unique comme décrit ci-dessus.
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 lorsque vous restaurez un composant, vous ne spécifiez pas le chemin d'accès au répertoire du fichier de sauvegarde, ni le préfixe "backup-" ou le suffixe ".tar.gz". Vous ne spécifiez que la partie date/heure du nom du fichier de sauvegarde.

   Vous pouvez éventuellement omettre le fichier de sauvegarde dans la commande restore. Edge utilisera alors 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

En cas de défaillance d'un seul nœud Cassandra faisant partie d'un ensemble, vous pouvez créer un nœud avec le même nom d'hôte ou la même adresse IP. Il vous suffit de réinstaller Cassandra. Vous n'avez pas besoin de restaurer les données.

1. Réinstallez Cassandra :

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

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

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

3. Lancez Cassandra :

   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra start

4. Une fois Cassandra installé et que le nœud est opérationnel (étant donné que RF>=2 pour tous les espaces de clés), exécutez la commande nodetool suivante pour initialiser le nœud:
   

   /opt/apigee/apigee-cassandra/bin/nodetool [-u username -pw password] -h localhost repair -pr

   Vous ne devez transmettre votre nom d'utilisateur et votre mot de passe que si vous avez activé l'authentification JMX pour Cassandra.

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 exécuté de manière autonome ou 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 du fichier de sauvegarde ni le suffixe ".dump". Vous ne spécifiez que la partie date/heure du nom du fichier de sauvegarde.

   Vous pouvez éventuellement omettre le fichier de sauvegarde dans la commande restore. Edge utilisera alors 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. Suppression des anciens répertoires du serveur Postgres :

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

3. Réinstaller 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 lorsque vous restaurez un composant, vous ne spécifiez pas le chemin d'accès au répertoire du fichier de sauvegarde, ni le préfixe "backup-" ou le suffixe ".tar.gz". Vous ne spécifiez que la partie date/heure du nom du fichier de sauvegarde.

   Vous pouvez éventuellement omettre le fichier de sauvegarde dans la commande restore. Edge utilisera alors 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, le serveur Qpid et le serveur Postgres 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éinstaller 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 lorsque vous restaurez un composant, vous ne spécifiez pas le chemin d'accès au répertoire du fichier de sauvegarde, ni le préfixe "backup-" ou le suffixe ".tar.gz". Vous ne spécifiez que la partie date/heure du nom du fichier de sauvegarde.

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

5. Démarrez 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. Restaurer le serveur Qpid :

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

   Notez que lorsque vous restaurez un composant, vous ne spécifiez pas le chemin d'accès au répertoire du fichier de sauvegarde, ni le préfixe "backup-" ou le suffixe ".tar.gz". Vous ne spécifiez que la partie date/heure du nom du fichier de sauvegarde.

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

8. Redémarrez les serveurs Qpid, 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êter OpenLDAP :

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

2. Réinstaller 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. Restaurer OpenLDAP :

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

   Notez que lorsque vous restaurez un composant, vous ne spécifiez pas le chemin d'accès au répertoire du fichier de sauvegarde, ni le préfixe "backup-" ou le suffixe ".tar.gz". Vous ne spécifiez que la partie date/heure du nom du fichier de sauvegarde.

   Vous pouvez éventuellement omettre le fichier de sauvegarde dans la commande restore. Edge utilisera alors 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éinstaller 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 lorsque vous restaurez un composant, vous ne spécifiez pas le chemin d'accès au répertoire du fichier de sauvegarde, ni le préfixe "backup-" ou le suffixe ".tar.gz". Vous ne spécifiez que la partie date/heure du nom du fichier de sauvegarde.

   Vous pouvez éventuellement omettre le fichier de sauvegarde dans la commande restore. Edge utilisera alors 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 de processeur de messages :

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

3. Réinstaller 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 lorsque vous restaurez un composant, vous ne spécifiez pas le chemin d'accès au répertoire du fichier de sauvegarde, ni le préfixe "backup-" ou le suffixe ".tar.gz". Vous ne spécifiez que la partie date/heure du nom du fichier de sauvegarde.

   Vous pouvez éventuellement omettre le fichier de sauvegarde dans la commande restore. Edge utilisera alors 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êter le routeur :

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

2. Supprimez les anciens répertoires de routeur :

   /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 lorsque vous restaurez un composant, vous ne spécifiez pas le chemin d'accès au répertoire du fichier de sauvegarde, ni le préfixe "backup-" ou le suffixe ".tar.gz". Vous ne spécifiez que la partie date/heure du nom du fichier de sauvegarde.

   Vous pouvez éventuellement omettre le fichier de sauvegarde dans la commande restore. Edge utilisera alors 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'UI :

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

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

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

3. Réinstaller l'UI:
   

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

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

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

   Notez que lorsque vous restaurez un composant, vous ne spécifiez pas le chemin d'accès au répertoire du fichier de sauvegarde, ni le préfixe "backup-" ou le suffixe ".tar.gz". Vous ne spécifiez que la partie date/heure du nom du fichier de sauvegarde.

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

5. Redémarrez 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: commencez par arrêter tous les nœuds périphériques, puis arrêtez tous les nœuds du datastore.
2. Restaurez tous les composants comme décrit ci-dessus.
3. Lancez maintenant tous les composants dans l'ordre suivant. Notez que l'ordre de démarrage des sous-systèmes est important :
   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. Assurez-vous que la base de données PostgreSQL est opérationnelle
   6. Démarrer le serveur de gestion
   7. Démarrer des routeurs et des processeurs de messages
   8. Démarrer le serveur Qpid
   9. Démarrer le serveur Postgres
   10. Démarrer l'interface utilisateur Apigee