Réinstaller et restaurer des composants

Ce document décrit la réinstallation et la restauration d'un composant Edge. Utilisez 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 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

Si un seul nœud ZooKeeper faisant partie d'un ensemble échoue, vous pouvez créer un nœud avec le même nom d'hôte/la même adresse IP et réinstaller ZooKeeper. Lorsque le nouveau nœud ZooKeeper rejoint l'ensemble ZooKeeper, il obtient les derniers instantanés du leader et commence à diffuser 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 l'ensemble du cluster.
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 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

Si un seul nœud Cassandra échoue et qu'il fait partie d'un ensemble, vous pouvez créer un nœud avec le même nom d'hôte/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. Démarrez Cassandra :

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

4. Après avoir installé Cassandra et une fois 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 l'ensemble du cluster.
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

PostgreSQL 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 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

PostgreSQL s'exécutant en tant que serveur de secours

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 même fichier de configuration que celui 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 du serveur Postgres :

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

Serveur Qpid 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 du serveur Qpid et de 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. Restaurez 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 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. 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 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ê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 répertoires 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 lors de la restauration d'un composant, vous ne spécifiez pas le chemin d'accès au 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é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 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 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 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 du 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 lors de la restauration d'un composant, vous ne spécifiez pas le chemin d'accès au 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émarrer le routeur :
   

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

UI Edge

1. Arrêtez l'UI :

   /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. Interface utilisateur de réinstallation :
   

   /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 lors de la restauration d'un composant, vous ne spécifiez pas le chemin d'accès au 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émarrer l'UI :
   

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

Récupération complète du site

1. Arrêtez tous les nœuds de composants. Notez que l'ordre d'arrêt des sous-systèmes est important : arrêtez d'abord tous les nœuds Edge, puis tous les nœuds de datastores.
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é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 les routeurs et les processeurs de messages
   8. Démarrer le serveur Qpid
   9. Démarrer le serveur Postgres
   10. Démarrer l'UI Apigee