Cette page a été traduite par l'API Cloud Translation.

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

Edge pour le cloud privé v4.18.01

Quelles versions d'Edge peuvent être mises à jour vers la version 4.18.01

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

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

Vous pouvez migrer Apigee Edge version 4.15.07 vers 4.16.01.
Si vous disposez d'une version d'Edge antérieure à la version 4.15.07, vous devez d'abord migrer vers la version 4.15.07, puis vers la version 4.16.01.
- Si vous migrez depuis la version 4.14.04 ou ultérieure d'Edge: migrez directement vers la version 4.15.07.
- Si vous migrez depuis la version 4.14.01 d'Edge: 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 identique à celui qui a initialement installé Edge ou à l'utilisateur racine.

Une fois les RPM périphériques installés, tous les utilisateurs peuvent 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.

Retour à une version antérieure de Zookeeper en cas de mise à jour depuis la version 4.16.01

La version du RPM Zookeeper dans Edge pour le cloud privé 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 des versions ultérieures depuis la version 4.16.01. Pour résoudre ce problème, exécutez la commande yum rétrograder 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 revenir à la version antérieure.

Propagation automatique des paramètres de la 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 par la mise à jour.

Mettre à jour les conditions préalables

Vérifiez les conditions préalables suivantes avant de mettre à niveau Apigee Edge:

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.

Vous bénéficiez 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 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 une mise à jour ayant échoué

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

Si l'échec nécessite un rollback vers la version précédente, consultez l'article 4.18.01 Rollback.

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 requise vers la version 8 de JDK Java

Cette version d'Edge nécessite l'installation de la version 8 de 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 le faire pour vous.

Dans le cadre de la mise à jour de Java 8, certains algorithmes de chiffrement TLS ne sont plus disponibles dans Oracle JDK 8. Pour obtenir la liste complète, consultez la section "Default Cipher Suites désactivées" à l'adresse 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 (EP EPEL) pour installer ou mettre à jour Edge. La commande à utiliser dépend de votre version de RedHat/CentOS:

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

Ajout obligatoire du paramètre de configuration SMTPMAILFROM

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 à 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 est au format suivant:

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 à une installation d'Apigee Edge Private Cloud existante. Cette fonctionnalité est conçue pour fonctionner avec n'importe quel service d'annuaire compatible avec LDAP, tel qu'Active Directory, OpenLDAP, etc. Une solution LDAP externe permet aux administrateurs système de gérer les identifiants utilisateur à partir d'un service centralisé de gestion d'annuaire, qui est externe aux systèmes tels qu'Apigee Edge qui les utilisent.

Pour en savoir plus, consultez 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, au lieu de l'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 lorsque vous mettez à jour Edge vers la version 4.18.01:

IS_EXTERNAL_AUTH="true"

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

Mise à niveau requise vers Qpid 1.35

Cette version contient une mise à jour obligatoire de Qpid 1.35. Dans le cadre de la mise à jour d'un nœud Qpid, vous devez:

Empêchez temporairement l'écriture des routeurs et des processeurs de message 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 `hostname` -i eth0 -j Drop
Attendez que la file d'attente Qpid soit vide pour vous assurer que le nœud Qpid a traité tous les messages avant la mise à jour. Exécutez la commande suivante pour vérifier que la file d'attente des messages Qpid est vide:
> qpid-stat -q
Mettez à jour le nœud Qpid.
Débloquez le port 5672 sur le nœud Qpid afin d'autoriser l'accès à partir des routeurs et des processeurs de messages. Pour débloquer ce port, vous pouvez utiliser la commande suivante:
> 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 `hostname` -i eth0 -j Drop

Ce processus est décrit en détail ci-dessous pour chaque topologie Edge.

Mise à niveau requise vers Postgres 9.6

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

Pendant le processus de mise à jour, pendant que les nœuds Postgres sont indisponibles, les données d'analyse sont toujours écrites dans les nœuds Qpid. Une fois les nœuds Postgres mis à jour et à nouveau en ligne, les données d'analyse sont transmises aux nœuds Postgres.

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

Installer un nouveau nœud de secours Postgres

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

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

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

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

conf_pg_hba_replication.connection=host réplication apigee existing_SLA_ip/32 Confiance\ \nhost réplication
Redémarrez apigee-postgresql sur le maître Postgres:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
Vérifiez que le nœud de secours a été ajouté en consultant le fichier /opt/apigee/apigee-postgresql/conf/pg_hba.conf sur le maître. Ce fichier doit contenir les lignes suivantes:
host réplication apigee apigee_existing_ip/32 confiance
host réplication apigee new_SLA_ip/32 confiance
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 Installer l'utilitaire de configuration Edge apigee.
3. Téléchargez le fichier Edge bootstrap_4.16.05.sh dans /tmp/bootstrap_4.16.05.sh :
  > curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
  
  Mise à jour.
4. Installez l'utilitaire et les dépendances Edge apigee-service:
  > sudo bash /tmp/bootstrap_4.16.05.sh apigeeuser=uName apigeepassword=pWord
5. Utilisez apigee-service pour installer l'utilitaire apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
6. Installez Postgres:
  > /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
7. Sur le nouveau nœud de secours, exécutez la commande suivante:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
  
  Confirmez qu'il s'agit de l'instance de secours.

Mettre un nœud Postgres hors service

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

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
?
Arrêtez le nouveau nœud de secours en exécutant la commande suivante:
> /opt/apigee/apigee-service/bin/apigee-all stop
Sur le nœud maître Postgres, modifiez le fichier /opt/apigee/customer/application/postgresql.properties pour supprimer le nœud de secours de conf_pg_hba_replication.connection:
conf_pg_hba_replication.connection=host réplication apigee existing_SLA_ip/32
Redémarrez apigee-postgresql sur le maître Postgres:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
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. Ce fichier ne doit contenir que la ligne suivante:
host réplication apigee existing_SLA_ip/32trust
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_SLA_uuid>

Mise à jour sans temps d'arrêt

Une mise à jour sans interruption, ou mise à jour progressive, vous permet de mettre à jour votre installation Edge sans désactiver Edge.

La mise à jour sans interruption n'est possible qu'avec une configuration à cinq nœuds ou supérieure.

La mise à niveau sans aucun temps d'arrêt consiste à supprimer chaque routeur, l'un après l'autre, de l'équilibreur de charge. Vous mettez ensuite à jour le routeur et tous les autres composants présents sur la même machine que le routeur, puis l'ajoutez de nouveau à l'équilibreur de charge.

Mettez à jour les machines dans le bon ordre d'installation, comme décrit ci-dessous dans la section "Ordre des mises à jour des machines".
Lorsque le moment est venu de mettre à jour les routeurs, sélectionnez l'un d'entre eux et rendez-le inaccessible, comme décrit dans la section Activer/Désactiver l'accessibilité du serveur (processeur de messages/routeur).
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.
Rendez le routeur accessible à nouveau.
Répétez les étapes 2 à 4 pour les autres routeurs.
Continuez la mise à jour pour toutes les machines restantes de votre installation.

Effectuez les opérations suivantes avant/après la mise à jour:

Sur le routeur et le nœud de traitement des messages combinés :
- Avant la mise à jour :
  1. Rend 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. Rendez le routeur accessible.
Sur un nœud de routeur unique :
- Avant la mise à jour, rendez le routeur inaccessible.
- Une fois la mise à jour effectuée, rendez le routeur accessible.
Sur un nœud unique de processeur de message :
- Avant la mise à jour, rendez le processeur de messages inaccessible.
- Une fois la mise à jour effectuée, rendez le processeur de messages accessible.

Utiliser un fichier de configuration silencieuse

Vous devez transmettre un fichier de configuration silencieuse à la commande de mise à jour. Le fichier de configuration silencieuse doit être identique à celui que vous avez utilisé pour installer Edge 4.16.01 ou 4.16.05.

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

Procédez comme suit pour mettre à jour les composants périphériques d'un nœud:

Si vous utilisez actuellement la réplication principale de secours Postgres, installez un nouveau nœud de secours Postgres, comme décrit ci-dessus dans la section Installer un nouveau nœud de secours Postgres.
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.
Connectez-vous en tant que racine à votre nœud pour installer les RPM Edge.
Remarque: Bien que l'installation du RPM nécessite un accès racine, vous pouvez effectuer une configuration Edge sans accès racine.
Installez yum-utils et yum-plugin-priorities:
> sudo yum install yum-utils
> sudo yum install yum-plugin-priorities
Désactivez SELinux comme décrit dans Installer l'utilitaire de configuration Apigee Edge.
Activez le dépôt EPEL comme décrit ci-dessus.
Si vous effectuez l'installation sur Oracle 7.x, exécutez la commande suivante:
> sudo yum-config-manager --enable ol7_Optional_latest
Si vous effectuez l'installation sur AWS, exécutez les commandes yum-configure-manager suivantes:
> yum update rh-amazon-rhui-client.noarch
> sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
Téléchargez le fichier Edge
Installez l'utilitaire et les dépendances Edge 4.18.01 apigee-service:
> sudo bash /tmp/bootstrap_4.18.01.sh apigeeuser=uName apigeepassword=pWord

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

Par défaut, le programme d'installation vérifie que Java 1.8 est installé. Si vous ne le faites pas, il l'installe pour vous. Utilisez l'option JAVA_FIX pour spécifier comment gérer l'installation de Java. JAVA_FIX accepte les valeurs suivantes:

I = Installer OpenJDK 1.8 (par défaut)
C = Continuer sans installer Java
Q = Quitter. Pour cette option, vous devez installer Java vous-même.
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 Edge 4.15.07.0x, vous devez installer l'utilitaire apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  
  Cette commande installe l'utilitaire update.sh dans /opt/apigee/apigee-setup/bin.
  
  Si vous avez déjà installé l'utilitaire apigee-setup, mettez-le à jour:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
2. Si vous avez installé la version 4.16.01 directement, ce qui signifie que vous n'avez pas effectué de mise à niveau à partir de la version 4.15.07.0x, vous devez mettre à jour l'utilitaire apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  
  Cette mise à jour vers apigee-service installe l'utilitaire update.sh dans /opt.
3. Si vous avez installé la version 4.16.05 directement ou par mise à jour, vous devez mettre à jour l'utilitaire apigee-setup:
  > Cette mise à jour vers apigee-service installe l'utilitaire update.sh dans /opt/apigee/apigee-setup/bin.
Selon votre version actuelle d'Edge, vous devez installer ou mettre à jour l'utilitaire apigee-validate sur le serveur de gestion.
1. Si vous utilisez actuellement Edge 4.16.05: mettez à jour l'utilitaire apigee-validate sur le serveur de gestion:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
2. Si vous utilisez :
3. Si vous effectuez une mise à niveau depuis la version 4.16.01: modifiez le fichier de configuration transmis à l'utilitaire apigee-validate. Dans la version 4.16.01 Edge, le fichier de configuration utilisé par apigee-validate nécessitait les propriétés suivantes:
  APIGEE_ADMINPW=sysAdminPword
  MP_POD=gateway
  REGION=dc-1
  
  Dans cette version, le fichier de configuration ne requiert que la propriété APIGEE_ADMINPW. Vous pouvez supprimer les deux autres propriétés du fichier.
Mettez à jour l'utilitaire apigee-provision:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
Exécutez l'utilitaire de mise à jour sur vos nœuds dans l'ordre indiqué dans la section Ordre des mises à jour des machines ci-dessous:
> /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

La seule condition requise pour le fichier de configuration est que l'utilisateur "apigee" puisse accéder au fichier de configuration ou le lire.

Utilisez l'option "-c" pour spécifier le composant à mettre à jour. ?
Testez la mise à jour en exécutant l'utilitaire apigee-validate sur le serveur de gestion, comme décrit dans Tester l'installation.
Si vous avez installé un nouveau nœud de secours Postgres, mettez-le hors service comme décrit dans la section Mettre un nœud Postgres hors service.

Pour effectuer un rollback ultérieur de la mise à jour, suivez la procédure décrite dans 4.18.01 Rollback processus.

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

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

Après avoir 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 dans un nœud, puis mettez-le à jour à 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 ou vous pouvez utiliser votre propre serveur Web.

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

Si vous utilisez actuellement la réplication principale de secours Postgres, installez un nouveau nœud de secours Postgres, comme décrit ci-dessus dans la section Installer un nouveau nœud de secours Postgres.
Créez un dépôt local 4.18.01 comme décrit dans la section "Créer un dépôt Apigee local" dans Installer l'utilitaire de configuration Apigee Apigee.
Remarque: Si vous disposez déjà d'un dépôt 4.16.01 ou 4.16.05, vous pouvez y ajouter le dépôt 4.18.01, comme décrit dans la section "Mettre à jour un dépôt Apigee local" dans Installer l'utilitaire de configuration Apigee Edge.
Pour installer apigee-service à partir d'un fichier .tar :
1. Sur le nœud avec le dépôt local, exécutez la commande suivante pour empaqueter le dépôt local dans un seul fichier .tar nommé /opt/apigee/data/apigee-Mirror/apigee-4.18.01.tar.gz:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-Mirror package
2. Copiez le fichier .tar sur le nœud où vous souhaitez mettre à jour Edge. Par exemple, copiez-le dans le répertoire /tmp du nouveau nœud.
3. Sur le nouveau nœud, annulez l'exécution du fichier dans le répertoire /tmp:
  > tar -xzf apigee-4.18.01.tar.gz
  
  Cette commande crée un répertoire nommé dépôts dans le répertoire contenant le fichier .tar. Exemple : /tmp/repos.
4. Installez l'utilitaire Edge apigee-service et les dépendances à partir de /tmp/repos:
  > sudo bash /tmp/repos/bootstrap_4.18.01.sh apigeeProtocol="file://" apigeerepobasepath=/tmp/repos
  
  Notez que vous incluez le chemin d'accès au répertoire des dépôts dans cette commande.
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" dans Installer l'utilitaire de configuration Apigee Edge.
2. Changement des règles :
3. Sur le nœud distant, installez l'utilitaire Edge apigee-service et les dépendances :
  > sudo bash /tmp/bootstrap_4.18.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord
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 Edge 4.15.07.0x, vous devez installer l'utilitaire apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  
  Cette commande installe l'utilitaire update.sh dans /opt/apigee/apigee-setup/bin.
  
  Si vous avez déjà installé l'utilitaire apigee-setup, mettez-le à jour:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
2. Si vous avez installé la version 4.16.01 directement, ce qui signifie que vous n'avez pas effectué de mise à niveau à partir de la version 4.15.07.0x, vous devez mettre à jour l'utilitaire apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  
  Cette mise à jour vers apigee-service installe l'utilitaire update.sh dans /opt.
3. Si vous avez installé la version 4.16.05 directement ou par mise à jour, vous devez mettre à jour l'utilitaire apigee-setup:
  >Cette mise à jour vers apigee-service installe l'utilitaire update.sh dans /opt/apigee/apigee-setup/bin.
Selon votre version actuelle d'Edge, vous devez installer ou mettre à jour l'utilitaire apigee-validate sur le serveur de gestion.
1. Si vous utilisez actuellement Edge 4.16.05: mettez à jour l'utilitaire apigee-validate sur le serveur de gestion:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
2. Si vous utilisez actuellement la commande ci-dessous, procédez comme suit :
3. Si vous effectuez une mise à niveau depuis la version 4.16.01: modifiez le fichier de configuration transmis à l'utilitaire apigee-validate. Dans la version 4.16.01 Edge, le fichier de configuration utilisé par apigee-validate nécessitait les propriétés suivantes:
  APIGEE_ADMINPW=sysAdminPword
  MP_POD=gateway
  REGION=dc-1
  
  Dans cette version, le fichier de configuration ne requiert que la propriété APIGEE_ADMINPW. Vous pouvez supprimer les deux autres propriétés du fichier.
Mettez à jour l'utilitaire apigee-provision:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
Exécutez l'utilitaire de mise à jour sur vos nœuds dans l'ordre indiqué ci-dessous dans la section "Ordre des mises à jour de la machine" ci-dessous:
> /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

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

Utilisez l'option "-c" pour spécifier le composant à mettre à jour. ?
Testez la mise à jour en exécutant l'utilitaire apigee-validate sur le serveur de gestion, comme décrit dans Tester l'installation.
Si vous avez installé un nouveau nœud de secours Postgres, mettez-le hors service comme décrit dans la section Mettre un nœud Postgres hors service.

Pour effectuer un rollback ultérieur de la mise à jour, suivez la procédure décrite dans 4.18.01 Rollback processus.

Ordre des mises à jour de la machine

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

Vous devez mettre à jour tous les nœuds Cassandra et ZooKeeper avant d'en modifier d'autres.
Pour toutes les machines dotées de plusieurs composants Edge (serveur de gestion, processeur de messages, routeur, serveur QPID, mais pas de serveur Postgres), utilisez l'option "-c Edge" pour les mettre à jour simultanément.
Si une étape spécifie qu'elle doit être exécutée sur plusieurs machines, effectuez-la dans l'ordre spécifié.
Il n'y a 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

Définissez SMTPMAILFROM dans votre fichier de configuration si vous avez activé SMTP sur Edge. Ce paramètre est au format suivant:
SMTPMAILFROM="Mon entreprise <monco@entreprise.com>"
En cas de mise à jour depuis la version 4.16.01, revenez à la version antérieure de Zookeeper:
> yum rétrograder apigee-zookeeper.
Mettez à jour Cassandra et ZooKeeper:
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
Définissez la règle iptables suivante:
> sudo iptables -A INPUT -p tcp --destination-port 5672 -s `hostname` -i eth0 -j Drop
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 égal à 0. Vous ne pouvez pas mettre à niveau Qpid tant que tous les messages n'ont pas été traités.
Mettez à jour qpidd:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
Vider les iptables:
> sudo iptables -F
Mettre à jour LDAP:
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
Arrêt de Postgres Server, du serveur Qpid et de PostgreSQL:
> /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
> /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
Mettre à jour postgresql:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
Mettez à jour la base de données Postgres:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
Mettez à jour les composants Edge restants:
> /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
Mettre à jour l'interface utilisateur Edge:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

Pour une installation autonome à deux hôtes

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

Définissez SMTPMAILFROM dans votre fichier de configuration si vous avez activé SMTP sur Edge. Ce paramètre est au format suivant:
SMTPMAILFROM="Mon entreprise <monco@entreprise.com>"
En cas de mise à jour depuis la version 4.16.01, revenez à la version antérieure de Zookeeper sur la machine 1:
> yum rétrograder apigee-zookeeper.
Mettez à jour Cassandra et ZooKeeper sur la machine 1:
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
Définissez la règle iptables suivante sur la machine 2:
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j Drop
Vérifiez la file d'attente des 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 égal à 0. Vous ne pouvez pas mettre à niveau Qpid tant que tous les messages n'ont pas été traités.
Mettez à jour qpidd sur la machine 2:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
Vider les iptables sur la machine 2:
> sudo iptables -F
Mettre à jour LDAP sur la machine 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
Mettez à jour les composants Edge sur la machine 1:
> /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
Mettre à jour l'interface utilisateur sur la machine 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
Mettez à jour postgresql sur la machine 2 :
1. Arrêtez Postgres Server, Qpid Server 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
2. Mettre à jour postgresql:
  > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
3. Mettez à jour la base de données Postgres:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
4. Mettez à jour les composants Edge sur la machine 2:
  > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile

Pour une installation en cluster à cinq hôtes

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

Définissez SMTPMAILFROM dans votre fichier de configuration si vous avez activé SMTP sur Edge. Ce paramètre est au format suivant:
SMTPMAILFROM="Mon entreprise <monco@entreprise.com>"
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.
En cas de mise à jour depuis la version 4.16.01, revenez à une version antérieure de Zookeeper sur les machines 1, 2 et 3:
> yum rétrograder apigee-zookeeper.
Mettez à jour Cassandra et ZooKeeper sur les machines 1, 2 et 3:
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
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
Vérifiez la file d'attente des 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 égal à 0. Vous ne pouvez pas mettre à niveau Qpid tant que tous les messages n'ont pas été traités.
Mettez à jour qpidd sur la machine 4:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
Vider les iptables sur la machine 4:
> sudo iptables -F
Répétez les étapes 5 à 8 sur la machine 5.
Mettre à jour LDAP sur la machine 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
Mettez à jour les composants Edge sur les machines 1, 2 et 3:
> /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
Mettre à jour l'interface utilisateur sur la machine 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
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
2. Arrêt du serveur Postgres, du serveur Qpid et de postgresql sur la machine 5:
  > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
  > /opt/apigee/service/bin/apigee-service Edge-qpid-server arrêt
  > /opt/apigee/apigee-service/bin/apigee-service apigee-post apigee
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. Mettre à jour postgresql sur les machines 4:
  > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
5. Mettez à jour la base de données Postgres sur la machine 4 (maître Postgres uniquement):
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
6. Mettre à jour postgresql sur les machines 5:
  > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
7. Démarrez le serveur Postgres et le serveur Qpid sur les machines 4 et 5:
  > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server start
  > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server start
8. Configurez Postgres en tant que nœud de secours en exécutant les commandes suivantes sur la machine 5:
  > cd /opt/apigee/data/apigee-postgresql/pgdata
  > rm -rf *
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f

Mettez à jour les composants Edge sur la machine 4, 5:
> /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile

Veillez à mettre hors service le nouveau nœud de secours en suivant la procédure ci-dessus décrite dans la section Mettre un nœud Postgres hors service.

Pour une installation en cluster de neuf hôtes

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

Mettez à jour les machines 8 et 9 :
1. 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

Mettez à jour les composants Edge sur les machines 8 et 9:
> /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile

Veillez à mettre hors service le nouveau nœud de secours en suivant la procédure ci-dessus décrite dans la section Mettre un nœud Postgres hors service.

Pour une installation en cluster de 13 hôtes

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

Mettez à jour les machines 8 et 9 :
1. 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

Pour une installation en cluster de 12 hôtes

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

Définissez SMTPMAILFROM dans votre fichier de configuration si vous avez activé SMTP sur Edge. Ce paramètre est au format suivant:
SMTPMAILFROM="Mon entreprise <monco@entreprise.com>"

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.

Mettez à jour Cassandra et ZooKeeper :

Si vous passez de la version 4.16.01 à une version antérieure de Zookeeper sur les versions 1, 2 et 3 de Mackeeper dans le centre de données 1:
> yum rétrograder apigee-zookeeper

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

En cas de mise à jour à partir de la version 4.16.01, revenir à une version antérieure de Zookeeper sur les versions 7, 8 et 9 de Maccare dans le centre de données 2:
> yum

Sur les machines 7, 8 et 9 dans le centre de données 2
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

Mettez à jour Qpidd :

Machines 4, 5 dans le centre de données 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

Vérifiez la file d'attente des 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 égal à 0. Vous ne pourrez pas mettre à niveau Qpid tant qu'elle n'aura pas traité tous les messages.

Mettez à jour qpidd sur la machine 4:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

Vider les iptables sur la machine 4:
> sudo iptables -F

Répétez les étapes 1 à 4 sur la machine 5.

Machines 10 et 11 dans le centre de données 2

Définissez la règle iptables suivante sur la machine 10:
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j Drop

Vérifiez la file d'attente des 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 égal à 0. Vous ne pourrez pas mettre à niveau Qpid tant qu'elle n'aura pas traité tous les messages.

Mettez à jour qpidd sur la machine 10:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

Vider les iptables sur la machine 10:
> sudo iptables -F

Répétez les étapes 1 à 4 sur la machine 11.

Mettez à jour LDAP :

Machines 1 dans centre de données 1
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

Machines 7 dans le centre de données 2
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

Mettez à jour les composants Edge :

Machines 4, 5, 1, 2 et 3 dans le centre de données 1
> /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile

Machines 10, 11, 7, 8 et 9 dans le centre de données 2
> /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile

Mettez à jour l'interface utilisateur :

Machine 1 dans le centre de données 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

Machine 7 dans le centre de données 2:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

Mettez à jour la machine 6 dans les centres de données 1 et 12 du centre de données 2 :
1. 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

Mettez à jour les composants Edge sur les machines 6 et 12:
> /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile

Veillez à mettre hors service le nouveau nœud de secours en suivant la procédure ci-dessus décrite dans la section Mettre un nœud Postgres hors service.

Pour une installation BaaS d'API à 7 ou 10 hôtes

Remarque:La procédure pour mettre à jour une version 4.16.01 ou 4.16.05 de l'API BaaS vers la version 4.18.01 est identique à la procédure de mise à jour d'une version 4.16.09. Consultez la mise à jour d'Apigee Edge 4.16.09 vers la version 4.18.01.

Pour une installation non standard

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

ZooKeeper

Cassandra

Qpidd

LDAP

Edge, qui signifie le profil "-c Edge" sur tous les nœuds de l'ordre: nœuds avec serveur Qpid, mais pas le serveur Postgres, le serveur de gestion, le processeur de messages et le routeur.
Remarque: Si le serveur Qpid et le serveur Postgres sont installés sur le nœud, exécutez l'étape de profil "-c Edge" à l'étape 8.

UI périphérique

postgresql sur le maître Postgres, y compris la mise à niveau.

postgresql dans l'instance de secours Postgres.

Edge, qui correspond au profil "-c Edge" sur tous les nœuds Qpid et Postgres combinés, ou sur tous les nœuds Postgres autonomes.