Mise à jour d'Apigee Edge 4.17.01/4.17.05 vers la version 4.17.09

Edge pour Private Cloud version 4.17.09

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

Vous pouvez mettre à niveau la version 4.17.01.0x/4.17.05.0x d'Apigee Edge vers la version 4.17.09 à l'aide de cette procédure.

Si votre version d'Edge est 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 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.

Propagation automatique des paramètres des établissements

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

Ajout obligatoire du paramètre de configuration SMTPMAILFROM

Edge 4.17.05 a ajouté un nouveau paramètre obligatoire au fichier de configuration utilisé lorsque vous activez 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 à partir de la version 4.17.01 ou 4.17.05, vous devez définir SMTPMAILFROM dans le fichier de configuration.

Ce paramètre a le format suivant:

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

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. Pour effectuer la sauvegarde, suivez la procédure correspondant à votre version actuelle d'Edge.
  
  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 une mise à jour ayant échoué

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 l'échec nécessite un rollback vers la version précédente, consultez la section Processus de rollback de la version 4.17.09 pour obtenir plus d'informations.

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 qui exécute l'utilitaire update.sh n'a pas accès à ce répertoire, le journal est écrit dans le répertoire /tmp sous le nom de fichier 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 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 consiste à supprimer chaque routeur de l'équilibreur de charge, un par un. Vous devez ensuite mettre à jour le routeur et tous les autres composants sur la même machine que le routeur, puis ajouter le routeur à 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. Lorsque vous devez mettre à jour les routeurs, sélectionnez un routeur et rendez-le inaccessible, comme décrit dans la section Activer/Désactiver la connectivité des serveurs (processeurs de messages/routeurs).
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, procédez comme suit :
    1. Rendre le routeur inaccessible.
    2. Rendre le processeur de messages inaccessible.
  • Après la mise à jour, procédez comme suit :
    1. Rendre 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, 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 silencieuse doit être le même que celui que vous avez utilisé pour installer Edge 4.17.01.

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 sur un nœud, procédez comme suit :

1. 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.
2. 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.
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 Edge de configuration apigee.
5. 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
6. 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
7. Installez l'utilitaire apigee-service et les dépendances d'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 bien installé. Si ce n'est pas le cas, 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.
8. Utilisez apigee-service pour mettre à jour l'utilitaire apigee-setup:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
9. Mettez à jour l'utilitaire apigee-validate sur le serveur de gestion:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
10. Mettez à jour l'utilitaire apigee-provision:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
11. Exécutez l'utilitaire de mise à jour sur vos nœuds dans l'ordre décrit ci-dessous dans la section Ordre de mise à jour de la machine:
    > /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
    
    La seule exigence concernant 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 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
12. 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 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 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 vous fournit le serveur Web Nginx, ou vous pouvez 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 Installer l'utilitaire apigee-setup Edge.
   Remarque: Si vous disposez déjà d'un dépôt 4.17.01/4.17.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 Installer l'utilitaire apigee-setup Edge.
2. 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 package 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 Edge apigee-service 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 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 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 correspond à 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.
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 update
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 "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
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 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 toute machine comportant plusieurs composants Edge (serveur de gestion, processeur de messages, routeur, serveur QPID, mais pas le serveur Postgres), utilisez l'option "-c edge" pour les mettre à jour tous en même temps.
• Si une étape indique qu'elle doit être effectuée sur plusieurs machines, effectuez-la dans l'ordre spécifié pour les machines.
• Il n'existe pas d'étape distincte pour mettre à jour la monétisation. Il est mis à jour lorsque vous spécifiez l'option "-c edge".

Pour une installation autonome à un hôte

1. Si vous effectuez la mise à jour à partir de la version 4.17.01, 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. Mettez à jour Cassandra et ZooKeeper:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
3. Mettez à jour Qpid et Postgres:
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
4. Démarrez postgresql:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
5. Mise à jour de LDAP:
   > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
6. Mettez à jour les autres composants Edge:
   > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
7. Mise à jour de l'interface utilisateur Edge:
   > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

Pour une installation autonome à 2 hôtes

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

1. Si vous effectuez la mise à jour à partir de la version 4.17.01, 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. Mettez à jour Cassandra et ZooKeeper sur la machine 1:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
3. Mettez à jour Qpid et Postgres sur la machine 2:
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
4. Démarrez postgresql sur la machine 2:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
5. Mise à jour de LDAP sur la machine 1:
   > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
6. Mettez à jour les composants Edge sur les machines 2 et 1:
   > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
7. Mettre à jour l'UI sur la machine 1:
   > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

Pour une installation en cluster à 5 hôtes

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

1. Si vous effectuez la mise à jour à partir de la version 4.17.01, 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 <mon_entreprise@entreprise.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. Mettez à jour Qpid et Postgres sur la machine 4:
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
4. Démarrez postgresql sur la machine 4:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
5. Répétez les étapes 3 et 4 sur la machine 5.
6. Mettez à jour LDAP sur la machine 1:
   > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
7. Mettez à jour les composants Edge sur les machines 4, 5, 1, 2 et 3:
   > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
8. Mise à jour de l'UI sur la machine 1:
   > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

Pour une installation en cluster à 9 hôtes

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

1. Si vous effectuez la mise à jour à partir de la version 4.17.01, 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. 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. Mettez à jour Qpid et Postgres sur la machine 6:
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
4. Démarrez postgresql sur la machine 6:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
5. Répétez les étapes 3 et 4 sur la machine 7.
6. Mise à jour de LDAP sur la machine 1:
   > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
7. Mettez à jour les composants Edge sur les machines 6, 7, 8, 9, 1, 4 et 5 dans l'ordre suivant:
   > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
8. Mise à jour de l'UI sur la machine 1:
   > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

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. Si vous effectuez la mise à jour à partir de la version 4.17.01, 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 <mon_entreprise@entreprise.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. Mettez à jour Qpid et Postgres sur la machine 12:
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
4. Démarrez postgresql sur la machine 12:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
5. Répétez les étapes 3 et 4 sur la machine 13.
6. Mettez à jour LDAP sur les machines 4 et 5:
   > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
7. Mettez à jour les composants Edge sur les machines 12, 13, 8, 9, 6, 7, 10 et 11 dans l'ordre suivant:
   > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
8. Mettez à jour l'interface utilisateur sur les machines 6 et 7:
   > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

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. Si vous effectuez la mise à jour à partir de la version 4.17.01, 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 <mon_entreprise@entreprise.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 du centre de données 1
      1. Mettez à jour qpidd sur la machine 4:
         > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. Répétez l'étape 1 sur la machine 5.
   2. Machines 10 et 11 dans le centre de données 2
      1. Mise à jour de qpidd sur la machine 10:
         > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. Répétez l'étape 1 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 du 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 et 3 du centre de données 1
      > /opt/apigee/apigee-setup/bin/update.sh -c edge -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 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

Pour une installation API BaaS à sept hôtes

1. Définissez SMTPMAILFROM dans votre fichier de configuration. Ce paramètre a le format suivant:
   SMTPMAILFROM="My Company <myco@company.com>"
2. Mettez à jour Cassandra sur les machines 5, 6 et 7:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile

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

4. Mettre à 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 API BaaS à 10 hôtes

1. Définissez SMTPMAILFROM dans votre fichier de configuration. Ce paramètre a le format suivant:
   SMTPMAILFROM="My Company <myco@company.com>"
2. Mettez à jour Cassandra sur les machines 8, 9 et 10:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
3. Mettez à jour ElasticSearch sur les machines 1, 2 et 3:
   > /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
4. Mettez à jour la pile API BaaS sur les machines 4, 5 et 6:
   > /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
5. Mise à jour du portail BaaS de l'API sur la machine 7:
   > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

Pour une installation d'API Baas à deux centres de données

Cette procédure nécessite de mettre à jour les nœuds Cassandra dans les deux centres de données. Si vous partagez ces nœuds Cassandra avec Edge, vous mettez généralement à jour ces nœuds lors de la mise à jour d'Edge.

1. Définissez SMTPMAILFROM dans vos fichiers de configuration. Ce paramètre a le format suivant:
   SMTPMAILFROM="My Company <myco@company.com>"
2. Mettez à jour les espaces de clés Cassandra avec un facteur de réplication correct pour les deux centres de données. Vous n'avez besoin d'exécuter cette étape qu'une seule fois sur n'importe quel serveur Cassandra de l'un des centres de données:
   
   Remarque: Les commandes ci-dessous définissent le facteur de réplication sur "3", ce qui indique trois nœuds Cassandra dans le cluster. Modifiez cette valeur si nécessaire pour votre installation.
   1. Démarrez l'utilitaire cqlsh Cassandra:
      > /opt/apigee/apigee-cassandra/bin/cqlsh cassandraIP
   2. Exécutez les commandes CQL suivantes à l'invite "cqlsh>" pour définir les niveaux de réplication des espaces de clés Cassandra :
      1. cqlsh> ALTER KEYSPACE "Apigee_Baas_dc_1" WITH réplication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      2. cqlsh> ALTER KEYSPACE "Apigee_Baas" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      3. cqlsh> ALTER KEYSPACE "Apigee_Baas_Locks" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      4. cqlsh> ALTER KEYSPACE "system_traces" WITH réplication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      5. cqlsh> ALTER KEYSPACE "Apigee_Baas_dc_2" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      6. Affichez les espaces de clés à l'aide de la commande:
         cqlsh> select * from system.schema_keyspaces;
      7. Quitter cqlsh:
         cqlsh> exit
3. (Uniquement si vous n'avez pas mis à jour Cassandra lors de la mise à jour d'Edge) Mettez à jour les nœuds Cassandra dans le centre de données 1, une machine à la fois:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
4. (Uniquement si vous n'avez pas mis à jour Cassandra lors de la mise à jour d'Edge) Mettez à jour les nœuds Cassandra du centre de données 2, une machine à la fois:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
5. Mettez à jour ElasticSearch sur les machines du centre de données 1, une par une:
   > /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
6. Mettez à jour ElasticSearch sur les machines du centre de données 2, une par une:
   > /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
7. Mettez à jour la pile API BaaS sur les machines du centre de données 1, une par une:
   > /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
8. Mettez à jour la pile API BaaS sur les machines du centre de données 2, une par une:
   > /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
9. Mettez à jour le portail API BaaS sur les machines du centre de données 1, une par une:
   > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile
10. Mettez à jour le portail API BaaS sur les machines du centre de données 2, une par une:
    > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile
11. Mettre à jour les valeurs d'espace de clés BaaS Ces espaces de clés doivent être définis pour la réplication au moment de l'installation, mais pas au moment de l'exécution. La suppression de la réplication permet également d'économiser de la mémoire Cassandra.
    
    Vous n'avez besoin d'exécuter cette étape qu'une seule fois sur un serveur Cassandra de l'un des centres de données :
    1. Démarrez l'utilitaire Cassandra cqlsh:
       > /opt/apigee/apigee-cassandra/bin/cqlsh cassandraIP
    2. Exécutez les commandes CQL suivantes pour définir les niveaux de réplication des espaces de clés Cassandra :
       1. cqlsh> ALTER KEYSPACE "Apigee_Baas_dc_1" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3' };
       2. cqlsh> ALTER KEYSPACE "Apigee_Baas_dc_2" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-2': '3' };
       3. Affichez les espaces de clés à l'aide de la commande:
          cqlsh> select * from system.schema_keyspaces;
       4. Quitter cqlsh:
          cqlsh> sortie

Pour une installation non standard

Si vous disposez d'une installation non 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 dans l'ordre suivant: nœuds avec serveur Qpid, serveur Postgres, serveur de gestion, processeur de messages et routeur.
   Remarque: Si le nœud est équipé à la fois d'un serveur Qpid et d'un serveur Postgres, exécutez l'étape de profil "-c edge".
6. Interface utilisateur Edge