Si vous rencontrez une erreur lors d'une mise à jour de Edge 4.50.00, vous pouvez effectuer un rollback du composant à l'origine de l'erreur, puis relancer la mise à jour.
Vous pouvez effectuer un rollback vers les versions suivantes d'Edge 4.50.00:
- Version 4.19.06
- Version 4.19.01
- Version 4.18.05
Il existe deux cas dans lesquels vous pouvez effectuer un rollback:
- Effectuer un rollback vers une version précédente de la fonctionnalité (de 4.50.00 à 4.18.05, par exemple).
- Effectuez un rollback vers une version de mise à jour précédente dans la même version. (de 4.19.01.02 à 4.19.01.01, par exemple).
Pour plus d'informations, consultez le processus de publication d'Apigee Edge.
Qui peut effectuer un rollback
L'utilisateur effectuant un rollback doit être le même que celui qui a mis à jour Edge ou un utilisateur s'exécutant en tant qu'utilisateur root.
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 utilisateur ayant accès à ces ports. Vous pouvez également exécuter un composant en tant qu'utilisateur et un autre en tant qu'utilisateur.
Composants avec du code commun
Les composants Edge suivants partagent un code commun. Par conséquent, pour effectuer un rollback de l'un de ces composants sur un nœud, vous devez effectuer le rollback de tous les composants qui se trouvent sur ce nœud.
edge-management-server
(serveur de gestion)edge-message-processor
(outil de traitement des 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 le rollback des trois.
Effectuer un rollback vers une version précédente de la fonctionnalité
Pour effectuer un rollback vers une version précédente de la fonctionnalité, procédez comme suit sur chaque nœud qui héberge le composant:
-
Téléchargez le fichier
bootstrap.sh
de la version à restaurer:- 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
- Pour effectuer un rollback vers la version 4.19.06, téléchargez
- Arrêtez le composant pour effectuer un rollback :
- Pour effectuer un rollback de l'un des composants avec du code commun sur le nœud, vous devez tous les arrêter, comme indiqué 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
- Pour effectuer le rollback d'un autre composant sur le nœud, arrêtez uniquement ce composant :
/opt/apigee/apigee-service/bin/apigee-service component stop
- Pour effectuer un rollback de l'un des composants avec du code commun sur le nœud, vous devez tous les arrêter, comme indiqué dans l'exemple suivant :
- Si vous effectuez un rollback de la monétisation, désinstallez-la de tous les nœuds Management Server et de processeur de messages :
/opt/apigee/apigee-service/bin/apigee-service edge-mint-gateway uninstall
- Désinstallez le composant pour effectuer un rollback sur le nœud :
- 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 indiqué dans l'exemple suivant :/opt/apigee/apigee-service/bin/apigee-service edge-gateway uninstall
- Pour effectuer le rollback d'un autre composant du nœud, désinstallez uniquement ce composant, comme indiqué dans l'exemple suivant :
/opt/apigee/apigee-service/bin/apigee-service component uninstall
Où component correspond au nom du composant.
- Pour effectuer un rollback de Edge Router, vous devez supprimer le contenu du fichier
/opt/nginx/conf.d
en plus de désinstaller le groupe de composantsedge-gateway
:cd /opt/nginx/conf.d
rm -rf *
- 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
- Désinstallez la version 4.50.00 de
apigee-setup
:/opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall
- 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 deapigee-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 êtes invité à le faire.
Si vous recevez un message d'erreur, vérifiez que vous avez bien téléchargé le fichier
bootstrap.sh
à l'étape 1. - Installer
apigee-setup
:/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- 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 le fichier de configuration de l'ancienne version.
- Si vous effectuez un rollback de Qpid, videz iptables :
sudo iptables -F
- Répétez cette procédure pour chaque nœud qui héberge le composant pour lequel vous effectuez le rollback.
Effectuer un rollback vers une version de mise à jour précédente
Pour effectuer le rollback d'un composant vers une version spécifique d'une version, procédez comme suit sur chaque nœud qui héberge le composant:
- Téléchargez la version spécifique du composant :
/opt/apigee/apigee-service/bin/apigee-service component_version install
Où component_version correspond au 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 des composants disponibles à l'aide de la commande suivante :
yum --showduplicates list comp
Exemple :
yum --showduplicates list edge-ui
- 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 spécifiez uniquement le nom du composant lors de l'installation, et non la version.
- Répétez cette procédure pour chaque nœud qui héberge le composant pour lequel vous effectuez le rollback.