Effectuer un rollback vers Apigee Edge 4.50.00

Si vous rencontrez une erreur lors d'une mise à jour vers Edge 4.50.00, vous pouvez effectuer un rollback du composant à l'origine de l'erreur, puis réessayer d'effectuer la mise à jour.

Vous pouvez effectuer un rollback d'Edge 4.50.00 vers les versions de fonctionnalités suivantes :

  • Version 4.19.06
  • Version 4.19.01
  • Version 4.18.05

Deux scénarios peuvent vous amener à effectuer un rollback :

  1. Effectuer un rollback vers une version de fonctionnalité précédente Par exemple, de la version 4.50.00 à la version 4.18.05.
  2. Effectuer un rollback vers une version de mise à jour précédente dans la même version. Par exemple, de la version 4.19.01.02 à la version 4.19.01.01.

Pour en savoir plus, consultez Processus de publication d'Apigee Edge.

Qui peut effectuer un rollback ?

L'utilisateur qui effectue un rollback doit être le même que celui qui a initialement mis à jour Edge, ou un utilisateur exécutant en tant que racine.

Par défaut, les composants Edge s'exécutent en tant qu'utilisateur "apigee". Dans certains cas, vous pouvez exécuter des composants Edge en tant qu'utilisateurs différents. Par exemple, si le routeur doit accéder à des ports privilégiés, tels que ceux inférieurs à 1 000, vous devez l'exécuter en tant qu'utilisateur racine ou en tant qu'utilisateur ayant accès à ces ports. Vous pouvez également exécuter un composant en tant qu'un utilisateur et un autre composant en tant qu'un autre utilisateur.

Composants avec du code commun

Les composants Edge suivants partagent un code commun. Par conséquent, pour effectuer le rollback de l'un de ces composants sur un nœud, vous devez effectuer le rollback de tous ces composants sur ce nœud.

  • edge-management-server (serveur de gestion)
  • edge-message-processor (processeur de messages)
  • edge-router (routeur)
  • edge-postgres-server (serveur Postgres)
  • edge-qpid-server (serveur Qpid)

Par exemple, si le serveur de gestion, le routeur et le processeur de messages sont installés sur le nœud, vous devez effectuer un rollback sur les trois pour effectuer un rollback sur l'un d'entre eux.

Effectuer un rollback vers une version de fonctionnalité précédente

Pour effectuer un rollback vers une version de fonctionnalité précédente, procédez comme suit sur chaque nœud qui héberge le composant :

  1. Téléchargez le fichier bootstrap.sh correspondant à la version vers laquelle vous souhaitez effectuer un rollback :

    • Pour effectuer un rollback vers la version 4.19.06, téléchargez bootstrap_4.19.06.sh : 
      curl https://software.apigee.com/bootstrap_4.19.06.sh -o /tmp/bootstrap_4.19.06.sh
    • Pour effectuer un rollback vers la version 4.19.01, téléchargez bootstrap_4.19.01.sh : 
      curl https://software.apigee.com/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh
    • Pour effectuer un rollback vers la version 4.18.05, téléchargez bootstrap_4.18.05.sh : 
      curl https://software.apigee.com/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.sh
  2. Arrêtez le composant pour effectuer un rollback :
    1. Pour effectuer un rollback de l'un des composants avec du code commun sur le nœud, vous devez tous les arrêter, comme illustré dans l'exemple suivant : 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-server stop
/opt/apigee/apigee-service/bin/apigee-service edge-router stop
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor stop
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. Pour effectuer le rollback de tout autre composant sur le nœud, arrêtez uniquement ce composant : 
      • /opt/apigee/apigee-service/bin/apigee-service component stop
  3. Si vous effectuez un rollback de la monétisation, désinstallez-la de tous les nœuds du serveur de gestion et du processeur de messages : 
    /opt/apigee/apigee-service/bin/apigee-service edge-mint-gateway uninstall
  4. Désinstallez le composant pour effectuer un rollback sur le nœud :
    1. Pour effectuer un rollback de l'un des composants avec du code commun sur le nœud, vous devez tous les désinstaller en désinstallant le groupe de composants edge-gateway, comme illustré dans l'exemple suivant : 
      /opt/apigee/apigee-service/bin/apigee-service edge-gateway uninstall
    2. Pour effectuer un rollback de tout autre composant sur le nœud, désinstallez uniquement ce composant, comme illustré dans l'exemple suivant : 
      /opt/apigee/apigee-service/bin/apigee-service component uninstall

      où component est le nom du composant.

    3. Pour effectuer un rollback du routeur Edge, vous devez supprimer le contenu du fichier /opt/nginx/conf.d en plus de désinstaller le groupe de composants edge-gateway : 
      cd /opt/nginx/conf.d
rm -rf *
  5. Désinstallez la version 4.50.00 de apigee-setup : 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall
  6. Installez la version 4.19.01 ou 4.18.05 de l'utilitaire apigee-service et ses dépendances. L'exemple suivant installe la version 4.18.05 de apigee-service : 
    sudo bash /tmp/bootstrap_4.18.05.sh apigeeuser=uName apigeepassword=pWord

    Où uName et pWord sont le nom d'utilisateur et le mot de passe que vous avez reçus d'Apigee. Si vous omettez pWord, vous serez invité à le saisir.

    Si un message d'erreur s'affiche, vérifiez que vous avez bien téléchargé le fichier bootstrap.sh à l'étape 1.

  7. Installez apigee-setup : 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  8. Installez l'ancienne version du composant : 
    /opt/apigee/apigee-setup/bin/setup.sh -p component -f configFile

    Où component est le composant à installer et configFile est votre fichier de configuration pour l'ancienne version.

  9. Si vous effectuez un rollback de Qpid, videz les iptables : 
    sudo iptables -F
  10. Répétez cette procédure pour chaque nœud qui héberge le composant que vous souhaitez restaurer.

Effectuer un rollback vers une version de mise à jour précédente

Pour effectuer un rollback d'un composant vers une version spécifique d'une release, procédez comme suit sur chaque nœud qui héberge le composant :

  1. Téléchargez la version spécifique du composant : 
    /opt/apigee/apigee-service/bin/apigee-service component_version install

    où component_version est le composant et la version de mise à jour à installer. Par exemple :

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

    Si vous utilisez le dépôt en ligne Apigee, vous pouvez déterminer les versions de composants disponibles à l'aide de la commande suivante : 

    yum --showduplicates list comp

    Exemple :

    yum --showduplicates list edge-ui
  2. Utilisez apigee-setup pour installer le composant : 
    /opt/apigee/apigee-setup/bin/setup.sh -p comp -f configFile

    Exemple :

    /opt/apigee/apigee-setup/bin/setup.sh -p ui -f configFile

    Notez que vous ne spécifiez que le nom du composant lorsque vous l'installez, et non la version.

  3. Répétez cette procédure pour chaque nœud qui héberge le composant que vous souhaitez restaurer.