Effectuer un rollback d'Apigee Edge 4.19.06

Si vous rencontrez une erreur lors d'une mise à jour vers Edge 4.19.06, vous pouvez effectuer un rollback du à l'origine de l'erreur, puis relancez la mise à jour.

Vous pouvez effectuer un rollback d'Edge 4.19.06 vers les versions de version suivantes:

  • Version
  • Version
  • Version

Il existe deux scénarios dans lesquels vous pouvez effectuer un rollback:

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

Pour plus d'informations, voir Version d'Apigee Edge processus.

Qui peut effectuer un rollback

L'utilisateur effectuant un rollback doit être l'utilisateur qui a initialement mis à jour Edge, ou un en tant qu'utilisateur racine.

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

Composants avec du code commun

Les composants Edge suivants partagent un code commun. Par conséquent, pour effectuer un rollback de l'une ces composants sur un nœud, vous devez effectuer un rollback de tous les composants qui se trouvent 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. Pour effectuer le rollback de l'un d'entre eux, vous devez effectuer le rollback tous les trois.

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 la version composant:

  1. Téléchargez le fichier bootstrap.sh correspondant à la version à déployer retour:

    • Pour revenir à 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 revenir à 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 revenir à la version 4.18.01, téléchargez bootstrap_4.18.01.sh:
      curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh 
  2. Arrêtez le composant à restaurer: <ph type="x-smartling-placeholder">
      </ph>
    1. Pour effectuer le rollback de l'un des composants avec du code commun sur le 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 un rollback vers un autre composant du nœud, arrêtez uniquement ce composant: <ph type="x-smartling-placeholder">
        </ph>
      • /opt/apigee/apigee-service/bin/apigee-service component stop
  3. Si vous effectuez un rollback de la monétisation, désinstallez-la de l'ensemble du serveur de gestion et des messages Nœuds de processeur:
    /opt/apigee/apigee-service/bin/apigee-service edge-mint-gateway uninstall
  4. Désinstallez le composant pour effectuer un rollback sur le nœud: <ph type="x-smartling-placeholder">
      </ph>
    1. Pour effectuer le rollback de l'un des composants avec du code commun sur le vous devez tous les désinstaller en désinstallant le composant edge-gateway. , comme le montre l'exemple suivant:
      /opt/apigee/apigee-service/bin/apigee-service edge-gateway uninstall
    2. Pour effectuer le rollback d'un autre composant du nœud, désinstallez-le uniquement, l'exemple suivant montre:
      /opt/apigee/apigee-service/bin/apigee-service component uninstall

      component est le nom du composant.

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

    uName et pWord correspondent au nom d'utilisateur et au mot de passe que vous avez reçus. d'Apigee. Si vous omettez pWord, vous serez invité à le faire.

    Si un message d'erreur s'affiche, vérifiez que vous avez 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

    component est le composant à installer et configFile est votre pour l'ancienne version.

  9. Si vous effectuez un rollback de Qpid, videz iptables:
    sudo iptables -F
  10. Répétez cette procédure pour chaque nœud qui héberge le composant faisant l'objet d'un 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:

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

    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.01-0.0.3749 install

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

    yum --showduplicates list comp

    Exemple :

    yum --showduplicates list edge-ui
  2. Installez le composant à l'aide de apigee-setup:
    /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, lors de l'installation, vous indiquez uniquement le nom du composant, et non sa version.

  3. Répétez cette procédure pour chaque nœud qui héberge le composant faisant l'objet d'un rollback.