Réinstaller et restaurer des composants

Ce document explique comment réinstaller et restaurer 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. 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

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

Si un seul nœud Cassandra faisant partie d'un ensemble échoue, vous pouvez créer un nœud avec le même nom d'hôte/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 répliques 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 puisse pas rejoindre accidentellement le cluster Cassandra. Ensuite, créez un nœud avec la même adresse IP que le nœud d'origine et exécutez les étapes d'amorçage Apigee habituelles.

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. Effacez 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 disposer d'un nœud avec la même adresse IP que le nœud défaillant, prêt pour l'installation du logiciel Apigee. Procédez comme suit :

1. Identifiez les nœuds de seed du centre de données.
   1. Sur n'importe quel nœud Cassandra opérationnel du même centre de données que le nœud à restaurer, exécutez la commande suivante :

      apigee-service apigee-cassandra configure -search conf_cassandra_seeds

   2. Le résultat ressemblera à 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 listées et séparées par une virgule sont les nœuds de départ utilisés par les nœuds de ce centre de données.
2. Sur le nouveau nœud en cours de restauration, 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 sources (l'adresse IP du nœud figure 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>"

   1. Par exemple, dans l'instance ci-dessus, la liste de seed comporte deux adresses IP : 10.1.0.1 et 10.1.0.2. Si le nœud en cours de restauration est 10.1.0.1, ajoutez une ligne comme celle-ci :
      

      conf_cassandra_seeds="10.1.0.2"

5. Enregistrez le fichier et assurez-vous qu'il appartient à l'utilisateur Apigee et qu'il est lisible par celui-ci :
   

   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 de Cassandra :
   

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

8. La configuration tentera en interne d'amorcer le service Cassandra. Cette opération peut prendre du temps en fonction de la quantité de données à diffuser en streaming depuis d'autres nœuds, du débit de votre réseau, etc.
9. [Option avancée] Vous pouvez accélérer le streaming des 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 de nouveau opérationnel, utilisez des commandes standards comme celles ci-dessous pour vérifier qu'il a bien rejoint l'anneau :
    

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

11. Une fois que vous avez 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 les étapes 3 et 4 de cette procédure.
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 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

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 lorsque vous restaurez le 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

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

Serveur Qpid 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é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 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. Restaurez 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

SymasLDAP

1. Arrêter SymasLDAP :

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

2. Réinstallez SymasLDAP :

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

3. Supprimez les anciens répertoires SymasLDAP :

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

4. Restaurer SymasLDAP :

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

   /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 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 Message Processor :

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

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

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

   /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 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. Interface utilisateur de redémarrage :
   

   /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 data store.
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. Assurez-vous que SymasLDAP 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'interface utilisateur Apigee