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 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-" 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.

  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 à 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 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 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 peut pas rejoindre accidentellement le cluster Cassandra. Ensuite, lancez un nouveau 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

Après avoir suivi les étapes ci-dessus, vous devriez disposer d'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. 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 en cours de restauration, 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 seed 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 source 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 d'amorcer le service Cassandra en interne. Cette opération peut prendre beaucoup de temps en fonction de la quantité de données à diffuser à partir 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 que le nœud Cassandra est 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 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 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

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

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

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

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

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

  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 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-" 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.

  5. Redémarrez le routeur :
    /opt/apigee/apigee-service/bin/apigee-service edge-router start

Nouvelle interface utilisateur Edge

  1. Arrêter la nouvelle UI Edge : 
    /opt/apigee/apigee-service/bin/apigee-service edge-management-ui stop
  2. Supprimez les anciens répertoires de l'UI New Edge : 
    /opt/apigee/data/edge-management-ui
/opt/apigee/etc/edge-management-ui.d
  3. Réinstallez la nouvelle interface utilisateur Edge : 
    /opt/apigee/apigee-service/bin/apigee-service edge-management-ui install
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui-static install
  4. 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.

  5. Redémarrez la nouvelle interface utilisateur Edge : 
    /opt/apigee/apigee-service/bin/apigee-service edge-management-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 arrêtez 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 la nouvelle UI Edge