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

Vous consultez la documentation d'Apigee Edge.
Consultez la documentation Apigee X.
en savoir plus

Version corrective de mars 2021

Les RPM de la version corrective de mars 2021 d'Edge for Private Cloud, qui avaient été transférés vers le dépôt de production Apigee, comportaient une mise à jour inattendue des dépendances pour apigee-nginx-1.18. Par conséquent, nous avons supprimé les RPM du dépôt et les avons remplacés par les RPM corrects. Les RPM non valides se trouvaient dans le dépôt le 25 mars 2021 entre 8h45 et 15h45 PST. Si vous avez téléchargé et installé des RPM Edge à cette date, vous devrez peut-être revenir à une version antérieure des composants Apigee suivants:

  • Passerelle périphérique
  • serveur-gestion-edge
  • processeur-message-à-bord
  • edge-postgres-server
  • serveur-edge-qpid
  • routeur de périphérie
  • nginx

Les sections suivantes décrivent comment vérifier si vous devez revenir à une version antérieure et comment revenir à une version antérieure des composants Apigee, si nécessaire.

Vérifier si vous devez revenir à une version antérieure

Pour savoir si vous devez revenir à une version antérieure des composants Apigee ou de NGINX, effectuez l'une des procédures suivantes, selon que vous utilisez Edge for Private Cloud 4.50.00 ou 4.19.06.

Procédure pour Edge 4.50.00

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

-- apigee-service edge-gateway version

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

  • Depuis moins de 2011, aucune autre action n'est requise de votre part.
  • Jusqu'à 20113, vous devez rétrograder les composants Apigee et NGINX.
  • Pour les versions ultérieures à 20113, recherchez votre version de NGINX en saisissant ce qui suit :
    -- 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 de NGINX est apigee-nginx.x86_64 1.18.0-XXX, il vous suffit de revenir à une version antérieure de NGINX.

Procédure pour Edge 4.19.06

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

-- apigee-service edge-gateway version

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

  • Depuis 2014, aucune autre action n'est requise de votre part.
  • Dans la version 20114, vous devez rétrograder les composants Apigee et repasser à une version antérieure de NGINX.
  • Pour les versions ultérieures à 20114, recherchez votre version de NGINX en saisissant ce qui suit :
    -- 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 de NGINX est apigee-nginx.x86_64 1.18.0-XXX, il vous suffit de revenir à une version antérieure de NGINX.

    Composants pour revenir à une version antérieure

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

    Composants pour revenir à une version antérieure de Edge pour Private Cloud 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 pour revenir à une version antérieure de Edge pour Private Cloud 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 contenant l'un des composants de la liste appropriée ci-dessus, saisissez la commande suivante pour chaque composant:

    -- apigee-service component version

    Revenir à une version antérieure des composants Apigee

    Pour revenir à une version antérieure des composants Apigee, procédez comme suit.

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

    • Passerelle périphérique
    • serveur-gestion-edge
    • processeur-message-à-bord
    • edge-postgres-server
    • serveur-edge-qpid
    • routeur de périphérie

    Arrêtez le composant en saisissant

    --apigee-service component stop

    Revenez ensuite à la version antérieure des composants:

    -- sudo yum downgrade 

    Voici quelques exemples :

    Si la passerelle et le processeur de messages de périphérie sont installés:

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

    Si la passerelle et le routeur de périphérie sont installés:

    -- sudo yum downgrade edge-gateway edge-router

    Si la configuration AIO est activée :

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

    Une fois que vous avez fini de revenir à une version antérieure, exécutez configure pour chaque composant et redémarrez-le.

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

    Vous trouverez ci-dessous la version correcte des RPM que vous obtenez après le passage à une version antérieure.

    Edge pour Private Cloud 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 Private Cloud 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

    Revenir à une version antérieure de NGINX

    Pour revenir à la version antérieure de 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. Revenir à une version antérieure de apigee-ngix
       -- sudo yum downgrade apigee-nginx
      Version apigee-nginx attendue après le retour à une version antérieure :
      -- 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