Revenir à une version antérieure des composants Apigee et de NGINX

Vous consultez la documentation Apigee Edge.
Accédez à la documentation**Apigee X**. info

Version du correctif de mars 2021

Les RPM de la version du correctif de mars 2021 d'Edge pour le cloud privé, qui ont été envoyés au dépôt de production Apigee, ont entraîné une mise à jour de dépendance involontaire pour apigee-nginx-1.18. Par conséquent, nous avons supprimé les RPM du dépôt et les avons remplacés par des RPM corrects. Les RPM non valides se trouvaient dans le dépôt le 25 mars 2021 de 8h45 à 15h45 PST. Si vous avez téléchargé et installé des RPM Edge à cette date, vous devrez peut-être rétrograder les composants Apigee suivants vers des versions antérieures :

  • edge-gateway
  • edge-management-server
  • edge-message-processor
  • edge-postgres-server
  • edge-qpid-server
  • edge-router
  • nginx

Les sections suivantes décrivent comment vérifier si vous devez effectuer une rétrogradation et comment rétrograder les composants Apigee, si nécessaire.

Vérifier si vous devez effectuer une rétrogradation

Pour déterminer si vous devez rétrograder les composants Apigee ou NGINX, suivez l'une des procédures ci-dessous, selon que vous utilisez Edge pour le cloud privé 4.50.00 ou 4.19.06.

Procédure pour Edge 4.50.00

Sur chaque nœud, saisissez la commande suivante pour trouver la version de votre passerelle :

-- apigee-service edge-gateway version

Si le numéro de version de edge-gateway est :

  • inférieur à 20113, aucune autre action n'est requise de votre part ;
  • égal à 20113, vous devez rétrograder les composants Apigee et NGINX.
  • supérieur à 20113, recherchez votre version NGINX en saisissant la commande suivante : 
    -- sudo yum list installed apigee-nginx

    Voici un exemple de résultat de la commande :

    Installed Packages
apigee-nginx.x86_64 1.18.0-1.el7
@apigee-thirdparty

    Si la version NGINX est apigee-nginx.x86_64 1.18.0-XXX, vous n'avez besoin que de rétrograder NGINX.

Procédure pour Edge 4.19.06

Sur chaque nœud, saisissez la commande suivante pour trouver la version de votre passerelle :

-- apigee-service edge-gateway version

Si le numéro de version de edge-gateway est :

  • inférieur à 20114, aucune autre action n'est requise de votre part ;
  • égal à 20114, vous devez rétrograder les composants Apigee et rétrograder NGINX.
  • supérieur à 20114, recherchez votre version NGINX en saisissant la commande suivante : 
    -- sudo yum list installed apigee-nginx

    Voici un exemple de résultat de la commande :

    Installed Packages
apigee-nginx.x86_64 1.18.0-1.el7
@apigee-thirdparty

    Si la version NGINX est apigee-nginx.x86_64 1.18.0-XXX, vous n'avez besoin que de rétrograder NGINX.

    Composants à rétrograder

    Si vous avez installé l'un des RPM des listes suivantes, vous devez revenir à la version précédente de ces RPM.

    Composants à rétrograder pour Edge pour le cloud privé 4.50.00

    edge-gateway-4.50.00-0.0.20113.noarch.rpm
edge-management-server-4.50.00-0.0.20113.noarch.rpm
edge-message-processor-4.50.00-0.0.20113.noarch.rpm
edge-postgres-server-4.50.00-0.0.20113.noarch.rpm
edge-qpid-server-4.50.00-0.0.20113.noarch.rpm
edge-router-4.50.00-0.0.20113.noarch.rpm

    Composants à rétrograder pour Edge pour le cloud privé 4.19.06

    edge-gateway-4.19.06-0.0.20114.noarch.rpm
edge-management-server-4.19.06-0.0.20114.noarch.rpm
edge-message-processor-4.19.06-0.0.20114.noarch.rpm
edge-postgres-server-4.19.06-0.0.20114.noarch.rpm
edge-qpid-server-4.19.06-0.0.20114.noarch.rpm
edge-router-4.19.06-0.0.20114.noarch.rpm

    Pour vérifier si ces RPM sont installés, sur chaque nœud où l'un des composants de la liste appropriée ci-dessus est installé, saisissez la commande suivante pour chaque composant :

    -- apigee-service component version

    Rétrograder les composants Apigee

    Pour rétrograder les composants Apigee, suivez la procédure ci-dessous.

    Sur chaque nœud sur lequel l'un des composants suivants est installé :

    • edge-gateway
    • edge-management-server
    • edge-message-processor
    • edge-postgres-server
    • edge-qpid-server
    • edge-router

    Arrêtez le composant en saisissant

    --apigee-service component stop

    Puis rétrogradez les composants :

    -- sudo yum downgrade

    Voici quelques exemples :

    Si la passerelle et edge-message-processor sont installés :

    -- sudo yum downgrade edge-gateway edge-message-processor

    Si la passerelle et edge-router sont installés :

    -- sudo yum downgrade edge-gateway edge-router

    Si la configuration AIO est utilisée : 

    -- sudo yum downgrade edge-gateway edge-postgres-server edge-router edge-management-server edge-message-processor edge-qpid-server

    Une fois la rétrogradation terminée, exécutez configure pour chaque composant et redémarrez-le.

    --apigee-service  component configure
--apigee-service  component start

    La version correcte des RPM que vous obtiendrez après la rétrogradation est indiquée ci-dessous.

    Edge pour le cloud privé 4.50.00

    edge-gateway-4.50.00-0.0.20110
Edge-management-server-4.50.00-0.0.20110
edge-message-processor-4.50.00-0.0.20110
edge-postgres-server-4.50.00-0.0.20110
edge-qpid-server-4.50.00-0.0.20110
edge-router-4.50.00-0.0.20110

    Edge pour le cloud privé 4.19.06

    edge-gateway-4.19.06-0.0.20112
Edge-management-server-4.19.06-0.0.20112
edge-message-processor-4.19.06-0.0.20112
edge-postgres-server-4.19.06-0.0.20112
edge-qpid-server-4.19.06-0.0.20112
edge-router-4.19.06-0.0.20112

    Rétrograder NGINX

    Pour rétrograder apigee-nginx, procédez comme suit pour le routeur Edge, un nœud à la fois :

    1. Arrêtez le routeur. 
      --apigee-service edge-router stop
    2. Rétrogradez apigee-ngix. 
       -- sudo yum downgrade apigee-nginx
       Version apigee-nginx attendue après la rétrogradation : 
      -- yum list installed apigee-nginx
apigee-nginx.x86_64 -1.16.1-6.el7
    3. Configurez le routeur. 
      apigee-service edge-router configure
    4. Démarrez le routeur. 
      apigee-service edge-router start