Mise à jour d'Apigee Edge 4.16.01/4.16.05 vers la version 4.18.01

Edge for Private Cloud v4.18.01

Quelles versions d'Edge pouvez-vous mettre à jour vers la version 4.18.01 ?

Vous pouvez mettre à jour les versions 4.16.01.0x et 4.16.05.x d'Apigee Edge vers la version 4.18.01 en suivant cette procédure.

Si vous disposez d'une version d'Edge antérieure à la version 4.16.01, vous devez d'abord migrer vers la version 4.16.01, puis passer à la version 4.18.01.

  • Vous pouvez migrer la version 4.15.07 d'Apigee Edge vers la version 4.16.01.
  • Si vous disposez d'une version d'Edge antérieure à la version 4.15.07, vous devez d'abord migrer vers la version 4.15.07, puis vers la version 4.16.01.
    • Si vous effectuez une migration depuis Edge 4.14.04 ou une version ultérieure: migrez directement vers la version 4.15.07.
    • Si vous effectuez une migration depuis Edge version 4.14.01: vous devez d'abord migrer vers la version 4.14.04, puis migrer vers la version 4.15.07.

Qui peut effectuer la mise à jour ?

L'utilisateur exécutant la mise à jour doit être le même que celui qui a installé Edge ou un utilisateur s'exécutant en tant qu'utilisateur root.

Une fois que vous avez installé les RPM Edge, n'importe quel utilisateur peut les configurer.

Composants à mettre à jour

Vous devez mettre à jour tous les composants Edge. Edge n'est pas compatible avec une configuration contenant des composants de plusieurs versions.

Revenir à une version antérieure de Zookeeper si vous effectuez la mise à jour depuis la version 4.16.01

La version du RPM de Zookeeper dans Edge for Private Cloud 4.16.01 est apigee-zookeeper-3.4.5-1.0.905.noarch.rpm. Dans les versions suivantes d'Edge, la version de Zookeeper a été redéfinie sur apigee-zookeeper-3.4.5-0.0.94x. Cela empêche yum de mettre à niveau Zookeeper vers une version ultérieure de la version 4.16.01. Pour corriger cette situation, exécutez la commande yum down apigee-zookeeper avant de mettre à jour Zookeeper.

Pour vérifier la version de ZooKeeper, exécutez la commande suivante:

> rpm -qa |grep apigee-zookeeper

Si cette commande renvoie la version de Zookeeper:

apigee-zookeeper-3.4.5-1.0.905

Vous devez ensuite revenir à une version antérieure.

Propagation automatique des paramètres de propriété

Si vous avez défini des propriétés en modifiant les fichiers .properties dans /opt/apigee/customer/application, ces valeurs sont conservées lors de la mise à jour.

Mettre à jour les prérequis

Avant de mettre à niveau Apigee Edge, remplissez les conditions préalables suivantes:

  • Sauvegarder tous les nœuds
    Avant de procéder à la mise à jour, nous vous recommandons d'effectuer une sauvegarde complète de tous les nœuds pour des raisons de sécurité. Suivez la procédure correspondant à votre version actuelle d'Edge pour effectuer la sauvegarde.

    Cela vous permet de disposer d'un plan de sauvegarde au cas où la mise à jour vers une nouvelle version ne fonctionnerait pas correctement. Pour en savoir plus sur la sauvegarde, consultez la page Sauvegarde et restauration.
  • Assurez-vous qu'Edge est en cours d'exécution
    Assurez-vous qu'Edge est opérationnel pendant le processus de mise à jour à l'aide de la commande suivante:

    > /opt/apigee/apigee-service/bin/apigee-all status

Gérer les échecs de mise à jour

En cas d'échec de la mise à jour, vous pouvez essayer de corriger le problème, puis exécuter à nouveau update.sh. Vous pouvez exécuter la mise à jour plusieurs fois afin de la reprendre là où elle s'était arrêtée.

Si l'échec nécessite un rollback de la mise à jour vers la version précédente, voir 4.18.01 Processus de rollback pour plus d'informations.

Informations sur les mises à jour de Logging

Par défaut, l'utilitaire update.sh écrit les informations de journal dans:

/opt/apigee/var/log/apigee-setup/update.log

Si l'utilisateur qui exécute l'utilitaire update.sh n'a pas accès à ce répertoire, il écrit le journal dans le répertoire /tmp sous la forme d'un fichier nommé update_username.log.

Si l'utilisateur n'a pas accès à /tmp, l'utilitaire update.sh échoue.

Mise à niveau requise vers Java JDK version 8

Cette version d'Edge nécessite que vous ayez installé Java JDK version 8 sur tous les nœuds de traitement Edge. Vous pouvez installer Oracle JDK 8 ou OpenJDK 8. Si Java JDK 8 n'est pas déjà installé, le script de mise à jour peut l'installer pour vous.

Dans le cadre de la mise à jour de Java 8, certains algorithmes de chiffrement TLS ne sont plus disponibles dans Oracle JDK 8. Pour obtenir la liste complète, consultez la section "Default Disabled Cipher Suites" (Suites de chiffrement désactivées par défaut) sur http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html.

Obligatoire pour activer le dépôt EPEL

Vous devez activer les packages supplémentaires pour Enterprise Linux (ou EPEL) pour installer ou mettre à jour Edge. La commande à utiliser dépend de votre version de RedHat/CentOS:

  • Pour RedHat/CentOS 7.x:
    > wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm; rpm -ivh epel-release-latest-7.noarch.rpm
  • Pour RedHat/CentOS 6.x:
    wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm; rpm -ivh epel-release-latest-6.noarch.rpm

Ajout du paramètre de configuration SMTPMAILFROM obligatoire

Edge 4.17.05 a ajouté un nouveau paramètre obligatoire au fichier de configuration utilisé lors de l'activation d'un serveur SMTP. Si vous effectuez une mise à jour depuis la version 4.17.01, vous devez définir SMTPMAILFROM dans le fichier de configuration lors de l'activation du serveur SMTP.

La version 4.17.09 de l'API BaaS est également compatible avec la propriété SMTPMAILFROM. Lors de la mise à jour des règles BaaS de l'API, vous devez définir SMTPFROM dans le fichier de configuration.

Ce paramètre se présente sous la forme suivante:

SMTPMAILFROM="My Company <myco@company.com>"

Obligatoire en cas de mise à jour lors de l'utilisation d'une authentification externe

Vous pouvez intégrer un service d'annuaire externe dans une installation de cloud privé Apigee Edge existante. Cette fonctionnalité est conçue pour fonctionner avec tous les services d'annuaire compatibles avec LDAP, comme Active Directory ou OpenLDAP. Une solution LDAP externe permet aux administrateurs système de gérer les identifiants des utilisateurs depuis un service centralisé de gestion des annuaires, externe aux systèmes qui les utilisent, tels qu'Apigee Edge.

Pour en savoir plus, consultez la section Configuration de l'authentification externe.

Lorsque l'authentification externe est activée, la plupart des clients utilisent le champ de nom de compte SAM Active Directory comme nom d'utilisateur pour l'authentification, au lieu d'une adresse e-mail utilisée par le serveur Edge OpenLDAP.

Si vous avez intégré un service d'annuaire externe, ajoutez la ligne suivante à votre fichier de configuration lors de la mise à jour d'Edge vers la version 4.18.01:

IS_EXTERNAL_AUTH="true"

Cette ligne configure Edge pour qu'il accepte un nom de compte plutôt qu'une adresse e-mail comme nom d'utilisateur.

Mise à niveau requise vers Qpid 1.35

Cette version contient une mise à jour requise pour Qpid 1.35. Dans le cadre de la mise à jour d'un nœud Qpid, vous devez effectuer les opérations suivantes:

  • Empêchez temporairement les routeurs et les processeurs de messages d'écrire sur le nœud Qpid en bloquant le port 5672 sur le nœud Qpid. Vous pouvez utiliser la commande suivante pour bloquer ce port sur le nœud Qpid:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `nom-hôte` -i eth0 -j DROP
  • Attendez que la file d'attente Qpid soit vide de messages pour vous assurer que le nœud Qpid a traité tous les messages avant la mise à jour. Utilisez la commande suivante pour vous assurer que la file d'attente de messages Qpid est vide:
    > qpid-stat -q
  • Mettez à jour le nœud Qpid.
  • Débloquez le port 5672 sur le nœud Qpid pour autoriser l'accès depuis les routeurs et les processeurs de messages. Vous pouvez utiliser la commande suivante pour débloquer ce port:
    > sudo iptables -F

    Notez que si vous utilisez iptables pour d'autres règles, vous pouvez utiliser l'option -D pour annuler la modification spécifique:
    > sudo iptables -D INPUT -p tcp --destination-port 5672 ! -s `nom-hôte` -i eth0 -j DROP

Ce processus est décrit en détail ci-dessous pour chaque topologie de périphérie.

Mise à niveau vers Postgres 9.6 requise

Cette version d'Edge inclut une mise à niveau vers Postgres 9.6. Dans le cadre de cette mise à niveau, toutes les données Postgres sont migrées vers Postgres 9.6.

Pendant le processus de mise à jour, lorsque les nœuds Postgres sont arrêtés pour la mise à jour, les données d'analyse sont toujours écrites dans les nœuds Qpid. Une fois les nœuds Postgres mis à jour et remis en ligne, les données d'analyse sont ensuite transmises aux nœuds Postgres.

Le nœud de secours Postgres supplémentaire est nécessaire si vous devez effectuer un rollback de la mise à jour pour une raison quelconque. Si vous devez effectuer un rollback de la mise à jour, le nouveau nœud de secours Postgres devient le nœud Postgres maître après le rollback. Par conséquent, lorsque vous installez le nouveau nœud de secours Postgres, celui-ci doit se trouver sur un nœud qui répond à toutes les exigences matérielles d'un serveur Postgres, comme défini dans les Conditions d'installation Edge.

Installer un nouveau nœud de secours Postgres

Cette procédure crée un serveur de secours Postgres sur un nouveau nœud. Veillez à installer un nouveau serveur de secours Postgres pour votre version existante d'Edge (4.16.01 ou 4.16.05), et non pour la version 4.18.01.

Pour effectuer l'installation, utilisez le même fichier de configuration que celui que vous avez utilisé pour installer votre version actuelle d'Edge.

Pour créer un nœud de secours Postgres:

  1. Sur le serveur Postgres actuel, modifiez le fichier /opt/apigee/customer/application/postgresql.properties pour définir le jeton suivant. Si ce fichier n'existe pas, créez-le:

    conf_pg_hba_réplication.connection=host réplication apigee existing_slave_ip/32 confiance\ \nréplication d'hôte apigee existing_slave_ip/32 trust

    existing_slave_ip est l'adresse IP de l'adresse IP de secours Postgres actuelle, et existing_slave_ip
  2. Redémarrez apigee-postgresql sur le maître Postgres:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
  3. Vérifiez que le nouveau nœud de secours a été ajouté en affichant le fichier /opt/apigee/apigee-postgresql/conf/pg_hba.conf sur le maître. Les lignes suivantes doivent s'afficher dans ce fichier:
    host réplication apigee existing_legacy_ip/32 trust
    host réplication apigee new_slave_ip/32 trust
  4. Installez le nouveau serveur de secours Postgres :
    1. Modifiez le fichier de configuration que vous avez utilisé pour installer votre version actuelle d'Edge pour spécifier les éléments suivants:

      # adresse IP du maître actuel:
      PG_MASTER=192.168.56.103
      # adresse IP du nouveau nœud de secours
      PG_STANDBY=192.168.56.102
    2. Désactivez SELinux comme indiqué dans l'article Installer l'utilitaire de configuration Edge Apigee.
    3. Téléchargez le fichier Edge bootstrap_4.16.05.sh dans /tmp/bootstrap_4.16.05.sh :
      > curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
      6.0.bootstrap 4.téléchargez le fichier depuis Edge./tmp/bootstrap_4.16.05.sh
    4. Installez l'utilitaire et les dépendances Edge apigee-service:
      > sudo bash /tmp/bootstrap_4.16.05.sh apigeeuser=uName apigeepassword=pWord
    5. Utilisez apigee-service pour installer l'utilitaire apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    6. Installez Postgres:
      > /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
    7. Sur le nouveau nœud de secours, exécutez la commande suivante:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      Vérifiez qu'il s'agit bien du nœud de secours.

Mettre hors service un nœud Postgres

Une fois la mise à jour terminée, mettez le nouveau nœud de secours hors service:

  1. Assurez-vous que Postgres est en cours d'exécution:
    > /opt/apigee/apigee-service/bin/apigee-all status

    Si Postgres n'est pas en cours d'exécution, démarrez-le:
    > /opt/apigee/apigee-service/bin/apigee-all start
  2. Obtenez l'UUID du nouveau nœud de secours en exécutant la commande cURL suivante sur le nouveau nœud de secours :
    > curl -u sysAdminEmail:password http://<node_IP>:8084/v1/servers/self

    L'identifiant du nœud doit s'afficher à la fin du résultat, sous la forme suivante :

  3. Arrêtez le nouveau nœud de secours en exécutant la commande suivante sur le nouveau nœud de secours:
    > /opt/apigee/apigee-service/bin/apigee-all stop
  4. Sur le nœud maître Postgres, modifiez /opt/apigee/customer/application/postgresql.properties pour supprimer le nouveau nœud de secours de conf_pg_hba_réplication.connection:
    conf_pg_hba_réplication.connection=host réplication apigee existing_slave_ip/32 trust
  5. Redémarrez apigee-postgresql sur le maître Postgres:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
  6. Vérifiez que le nouveau nœud de secours a été supprimé en affichant le fichier /opt/apigee/apigee-postgresql/conf/pg_hba.conf sur le maître. Vous ne devriez voir que la ligne suivante dans ce fichier:
    host réplication apigee existing_slave_ip/32 trust
  7. Supprimez l'UUID du nœud de secours de ZooKeeper en effectuant l'appel d'API de gestion Edge suivant sur le nœud du serveur de gestion:
    > curl -u sysAdminEmail:password -X DELETE http://<ms_IP>:8080/v1/servers/<new_slave_uuid>

Mise à jour sans temps d'arrêt

Une mise à jour sans temps d'arrêt ou une mise à jour progressive vous permet de mettre à jour votre installation Edge sans désactiver Edge.

La mise à jour sans temps d'arrêt n'est possible qu'avec une configuration à cinq nœuds ou plus.

La clé pour une mise à niveau sans temps d'arrêt consiste à supprimer chaque routeur, un par un, de l'équilibreur de charge. Ensuite, mettez à jour le routeur et tous les autres composants sur la même machine que le routeur, puis ajoutez de nouveau le routeur à l'équilibreur de charge.

  1. Mettez à jour les machines dans le bon ordre pour votre installation, comme décrit ci-dessous dans la section "Ordre des mises à jour des machines".
  2. Au moment de mettre à jour les routeurs, sélectionnez un routeur et rendez-le inaccessible, comme décrit dans la section Activer/Désactiver l'accessibilité du serveur (processeur de messages/routeur).
  3. Mettez à jour le routeur sélectionné et tous les autres composants Edge sur la même machine que le routeur. Toutes les configurations Edge montrent un routeur et un processeur de messages sur le même nœud.
  4. Rendez le routeur à nouveau accessible.
  5. Répétez les étapes 2 à 4 pour les autres routeurs.
  6. Continuez la mise à jour pour toutes les machines restantes de votre installation.

Effectuez les actions suivantes avant/après la mise à jour:

  • Sur le nœud à la fois de routeur et de processeur de messages :
    • Avant la mise à jour, effectuez les opérations suivantes :
      1. Rendez le routeur inaccessible.
      2. Rend le processeur de messages inaccessible.
    • Après la mise à jour, procédez comme suit :
      1. Rend le processeur de messages accessible.
      2. Rendez le routeur accessible.
  • Sur un seul nœud de routeur :
    • Avant la mise à jour, rendez le routeur inaccessible.
    • Après la mise à jour, rendez le routeur accessible.
  • Sur un seul nœud de processeur de messages :
    • Avant la mise à jour, rendez le processeur de messages inaccessible.
    • Après la mise à jour, rendez le processeur de messages accessible.

Utilisation d'un fichier de configuration silencieux

Vous devez transmettre un fichier de configuration silencieuse à la commande "update". Le fichier de configuration silencieuse doit être le même que celui que vous avez utilisé pour installer Edge 4.16.01 ou 4.16.05.

Procédure de mise à jour vers la version 4.18.01 sur un nœud avec une connexion Internet externe

Pour mettre à jour les composants Edge d'un nœud, procédez comme suit:

  1. Si vous utilisez actuellement la réplication en attente maître Postgres, installez un nouveau nœud de secours Postgres comme décrit ci-dessus dans Installer un nouveau nœud de secours Postgres.
  2. Le cas échéant, désactivez toutes les tâches CRON configurées pour effectuer une opération de réparation sur Cassandra jusqu'à la fin de la mise à jour.
  3. Connectez-vous à votre nœud en tant qu'utilisateur racine pour installer les RPM Edge.
    Remarque: Bien que l'installation RPM nécessite un accès racine, vous pouvez effectuer une configuration Edge sans accès racine.
  4. Installez yum-utils et yum-plugin-priorities:
    > sudo yum install yum-utils
    > sudo yum install yum-plugin-priorities
  5. Désactivez SELinux comme décrit dans la section Installer l'utilitaire de configuration Edge Apigee.
  6. Activez le dépôt EPEL comme décrit ci-dessus.
  7. Si vous effectuez l'installation sur Oracle 7.x, exécutez la commande suivante:
    > sudo yum-config-manager --enable ol7_optional_latest
  8. Si vous effectuez l'installation sur AWS, exécutez les commandes yum-configure-manager suivantes:
    > yum update rh-amazon-rhui-client.noarch
    > sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
  9. Téléchargez le fichier Edge 4.18.01 bootstrap_4.18.01.sh dans /tmp/bootstrap_4.18.01.sh:
    > curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
  10. Installez l'utilitaire et les dépendances apigee-service d'Edge 4.18.01:
    > sudo bash /tmp/bootstrap_4.18.01.sh apigeeuser=uName apigeepassword=pWord

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

    Par défaut, le programme d'installation vérifie que Java 1.8 est installé. Dans le cas contraire, il l'installe pour vous. Utilisez l'option JAVA_FIX pour indiquer comment gérer l'installation de Java. JAVA_FIX prend les valeurs suivantes:

    I = Installer OpenJDK 1.8 (par défaut)
    C = Continuer sans installer Java
    Q = Quitter. Pour utiliser cette option, vous devez installer Java vous-même.
  11. Utilisez apigee-service pour mettre à jour l'utilitaire apigee-setup :
    1. Si vous avez installé la version 4.16.01 en mettant à niveau Edge version 4.15.07.0x, vous devez installer l'utilitaire apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install

      Cette commande installe l'utilitaire update.sh dans /opt/apigee/apigee-setup/bin.

      Si vous avez déjà installé l'utilitaire apigee-setup, mettez-le à jour:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
    2. Si vous avez installé la version 4.16.01 directement, ce qui signifie que vous n'avez pas effectué de mise à niveau à partir de la version 4.15.07.0x, vous devez mettre à jour l'utilitaire apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

      Cette mise à jour vers apigee-service installe l'utilitaire gagner.
    3. Si vous avez installé la version 4.16.05 directement ou par mise à jour, vous devez mettre à jour l'utilitaire apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

      Cette mise à jour de apigee-service installe l'utilitaire update.sh dans /opt/apigee/apigee-setup/bin.
  12. Selon votre version actuelle d'Edge, vous devez installer ou mettre à jour l'utilitaire apigee-validate sur le serveur de gestion.
    1. Si vous utilisez actuellement Edge 4.16.05: mettez à jour l'utilitaire apigee-validate sur le serveur de gestion:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
    2. Si vous utilisez actuellement Edge 4.16.01: installez l'utilitaire apigee-validate sur le serveur de gestion:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-validate install

      Remarque: si vous avez installé l'utilitaire apigee-validate sur un nœud de processeur de messages lors de l'installation de apigee/apigee:


    3. Si vous effectuez une mise à niveau depuis la version 4.16.01: modifiez le fichier de configuration transmis à l'utilitaire apigee-validate. Dans la version 4.16.01 Edge, le fichier de configuration utilisé par apigee-validate nécessitait les propriétés suivantes:
      APIGEE_ADMINPW=sysAdminPword
      MP_POD=gateway
      REGION=dc-1


      Dans cette version, le fichier de configuration ne nécessite que la propriété APIGEE_ADMINPW. Vous pouvez supprimer les deux autres propriétés du fichier.
  13. Mettez à jour l'utilitaire apigee-provision:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  14. Exécutez l'utilitaire de mise à jour sur vos nœuds dans l'ordre décrit ci-dessous dans la section Ordre des mises à jour de la machine ci-dessous:
    > /opt/apigee/apigee-setup/bin/update.sh -c composant -f configFile

    La seule condition requise dans le fichier de configuration est qu'il soit accessible ou lisible par l'utilisateur "apigee".

    Utilisez l'option "-c" pour spécifier le composant à mettre à jour. La liste des composants possibles comprend les éléments suivants:
    ldap = OpenLDAP
    cs = Cassandra
    zk = Zookeeper
    qpid = qpidd
    ps = postgresql
    edge = tous les composants Edge, à l'exception de l'interface utilisateur Edge: serveur de gestion, de l'API Baastic, du routeur, de la mise à jour de l'API Edge
    le serveur d'API Edge
    ui



  15. Testez la mise à jour en exécutant l'utilitaire "apigee-validate" sur le serveur de gestion, comme décrit dans la section Tester l'installation.
  16. Si vous avez installé un nouveau nœud de secours Postgres, mettez le nœud hors service comme décrit ci-dessus dans la section Mise hors service d'un nœud Postgres.

Pour annuler la mise à jour ultérieurement, suivez la procédure décrite dans la section 4.18.01 Processus de rollback.

Procédure de mise à jour vers la version 4.18.01 à partir d'un dépôt local

Si vos nœuds périphériques sont protégés par un pare-feu ou qu'ils ne sont pas autorisés à accéder au dépôt Apigee sur Internet, vous pouvez effectuer la mise à jour à partir d'un dépôt local ou en miroir du dépôt Apigee.

Après avoir créé un dépôt Edge local, vous disposez de deux options pour mettre à jour Edge à partir du dépôt local:

  • Créez un fichier .tar du dépôt, copiez-le sur un nœud, puis mettez à jour Edge à partir du fichier .tar.
  • Installez un serveur Web sur le nœud contenant le dépôt local afin que les autres nœuds puissent y accéder. Apigee met à votre disposition le serveur Web Nginx. Vous pouvez aussi utiliser votre propre serveur Web.

Pour effectuer une mise à jour à partir d'un dépôt 4.18.01 local:

  1. Si vous utilisez actuellement la réplication en attente maître Postgres, installez un nouveau nœud de secours Postgres comme décrit ci-dessus dans Installer un nouveau nœud de secours Postgres.
  2. Créez un dépôt local 4.18.01 comme décrit dans la section "Créer un dépôt Apigee local" de la section Installer l'utilitaire de configuration d'Apigee Edge.
    Remarque: Si vous disposez déjà d'un dépôt 4.16.01 ou 4.16.05, vous pouvez y ajouter le dépôt 4.18.01 comme décrit dans la section "Mettre à jour un dépôt Apigee local" dans la section Installer l'utilitaire de configuration d'Edge d'Apigee.
  3. Pour installer apigee-service à partir d'un fichier .tar :
    1. Sur le nœud contenant le dépôt local, utilisez la commande suivante pour empaqueter le dépôt local dans un seul fichier .tar nommé /opt/apigee/data/apigee-mirror/apigee-4.18.01.tar.gz:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
    2. Copiez le fichier .tar sur le nœud où vous souhaitez mettre à jour Edge. Par exemple, copiez-le dans le répertoire /tmp du nouveau nœud.
    3. Sur le nouveau nœud, décompressez le fichier dans le répertoire /tmp:
      > tar -xzf apigee-4.18.01.tar.gz

      Cette commande crée un nouveau répertoire, nommé "repos", dans le répertoire contenant le fichier .tar. Par exemple, /tmp/repos.
    4. Installez l'utilitaire et les dépendances Edge apigee-service à partir de /tmp/repos:
      > sudo bash /tmp/repos/bootstrap_4.18.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

      Notez que vous incluez le chemin d'accès au répertoire de dépôts dans cette commande.
  4. Pour installer apigee-service à l'aide du serveur Web Nginx:
    1. Configurez le serveur Web Nginx comme décrit dans la section "Installer à partir du dépôt à l'aide du serveur Web Nginx" de la section Installer l'utilitaire de configuration Edge apigee-setup.
    2. Sur le nœud distant, téléchargez le fichier Edge bootstrap_4.18.01.sh dans /tmp/bootstrap_4.18.01.sh :
      > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.0.

    3. Sur le nœud distant, installez l'utilitaire et les dépendances Edge apigee-service :
      > sudo bash /tmp/bootstrap_4.18.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeName=http://

  5. Utilisez apigee-service pour mettre à jour l'utilitaire apigee-setup :
    1. Si vous avez installé la version 4.16.01 en mettant à niveau Edge version 4.15.07.0x, vous devez installer l'utilitaire apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install

      Cette commande installe l'utilitaire update.sh dans /opt/apigee/apigee-setup/bin.

      Si vous avez déjà installé l'utilitaire apigee-setup, mettez-le à jour:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
    2. Si vous avez installé la version 4.16.01 directement, ce qui signifie que vous n'avez pas effectué de mise à niveau à partir de la version 4.15.07.0x, vous devez mettre à jour l'utilitaire apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

      cette mise à jour vers apigee-service installe l'utilitaire apigee/setup/bin/apigee/apigee.sh .
    3. Si vous avez installé la version 4.16.05 directement ou par mise à jour, vous devez mettre à jour l'utilitaire apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

      Cette mise à jour de apigee-service installe l'utilitaire update.sh dans /opt/apigee/apigee-setup/bin.
  6. Selon votre version actuelle d'Edge, vous devez installer ou mettre à jour l'utilitaire apigee-validate sur le serveur de gestion.
    1. Si vous utilisez actuellement Edge 4.16.05: mettez à jour l'utilitaire apigee-validate sur le serveur de gestion:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
    2. Si vous utilisez actuellement Edge 4.16.01: installez l'utilitaire apigee-validate sur le serveur de gestion:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-validate install

      Remarque: si vous avez installé l'utilitaire apigee-validate sur un nœud de processeur de messages lors de l'installation de apigee/apigee:


    3. Si vous effectuez une mise à niveau depuis la version 4.16.01: modifiez le fichier de configuration transmis à l'utilitaire apigee-validate. Dans la version 4.16.01 Edge, le fichier de configuration utilisé par apigee-validate nécessitait les propriétés suivantes:
      APIGEE_ADMINPW=sysAdminPword
      MP_POD=gateway
      REGION=dc-1


      Dans cette version, le fichier de configuration ne nécessite que la propriété APIGEE_ADMINPW. Vous pouvez supprimer les deux autres propriétés du fichier.
  7. Mettez à jour l'utilitaire apigee-provision:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  8. Exécutez l'utilitaire de mise à jour sur vos nœuds dans l'ordre décrit ci-dessous dans la section "Ordre des mises à jour de la machine" ci-dessous:
    > /opt/apigee/apigee-setup/bin/update.sh -c composant -f configFile

    La seule condition requise dans le fichier de configuration est qu'il doit être accessible ou lisible par l'utilisateur "apigee".

    Utilisez l'option "-c" pour spécifier le composant à mettre à jour. La liste des composants possibles comprend les éléments suivants:
    ldap = OpenLDAP
    cs = Cassandra
    zk = Zookeeper
    qpid = qpidd
    ps = postgresql
    edge = tous les composants Edge, à l'exception de l'interface utilisateur Edge: serveur de gestion, de l'API Baastic, du routeur, de la mise à jour de l'API Edge
    le serveur d'API Edge
    ui



  9. Testez la mise à jour en exécutant l'utilitaire "apigee-validate" sur le serveur de gestion, comme décrit dans la section Tester l'installation.
  10. Si vous avez installé un nouveau nœud de secours Postgres, mettez le nœud hors service comme décrit ci-dessus dans la section Mise hors service d'un nœud Postgres.

Pour annuler la mise à jour ultérieurement, suivez la procédure décrite dans la section 4.18.01 Processus de rollback.

Ordre des mises à jour de la machine

L'ordre dans lequel vous mettez à jour les machines dans une installation Edge est important. Voici les points les plus importants à prendre en compte avant une mise à jour:

  • Vous devez mettre à jour tous les nœuds Cassandra et ZooKeeper avant de mettre à jour les autres nœuds.
  • Pour toute machine comportant plusieurs composants Edge (serveur de gestion, processeur de messages, routeur, serveur QPID mais pas serveur Postgres), utilisez l'option "-c bord" pour tous les mettre à jour en même temps.
  • Si une étape indique qu'elle doit être effectuée sur plusieurs machines, exécutez-la dans l'ordre des machines spécifié.
  • Il n'existe aucune étape distincte pour mettre à jour la monétisation. Elle est mise à jour lorsque vous spécifiez l'option "-c bord".

Pour une installation autonome avec un hôte

  1. Définissez SMTPMAILFROM dans votre fichier de configuration si vous avez activé SMTP sur Edge. Ce paramètre se présente sous la forme suivante:
    SMTPMAILFROM="Mon entreprise <myco@company.com>"
  2. Si vous effectuez une mise à jour depuis la version 4.16.01, revenez à la version antérieure de Zookeeper:
    > yum rétrograder apigee-zookeeper
  3. Mettez à jour Cassandra et ZooKeeper:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  4. Définissez la règle iptables suivante:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `nom-hôte` -i eth0 -j DROP
  5. Vérifiez la file d'attente de messages Qpid:
    > qpid-stat -q

    Continuez à vérifier la file d'attente jusqu'à ce que le nombre indiqué dans la colonne "msg" soit 0. Vous ne pouvez pas mettre à niveau Qpid tant que tous les messages n'ont pas été traités.
  6. Mettez à jour qpidd:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. Flush iptables:
    > sudo iptables -F
  8. Mettez à jour LDAP:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  9. Arrêtez Postgres Server, le serveur Qpid et PostgreSQL:
    > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
    > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server stop
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
  10. Mettez à jour postgresql:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  11. Mettez à jour la base de données Postgres:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
  12. Mettez à jour les composants Edge restants:
    > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  13. Mettez à jour l'interface utilisateur Edge:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

Pour une installation autonome avec deux hôtes

Consultez la section Topologies d'installation pour obtenir la liste des topologies en périphérie et des nombres de nœuds.

  1. Définissez SMTPMAILFROM dans votre fichier de configuration si vous avez activé SMTP sur Edge. Ce paramètre se présente sous la forme suivante:
    SMTPMAILFROM="Mon entreprise <myco@company.com>"
  2. Si vous effectuez une mise à jour à partir de la version 4.16.01, revenez à la version antérieure de Zookeeper sur la machine 1:
    > rétrograder yum apigee-zookeeper
  3. Mettez à jour Cassandra et ZooKeeper sur la machine 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  4. Définissez la règle iptables suivante sur la machine 2:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `nom-hôte` -i eth0 -j DROP
  5. Vérifiez la file d'attente de messages Qpid sur la machine 2:
    > qpid-stat -q

    Continuez à vérifier la file d'attente jusqu'à ce que le nombre indiqué dans la colonne "msg" soit 0. Vous ne pouvez pas mettre à niveau Qpid tant que tous les messages n'ont pas été traités.
  6. Mettez à jour qpidd sur la machine 2:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. Vide iptables sur la machine 2:
    > sudo iptables -F
  8. Mettez à jour LDAP sur la machine 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  9. Mettez à jour les composants Edge sur la machine 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c bord -f configFile
  10. Mettez à jour l'UI sur la machine 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  11. Mettez à jour postgresql sur la machine 2 :
    1. Arrêtez Postgres Server, le serveur Qpid et postgresql:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server stop
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    2. Mettez à jour postgresql:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    3. Mettez à jour la base de données Postgres:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    4. Mettez à jour les composants Edge sur la machine 2:
      > /opt/apigee/apigee-setup/bin/update.sh -c bord -f configFile

Pour une installation en cluster à cinq hôtes

Consultez la section Topologies d'installation pour obtenir la liste des topologies en périphérie et des nombres de nœuds.

  1. Définissez SMTPMAILFROM dans votre fichier de configuration si vous avez activé SMTP sur Edge. Ce paramètre se présente sous la forme suivante:
    SMTPMAILFROM="Mon entreprise <myco@company.com>"
  2. Assurez-vous d'avoir installé un nouveau nœud de secours Postgres comme décrit ci-dessus dans la section Installer un nouveau nœud de secours Postgres.
  3. Si vous effectuez une mise à jour depuis la version 4.16.01, revenez à la version antérieure de Zookeeper sur les machines 1, 2 et 3:
    > rétrograder yum apigee-zookeeper
  4. Mettez à jour Cassandra et ZooKeeper sur les machines 1, 2 et 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  5. Définissez la règle iptables suivante sur la machine 4:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `nom-hôte` -i eth0 -j DROP
  6. Vérifiez la file d'attente de messages Qpid sur la machine 4:
    > qpid-stat -q

    Continuez à vérifier la file d'attente jusqu'à ce que le nombre indiqué dans la colonne "msg" soit 0. Vous ne pouvez pas mettre à niveau Qpid tant que tous les messages n'ont pas été traités.
  7. Mettez à jour qpidd sur la machine 4:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. Videz iptables sur la machine 4:
    > sudo iptables -F
  9. Répétez les étapes 5 à 8 sur la machine 5.
  10. Mettez à jour LDAP sur la machine 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  11. Mettez à jour les composants Edge sur les machines 1, 2 et 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  12. Mettez à jour l'UI sur la machine 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  13. Mettre à jour les machines 4 et 5 :
    1. Arrêtez le serveur Postgres et le serveur Qpid sur la machine 4:
      > /opt/apigee/apigee-service/bin/apigee-service bord-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server stop
    2. Arrêtez le serveur Postgres, le serveur Qpid et postgresql sur la machine 5:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server stop
      > /opt/apigee/apigee-service/bin/apigee-service stopsql
      apigee-postgre
    3. Arrêtez le serveur Postgres et postgresql sur le nouveau nœud de secours que vous avez ajouté pour le rollback:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    4. Mettez à jour postgresql sur les machines 4:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    5. Mettez à jour la base de données Postgres sur la machine 4 (maître PostgreSQL uniquement):
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    6. Mettez à jour postgresql sur les machines 5:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    7. Démarrez le serveur Postgres et le serveur Qpid sur les machines 4 et 5:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server start
      > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server start
    8. Configurez Postgres en tant que nœud de secours en exécutant les commandes suivantes sur la machine 5:
      > cd /opt/apigee/data/apigee-postgresql/pgdata
      > rm -rf *
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-réplication-on-standby -f
      configFile
    9. Vérifiez l'état de la réplication en émettant les scripts suivants sur les deux serveurs. Le système doit afficher des résultats identiques sur les deux serveurs pour assurer une réplication réussie:

      Sur la machine 4, le nœud maître, exécutez la commande suivante:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

      Vérifiez qu'il s'agit bien du nœud maître.

      Sur la machine 5, le nœud de secours:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      Vérifiez qu'il indique qu'il s'agit bien du nœud de secours.
  14. Mettez à jour les composants Edge sur la machine 4, 5:
    > /opt/apigee/apigee-setup/bin/update.sh -c bord -f configFile
  15. Assurez-vous de mettre le nouveau nœud de secours hors service en suivant la procédure ci-dessus dans la section Mise hors service d'un nœud Postgres.

Pour une installation en cluster avec neuf hôtes

Consultez la section Topologies d'installation pour obtenir la liste des topologies en périphérie et des nombres de nœuds.

  1. Définissez SMTPMAILFROM dans votre fichier de configuration si vous avez activé SMTP sur Edge. Ce paramètre se présente sous la forme suivante:
    SMTPMAILFROM="Mon entreprise <myco@company.com>"
  2. Assurez-vous d'avoir installé un nouveau nœud de secours Postgres comme décrit ci-dessus dans la section Installer un nouveau nœud de secours Postgres.
  3. Si vous effectuez une mise à jour depuis la version 4.16.01, revenez à la version antérieure de Zookeeper sur les machines 1, 2 et 3:
    > rétrograder yum apigee-zookeeper
  4. Mettez à jour Cassandra et ZooKeeper sur les machines 1, 2 et 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  5. Définissez la règle iptables suivante sur la machine 6:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `nom-hôte` -i eth0 -j DROP
  6. Vérifiez la file d'attente de messages Qpid sur la machine 6:
    > qpid-stat -q

    Continuez à vérifier la file d'attente jusqu'à ce que le nombre indiqué dans la colonne "msg" soit 0. Vous ne pouvez pas mettre à niveau Qpid tant que tous les messages n'ont pas été traités.
  7. Mettez à jour qpidd sur la machine 6:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. Videz iptables sur la machine 6:
    > sudo iptables -F
  9. Répétez les étapes 5 à 8 sur la machine 7.
  10. Mettez à jour LDAP sur la machine 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  11. Mettez à jour les composants Edge sur les machines 6, 7, 1, 4 et 5, dans cet ordre:
    > /opt/apigee/apigee-setup/bin/update.sh -c bord -f configFile
  12. Mettez à jour l'UI sur la machine 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  13. Mettre à jour les machines 8 et 9 :
    1. Arrêtez le serveur Postgres sur la machine 8:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
    2. Arrêtez le serveur Postgres et postgresql sur la machine 9:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. Arrêtez le serveur Qpid sur les machines 6 et 7:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server stop
    4. Arrêtez le serveur Postgres et postgresql sur le nouveau nœud de secours que vous avez ajouté pour le rollback:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    5. Mettez à jour postgresql sur les machines 8:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. Mettez à jour la base de données Postgres sur la machine 8 (maître PostgreSQL uniquement):
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. Mettez à jour postgresql sur les machines 9:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    8. Démarrez le serveur Postgres sur les machines 8 et 9:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server start
    9. Démarrez le serveur Qpid sur les machines 6 et 7:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server start
    10. Configurez Postgres en tant que nœud de secours en exécutant les commandes suivantes sur la machine 9:
      > cd /opt/apigee/data/apigee-postgresql/pgdata
      > rm -rf *
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-réplication-on-standby -f
      configFile
    11. Vérifiez l'état de la réplication en émettant les scripts suivants sur les deux serveurs. Le système doit afficher des résultats identiques sur les deux serveurs pour assurer une réplication réussie:
      Sur la machine 8, le nœud maître, exécutez la commande suivante:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

      Vérifiez qu'il s'agit bien du nœud maître.

      Sur la machine 9, le nœud de secours:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      Vérifiez qu'il indique qu'il s'agit bien du nœud de secours.
  14. Mettez à jour les composants Edge sur les machines 8 et 9:
    > /opt/apigee/apigee-setup/bin/update.sh -c bord -f configFile
  15. Assurez-vous de mettre le nouveau nœud de secours hors service en suivant la procédure ci-dessus dans la section Mise hors service d'un nœud Postgres.

Pour une installation en cluster avec 13 hôtes

Consultez la section Topologies d'installation pour obtenir la liste des topologies en périphérie et des nombres de nœuds.

  1. Définissez SMTPMAILFROM dans votre fichier de configuration si vous avez activé SMTP sur Edge. Ce paramètre se présente sous la forme suivante:
    SMTPMAILFROM="Mon entreprise <myco@company.com>"
  2. Assurez-vous d'avoir installé un nouveau nœud de secours Postgres comme décrit ci-dessus dans la section Installer un nouveau nœud de secours Postgres.
  3. Si vous effectuez une mise à jour depuis la version 4.16.01, revenez à la version antérieure de Zookeeper sur les machines 1, 2 et 3:
    > rétrograder yum apigee-zookeeper
  4. Mettez à jour Cassandra et ZooKeeper sur les machines 1, 2 et 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  5. Définissez la règle iptables suivante sur la machine 12:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `nom-hôte` -i eth0 -j DROP
  6. Vérifiez la file d'attente de messages Qpid sur la machine 12:
    > qpid-stat -q

    Continuez à vérifier la file d'attente jusqu'à ce que le nombre indiqué dans la colonne "msg" soit 0. Vous ne pouvez pas mettre à niveau Qpid tant que tous les messages n'ont pas été traités.
  7. Mettez à jour qpidd sur la machine 12:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. Vide iptables sur la machine 12:
    > sudo iptables -F
  9. Répétez les étapes 5 à 8 sur la machine 13.
  10. Mettez à jour LDAP sur les machines 4 et 5:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  11. Mettez à jour les composants Edge sur les machines 12, 13, 6, 7, 10 et 11, dans cet ordre:
    > /opt/apigee/apigee-setup/bin/update.sh -c bord -f configFile
  12. Mettez à jour l'UI sur les machines 6 et 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  13. Mettre à jour les machines 8 et 9 :
    1. Arrêtez le serveur Postgres sur la machine 8:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
    2. Arrêtez le serveur Postgres et postgresql sur la machine 9:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. Arrêtez le serveur Qpid sur les machines 12 et 13:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server stop
    4. Arrêtez le serveur Postgres et postgresql sur le nouveau nœud de secours que vous avez ajouté pour le rollback:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    5. Mettez à jour postgresql sur les machines 8:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. Mettez à jour la base de données Postgres sur la machine 8 (maître PostgreSQL uniquement):
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. Mettez à jour postgresql sur les machines 9:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    8. Démarrez le serveur Postgres sur les machines 8 et 9:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server start
    9. Démarrez le serveur Qpid sur les machines 12 et 13:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server start
    10. Configurez Postgres en tant que nœud de secours en exécutant les commandes suivantes sur la machine 9:
      > cd /opt/apigee/data/apigee-postgresql/pgdata
      > rm -rf *
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-réplication-on-standby -f
      configFile
    11. Vérifiez l'état de la réplication en émettant les scripts suivants sur les deux serveurs. Le système doit afficher des résultats identiques sur les deux serveurs pour assurer une réplication réussie:
      Sur la machine 8, le nœud maître, exécutez la commande suivante:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

      Vérifiez qu'il s'agit bien du nœud maître.

      Sur la machine 9, le nœud de secours:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      Vérifiez qu'il indique qu'il s'agit bien du nœud de secours.
  14. Mettez à jour les composants Edge sur les machines 8 et 9:
    > /opt/apigee/apigee-setup/bin/update.sh -c bord -f configFile
  15. Assurez-vous de mettre le nouveau nœud de secours hors service en suivant la procédure ci-dessus dans la section Mise hors service d'un nœud Postgres.

Pour une installation en cluster avec 12 hôtes

Consultez la section Topologies d'installation pour obtenir la liste des topologies en périphérie et des nombres de nœuds.

  1. Définissez SMTPMAILFROM dans votre fichier de configuration si vous avez activé SMTP sur Edge. Ce paramètre se présente sous la forme suivante:
    SMTPMAILFROM="Mon entreprise <myco@company.com>"
  2. Assurez-vous d'avoir installé un nouveau nœud de secours Postgres comme décrit ci-dessus dans la section Installer un nouveau nœud de secours Postgres.
  3. Mettez à jour Cassandra et ZooKeeper :
    1. Si vous effectuez une mise à jour depuis la version 4.16.01, revenez à la version antérieure de Zookeeper sur les machines 1, 2 et 3 dans le centre de données 1:
      > rétrogradez yum apigee-zookeeper
    2. Sur les machines 1, 2 et 3 du centre de données 1:
      > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
    3. Si vous effectuez une mise à jour depuis la version 4.16.01, revenez à la version antérieure de Zookeeper sur les machines 7, 8 et 9 dans le centre de données 2:
      > rétrograder yum apigee-zookeeper
    4. Sur les machines 7, 8 et 9 du centre de données 2
      > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  4. Mettez à jour qpidd :
    1. Machines 4 et 5 dans le centre de données 1
      1. Définissez la règle iptables suivante sur la machine 4:
        > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `nom-hôte` -i eth0 -j DROP
      2. Vérifiez la file d'attente de messages Qpid sur la machine 4:
        > qpid-stat -q

        Continuez à vérifier la file d'attente jusqu'à ce que le nombre indiqué dans la colonne "msg" soit 0. Vous ne pouvez pas mettre à niveau Qpid tant qu'il n'a pas traité tous les messages.
      3. Mettez à jour qpidd sur la machine 4:
        > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      4. Vide iptables sur la machine 4:
        > sudo iptables -F
      5. Répétez les étapes 1 à 4 sur la machine 5.
    2. Machines 10 et 11 du centre de données 2
      1. Définissez la règle iptables suivante sur la machine 10:
        > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `nom-hôte` -i eth0 -j DROP
      2. Vérifiez la file d'attente de messages Qpid sur la machine 10:
        > qpid-stat -q

        Continuez à vérifier la file d'attente jusqu'à ce que le nombre indiqué dans la colonne "msg" soit 0. Vous ne pouvez pas mettre à niveau Qpid tant qu'il n'a pas traité tous les messages.
      3. Mettez à jour qpidd sur la machine 10:
        > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      4. Videz iptables sur la machine 10:
        > sudo iptables -F
      5. Répétez les étapes 1 à 4 sur la machine 11.
  5. Mettez à jour LDAP :
    1. Machines 1 dans le centre de données 1
      > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
    2. Machines 7 dans le centre de données 2
      > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. Mettez à jour les composants Edge :
    1. Machines 4, 5, 1, 2, 3 dans le centre de données 1
      > /opt/apigee/apigee-setup/bin/update.sh -c bord -f configFile
    2. Machines 10, 11, 7, 8, 9 dans le centre de données 2
      > /opt/apigee/apigee-setup/bin/update.sh -c bord -f configFile
  7. Mettez à jour l'interface utilisateur :
    1. Machine 1 dans le centre de données 1:
      > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
    2. Machine 7 dans le centre de données 2:
      > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  8. Mettez à jour la machine 6 dans les centres de données 1 et 12 dans le centre de données 2 :
    1. Arrêtez le serveur Postgres sur la machine 6:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
    2. Arrêtez le serveur Postgres et postgresql sur la machine 12:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. Arrêtez le serveur Qpid sur les machines 4, 5, 10 et 11:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server stop
    4. Arrêtez le serveur Postgres et postgresql sur le nouveau nœud de secours que vous avez ajouté pour le rollback:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    5. Mettez à jour postgresql sur les machines 6:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. Mettez à jour la base de données Postgres sur la machine 6 (maître PostgreSQL uniquement):
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. Mettez à jour postgresql sur les machines 12:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    8. Démarrez le serveur Postgres sur les machines 6 et 12:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server start
    9. Démarrez le serveur Qpid sur les machines 4, 5, 10 et 11:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server start
    10. Configurez Postgres en tant que nœud de secours en exécutant les commandes suivantes sur la machine 12:
      > cd /opt/apigee/data/apigee-postgresql/pgdata
      > rm -rf *
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-réplication-on-standby -f
      configFile
    11. Vérifiez l'état de la réplication en émettant les scripts suivants sur les deux serveurs. Le système doit afficher des résultats identiques sur les deux serveurs pour assurer une réplication réussie:
      Sur la machine 6, le nœud maître, exécutez la commande suivante:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

      Vérifiez qu'il s'agit bien du nœud maître.

      Sur la machine 12, le nœud de secours:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      Vérifiez qu'il indique qu'il s'agit bien du nœud de secours.
  9. Mettez à jour les composants Edge sur les machines 6 et 12:
    > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  10. Assurez-vous de mettre le nouveau nœud de secours hors service en suivant la procédure ci-dessus dans la section Mise hors service d'un nœud Postgres.

Pour une installation BaaS d'API avec sept ou dix hôtes

Pour une installation non standard

Si votre installation n'est pas standard, mettez à jour les composants Edge dans l'ordre suivant:

  1. ZooKeeper
  2. Cassandra
  3. QPIDd
  4. LDAP
  5. Edge, c'est-à-dire le profil "-c Edge" sur tous les nœuds de l'ordre: les nœuds avec le serveur Qpid, mais pas le serveur Postgres, le serveur de gestion, le processeur de messages et le routeur.
    Remarque: Si le serveur Qpid et le serveur Postgres sont installés sur le nœud, exécutez l'étape de profil "-c Edge" à l'étape 8.
  6. Interface utilisateur périphérique
  7. Postgresql sur le maître Postgres, y compris la mise à niveau.
  8. postgresql dans l'instance de secours Postgres.
  9. Edge, c'est-à-dire le profil "-c Edge" sur tous les nœuds Qpid et Postgres combinés, ou sur n'importe quel nœud Postgres autonome.