Google utilise la technologie IA pour traduire le contenu dans votre langue préférée. Les traductions générées par IA peuvent contenir des erreurs.

Mettre à jour Apigee Edge vers la version 4.16.09

Edge for Private Cloud v. 4.16.09

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

Vous pouvez mettre à jour les versions 4.16.01.0x et 4.16.05.x d'Apigee Edge vers la version 4.16.09.

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.16.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 qu'utilisateur racine.

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

Mise à niveau requise vers Java JDK version 8

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

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

Passer à une version antérieure de ZooKeeper en cas de mise à jour depuis la version 4.16.01

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

Vous pouvez vérifier votre version de Zookeeper à l'aide de la commande suivante :

> rpm -qa |grep apigee-zookeeper

Si cette commande renvoie la version de Zookeeper :

apigee-zookeeper-3.4.5-1.0.905

Vous devez ensuite effectuer le changement de version.

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 par la mise à jour.

Conditions préalables à la mise à jour

Avant de mettre à niveau Apigee Edge, assurez-vous de respecter les conditions préalables suivantes :

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

Cela vous permet de disposer d'un plan de secours 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.
S'assurer 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 :

> /<inst_root>/apigee/apigee-service/bin/apigee-all status

Gérer un échec de mise à jour

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

Si l'échec nécessite un rollback de la mise à jour vers la version précédente, consultez Processus de rollback de la version 4.16.09 pour en savoir plus.

Informations sur la mise à jour de la journalisation

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

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

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

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

Mise à niveau requise vers Postgres 9.4

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

Pendant le processus de mise à jour, lorsque les nœuds Postgres sont indisponibles, les données d'analyse sont toujours écrites sur les nœuds Qpid. Une fois les nœuds Postgres mis à jour et de 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 maître Postgres après le rollback. Par conséquent, lorsque vous installez le nouveau nœud de secours Postgres, il doit se trouver sur un nœud qui répond à toutes les exigences matérielles d'un serveur Postgres, telles que définies 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.16.09.

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

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

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

conf_pg_hba_replication.connection=host replication apigee existing_slave_ip/32 trust\ \nhost replication apigee new_slave_ip/32 trust

où existing_slave_ip est l'adresse IP du serveur de secours Postgres actuel et new_slave_ip est l'adresse IP du nouveau nœud de secours.
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é ajouté en consultant le fichier /opt/apigee/apigee-postgresql/conf/pg_hba.conf sur le nœud maître. Les lignes suivantes doivent s'afficher dans ce fichier :
host replication apigee existing_slave_ip/32 trust
host replication apigee new_slave_ip/32 trust
Installez le nouveau serveur Postgres de secours :
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 master 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 apigee-setup d'Edge.
3. Téléchargez le fichier Edge bootstrap_4.16.05.sh dans /tmp/bootstrap_4.16.05.sh :
  > curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
  
  Remarque : Si vous effectuez la mise à jour à partir de la version 4.16.01, téléchargez le fichier Edge bootstrap.sh.
4. Installez l'utilitaire apigee-service d'Edge et ses dépendances :
  > sudo bash /tmp/bootstrap_4.16.05.sh apigeeuser=uName apigeepassword=pWord
5. Utilisez apigee-service pour installer l'utilitaire apigee-setup :
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
6. Installez Postgres :
  > /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
7. Sur le nouveau nœud de secours, exécutez la commande suivante :
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
  
  Vérifiez qu'il s'agit bien du nœud de secours.

Mettre hors service un nœud Postgres

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
Obtenez l'UUID du nouveau nœud de secours en exécutant la commande cURL suivante sur le nouveau nœud de secours :
> curl -u sysAdminEmail:password http://<node_IP>:8084/v1/servers/self

L'UUID du nœud doit s'afficher à la fin du résultat, sous la forme suivante :
"type" : [ "postgres-server" ],
"uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
Arrêtez le nouveau nœud de secours en exécutant la commande suivante sur le nouveau nœud de secours :
> /opt/apigee/apigee-service/bin/apigee-all stop
Sur le nœud maître Postgres, modifiez /opt/apigee/customer/application/postgresql.properties pour supprimer le nouveau nœud de secours de conf_pg_hba_replication.connection :
conf_pg_hba_replication.connection=host replication apigee existing_slave_ip/32 trust
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 nœud maître. Vous ne devriez voir que la ligne suivante dans ce fichier :
host replication apigee existing_slave_ip/32 trust
Supprimez l'UUID du nœud de secours de ZooKeeper en effectuant l'appel d'API de gestion Edge suivant sur le nœud du serveur de gestion :
> curl -u sysAdminEmail:password -X DELETE http://<ms_IP>:8080/v1/servers/<new_slave_uuid>

Mise à jour sans temps d'arrêt

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

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, un par un, de l'équilibreur de charge. Vous mettez ensuite à jour le routeur et tous les autres composants sur la même machine que le routeur, puis vous ajoutez à nouveau le routeur à l'équilibreur de charge.

Mettez à jour les machines dans l'ordre approprié pour votre installation, comme décrit ci-dessous dans la section "Ordre de mise à jour des machines".
Lorsque vous devez 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).
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 à nouveau accessible.
Répétez les étapes 2 à 4 pour les routeurs restants.
Poursuivez la mise à jour pour toutes les machines restantes de votre installation.

Tenez compte des points suivants avant/après la mise à jour :

Sur le nœud combiné du routeur et du processeur de messages :
- 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. Rendez le processeur de messages accessible.
  2. Rendre le routeur accessible.
Sur un seul nœud de routeur :
- Avant la mise à jour, rendez le routeur inaccessible.
- Après la mise à jour, 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.

Utiliser un fichier de configuration silencieux

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.16.01 ou 4.16.05.

Procédure de mise à jour vers la version 4.16.09 sur un nœud disposant d'une connexion Internet externe

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

Si vous utilisez actuellement la réplication maître-secours Postgres, installez un nouveau nœud de secours Postgres comme décrit ci-dessus dans Installer un nouveau nœud de secours Postgres.
Le cas échéant, désactivez les jobs Cron configurés pour effectuer une opération de réparation sur Cassandra jusqu'à ce que la mise à jour soit terminée.
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 configurer Edge sans accès racine.
Désactivez SELinux comme décrit dans Installer l'utilitaire apigee-setup d'Edge.
Téléchargez le fichier bootstrap_4.16.09.sh d'Edge 4.16.09 dans /tmp/bootstrap_4.16.09.sh :
> curl https://software.apigee.com/bootstrap_4.16.09.sh -o /tmp/bootstrap_4.16.09.sh
Installez l'utilitaire apigee-service et les dépendances d'Edge 4.16.09 :
> sudo bash /tmp/bootstrap_4.16.09.sh apigeeuser=uName apigeepassword=pWord

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

Par défaut, le programme d'installation vérifie que Java 1.8 est installé. 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 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 Edge version 4.15.07.0x, vous devez installer l'utilitaire apigee-setup :
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  
  Cette commande installe l'utilitaire update.sh dans <inst_dir>/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, c'est-à-dire 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 d'apigee-service installe l'utilitaire update.sh dans <inst_dir>/apigee/apigee-setup/bin.
3. Si vous avez installé la version 4.16.05 directement ou par mise à jour, vous devez mettre à jour l'utilitaire apigee-setup :
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  
  Cette mise à jour d'apigee-service installe l'utilitaire update.sh dans <inst_dir>/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 Edge 4.16.01 : installez l'utilitaire apigee-validate sur le serveur de gestion :
  > /opt/apigee/apigee-service/bin/apigee-service apigee-validate install
  
  Remarque : Si vous avez installé l'utilitaire apigee-validate sur un nœud de processeur de messages lors de l'installation de la version 4.16.01, vous pouvez le mettre à jour à l'aide de la commande suivante sur ce nœud :
  > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  
  Toutefois, à partir de la version 4.16.05, Apigee vous recommande d'installer et d'exécuter l'utilitaire apigee-validate sur le serveur de gestion.
3. Si vous effectuez une mise à niveau à partir de la version 4.16.01 : modifiez le fichier de configuration transmis à l'utilitaire apigee-validate. Dans la version 4.16.01 d'Edge, le fichier de configuration utilisé par apigee-validate nécessitait les propriétés suivantes :
  APIGEE_ADMINPW=sysAdminPword
  MP_POD=gateway
  REGION=dc-1
  
  Dans cette version, le fichier de configuration ne nécessite que la propriété APIGEE_ADMINPW. Vous pouvez supprimer les deux autres propriétés du fichier.
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 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'interface utilisateur Edge : serveur de gestion, processeur de messages, routeur, serveur QPID, serveur Postgres
ui = interface utilisateur Edge
all = met à jour tous les composants de la machine (à utiliser uniquement pour un profil d'installation Edge aio ou un profil d'installation API BaaS asa)
e = ElasticSearch
b = pile API BaaS
p = portail API BaaS
ebp = ElasticSearch, pile API BaaS et portail API BaaS sur le même nœud
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 ci-dessus dans Mettre hors service un nœud Postgres.

Pour effectuer un rollback de la mise à jour ultérieurement, suivez la procédure décrite dans Processus de rollback de la version 4.16.09.

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

Si vos nœuds Edge se trouvent derrière un pare-feu ou si l'accès au dépôt Apigee via Internet est interdit, vous pouvez effectuer la mise à jour à partir d'un dépôt local ou d'un 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 avec le dépôt local afin que les autres nœuds puissent y accéder. Apigee fournit le serveur Web Nginx, mais vous pouvez utiliser votre propre serveur Web.

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

Si vous utilisez actuellement la réplication maître-secours Postgres, installez un nouveau nœud de secours Postgres comme décrit ci-dessus dans Installer un nouveau nœud de secours Postgres.
Créez un dépôt 4.16.09 local comme décrit dans la section "Créer un dépôt Apigee local" de la page Installer l'utilitaire apigee-setup d'Edge.
Remarque : Si vous disposez déjà d'un dépôt 4.16.01 ou 4.16.05, vous pouvez y ajouter le dépôt 4.16.09, comme décrit dans la section "Mettre à jour un dépôt Apigee local" de la page Installer l'utilitaire apigee-setup d'Edge.
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.16.09.tar.gz :
  > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
2. Copiez le fichier .tar sur le nœud sur lequel 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.16.09.tar.gz
  
  Cette commande crée un répertoire nommé repos dans le répertoire contenant le fichier .tar. Par exemple, /tmp/repos.
4. Installez l'utilitaire apigee-service d'Edge et les dépendances à partir de /tmp/repos :
  > sudo bash /tmp/repos/bootstrap_4.16.09.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" de la page Installer l'utilitaire apigee-setup d'Edge.
2. Sur le nœud distant, téléchargez le fichier Edge bootstrap_4.16.09.sh dans /tmp/bootstrap_4.16.09.sh :
  > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.16.09.sh -o /tmp/bootstrap_4.16.09.sh
  
  où uName:pWord sont le nom d'utilisateur et le mot de passe que vous avez définis ci-dessus pour le dépôt, et remoteRepo est l'adresse IP ou le nom DNS du nœud du dépôt.
3. Sur le nœud distant, installez l'utilitaire apigee-service d'Edge et les dépendances :
  > sudo bash /tmp/bootstrap_4.16.09.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
  
  où uName:pWord sont le nom d'utilisateur et le mot de passe du dépôt.
Utilisez apigee-service pour mettre à jour l'utilitaire apigee-setup :
1. Si vous avez installé la version 4.16.01 en mettant à niveau Edge version 4.15.07.0x, vous devez installer l'utilitaire apigee-setup :
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  
  Cette commande installe l'utilitaire update.sh dans <inst_dir>/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, c'est-à-dire 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 d'apigee-service installe l'utilitaire update.sh dans <inst_dir>/apigee/apigee-setup/bin.
3. Si vous avez installé la version 4.16.05 directement ou par mise à jour, vous devez mettre à jour l'utilitaire apigee-setup :
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  
  Cette mise à jour d'apigee-service installe l'utilitaire update.sh dans <inst_dir>/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 Edge 4.16.01 : installez l'utilitaire apigee-validate sur le serveur de gestion :
  > /opt/apigee/apigee-service/bin/apigee-service apigee-validate install
  
  Remarque : Si vous avez installé l'utilitaire apigee-validate sur un nœud de processeur de messages lors de l'installation de la version 4.16.01, vous pouvez le mettre à jour à l'aide de la commande suivante sur ce nœud :
  > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  
  Toutefois, à partir de la version 4.16.05, Apigee vous recommande d'installer et d'exécuter l'utilitaire apigee-validate sur le serveur de gestion.
3. Si vous effectuez une mise à niveau à partir de la version 4.16.01 : modifiez le fichier de configuration transmis à l'utilitaire apigee-validate. Dans la version 4.16.01 d'Edge, le fichier de configuration utilisé par apigee-validate nécessitait les propriétés suivantes :
  APIGEE_ADMINPW=sysAdminPword
  MP_POD=gateway
  REGION=dc-1
  
  Dans cette version, le fichier de configuration ne nécessite que la propriété APIGEE_ADMINPW. Vous pouvez supprimer les deux autres propriétés du fichier.
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 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'interface utilisateur Edge : serveur de gestion, processeur de messages, routeur, serveur QPID, serveur Postgres
ui = interface utilisateur Edge
all = met à jour tous les composants de la machine (à utiliser uniquement pour un profil d'installation Edge aio ou un profil d'installation API BaaS asa)
e = ElasticSearch
b = pile API BaaS
p = portail API BaaS
ebp = ElasticSearch, pile API BaaS et portail API BaaS sur le même nœud
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 ci-dessus dans Mettre hors service un nœud Postgres.

Pour effectuer un rollback de la mise à jour ultérieurement, suivez la procédure décrite dans Processus de rollback de la version 4.16.09.

Ordre de mise à jour des machines

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 les autres nœuds.
Pour toute machine dotée de plusieurs composants Edge (Management Server, Processeur de messages, Router, QPID Server, mais pas Postgres Server), utilisez l'option "-c edge" pour les mettre à jour simultanément.
Si une étape indique qu'elle doit être effectuée sur plusieurs machines, effectuez-la dans l'ordre spécifié.
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".