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

Mise à jour d'Apigee Edge 4.50.00 ou 4.51.00 vers la version 4.52.00

Apigee permet de mettre à niveau Edge for Private Cloud de la version 4.50.00 ou de la version 4.51.00 directement vers la version 4.52.00. Cette page explique comment effectuer ces deux mises à niveau.

Qui peut effectuer la mise à jour

La personne qui exécute la mise à jour doit être la même que celle qui a installé Edge à l'origine ou une personne qui s'exécute en tant qu'utilisateur root.

Après avoir installé les RPM Edge, n'importe qui peut les configurer.

Composants à mettre à jour

Vous devez mettre à jour tous les composants Edge. Edge n'est pas compatible avec les configurations contenant des composants de plusieurs versions.

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é, nous vous recommandons d'effectuer une sauvegarde complète de tous les nœuds avant d'effectuer la mise à jour. Suivez la procédure correspondant à votre version actuelle d'Edge pour effectuer la sauvegarde.
Vous disposez ainsi d'un plan de sauvegarde au cas où la mise à jour vers une nouvelle version ne fonctionnerait pas correctement. Pour en savoir plus sur la sauvegarde, consultez la page Sauvegarde et restauration.
Assurez-vous qu'Edge est en cours d'exécution
Assurez-vous qu'Edge est opérationnel pendant le processus de mise à jour à l'aide de la commande suivante :
```
/opt/apigee/apigee-service/bin/apigee-all status
```
Assurez-vous que la stratégie de compatification de Cassandra est LeveledCompactionStrategy
Assurez-vous que la stratégie de compatification de Cassandra est définie sur LeveledCompactionStrategy, comme décrit dans la section Modifier la stratégie de compactage de Cassandra.

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.

Mise à niveau requise vers Zookeeper 3.8.0

Cette version d'Edge for Private Cloudes inclut une mise à niveau vers Zookeeper 3.8.0. Dans le cadre de cette mise à niveau, toutes les données de Zookeeper seront migrées vers Zookeeper 3.8.0.

Avant de mettre à niveau ZooKeeper, consultez le guide de maintenance de ZooKeeper. La plupart des systèmes de production Edge utilisent un cluster de nœuds Zookeeper répartis dans plusieurs centres de données. Certains de ces nœuds sont configurés en tant que votants qui participent à l'élection du responsable Zookeeper, tandis que les autres sont configurés en tant qu'observateurs. Pour en savoir plus, consultez la section À propos des dirigeants, des abonnés, des électeurs et des observateurs. Les nœuds électoraux élitent un responsable, après quoi ces nœuds deviennent eux-mêmes des abonnés.

Au cours du processus de mise à jour, il peut y avoir un délai momentané ou un échec d'écriture dans Zookeeper lorsque le nœud principal est arrêté. Cela peut affecter les opérations de gestion qui écrivent dans Zookeeper, telles que l'opération de déploiement d'un proxy et les modifications de l'infrastructure Apigee, telles que l'ajout ou la suppression d'un processeur de messages, etc. Cela ne devrait avoir aucun impact sur les API d'exécution d'Apigee (sauf si ces API de gestion des appels d'API d'exécution) lors de la mise à niveau de Zookeeper, tout en suivant la procédure ci-dessous.

De manière générale, le processus de mise à niveau implique une sauvegarde de chaque nœud. Ensuite, mettez à niveau tous les observateurs et followers, puis mettez à niveau le nœud principal.

Effectuer une sauvegarde

Effectuez une sauvegarde de tous les nœuds de Zookeeper pour l'utiliser au cas où un rollback serait nécessaire. Notez qu'un rollback restaurera Zookeeper à l'état d'origine de la sauvegarde. Remarque:Tous les déploiements ou modifications d'infrastructure dans Apigee depuis la sauvegarde (dont les informations sont stockées dans Zookeeper) seront perdus pendant la restauration.

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper backup

Si vous utilisez des machines virtuelles et que vous en avez la capacité, des instantanés ou des sauvegardes de VM peuvent également être réalisés à des fins de restauration ou de rollback (si nécessaire).

Identifier les dirigeants, les followers et les observateurs

Remarque:Les exemples de commandes ci-dessous utilisent l'utilitaire nc pour envoyer des données à Zookeeper. Vous pouvez également utiliser d'autres utilitaires pour envoyer des données à Zookeeper.

S'il n'est pas installé sur le nœud ZooKeeper, installez nc :
```
  sudo yum install nc
```
Exécutez la commande nc suivante sur le nœud, où 2181 correspond au port ZooKeeper :
```
  echo stat | nc localhost 2181
```
Vous devriez voir une sortie semblable à ce qui suit.
```
  Zookeeper version: 3.8.0-5a02a05eddb59aee6ac762f7ea82e92a68eb9c0f, built on 2022-02-25 08:49 UTC
  Clients:
   /0:0:0:0:0:0:0:1:41246[0](queued=0,recved=1,sent=0)
  
  Latency min/avg/max: 0/0.2518/41
  Received: 647228
  Sent: 647339
  Connections: 4
  Outstanding: 0
  Zxid: 0x400018b15
  Mode: follower
  Node count: 100597
```
Sur la ligne Mode du résultat des nœuds, vous devriez voir un observateur, un leader ou un followers (c'est-à-dire un votant qui n'est pas le responsable) en fonction de la configuration du nœud. Remarque:Dans une installation autonome d'Edge avec un seul nœud ZooKeeper, Mode est défini comme autonome.
Répétez les étapes 1 et 2 sur chaque nœud ZooKeeper.

Mettre à niveau ZooKeeper sur les nœuds d'observateur et de followers

Mettez à niveau ZooKeeper sur chacun des nœuds d'observateur et de followers comme suit:

Téléchargez et exécutez l'amorçage d'Edge pour le cloud privé 4.52, comme décrit dans la section Mise à jour vers la version 4.52.00 sur un nœud avec une connexion Internet externe. Le processus varie probablement selon que le nœud dispose d'une connexion Internet externe ou que vous effectuez une installation hors connexion.
Mettez à niveau le composant Zookeeper :
```
  /opt/apigee/apigee-setup/bin/update.sh -c zk -f <silent-config-file>
```
Remarque:Si d'autres composants sont installés sur ces nœuds (comme Cassandra), vous pouvez les mettre à niveau maintenant (comme avec le profil cs,zk) ou les autres composants ultérieurement. Apigee vous recommande de ne mettre à niveau Zookeeper qu'une première fois et de vous assurer que votre cluster fonctionne correctement avant de mettre à niveau d'autres composants.
Répétez les étapes ci-dessus sur chaque nœud d'observateur et de followers Zookeeper.

Arrêter la variante optimale

Une fois tous les nœuds d'observateur et esclaves mis à niveau, arrêtez la variante optimale. Sur le nœud identifié comme responsable, exécutez la commande ci-dessous :

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop

Notez que pendant cet événement, avant l'élection d'un nouveau responsable, des retards temporaires ou des échecs d'écriture peuvent se produire dans Zookeeper. Cela peut affecter les opérations d'écriture dans Zookeeper telles que l'action de déploiement de proxys ou les modifications de l'infrastructure Apigee, telles que l'ajout ou la suppression de processeurs de messages, etc.

Vérifier que le nouveau responsable est élu

En suivant les étapes de la section Identifier le dirigeant, les followers et les observateurs ci-dessus, vérifiez qu'un nouveau responsable a été élu parmi les followers, une fois le responsable existant arrêté. Notez que le dirigeant aurait pu être élu dans un centre de données différent de celui du responsable actuel.

Mettre à niveau le responsable

Suivez la même procédure que dans Mettre à niveau Zookeeper sur les nœuds observateur et followers ci-dessus.

Une fois l'ancien nœud maître mis à niveau, vérifiez l'état du cluster et assurez-vous qu'il existe un nœud principal.

Rollback

Si un rollback est nécessaire:

Effectuez d'abord des étapes de rollback sur les observateurs et les followers.
Téléchargez et exécutez l'amorçage de la version vers laquelle vous effectuez le rollback : 4.50 ou 4.51. Le processus variera probablement selon que le nœud dispose d'une connexion Internet externe ou que vous suivez une installation hors connexion.

Arrêtez Zookeeper s'il est en cours d'exécution sur le nœud :

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop

Désinstaller le zookeeper existant :

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper uninstall

Installez ZooKeeper comme d'habitude :

  /opt/apigee/apigee-setup/bin/setup.sh -p zk -f <silent-config-file>

Une fois le rollback de tous les followers et observateurs, effectuez le rollback du nœud principal en suivant les étapes 2 à 5 sur le nœud principal.

Une fois le rollback de tous les nœuds effectué, vérifiez l'état du cluster et assurez-vous qu'il existe un nœud principal.

Restauration depuis une sauvegarde

Consultez Restaurer à partir d'une sauvegarde. Notez que les sauvegardes de Zookeeper effectuées à partir de versions antérieures d'Edge for Private Cloud, telles que 4.50 et 4.51, doivent être compatibles avec la version de Zookeeper dans Edge pour Private Cloud 4.52.

Mise à niveau vers Postgres 14 requise

Cette version d'Edge inclut une mise à niveau vers Postgres 14. Lors de cette mise à niveau, toutes les données Postgres sont migrées vers Postgres 14.

La plupart des systèmes de production Edge utilisent deux nœuds Postgres configurés pour la réplication en attente du maître. Pendant le processus de mise à jour, lorsque les nœuds Postgres sont arrêtés pour la mise à jour, les données d'analyse sont toujours écrites dans les nœuds Qpid. Une fois les nœuds Postgres mis à jour et de nouveau en ligne, les données d'analyse sont envoyées aux nœuds Postgres.

La manière dont vous effectuez la mise à jour de Postgres dépend de la configuration du stockage des données pour vos nœuds Postgres:

Si vous utilisez un stockage de données local pour vos nœuds Postgres, vous devez installer un nouveau nœud de secours Postgres pour la durée de la mise à niveau. Une fois la mise à niveau terminée, vous pouvez mettre le nouveau nœud de secours Postgres hors service.
Le nœud de secours Postgres supplémentaire est nécessaire 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, telles que définies dans la section Configuration requise pour l'installation d'Edge.

Dans une configuration Edge à un nœud et à deux nœuds, les topologies utilisées pour le prototypage et les tests, vous ne disposez que d'un seul nœud Postgres. Vous pouvez mettre à jour ces nœuds Postgres directement sans avoir à créer un nouveau nœud Postgres.
Si vous utilisez un stockage réseau pour vos nœuds Postgres, comme recommandé par Apigee, vous n'avez pas besoin d'installer un nouveau nœud Postgres. Dans les procédures ci-dessous, vous pouvez ignorer les étapes indiquant d'installer et de mettre hors service un nouveau nœud de secours Postgres.
Avant de commencer le processus de mise à jour, prenez un instantané du réseau du datastore utilisé par Postgres. Ensuite, si des erreurs se produisent lors de la mise à jour et que vous êtes obligé d'effectuer un rollback, vous pouvez restaurer le nœud Postgres à partir de cet instantané.

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.50.00 ou 4.51.00), et non pour la version 4.52.00.

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, procédez comme suit:

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 replication apigee existing_standby_ip/32 trust\ \nhost replication apigee new_standby_ip/32 trust
```
Où existing_standby_ip est l'adresse IP du serveur de secours Postgres actuel, et new_standby_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 affichant le fichier /opt/apigee/apigee-postgresql/conf/pg_hba.conf sur le maître. Les lignes suivantes doivent s'afficher dans ce fichier :
```
host replication apigee existing_standby_ip/32 trust
host replication apigee new_standby_ip/32 trust
```
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 :
```
# IP address of the current master:
PG_MASTER=192.168.56.103
# IP address of the new standby node
PG_STANDBY=192.168.56.102
```
2. Désactivez SELinux comme décrit dans la section Installer l'utilitaire de configuration Edge de Apigee.
3. Si vous utilisez actuellement Edge 4.51.00:
  1. Téléchargez le fichier Edge bootstrap_4.51.00.sh dans /tmp/bootstrap_4.51.00.sh :
```
curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
```
  2. Installez l'utilitaire et les dépendances apigee-service d'Edge :
```
sudo bash /tmp/bootstrap_4.51.00.sh apigeeuser=uName apigeepassword=pWord
```
  Si vous utilisez actuellement Edge 4.50.00:
  1. Téléchargez le fichier Edge bootstrap_4.50.00.sh dans /tmp/bootstrap_4.50.00.sh :
```
curl https://software.apigee.com/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.00.sh
```
  2. Installez l'utilitaire et les dépendances apigee-service d'Edge :
```
sudo bash /tmp/bootstrap_4.50.00.sh apigeeuser=uName apigeepassword=pWord
```
4. Utilisez apigee-service pour installer l'utilitaire apigee-setup :
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
```
5. Installez Postgres :
```
/opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
```
6. 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 de l'instance de secours.

Effectuer une mise à niveau sur place de Postgres

Remarque:Vous devez effectuer l'étape préliminaire suivante avant d'effectuer une mise à niveau sur place de Postgres.

Remarque:Avec Postgres 14, le paramètre de configuration de Postgres wal_keep_segments n'est plus accepté. Si vous avez ajouté ou modifié ce paramètre Postgres, vous devez le supprimer avant d'effectuer la mise à niveau de Postgres. Pour ce faire :

Ouvrez le fichier $APIGEE_ROOT/customer/application/postgresql.properties.
Supprimez la configuration liée à wal_keep_segments.
Redémarrez Postgres.

Étape préliminaire

Avant d'effectuer une mise à niveau sur place vers Postgres, procédez comme suit sur l'hôte maître et sur l'instance de secours pour mettre à jour la propriété max_locks_per_transaction sur apigee-postgresql:

S'il n'est pas présent, créez le fichier /opt/apigee/customer/application/postgresql.properties.

Renommez la propriété de ce fichier en apigee :

sudo chown apigee:apigee /opt/apigee/customer/application/postgresql.properties

Ajoutez la propriété suivante au fichier :

conf/postgresql.conf+max_locks_per_transaction=30000

Configurer apigee-postgresql :

apigee-service apigee-postgresql configure

Redémarrez apigee-postgresql :

apigee-service apigee-postgresql restart

Effectuer la mise à niveau sur place

Pour effectuer une mise à niveau sur place vers Postgres 14, procédez comme suit:

Mettre à niveau postgres sur l'hôte maître

/opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf

Exécutez la commande de configuration sur l'hôte maître :
```
apigee-service apigee-postgresql setup -f /opt/silent.conf
```
Exécutez la commande de configuration sur l'hôte maître :
```
apigee-service apigee-postgresql configure
```

Redémarrez l'hôte maître :

apigee-service apigee-postgresql restart

Configurez-la en tant que maître :

apigee-service apigee-postgresql setup-replication-on-master -f /opt/silent.conf

Assurez-vous que l'hôte maître a démarré :

apigee-service apigee-postgresql wait_for_ready

Arrêtez l'instance de secours :
```
apigee-service apigee-postgresql stop
```
Mettez à niveau l'instance de secours.
Remarque:Si cette étape échoue ou échoue, vous pouvez l'ignorer. update.sh tente de démarrer le serveur de secours avec une configuration incorrecte. Si l'installation de Postgres est mise à niveau vers la version 14, l'erreur peut être ignorée.
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
```
Assurez-vous que l'instance de secours est arrêtée :
```
apigee-service apigee-postgresql stop
```
Supprimez l'ancienne configuration de secours :
```
rm -rf /opt/apigee/data/apigee-postgresql/
```

Configurez la réplication sur le serveur de secours :

apigee-service apigee-postgresql setup-replication-on-standby -f /opt/silent.conf

Supprimez la ligne conf/postgresql.conf+max_locks_per_transaction=30000 du fichier /opt/apigee/customer/application/postgresql.properties à la fois sur l'hôte maître et sur l'hôte de secours. Cette ligne a été ajoutée lors de l'étape préliminaire.

Une fois cette procédure terminée, l'instance de secours démarrera correctement.

Mettre un nœud Postgres hors service

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

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, au format suivant :
```
"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_standby_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 affichant le fichier /opt/apigee/apigee-postgresql/conf/pg_hba.conf sur le maître. Seule la ligne suivante devrait s'afficher dans ce fichier :
```
host replication apigee existing_standby_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_standby_uuid
```

Nouvelle interface utilisateur Edge

Cette section répertorie les considérations relatives à l'interface utilisateur Edge. Pour plus d'informations, voir La nouvelle interface utilisateur Edge pour cloud privé.

Installer l'interface utilisateur Edge

Une fois l'installation initiale terminée, Apigee vous recommande d'installer l'interface utilisateur Edge, qui est une interface utilisateur améliorée pour les développeurs et les administrateurs d'Apigee Edge for Private Cloud.

Notez que l'interface utilisateur Edge nécessite que vous désactiviez l'authentification de base et que vous utilisiez un IdP tel que SAML ou LDAP.

Pour plus d'informations, voir Installer la nouvelle interface utilisateur Edge.

Mettre à jour l'interface utilisateur Edge

Pour mettre à jour le composant d'interface utilisateur Edge, prenez en compte la version d'Edge pour le cloud privé à partir de laquelle vous effectuez la mise à niveau:

De la version 4.51.00 à la version 4.52.00 (avec la nouvelle interface utilisateur Edge installée): suivez les instructions de mise à niveau de cette section pour le composant edge-management-ui.

Effectuer la mise à jour avec Apigee mTLS

Pour mettre à jour Apigee mTLS , procédez comme suit:

Restaurer une 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 et elle reprend là où elle s'était arrêtée.

Si l'échec nécessite un rollback vers la version précédente, consultez la page Effectuer un rollback vers la version 4.52.00 pour obtenir des instructions détaillées.

Informations sur les mises à jour des journaux

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

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

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

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

Mise à jour sans temps d'arrêt

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

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

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

Mettez à jour les machines dans le bon ordre pour votre installation, comme indiqué dans l'article Ordre des mises à jour des machines.
Au moment de mettre à jour les routeurs, sélectionnez un routeur et rendez-le inaccessible, comme décrit dans la section Activer/Désactiver la joignabilité du serveur (processeur de messages/routeur).
Mettez à jour le routeur sélectionné et tous les autres composants Edge sur la même machine que le routeur. Toutes les configurations Edge montrent un routeur et un processeur de messages sur le même nœud.
Rendez le routeur à nouveau accessible.
Répétez les étapes 2 à 4 pour les autres routeurs.
Continuez la mise à jour pour toutes les machines restantes de votre installation.

Prenez les mesures suivantes avant et après la mise à jour:

Sur un nœud de routeur et de processeur de messages combiné :
- Avant la mise à jour, effectuez les opérations suivantes :
  1. Rendez 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.
- Après la mise à jour, rendez le routeur accessible.
Sur un nœud de processeur de messages unique :
- 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 silencieuse à la commande update. Le fichier de configuration silencieuse doit être le même que celui que vous avez utilisé pour installer Edge 4.50.00 ou 4.51.00.

Mettre à jour vers la version 4.52.00 sur un nœud avec une connexion Internet externe

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

Le cas échéant, désactivez toutes les tâches cron configurées pour effectuer une opération de réparation sur Cassandra jusqu'à la fin de la mise à jour.
Connectez-vous à votre nœud en tant que racine pour installer les RPM Edge.
REMARQUE:Bien que l'installation RPM nécessite un accès racine, vous pouvez effectuer une configuration Edge sans accès racine.
Installez yum-utils et yum-plugin-priorities :
Remarque:Si votre système d'exploitation est RHEL 8.0 à 8.6, ignorez cette étape.
```
sudo yum install yum-utils
sudo yum install yum-plugin-priorities
```
Désactivez SELinux comme décrit dans la section Installer l'utilitaire de configuration Edge de Apigee.
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

Si vous utilisez actuellement Edge 4.51.00:
1. Téléchargez le fichier Edge bootstrap_4.52.00.sh dans /tmp/bootstrap_4.52.00.sh :
```
curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
```
2. Installez l'utilitaire apigee-service et les dépendances Edge 4.52.00 en exécutant la commande suivante :
```
sudo bash /tmp/bootstrap_4.52.00.sh apigeeuser=uName apigeepassword=pWord
```
  Où uName:pWord sont le nom d'utilisateur et le mot de passe que vous avez reçus de la part d'Apigee. 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, le programme d'installation l'installe pour vous.
  
  Utilisez l'option JAVA_FIX pour spécifier comment gérer l'installation Java. JAVA_FIX peut avoir les valeurs suivantes:
  - I: installer OpenJDK 1.8 (par défaut)
  - C: continuer sans installer Java.
  - Q: quitter. Pour utiliser cette option, vous devez installer Java vous-même.
3. Utilisez apigee-service pour mettre à jour l'utilitaire apigee-setup, comme le montre l'exemple suivant :
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
```
4. Mettez à jour l'utilitaire apigee-validate sur le serveur de gestion, comme indiqué dans l'exemple suivant :
```
/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
```
5. Mettez à jour l'utilitaire apigee-provision sur le serveur de gestion, comme indiqué dans l'exemple suivant :
```
/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
```
6. Exécutez l'utilitaire update sur vos nœuds à l'aide de la commande suivante :
```
/opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
```
  Effectuez les opérations dans l'ordre décrit dans la section Ordre des mises à jour des machines.
  
  Où :
  - component est le composant Edge à mettre à jour. Les valeurs possibles sont les suivantes :
    - cs: Cassandra
    - edge: tous les composants Edge à l'exception de l'interface utilisateur Edge: serveur de gestion, processeur de messages, routeur, serveur QPID, serveur Postgres
    - ldap: OpenLDAP
    - ps: postgresql
    - qpid: qpidd
    - sso: Apigee SSO (si vous avez installé l'authentification unique)
    - ue: nouvelle interface utilisateur Edge
    - ui: interface utilisateur Classic Edge
    - zk: Zookeeper
  - configFile est le même fichier de configuration que celui que vous avez utilisé pour définir vos composants Edge lors de l'installation de la version 4.50.00 ou 4.51.00.
  Vous pouvez exécuter update.sh sur tous les composants en définissant component sur "tous", mais uniquement si vous disposez d'un profil d'installation Edge tout-en-un (AIO). Exemple :
```
/opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
```
7. Si vous ne l'avez pas déjà fait, redémarrez le composant d'interface utilisateur Edge sur tous les nœuds qui l'exécutent :
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```
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.
Si vous décidez ultérieurement d'effectuer un rollback de la mise à jour, suivez la procédure décrite dans la section Effectuer un rollback de la version 4.52.00.

Passer à la version 4.52.00 à partir d'un dépôt local

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

Après avoir créé un dépôt Edge local, vous disposez de deux options pour mettre à jour Edge à partir du dépôt local:
- Créez un fichier .tar du dépôt, copiez-le sur un nœud, puis mettez à jour Edge à partir du fichier .tar.
- Installez un serveur Web sur le nœud contenant le dépôt local afin que les autres nœuds puissent y accéder. Apigee met à votre disposition le serveur Web Nginx, mais vous pouvez utiliser votre propre serveur Web.
Pour effectuer la mise à jour à partir d'un dépôt local 4.52.00:
1. Créez un dépôt local 4.52.00 comme décrit dans la section "Créer un dépôt Apigee local" de la page Installer l'utilitaire de configuration Edge de Apigee.
  REMARQUE:Si vous disposez déjà d'un dépôt existant, vous pouvez y ajouter le dépôt 4.52.00, comme indiqué dans la section "Mettre à jour un dépôt Apigee local" de la page Installer l'utilitaire de configuration Edge d'apigee.
2. Pour installer apigee-service à partir d'un fichier .tar :
  1. Sur le nœud contenant 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.52.00.tar.gz :
```
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
```
  2. Copiez le fichier .tar sur le nœud dans 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.52.00.tar.gz
```
    Cette commande crée un répertoire, nommé repos, dans le répertoire contenant le fichier .tar. Exemple : /tmp/repos.
  4. Installez l'utilitaire apigee-service Edge et les dépendances à partir de /tmp/repos :
```
sudo bash /tmp/repos/bootstrap_4.52.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
```
    Notez que vous incluez dans cette commande le chemin d'accès au répertoire du dépôt.
3. Pour installer apigee-service à l'aide du serveur Web Nginx:
  1. Configurez le serveur Web Nginx comme décrit dans la section "Installer à partir du dépôt à l'aide du serveur Web Nginx" de la section Installer l'utilitaire Edge apigee-setup.
  2. Sur le nœud distant, téléchargez le fichier Edge bootstrap_4.52.00.sh dans /tmp/bootstrap_4.52.00.sh :
```
/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.52.00.sh -o /tmp/bootstrap_4.52.00.sh
```
    Où uName:pWord correspond au nom d'utilisateur et au mot de passe que vous avez définis précédemment pour le dépôt, et remoteRepo à l'adresse IP ou au nom DNS du nœud de dépôt.
  3. Sur le nœud distant, installez l'utilitaire apigee-setup d'Edge et les dépendances :
```
sudo bash /tmp/bootstrap_4.52.00.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
```
    Où uName:pWord correspondent au nom d'utilisateur et au mot de passe du dépôt.
4. Utilisez apigee-service pour mettre à jour l'utilitaire apigee-setup, comme le montre l'exemple suivant :
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup update 
```
5. Mettez à jour l'utilitaire apigee-validate sur le serveur de gestion, comme indiqué dans l'exemple suivant :
```
/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
```
6. Mettez à jour l'utilitaire apigee-provision sur le serveur de gestion, comme indiqué dans l'exemple suivant :
```
/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
```
7. Exécutez l'utilitaire update sur vos nœuds dans l'ordre décrit dans la section Ordre des mises à jour de la machine :
```
/opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
```
  Où :
  - component est le composant Edge à mettre à jour. En général, vous mettez à jour les composants suivants :
    - cs: Cassandra
    - edge: tous les composants Edge à l'exception de l'interface utilisateur Edge: serveur de gestion, processeur de messages, routeur, serveur QPID, serveur Postgres
    - ldap: OpenLDAP
    - ps: postgresql
    - qpid: qpidd
    - sso: Apigee SSO (si vous avez installé l'authentification unique)
    - ue Nouvelle interface utilisateur Edge
    - ui: interface utilisateur Classic Edge
    - zk: Zookeeper
  - configFile est le même fichier de configuration que celui que vous avez utilisé pour définir vos composants Edge lors de l'installation de la version 4.50.00 ou 4.51.00.
    REMARQUE:Le fichier de configuration doit être lisible par l'utilisateur "apigee". Pour modifier le propriétaire, exécutez la commande suivante :
```
chown apigee:apigee configFile
```
  Vous pouvez exécuter update.sh sur tous les composants en définissant component sur "tous", mais uniquement si vous disposez d'un profil d'installation Edge tout-en-un (AIO). Exemple :
```
/opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config
```
8. Si vous ne l'avez pas déjà fait, redémarrez les composants d'interface utilisateur sur tous les nœuds qui l'exécutent :
```
/opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
```
9. Testez la mise à jour en exécutant l'utilitaire apigee-validate sur le serveur de gestion, comme décrit dans la section Tester l'installation.
Si vous décidez ultérieurement d'effectuer un rollback de la mise à jour, suivez la procédure décrite dans la section Effectuer un rollback de la version 4.52.00.

Ordre des mises à jour de la machine

L'ordre dans lequel vous mettez à jour les machines dans une installation Edge est important:
- Vous devez mettre à jour tous les nœuds Cassandra et ZooKeeper avant de mettre à jour les autres nœuds.
- Pour toute machine comportant plusieurs composants Edge (serveur de gestion, processeur de messages, routeur, serveur QPID mais pas serveur Postgres), utilisez l'option -c edge pour tous les mettre à jour en même temps.
- Si une étape indique qu'elle doit être exécutée sur plusieurs machines, effectuez-la dans l'ordre spécifié.
- Il n'existe pas d'étape distincte pour modifier la monétisation. Elle est mise à jour lorsque vous spécifiez l'option -c edge.
REMARQUE:Après avoir mis à jour le composant d'interface utilisateur Edge, vous devez redémarrer le service de l'interface utilisateur Edge, comme décrit dans les instructions d'installation de la mise à jour.

Mise à niveau autonome à un nœud

Pour mettre à niveau une configuration autonome à un nœud vers la version 4.52.00:
1. Mettez à jour tous les composants :
```
/opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
```
2. (Si vous avez installé apigee-adminapi) Mise à jour de l'utilitaire apigee-adminapi :
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
Mise à niveau autonome à deux nœuds

Mettez à jour les composants suivants pour une installation autonome à deux nœuds:

Pour obtenir la liste des topologies Edge et des numéros de nœuds, reportez-vous à la section Topologies d'installation.
1. Mettez à jour Cassandra et ZooKeeper sur la machine 1 :
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```
  .
2. Mettez à jour Qpid et Postgres sur la machine 2 :
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
```
3. Mettre à jour LDAP sur la machine 1 :
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
4. Mettez à jour les composants Edge sur les machines 2 et 1 :
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
5. Mettez à jour l'UI sur la machine 1 :
```
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
```
6. (Si vous avez installé apigee-adminapi) Mise à jour de l'utilitaire apigee-adminapi sur la machine 1 :
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
7. (Si vous avez installé l'authentification unique Apigee) Mettez à jour l'authentification unique Apigee sur la machine 1 :
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
  Où sso_config_file est le fichier de configuration que vous avez créé lors de l'installation de l'authentification unique.
8. Redémarrez le composant d'interface utilisateur Edge sur la machine 1 :
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```
Mise à niveau à cinq nœuds

Mettez à jour les composants suivants pour une installation à cinq nœuds:

Pour obtenir la liste des topologies Edge et des numéros de nœuds, reportez-vous à la section Topologies d'installation.
1. Mettez à jour Cassandra et ZooKeeper sur les machines 1, 2 et 3 :
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```
  .
2. Mettez à jour Qpid et Postgres sur la machine 4 :
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile
```
3. Mettez à jour Qpid et Postgres sur la machine 5 :
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile
```
4. Mettre à jour LDAP sur la machine 1 :
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
5. Mettre à jour les composants Edge sur la machine 4, 5, 1, 2, 3 :
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
6. Mettez à jour l'interface utilisateur Edge :
  - Interface utilisateur classique:si vous utilisez l'interface utilisateur classique, mettez à jour le composant ui sur la machine 1, comme indiqué dans l'exemple suivant :
```
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
```
  - Nouvelle interface utilisateur Edge:si vous avez installé la nouvelle interface utilisateur Edge, mettez à jour le composant ue sur la machine appropriée (peut-être pas la machine 1) :
```
/opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
```
7. (Si vous avez installé apigee-adminapi) Mise à jour de l'utilitaire apigee-adminapi sur la machine 1 :
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
8. (Si vous avez installé l'authentification unique Apigee) Mettez à jour l'authentification unique Apigee sur la machine 1 :
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
  Où sso_config_file est le fichier de configuration que vous avez créé lors de l'installation de l'authentification unique.
9. Redémarrez le composant d'interface utilisateur :
  - Interface utilisateur classique:si vous utilisez l'interface utilisateur classique, redémarrez le composant edge-ui sur la machine 1, comme indiqué dans l'exemple suivant :
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```
  - Nouvelle interface utilisateur Edge:si vous avez installé la nouvelle interface utilisateur Edge, redémarrez le composant edge-management-ui sur la machine appropriée (peut-être pas la machine 1) :
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
```
Mise à niveau en cluster à 9 nœuds

Mettez à jour les composants suivants pour une installation en cluster à 9 nœuds:

Pour obtenir la liste des topologies Edge et des numéros de nœuds, reportez-vous à la section Topologies d'installation.
1. Mettez à jour Cassandra et ZooKeeper sur les machines 1, 2 et 3 :
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```
  .
2. Mettez à jour Qpid sur les machines 6 et 7 :
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
```
3. Mettez à jour Postgres sur la machine 8 :
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
4. Mettez à jour Postgres sur la machine 9 :
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
5. Mettre à jour 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 6, 7, 8, 9, 1, 4 et 5, dans cet ordre :
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
7. Mettez à jour la nouvelle UI (ue) ou l'UI classique (ui) sur la machine 1 :
```
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
```
8. (Si vous avez installé apigee-adminapi) Mettez à jour l'utilitaire apigee-adminapi sur la machine 1 :
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
9. (Si vous avez installé l'authentification unique Apigee) Mettez à jour l'authentification unique Apigee sur la machine 1 :
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
  Où sso_config_file est le fichier de configuration que vous avez créé lors de l'installation de l'authentification unique.
10. Redémarrez le composant d'interface utilisateur :
  - Interface utilisateur classique:si vous utilisez l'interface utilisateur classique, redémarrez le composant edge-ui sur la machine 1, comme indiqué dans l'exemple suivant :
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```
  - Nouvelle interface utilisateur Edge:si vous avez installé la nouvelle interface utilisateur Edge, redémarrez le composant edge-management-ui sur la machine appropriée (peut-être pas la machine 1) :
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
```
Mise à niveau en cluster à 13 nœuds

Mettez à jour les composants suivants pour une installation en cluster à 13 nœuds:

Pour obtenir la liste des topologies Edge et des numéros de nœuds, reportez-vous à la section Topologies d'installation.
1. Mettez à jour Cassandra et ZooKeeper sur les machines 1, 2 et 3 :
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```
  .
2. Mettre à jour Qpid sur les machines 12 et 13 :
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
```
3. Mettez à jour Postgres sur la machine 8 :
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
4. Mettez à jour Postgres sur la machine 9 :
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
5. Mettre à jour LDAP sur les machines 4 et 5 :
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
6. Mettez à jour les composants Edge sur les machines 12, 13, 8, 9, 6, 7, 10 et 11, dans cet ordre :
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
7. Mettez à jour la nouvelle UI (ue) ou l'UI classique (ui) sur les machines 6 et 7 :
```
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
```
8. (Si vous avez installé apigee-adminapi) Mise à jour de l'utilitaire apigee-adminapi sur les machines 6 et 7 :
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
9. (Si vous avez installé l'authentification unique Apigee) Mettez à jour l'authentification unique Apigee sur les machines 6 et 7 :
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
  Où sso_config_file est le fichier de configuration que vous avez créé lors de l'installation de l'authentification unique.
10. Redémarrez le composant d'interface utilisateur :
  - Interface utilisateur classique:si vous utilisez l'interface utilisateur classique, redémarrez le composant edge-ui sur les machines 6 et 7, comme indiqué dans l'exemple suivant :
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```
  - Nouvelle interface utilisateur Edge:si vous avez installé la nouvelle interface utilisateur Edge, redémarrez le composant edge-management-ui sur les machines 6 et 7 :
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
```
Mise à niveau en cluster à 12 nœuds

Mettez à jour les composants suivants pour une installation en cluster à 12 nœuds:

Pour obtenir la liste des topologies Edge et des numéros de nœuds, reportez-vous à la section Topologies d'installation.
1. 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
```
2. 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. Mettez à jour qpidd sur la machine 5 :
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
```
  2. Machines 10 et 11 du centre de données 2
    1. Mettez à jour qpidd sur la machine 10 :
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
```
    2. Mettez à jour qpidd sur la machine 11 :
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
```
3. Mettez à jour Postgres :
  1. Machine 6 dans le centre de données 1
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
  2. Machine 12 dans le centre de données 2
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
4. Mettre à jour LDAP :
  1. Machine 1 dans le centre de données 1
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
  2. Machine 7 dans le centre de données 2
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
5. Mettez à jour les composants Edge :
  1. Machines 4, 5, 6, 1, 2, 3 du centre de données 1
```
/opt/apigee/apigee-setup/bin/update.sh -c 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
```
6. Mettez à jour la nouvelle UI (ue) ou l'UI classique (ui) :
  1. Machine 1 dans le centre de données 1 :
```
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
```
  2. Machine 7 dans le Centre de données 2 :
```
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
```
7. (Si vous avez installé apigee-adminapi) Mise à jour de l'utilitaire apigee-adminapi :
  1. Machine 1 dans le centre de données 1 :
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
  2. Machine 7 dans le Centre de données 2 :
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
8. (Si vous avez installé l'authentification unique Apigee) Mettez à jour l'authentification unique Apigee :
  1. Machine 1 dans le centre de données 1 :
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
  2. Machine 7 dans le Centre de données 2 :
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
9. Redémarrez la nouvelle interface utilisateur Edge (edge-management-ui) ou le composant UI Edge classique (edge-ui) sur les machines 1 et 7 :
```
/opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart
```
Pour une configuration non standard

Si vous disposez d'une configuration 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 périphérique" sur tous les nœuds de l'ordre: nœuds avec serveur Qpid, serveur Edge Postgres, serveur de gestion, processeur de messages et routeur.
  REMARQUE:Si le serveur Qpid et le serveur Edge Postgres sont installés sur un nœud, exécutez l'étape de profil "-c Edge".
6. Interface utilisateur Edge (classique ou nouvelle)
7. apigee-adminapi
8. Authentification unique Apigee
Une fois la mise à jour terminée, veillez à redémarrer le composant d'interface utilisateur Edge sur toutes les machines qui l'exécutent.