Mise à jour d'Apigee Edge 4.16.09 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 Apigee Edge de la version 4.16.09.0x vers la version 4.17.09 à l'aide de 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.x, puis passer à la version 4.17.09.

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.

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.

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/Oracle 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/Oracle 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.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.

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 vers la version précédente de la mise à jour, consultez la section Processus de rollback de la version 4.17.09 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 à 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.09.

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

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

  1. 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.
  2. 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.
  3. Installez yum-utils et yum-plugin-priorities:
    > sudo yum install yum-utils
    > sudo yum install yum-plugin-priorities
  4. Désactivez SELinux comme décrit dans la section Installer l'utilitaire de configuration Edge Apigee.
  5. Activez le dépôt EPEL comme décrit ci-dessus.
  6. 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
  7. Téléchargez le fichier Edge 4.17.09 bootstrap_4.17.09.sh dans /tmp/bootstrap_4.17.09.sh:
    > curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
  8. Installez l'utilitaire et les dépendances d'Edge 4.17.09 apigee-service:
    > sudo bash /tmp/bootstrap_4.17.09.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.
  9. Utilisez apigee-service pour mettre à jour l'utilitaire apigee-setup:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup mise à jour
  10. Mettez à jour l'utilitaire apigee-validate sur le serveur de gestion:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  11. Mettez à jour l'utilitaire apigee-provision:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  12. 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



  13. 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.

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

Procédure de mise à jour vers la version 4.17.09 à 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 local 4.17.09:

  1. 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 la section Installer l'utilitaire de configuration d'Apigee Edge.
    Remarque: Si vous disposez déjà d'un dépôt 4.16.09, 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" dans la section Installer l'utilitaire de configuration d'Edge d'Edge.
  2. 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.17.09.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.17.09.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.17.09.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.
  3. 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.17.09.sh dans /tmp/bootstrap_4.17.09.sh :
      > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.0

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

  4. Utilisez apigee-service pour mettre à jour l'utilitaire apigee-setup:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  5. Mettez à jour l'utilitaire apigee-validate sur le serveur de gestion.
    > /opt/apigee/apigee-service/bin/apigee-service apigee-validate mise à jour
  6. Mettez à jour l'utilitaire apigee-provision:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  7. 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



  8. 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.

Pour effectuer un rollback ultérieur de la mise à jour, suivez la procédure décrite dans la section 4.17.09 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. Mettez à jour Cassandra et ZooKeeper:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Définissez la règle iptables suivante:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `nom-hôte` -i eth0 -j DROP
  4. 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.
  5. Mettez à jour qpidd:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  6. Flush iptables:
    > sudo iptables -F
  7. Mettez à jour postgresql:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  8. Démarrez postgresql:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  9. Mettez à jour LDAP:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  10. Mettez à jour les composants Edge restants:
    > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  11. 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 de 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. Mettez à jour Cassandra et ZooKeeper sur la machine 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. 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
  4. 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.
  5. Mettez à jour qpidd sur la machine 2:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  6. Vide iptables sur la machine 2:
    > sudo iptables -F
  7. Mettez à jour postgresql sur la machine 2:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  8. Démarrez postgresql sur la machine 2:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  9. Mettez à jour LDAP sur la machine 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  10. Mettez à jour les composants Edge sur les machines 2 et 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c bord -f configFile
  11. Mettez à jour l'UI sur la machine 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

Pour une installation en cluster à cinq hôtes

Consultez la section Topologies d'installation pour obtenir la liste des topologies de 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. Mettez à jour Cassandra et ZooKeeper sur les machines 1, 2 et 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. 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
  4. 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.
  5. Mettez à jour qpidd sur la machine 4:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  6. Videz iptables sur la machine 4:
    > sudo iptables -F
  7. Répétez les étapes 3 à 6 sur la machine 5.
  8. Mettez à jour postgresql sur la machine 4:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  9. Démarrez postgresql sur la machine 4:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  10. Répétez les étapes 8 et 9 sur la machine 5.
  11. Mettez à jour LDAP sur la machine 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  12. Mettez à jour les composants Edge sur les machines 4, 5, 1, 2, 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c bord -f configFile
  13. Mettez à jour l'UI sur la machine 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

Pour une installation en cluster avec neuf hôtes

Consultez la section Topologies d'installation pour obtenir la liste des topologies de 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. Mettez à jour Cassandra et ZooKeeper sur les machines 1, 2 et 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. 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
  4. 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.
  5. Mettez à jour qpidd sur la machine 6:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  6. Videz iptables sur la machine 6:
    > sudo iptables -F
  7. Répétez les étapes 3 à 6 sur la machine 7.
  8. Mettez à jour postgresql sur la machine 6:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  9. Démarrez postgresql sur la machine 6:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  10. Répétez les étapes 8 et 9 sur la machine 7.
  11. Mettez à jour LDAP sur la machine 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  12. Mettez à jour les composants Edge sur les machines 6, 7, 8, 9, 1, 1, 4 et 5:
    > /opt/apigee/apigee-setup/bin/update.sh -c bord -f configFile
  13. Mettez à jour l'UI sur la machine 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

Pour une installation en cluster avec 13 hôtes

Consultez la section Topologies d'installation pour obtenir la liste des topologies de 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. Mettez à jour Cassandra et ZooKeeper sur les machines 1, 2 et 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. 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
  4. 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.
  5. Mettez à jour qpidd sur la machine 12:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  6. Vide iptables sur la machine 12:
    > sudo iptables -F
  7. Répétez les étapes 3 à 6 sur la machine 13.
  8. Mettez à jour postgresql sur la machine 12:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  9. Démarre postgresql sur la machine 12:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  10. Répétez les étapes 8 et 9 sur la machine 13.
  11. Mettez à jour LDAP sur les machines 4 et 5:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  12. Mettez à jour les composants Edge sur les machines 12, 13, 8, 9, 6, 7, 10 et 11, dans cet ordre:
    > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  13. Mettez à jour l'UI sur les machines 6 et 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

Pour une installation en cluster avec 12 hôtes

Consultez la section Topologies d'installation pour obtenir la liste des topologies de 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. Mettez à jour Cassandra et ZooKeeper :
    1. 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
    2. 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
  3. 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.
  4. Mettez à jour postgresql:
    1. Machines 6 dans le centre de données 1
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
    2. Machines 12 dans le centre de données 2
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  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, 6, 1, 2, 3 du centre de données 1
      > /opt/apigee/apigee-setup/bin/update.sh -c bord -f configFile
    2. Machines 10, 11, 12, 7, 8 et 9 du 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

Pour une installation d'API BaaS à sept hôtes

# For a single data center, specify the same value as BAAS_CASS_LOCALDC.
BAAS_CASS_DC_LIST="dc-1"

# Defines the initial contact points for members of the BaaS cluster. 
# Specify the IP address of no more than two Stack nodes. 
BAAS_CLUSTER_SEEDS="dc-1:$IP4,dc-1:$IP5"

# Specify the from address of generated emails.
SMTPMAILFROM="My Company <myco@company.com>"

Pour obtenir un exemple de fichier de configuration complet, consultez Installation de l'API BaaS.

Vous devez également vous assurer que le port 2551 est ouvert sur tous les nœuds de pile pour pouvoir y accéder depuis tous les autres nœuds de pile.

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

  1. Mettez à jour Cassandra sur les machines 5, 6 et 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  2. Mettez à jour ElasticSearch et la pile BaaS d'API sur les machines 1, 2 et 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c e,b -f configFile

  3. Mettez à jour le portail BaaS de l'API sur la machine 4:
    > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

Pour une installation d'API BaaS avec 10 hôtes

# For a single data center, specify the same value as BAAS_CASS_LOCALDC.
BAAS_CASS_DC_LIST="dc-1"

# Defines the initial contact points for members of the BaaS cluster. 
# Specify the IP address of no more than two Stack nodes. 
BAAS_CLUSTER_SEEDS="dc-1:$IP4,dc-1:$IP5"

# Specify the from address of generated emails.
SMTPMAILFROM="My Company <myco@company.com>"

Pour obtenir un exemple de fichier de configuration complet, consultez Installation de l'API BaaS.

Vous devez également vous assurer que le port 2551 est ouvert sur tous les nœuds de pile pour pouvoir y accéder depuis tous les autres nœuds de pile.

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

  1. Mettez à jour Cassandra sur les machines 8, 9 et 10:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  2. Mettez à jour ElasticSearch sur les machines 1, 2 et 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
  3. Mettez à jour la pile BaaS de l'API sur les machines 4, 5 et 6:
    > /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
  4. Mettez à jour le portail BaaS de l'API sur la machine 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

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, ps
  4. LDAP
  5. Edge, c'est-à-dire le profil "-c Edge" sur tous les nœuds de l'ordre: nœuds avec serveur Qpid, serveur Postgres, serveur de gestion, processeur de messages et routeur.
    Remarque: Si le serveur Qpid et le serveur Postgres sont installés sur le nœud, exécutez l'étape de profil "-c bord".
  6. Interface utilisateur périphérique