Ce document explique comment restaurer un composant Edge dans un environnement existant sans avoir à le réinstaller. Cela signifie que le nœud sur lequel vous restaurez le composant possède la même adresse IP ou le même nom DNS que lorsque vous avez effectué la sauvegarde.
Si vous devez réinstaller le composant, consultez la section Réinstaller et restaurer des composants.
Apache ZooKeeper
Restaurer un nœud autonome
- Supprimez les anciens répertoires ZooKeeper :
/opt/apigee/data/apigee-zookeeper /opt/apigee/etc/apigee-zookeeper.d
- Restaurez les données ZooKeeper à partir du fichier de sauvegarde :
/opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper restore backup-2016.03.17,14.40.41.tar.gz
- Redémarrez tous les composants pour établir la synchronisation avec le nouveau ZooKeeper restauré.
Restaurer un nœud de cluster
- Si un seul nœud ZooKeeper, qui fait partie d'un ensemble, échoue, vous pouvez créer un nœud avec le même nom d'hôte/adresse IP (suivez les étapes de réinstallation décrites dans la section Réinstaller et restaurer des composants). Lorsqu'il rejoint l'ensemble ZooKeeper, il reçoit les derniers instantanés du leader et commence à servir les clients. Vous n'avez pas besoin de restaurer les données dans cette instance.
Restaurer un cluster complet
- Arrêtez le cluster complet.
- Restaurez tous les nœuds ZooKeeper à partir du fichier de sauvegarde.
- Démarrez le cluster ZooKeeper.
- Redémarrez tous les composants.
Apache Cassandra
Restaurer un nœud autonome
- Supprimez l'ancien répertoire Cassandra :
/opt/apigee/data/apigee-cassandra
- Restaurez le nœud Cassandra à partir du fichier de sauvegarde :
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restore backup-2016.03.17,14.40.41.tar.gz
- Redémarrez tous les composants.
Restaurer un nœud de cluster
- Si un seul nœud Cassandra, qui fait partie d'un ensemble, échoue, vous pouvez créer un nœud avec le même nom d'hôte/adresse IP (suivez les étapes de réinstallation décrites dans la section Réinstaller et restaurer des composants). Vous
n'avez qu'à réinstaller Cassandra. Vous n'avez pas besoin de restaurer les données.
Lorsque vous effectuez une restauration sur un nœud non-seed, assurez-vous qu'au moins un nœud seed Cassandra est actif.
Après avoir installé Cassandra et lorsque le nœud est actif (étant donné que RF>=2 pour tous les espaces clés) exécutez la commande
nodetoolsuivante pour initialiser le nœud :/opt/apigee/apigee-cassandra/bin/nodetool [-u username -pw password] -h localhost repair -pr
Vous n'avez qu'à transmettre votre nom d'utilisateur et votre mot de passe si vous avez activé l'authentification JMX pour Cassandra.
Restaurer un cluster complet
- Arrêtez le cluster complet.
- Restaurez tous les nœuds Cassandra à partir du fichier de sauvegarde.
- Démarrez le cluster Cassandra.
- Redémarrez tous les composants.
Base de données PostgreSQL
PosgreSQL exécuté de manière autonome ou en tant que maître
- Arrêtez 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 stop
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop - Assurez-vous que la base de données PostgreSQL est en cours d'exécution :
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql status
- Restaurez la base de données PostgreSQL à partir du fichier de sauvegarde :
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restore 2016.03.17,14.40.41.dump
- 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 tant que veille
- Reconfigurez la base de données PostgreSQL à l'aide du même fichier de configuration que celui que vous avez utilisé pour l'installer :
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup -f configFile
- Démarrez PostgreSQL :
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
Serveur Postgres
- Supprimez les anciens répertoires du serveur Postgres :
/opt/apigee/data/edge-postgres-server /opt/apigee/etc/edge-postgres-server.d
- Restaurez le serveur Postgres à partir du fichier de sauvegarde :
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server restore backup-2016.03.17,14.40.41.tar.gz
- Démarrez le serveur Postgres :
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
Base de données Qpidd
- Supprimez les anciens répertoires Qpidd :
/opt/apigee/data/apigee-qpidd /opt/apigee/etc/apigee-qpidd.d
- Restaurez Qpidd :
/opt/apigee/apigee-service/bin/apigee-service apigee-qpidd restore backup-2016.03.17,14.40.41.tar.gz
- Démarrez Qpidd :
/opt/apigee/apigee-service/bin/apigee-service apigee-qpidd start
Serveur Qpid
- Supprimez les anciens répertoires du serveur Qpid :
/opt/apigee/data/edge-qpid-server /opt/apigee/etc/edge-qpid-server.d
- Restaurez le serveur Qpid à partir du fichier de sauvegarde :
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restore backup-2016.03.17,14.40.41.tar.gz
- Démarrez le serveur Qpid :
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
SymasLDAP
- Supprimez les anciens répertoires SymasLDAP :
/opt/apigee/data/apigee-openldap /opt/apigee/etc/apigee-openldap.d
- Restaurez SymasLDAP à partir du fichier de sauvegarde :
/opt/apigee/apigee-service/bin/apigee-service apigee-openldap restore 2016.03.17,14.40.41
- Redémarrez SymasLDAP :
/opt/apigee/apigee-service/bin/apigee-service apigee-openldap start
Serveur de gestion
- Supprimez les anciens répertoires du serveur de gestion :
/opt/apigee/data/edge-management-server /opt/apigee/etc/edge-management-server.d
- Restaurez le serveur de gestion à partir du fichier de sauvegarde :
/opt/apigee/apigee-service/bin/apigee-service edge-management-server restore backup-2016.03.17,14.40.41.tar.gz
- Redémarrez le serveur de gestion :
/opt/apigee/apigee-service/bin/apigee-service edge-management-server start
Processeur de messages
- Supprimez les anciens répertoires du processeur de messages :
/opt/apigee/data/edge-message-processor /opt/apigee/etc/edge-message-processor.d
- Restaurez le processeur de messages à partir du fichier de sauvegarde :
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor restore backup-2016.03.17,14.40.41.tar.gz
- Redémarrez le processeur de messages :
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor start
Routeur
- Supprimez les anciens répertoires du routeur :
/opt/apigee/data/edge-router /opt/apigee/etc/edge-router.d
- Restaurez le routeur à partir du fichier de sauvegarde :
/opt/apigee/apigee-service/bin/apigee-service edge-router restore backup-2016.03.17,14.40.41.tar.gz
- Redémarrez le routeur :
/opt/apigee/apigee-service/bin/apigee-service edge-router start
Nouvelle interface utilisateur Edge
- Arrêtez la nouvelle interface utilisateur Edge :
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui stop
- Supprimez les anciens répertoires de la nouvelle interface utilisateur Edge :
/opt/apigee/data/edge-management-ui /opt/apigee/etc/edge-management-ui.d
- Restaurez la nouvelle interface utilisateur Edge à partir du fichier de sauvegarde :
/opt/apigee/apigee-service/bin/apigee-service edge-management-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 fichier de sauvegarde, ni le préfixe "backup-" ni 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. - Redémarrez la nouvelle interface utilisateur Edge :
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui start