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

Edge pour Private Cloud version 4.17.09

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

Vous pouvez mettre à jour les versions 4.16.01.0x et 4.16.05.x d'Apigee Edge vers la version 4.17.09 à l'aide de cette procédure.

Si vous utilisez une version d'Edge antérieure à la version 4.16.01, vous devez d'abord passer à la version 4.16.01, puis mettre à jour vers la version 4.17.09.

  • Vous pouvez migrer la version 4.15.07 d'Apigee Edge vers la version 4.16.01.
  • Si votre version d'Edge est 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 migrez depuis la version 4.14.04 d'Edge ou une version ultérieure: migrez directement vers la version 4.15.07.
    • Si vous effectuez une migration à partir de la version Edge 4.14.01: vous devez d'abord migrer vers la version 4.14.04, puis vers la version 4.15.07.

Qui peut effectuer la mise à jour ?

L'utilisateur qui exécute la mise à jour doit être le même que celui qui a installé Edge à l'origine ou un utilisateur exécutant en tant que racine.

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

Quels composants devez-vous mettre à jour ?

Vous devez mettre à jour tous les composants Edge. Edge ne prend pas en charge une configuration contenant des composants de plusieurs versions.

Réduire Zookeeper si vous passez de la version 4.16.01

La version du RPM Zookeeper dans Edge pour Private Cloud 4.16.01 est apigee-zookeeper-3.4.5-1.0.905.noarch.rpm. Dans les versions ultérieures 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 à partir de la version 4.16.01. Pour corriger cette situation, exécutez yum downgrade apigee-zookeeper avant de mettre à jour Zookeeper.

Vous pouvez vérifier la version de Zookeeper à l'aide de 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 effectuer la rétrogradation.

Propagation automatique des paramètres des établissements

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

Assurez-vous de remplir les conditions préalables suivantes avant de mettre à niveau Apigee Edge:

  • Sauvegarder tous les nœuds
    Pour des raisons de sécurité, il est recommandé d'effectuer une sauvegarde complète de tous les nœuds avant d'effectuer la mise à jour. Utilisez la procédure relative à votre version actuelle de Edge pour effectuer la sauvegarde.

    Vous disposez ainsi 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 section Sauvegarde et restauration.
  • Vérifier qu'Edge est en cours d'exécution
    Assurez-vous qu'Edge est en cours d'exécution pendant le processus de mise à jour à l'aide de la commande suivante:

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

Gérer un échec de mise à jour

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

Si la défaillance nécessite que vous annuliez la mise à jour vers votre version précédente, consultez la section Procédure de rollback de la version 4.17.09 pour en savoir plus.

Informations sur la mise à jour de la journalisation

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

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

Si l'utilisateur exécutant 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 vers la version 8 du JDK Java requise

Cette version d'Edge nécessite que vous ayez installé la version 8 du JDK Java 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.

Lors de la mise à jour vers 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 que vous utilisez 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 obligatoire du paramètre de configuration SMTPMAILFROM

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

La version 4.17.09 de l'API BaaS est également compatible avec la propriété SMTPMAILFROM. Lorsque vous mettez à jour l'API BaaS, vous devez définir SMTPMAILFROM dans le fichier de configuration.

Ce paramètre prend la forme suivante:

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

Obligatoire si vous effectuez une mise à jour lorsque vous utilisez une authentification externe

Vous pouvez intégrer un service d'annuaire externe à une installation de cloud privé Apigee Edge existante. Cette fonctionnalité est conçue pour fonctionner avec n'importe quel service d'annuaire compatible avec LDAP, comme Active Directory, OpenLDAP et d'autres. Une solution LDAP externe permet aux administrateurs système de gérer les identifiants des utilisateurs à partir d'un service de gestion d'annuaire centralisé, externe aux systèmes tels qu'Apigee Edge qui les utilisent.

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 du compte SAM Active Directory comme nom d'utilisateur pour l'authentification, au lieu d'une adresse e-mail utilisée par le serveur OpenLDAP Edge.

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

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 vers Qpid 1.35 requise

Cette version contient une mise à jour obligatoire de Qpid 1.35. Pour mettre à jour un nœud Qpid, vous devez:

  • 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 d'hôte" -i eth0 -j DROP
  • Attendez que la file d'attente Qpid ne contienne plus 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 des routeurs et des 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 inverser la modification spécifique:
    > sudo iptables -D INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP

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

Mise à niveau requise vers Postgres 9.4

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

Pendant le processus de mise à jour, lorsque les nœuds Postgres sont indisponibles pour la mise à jour, les données d'analyse sont toujours écrites sur les nœuds Qpid. Une fois les nœuds Postgres mis à jour et remis en ligne, les données d'analyse sont transférées vers ces nœuds.

Le nœud de veille Postgres supplémentaire est nécessaire si vous devez annuler la mise à jour pour une raison quelconque. Si vous devez annuler la mise à jour, le nouveau nœud de secours Postgres devient le nœud Postgres principal après le rollback. Par conséquent, lorsque vous installez le nouveau nœud de disponibilité Postgres, il 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 d'Edge.

Installer un nouveau nœud de disponibilité Postgres

Cette procédure crée un serveur de secours Postgres sur un nouveau nœud. Assurez-vous d'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.17.09.

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 disponibilité Postgres :

  1. Sur l'instance maître PostgreSQL actuelle, 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_replication.connection=host replication apigee existing_slave_ip/32 trust\ \nhost replication apigee new_slave_ip/32 trust

    où existing_slave_ip est l'adresse IP du serveur de secours Postgres actuel et new_slave_ip est l'adresse IP du nouveau nœud de secours.
  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 consultant le fichier /opt/apigee/apigee-postgresql/conf/pg_hba.conf sur le maître. Les lignes suivantes doivent s'afficher dans ce fichier:
    host replication apigee existing_slave_ip/32 trust
    host replication 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 afin de 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 décrit dans la section Installer l'utilitaire apigee-setup Edge.
    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

      Remarque: Si vous effectuez la mise à jour à partir de la version 4.16.01, téléchargez le fichier Edge bootstrap.sh.
    4. Installez l'utilitaire Edge apigee-service et ses dépendances:
      > 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.

Désactivation d'un nœud Postgres

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

  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

    Vous devriez voir l'UUID du nœud à la fin de la sortie, sous la forme:
    "type" : [ "postgres-server" ],
    "uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
  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_replication.connection:
    conf_pg_hba_replication.connection=host replication 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 consultant 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 replication 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 mise à jour progressive, vous permet de mettre à jour votre installation d'Edge sans l'arrêter.

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

La clé d'une mise à niveau sans temps d'arrêt est de supprimer chaque routeur, un par un, de l'équilibreur de charge. Vous devez ensuite mettre à jour le routeur et tous les autres composants sur la même machine que le routeur, puis l'ajouter de nouveau à l'équilibreur de charge.

  1. Mettez à jour les machines dans l'ordre approprié pour votre installation, comme décrit ci-dessous dans "Ordre de mise à jour des machines".
  2. Au moment de la mise à jour des routeurs, sélectionnez un routeur et rendez-le inaccessible, comme décrit dans la section Activer/Désactiver la joignabilité 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 affichent un routeur et un processeur de messages sur le même nœud.
  4. Rendre le routeur accessible à nouveau.
  5. Répétez les étapes 2 à 4 pour les autres routeurs.
  6. Poursuivez la mise à jour pour les machines restantes de votre installation.

Prenez soin des points suivants avant/après la mise à jour:

  • Sur le nœud de routeur et de processeur de messages combiné :
    • Avant la mise à jour :
      1. Rendre le routeur inaccessible.
      2. Rendez le processeur de messages inaccessible.
    • Après la mise à jour, procédez comme suit :
      1. Rendez le processeur de messages accessible.
      2. Rendre le routeur accessible
  • Sur un seul nœud de routeur :
    • Avant la mise à jour, rendez le routeur inaccessible.
    • Après la mise à jour, assurez-vous que le routeur est 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.

Utiliser un fichier de configuration silencieuse

Vous devez transmettre un fichier de configuration silencieux à la commande de mise à jour. Le fichier de configuration silencieux 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.17.09 sur un nœud avec une connexion Internet externe

Procédez comme suit pour mettre à jour les composants Edge sur un nœud:

  1. Si vous utilisez actuellement la réplication maître-nœud de disponibilité Postgres, installez un nouveau nœud de disponibilité Postgres comme décrit ci-dessus dans la section Installer un nouveau nœud de disponibilité Postgres.
  2. Le cas échéant, désactivez 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 de RPM nécessite un accès racine, vous pouvez effectuer la configuration d'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 apigee-setup Edge.
  6. Activez le dépôt EPEL comme décrit ci-dessus.
  7. Si vous effectuez l'installation sur AWS, exécutez la commande yum-configure-manager suivante:
    > sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
  8. Téléchargez le fichier bootstrap_4.17.09.sh d'Edge 4.17.09 dans /tmp/bootstrap_4.17.09.sh:
    > curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
  9. Installez l'utilitaire et les dépendances apigee-service Edge 4.17.09:
    > sudo bash /tmp/bootstrap_4.17.09.sh apigeeuser=uName apigeepassword=pWord

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

    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 spécifier comment gérer l'installation de Java. JAVA_FIX peut prendre les valeurs suivantes:

    I = Install OpenJDK 1.8 (par défaut)
    C = Continue without installing Java (Continuer sans installer Java)
    Q = Quit (Quitter). Pour cette option, vous devez installer Java vous-même.
  10. Utilisez apigee-service pour mettre à jour l'utilitaire apigee-setup :
    1. Si vous avez installé la version 4.16.01 en mettant à niveau la version 4.15.07.0x d'Edge, 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é directement la version 4.16.01, 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 de apigee-service installe l'utilitaire update.sh dans /opt/apigee/apigee-setup/bin.
    3. Si vous avez installé la version 4.16.05 directement ou via une mise à jour, vous devez mettre à jour l'utilitaire apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

      Cette mise à jour d'apigee-service installe l'utilitaire update.sh dans /opt/apigee/apigee-setup/bin.
  11. En fonction de la 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 traitement des messages lors de l'installation de la version 4.16.01, vous pouvez le mettre à jour à l'aide de la commande suivante sur ce nœud:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update

      Toutefois, à partir de la version 4.16.05, Apigee vous recommande d'installer et d'exécuter l'utilitaire apigee-validate sur le serveur de gestion.
    3. Si vous effectuez une mise à niveau à partir de la version 4.16.01: modifiez le fichier de configuration transmis à l'utilitaire apigee-validate. Dans la version Edge 4.16.01, 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.
  12. Mettez à jour l'utilitaire apigee-provision:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  13. Exécutez l'utilitaire de mise à jour sur vos nœuds dans l'ordre décrit ci-dessous dans la section Order of machine update (Ordre des mises à jour de la machine) ci-dessous:
    > /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

    Le fichier de configuration 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 inclut:
    ldap = OpenLDAP
    cs = Cassandra
    zk = Zookeeper
    qpid = qpidd
    ps = postgresql
    edge =Tous les composants Edge, à l'exception de l'UI Edge: serveur de gestion, processeur de messages, routeur, serveur QPID, serveur Postgres
    ui = UI Edge
    all = mise à jour de tous les composants sur la machine (à utiliser uniquement pour un profil d'installation aio Edge ou un profil d'installation asa API BaaS)
    e = ElasticSearch
    b = API BaaS Stack
    p = API BaaS Portal
    ebp = ElasticSearch, API BaaS Stack et API BaaS Portal sur le même nœud
  14. 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.
  15. Si vous avez installé un nouveau nœud de disponibilité Postgres, mettez-le hors service comme décrit ci-dessus dans la section Mettre hors service un nœud Postgres.

Pour effectuer ultérieurement un rollback de la mise à jour, suivez la procédure décrite dans la section Procédure de rollback 4.17.09.

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

Si vos nœuds Edge sont derrière un pare-feu ou s'ils ne sont pas autorisés à accéder au dépôt Apigee via Internet, vous pouvez effectuer la mise à jour à partir d'un dépôt local (ou miroir) du dépôt Apigee.

Une fois que vous avez créé un dépôt Edge local, vous avez deux options pour mettre à jour Edge à partir du dépôt local :

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

Pour effectuer la mise à jour à partir d'un dépôt local 4.17.09:

  1. Si vous utilisez actuellement la réplication maître-nœud de disponibilité Postgres, installez un nouveau nœud de disponibilité Postgres comme décrit ci-dessus dans la section Installer un nouveau nœud de disponibilité Postgres.
  2. Créez un dépôt local 4.17.09 comme décrit dans la section "Créer un dépôt Apigee local" de Installer l'utilitaire apigee-setup 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.17.09 comme décrit dans la section "Mettre à jour un dépôt Apigee local" de la page Installer l'utilitaire Edge de configuration Apigee.
  3. Pour installer apigee-service à partir d'un fichier .tar :
    1. Sur le nœud avec 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.17.09.tar.gz:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror
    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.17.09.tar.gz

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

      Notez que vous devez inclure le chemin d'accès au répertoire repos 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 Installer l'utilitaire apigee-setup Edge.
    2. Sur le nœud distant, téléchargez le fichier bootstrap_4.17.09.sh d'Edge dans /tmp/bootstrap_4.17.09.sh:
      > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh

      où uName:pWord correspond au nom d'utilisateur et au mot de passe que vous avez définis ci-dessus pour le dépôt, et remoteRepo à l'adresse IP ou au nom DNS du nœud du dépôt.
    3. Sur le nœud distant, installez l'utilitaire apigee-service Edge et les dépendances:
      > sudo bash /tmp/bootstrap_4.17.09.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

      où uName:pWord correspond au nom d'utilisateur et au mot de passe du dépôt.
  5. Utilisez apigee-service pour mettre à jour l'utilitaire apigee-setup :
    1. Si vous avez installé la version 4.16.01 en mettant à niveau la version 4.15.07.0x d'Edge, 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é directement la version 4.16.01, 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 de apigee-service installe l'utilitaire update.sh dans /opt/apigee/apigee-setup/bin.
    3. Si vous avez installé la version 4.16.05 directement ou via une mise à jour, vous devez mettre à jour l'utilitaire apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

      Cette mise à jour d'apigee-service installe l'utilitaire update.sh dans /opt/apigee/apigee-setup/bin.
  6. En fonction de la 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






    3. Si vous passez à partir de la version 4.16.01: modifiez le fichier de configuration transmis à l'utilitaire apigee-validate. Dans la version Edge 4.16.01, 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 "Ordre des mises à jour de la machine" ci-dessous:
    > /opt/apigee/apigee-setup/bin/update.sh -c composant -f configFile

    Le fichier de configuration 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 inclut:
    ldap = OpenLDAP
    cs = Cassandra
    zk = Zookeeper
    qpid = qpidd
    ps = postgresql
    edge =Tous les composants Edge, à l'exception de l'UI Edge: serveur de gestion, processeur de messages, routeur, serveur QPID, serveur Postgres
    ui = UI Edge
    all = mise à jour de tous les composants sur la machine (à utiliser uniquement pour un profil d'installation aio Edge ou un profil d'installation asa API BaaS)
    e = ElasticSearch
    b = API BaaS Stack
    p = API BaaS Portal
    ebp = ElasticSearch, API BaaS Stack et API BaaS Portal sur le même nœud
  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 disponibilité Postgres, mettez-le hors service comme décrit ci-dessus dans la section Mettre hors service un nœud Postgres.

Pour effectuer ultérieurement un rollback de la mise à jour, suivez la procédure décrite dans la section Procédure de rollback 4.17.09.

Ordre de mise à 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 lors d'une mise à jour:

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

Pour une installation autonome à un hôte

  1. Définissez SMTPMAILFROM dans votre fichier de configuration si vous avez activé SMTP sur Edge. Ce paramètre a le format suivant:
    SMTPMAILFROM="My Company <myco@company.com>"
  2. Si vous effectuez la mise à niveau à partir de la version 4.16.01, revenez à la version antérieure de Zookeeper:
    > yum downgrade 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 `hostname` -i eth0 -j DROP
  5. Vérifiez la file d'attente des 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 qu'il n'a pas traité tous les messages.
  6. Mettez à jour qpidd:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. Vider iptables:
    > sudo iptables -F
  8. Mise à jour de LDAP:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  9. Arrêtez le serveur Postgres, 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 autres composants Edge:
    > /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 à deux hôtes

Pour obtenir la liste des topologies Edge et des numéros de nœuds, consultez la section Topologies d'installation.

  1. Définissez SMTPMAILFROM dans votre fichier de configuration si vous avez activé SMTP sur Edge. Ce paramètre a le format suivant:
    SMTPMAILFROM="My Company <myco@company.com>"
  2. Si vous effectuez une mise à jour à partir de la version 4.16.01, revenez à une version antérieure de Zookeeper sur la machine 1:
    > revenez à une version antérieure pour 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 d'hôte" -i eth0 -j DROP
  5. Vérifiez la file d'attente de messages Qpid sur la machine 2:
    > qpid-stat -q

    Vérifiez la file d'attente jusqu'à ce que le nombre dans la colonne "msg" soit égal à 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. Vider iptables sur la machine 2:
    > sudo iptables -F
  8. Mise à jour de 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 edge -f configFile
  10. Mise à jour de 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 le serveur Postgres, 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 les machines 2 et 1:
      > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  12. Mettez à jour les composants Edge sur la machine 2:
    > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile

Pour une installation en cluster à cinq hôtes

Pour obtenir la liste des topologies Edge et des numéros de nœuds, consultez la section Topologies d'installation.

  1. Définissez SMTPMAILFROM dans votre fichier de configuration si vous avez activé SMTP sur Edge. Ce paramètre a le format suivant:
    SMTPMAILFROM="My Company <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 la mise à jour à partir de la version 4.16.01, revenez à la version antérieure de Zookeeper sur les machines 1, 2 et 3:
    > yum downgrade 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 d'hôte" -i eth0 -j DROP
  6. Vérifiez la file de messages Qpid sur la machine 4:
    > qpid-stat -q

    Vérifiez la file de messages jusqu'à ce que le nombre dans la colonne "msg" soit égal à 0. Vous ne pouvez pas mettre à niveau Qpid tant qu'il n'a pas traité tous les messages.
  7. Mettez à jour qpidd sur la machine 4:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. Videz les iptables sur la machine 4:
    > sudo iptables -F
  9. Répétez les étapes 5 à 8 sur la machine 5.
  10. Mise à jour de 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. Mise à jour de l'UI sur la machine 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  13. Mettez à 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 edge-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 apigee-postgresql stop
    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 (instance maître Postgres 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 les serveurs Postgres et 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-replication-on-standby -f       configFile
    9. Vérifiez l'état de la réplication en exécutant les scripts suivants sur les deux serveurs. Le système doit afficher des résultats identiques sur les deux serveurs pour garantir la réussite de la réplication:

      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 du 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 s'agit bien du nœud de secours.
  14. Mettez à jour les composants Edge sur les machines 4 et 5:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  15. Veillez à mettre hors service le nouveau nœud de secours en suivant la procédure ci-dessus dans Mettre hors service un nœud Postgres.

Pour une installation en cluster à neuf hôtes

Pour obtenir la liste des topologies Edge et des numéros de nœuds, consultez la section Topologies d'installation.

  1. Définissez SMTPMAILFROM dans votre fichier de configuration si vous avez activé SMTP sur Edge. Ce paramètre a le format suivant:
    SMTPMAILFROM="My Company <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 la mise à jour à partir de la version 4.16.01, revenez à la version antérieure de Zookeeper sur les machines 1, 2 et 3:
    > yum downgrade 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 `hostname` -i eth0 -j DROP
  6. Vérifiez la file de messages Qpid sur la machine 6:
    > qpid-stat -q

    Vérifiez la file de messages jusqu'à ce que le nombre dans la colonne "msg" soit égal à 0. Vous ne pouvez pas mettre à niveau Qpid tant qu'il n'a pas traité tous les messages.
  7. Mise à jour de qpidd sur la machine 6:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. Videz les 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 Edge -f configFile
  12. Mise à jour de l'UI sur la machine 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  13. Mettez à 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 Postgres 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-replication-on-standby -f       configFile
    11. Vérifiez l'état de la réplication en exécutant les scripts suivants sur les deux serveurs. Le système doit afficher des résultats identiques sur les deux serveurs pour garantir une réplication réussie:
      Sur la machine 8, le nœud maître, exécutez:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

      Vérifiez qu'il indique qu'il s'agit du 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 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 edge -f configFile
  15. Veillez à mettre hors service le nouveau nœud de secours en suivant la procédure ci-dessus dans Mettre hors service un nœud Postgres.

Pour une installation en cluster à 13 hôtes

Pour obtenir la liste des topologies Edge et des numéros de nœuds, consultez la section Topologies d'installation.

  1. Définissez SMTPMAILFROM dans votre fichier de configuration si vous avez activé SMTP sur Edge. Ce paramètre a le format suivant:
    SMTPMAILFROM="My Company <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 la mise à jour à partir de la version 4.16.01, revenez à la version antérieure de Zookeeper sur les machines 1, 2 et 3:
    > yum downgrade 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 d'hôte" -i eth0 -j DROP
  6. Vérifiez la file d'attente de messages Qpid sur la machine 12:
    > qpid-stat -q

    Vérifiez la file d'attente jusqu'à ce que le nombre dans la colonne "msg" soit égal à 0. Vous ne pouvez pas mettre à niveau Qpid tant que tous les messages n'ont pas été traités.
  7. Mise à jour de qpidd sur la machine 12:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. Vider 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 l'ordre suivant:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -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. Mettez à 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 Postgres 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 du 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-replication-on-standby -f       configFile
    11. Vérifiez l'état de la réplication en exécutant les scripts suivants sur les deux serveurs. Le système doit afficher des résultats identiques sur les deux serveurs pour garantir une réplication réussie:
      Sur la machine 8, le nœud maître, exécutez:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

      Vérifiez qu'il indique qu'il s'agit du 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 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 edge -f configFile
  15. Veillez à mettre hors service le nouveau nœud de secours en suivant la procédure ci-dessus dans Mettre hors service un nœud Postgres.

Pour une installation en cluster à 12 hôtes

Consultez la section Topologies d'installation pour obtenir la liste des topologies Edge et des numéros de nœuds.

  1. Définissez SMTPMAILFROM dans votre fichier de configuration si vous avez activé SMTP sur Edge. Ce paramètre a le format suivant:
    SMTPMAILFROM="My Company <myco@company.com>"
  2. Assurez-vous d'avoir installé un nouveau nœud de disponibilité Postgres comme décrit ci-dessus dans Installer un nouveau nœud de disponibilité Postgres.
  3. Mettez à jour Cassandra et ZooKeeper :
    1. Si vous effectuez une mise à jour à partir de la version 4.16.01, revenez à une version antérieure de Zookeeper sur Mac 1, 2 et 3 dans le centre de données 1:
      > yum rétrograder 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 la mise à jour à partir de la version 4.16.01, rétrogradez Zookeeper sur les machines 7, 8 et 9 du centre de données 2:
      > yum downgrade 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 du 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 `hostname` -i eth0 -j DROP
      2. Vérifiez la file de messages Qpid sur la machine 4:
        > qpid-stat -q

        Vérifiez la file de messages jusqu'à ce que le nombre dans la colonne "msg" soit égal à 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. Vider 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 d'hôte" -i eth0 -j DROP
      2. Vérifiez la file de messages Qpid sur la machine 10:
        > qpid-stat -q

        Vérifiez la file de messages jusqu'à ce que le nombre dans la colonne "msg" soit égal à 0. Vous ne pouvez pas mettre à niveau Qpid tant que tous les messages n'ont pas été traités.
      3. Mettez à jour qpidd sur la machine 10:
        > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      4. Vider iptables sur la machine 10:
        > sudo iptables -F
      5. Répétez les étapes 1 à 4 sur la machine 11.
  5. Mise à jour du 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 du 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 Edge -f configFile
    2. Machines 10, 11, 7, 8, 9 dans le centre de données 2
      > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  7. Mise à jour de l'UI :
    1. Machine 1 dans le centre de données 1:
      > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
    2. Machine 7 du centre de données 2:
      > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  8. Mettez à jour la machine 6 dans le centre de données 1 et la machine 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 PostgreSQL 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-replication-on-standby -f       configFile
    11. Vérifiez l'état de la réplication en exécutant les scripts suivants sur les deux serveurs. Le système doit afficher des résultats identiques sur les deux serveurs pour garantir une réplication réussie:
      Sur la machine 6, le nœud maître, exécutez:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

      Vérifiez qu'il indique qu'il s'agit du maître.

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

      Confirmez qu'il s'agit de l'instance 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. Veillez à mettre hors service le nouveau nœud de secours en suivant la procédure ci-dessus dans Mettre hors service un nœud Postgres.

Pour une installation BaaS d'API à 7 ou 10 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 dans l'ordre suivant: 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 nœud est équipé à la fois du serveur Qpid et du serveur Postgres, exécutez l'étape de profil "-c edge" à l'étape 8.
  6. Interface utilisateur Edge
  7. postgresql sur le maître Postgres, y compris la mise à niveau.
  8. postgresql sur le serveur de secours Postgres.
  9. Edge, c'est-à-dire le profil "-c edge" sur tous les nœuds Qpid et Postgres combinés, ou sur tous les nœuds Postgres autonomes.