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.

Mise à niveau du système d'exploitation nœud par nœud pour Apigee Edge pour Private Cloud

Vous consultez la documentation Apigee Edge.
Accédez à la documentation Apigee X.

Ce document décrit une autre méthode pour mettre à niveau le système d'exploitation des serveurs de votre cluster Apigee Edge pour Private Cloud. Au lieu de configurer un tout nouveau centre de données parallèle, cette approche nœud par nœud vous permet de mettre à niveau votre OS sur place, une machine/un nœud à la fois.

Compatibilité

Avant de lancer la mise à niveau de l'OS nœud par nœud, vérifiez que votre version actuelle d'Apigee Edge pour le cloud privé est compatible avec la version cible de l'OS. Pour le vérifier, veuillez consulter la matrice de compatibilité des systèmes d'exploitation.

Prérequis

Avant de commencer la mise à niveau nœud par nœud, vérifiez que vous avez effectué les tâches suivantes :

Sauvegarder tous les nœuds

Avant de suivre la procédure, nous vous recommandons d'effectuer une sauvegarde complète de tous les nœuds, par exemple au niveau de la VM, au niveau des composants (ou les deux), pour des raisons de sécurité. Cela vous permet d'avoir un plan de sauvegarde au cas où l'une des étapes suivantes ne fonctionnerait pas correctement. Pour en savoir plus sur la sauvegarde au niveau des composants, consultez Sauvegarder et restaurer.

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

Ordre de remplacement des nœuds

Nous vous recommandons de mettre à niveau les nœuds dans l'ordre indiqué ci-dessous, en fonction du type de composant :

Cassandra
ZooKeeper
Postgres
LDAP
Qpid
Message-Processor
Routeur
Management-server
UI/UE
Authentification unique

Autres scénarios

Lorsque vous effectuez une mise à niveau de l'OS nœud par nœud, veuillez suivre ces étapes supplémentaires si l'une des configurations suivantes est présente dans la configuration existante :

apigee-mtls : si apigee-mtls est activé, la mise à niveau de l'OS nœud par nœud (progressive) n'est pas compatible avec cette configuration. Pour mettre à niveau le même, veuillez suivre le guide de mise à niveau d'apigee-mtls.

Cassandra

Lorsque vous remplacez Cassandra, pensez à remplacer d'abord les nœuds non-seed, puis les nœuds seed.

Voici les cas particuliers à prendre en compte pour Cassandra :

Cassandra Native-mTLS : si native-mTLS est activé et appliqué, supprimez l'application sur les nœuds compatibles avec mTLS en définissant conf_cassandra_client_encryption_optional=true. Pour en savoir plus, consultez la documentation sur le mTLS natif.
Le chiffrement entre les nœuds Cassandra est activé : consultez Activer le chiffrement entre les nœuds Cassandra pour vous assurer que les certificats des nœuds Cassandra existants sont inclus dans le truststore du nouveau nœud remplacé et inversement.

Procédure pour remplacer un nœud Cassandra :

Sauvegardez le nœud en prenant des instantanés de la machine virtuelle (si possible) et effectuez une sauvegarde Apigee pour Cassandra sur tous les nœuds à l'aide de la commande suivante :
```
apigee-service apigee-cassandra backup
```
Acquérir un nouveau nœud avec l'OS mis à niveau.
Appliquez les conditions préalables spécifiques à l'OS.
Téléchargez et exécutez le fichier Edge pour installer l'utilitaire apigee-service. Démarrez la version d'Apigee utilisée, run bootstrap pour obtenir apigee-service et installez apigee-setup.
REMARQUE : Assurez-vous que le nouveau nœud ne contient aucun répertoire de données sur le chemin d'accès au répertoire de données apigee-cassandra.

Répertoriez les nœuds seed :

apigee-service apigee-cassandra configure -search conf_cassandra_seeds

Mettez à jour le fichier de configuration en modifiant l'adresse IP du nœud Cassandra existant et en la remplaçant par la nouvelle adresse IP du nœud.
REMARQUE : Assurez-vous de conserver l'ordre des adresses IP remplacées. Par exemple, si vous remplacez IP2 par IP4.

CASS_HOSTS existants
```
CASS_HOSTS="$IP1 $IP2 $IP3"
```
CASS_HOSTS mis à jour
```
CASS_HOSTS="$IP1 $IP4 $IP3"
```
Reconfigurez les nœuds existants du cluster avec la nouvelle adresse IP du nœud Cassandra (à l'exception du nœud à remplacer). Veuillez utiliser la documentation de référence sur les fichiers de configuration.
```
/opt/apigee/apigee-setup/bin/setup.sh -p c -f updatedConfigFile
```

Arrêtez et annulez l'enregistrement de Cassandra sur l'ancien nœud :

Arrêtez Cassandra sur le nœud à remplacer :
```
apigee-service apigee-cassandra stop
```

Listez l'UUID du nœud Cassandra à mettre hors service (si plusieurs centres de données sont concernés, tenez-en compte) :

apigee-adminapi.sh servers list -r dc-1 -p central -t application-datastore --admin AdminEmailID --pwd 'AdminPassword' --host localhost

Désinscrivez les types de datastore associés à l'UUID Cassandra existant :

curl -u AdminEmailID:'AdminPassword' -X POST http://MS_IP:8080/v1/servers -d "type=cache-datastore&type=user-settings-datastore&type=scheduler-datastore&type=audit-datastore&type=apimodel-datastore&type=application-datastore&type=edgenotification-datastore&type=identityzone-datastore&type=auth-datastore&region=dc-1&pod=central&uuid=old_cassandra_uuid&action=remove"

Supprimez le serveur.
REMARQUE : N'exécutez pas cette étape si Cassandra et d'autres composants Edge, tels que management-server, se trouvent sur le même nœud. Cela peut être le cas si votre configuration utilise une configuration Apigee standard à cinq nœuds.
```
curl -u AdminEmailID:AdminPassword -X DELETE http://MS_IP:8080/v1/servers/old_cassandra_uuid
```

Préparez un nouveau nœud pour l'hôte apigee-cassandra. Ajoutez la ligne suivante au fichier cassandra.properties sous /opt/apigee/customer/application/cassandra.properties (créez-le s'il n'existe pas déjà) sur le nouveau nœud Cassandra :
```
conf_jvm_options_custom_settings=-Dcassandra.replace_address=IPOfOldCassandraNode -Dcassandra.allow_unsafe_replace=true
```
Vérifiez que le propriétaire et le groupe sont définis sur apigee:apigee dans le fichier cassandra.properties. Si nécessaire, utilisez la commande suivante pour modifier le propriétaire et le groupe :
```
chown apigee:apigee /opt/apigee/customer/application/cassandra.properties
```

Installez Cassandra et exécutez la configuration sur le nœud nouvellement ajouté :

apigee-service apigee-cassandra install

apigee-service apigee-cassandra setup -f updatedConfigFile

Après avoir configuré le nouveau nœud, supprimez la configuration supplémentaire ajoutée à /opt/apigee/customer/application/cassandra.properties et redémarrez apigee-cassandra :
```
conf_jvm_options_custom_settings=-Dcassandra.replace_address=IPOfOldCassandraNode -Dcassandra.allow_unsafe_replace=true
```
```
apigee-service apigee-cassandra restart
```

Vérifiez l'état du nouveau nœud remplacé :

apigee-service apigee-cassandra status

/opt/apigee/apigee-cassandra/bin/nodetool status

Reconstruisez le nouveau nœud ajouté au cluster :

/opt/apigee/apigee-cassandra/bin/nodetool rebuild -dc dc-1

Reconfigurez les nœuds existants des serveurs Router, Message-Processor, Qpid, Postgres et Management en mettant à jour l'adresse IP du nouveau nœud Cassandra dans le fichier de configuration :
```
/opt/apigee/apigee-setup/bin/setup.sh -p r|mp|qs|ps|ms|mo -f updatedConfigFile
```
REMARQUE : Si le routeur et le processeur de messages se trouvent sur le même nœud, utilisez -p rmp.
Supprimez/désinstallez Cassandra de l'ancien nœud :
```
apigee-service apigee-cassandra uninstall
```
Répétez l'opération pour les autres nœuds Cassandra du cluster.

ZooKeeper

Reportez-vous à la procédure ci-dessous pour remplacer les nœuds Zookeeper. Envisagez de remplacer d'abord les nœuds suiveurs, puis les nœuds leaders, pour vous assurer que l'ensemble conserve le quorum.

Sauvegardez le nœud en prenant des instantanés de machine virtuelle (si possible) et effectuez une sauvegarde Apigee pour ZooKeeper sur tous les nœuds.

Arrêtez et désinstallez ZooKeeper sur le nœud existant :

apigee-service apigee-zookeeper stop

apigee-service apigee-zookeeper uninstall

Acquérir un nouveau nœud avec l'OS mis à niveau.
Appliquez les conditions préalables spécifiques à l'OS.
Téléchargez le programme d'amorçage de la version d'Apigee que vous utilisez, exécutez le programme d'amorçage pour obtenir apigee-service et installez apigee-setup.
Mettez à jour le fichier de configuration en supprimant les adresses IP des nœuds obsolètes/supprimés et en les remplaçant par les nouvelles adresses IP des nœuds pour Zookeeper. Pour en savoir plus, consultez la documentation de référence sur le fichier de configuration :
REMARQUE : Veillez à conserver l'ordre des adresses IP remplacées. Par exemple, si vous remplacez IP2 par IP4.

Configuration ZK existante
```
ZK_HOSTS="$IP1 $IP2 $IP3"
ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3"
    
```
Configuration ZK mise à jour
```
ZK_HOSTS="$IP1 $IP4 $IP3"
ZK_CLIENT_HOSTS="$IP1 $IP4 $IP3"
    
```
Installez, configurez et démarrez Zookeeper sur le nouveau nœud à l'aide du fichier de configuration mis à jour :
```
/opt/apigee/apigee-setup/bin/setup.sh -p zk -f updatedConfigFile
```

Modifiez le nœud Zookeeper existant avec updatedConfigFile :

/opt/apigee/apigee-setup/bin/setup.sh -p zk -f updatedConfigFile

Reconfigurez les nœuds existants des serveurs Routeur, Processeur de messages, Qpid, Postgres et de gestion en mettant à jour la nouvelle adresse IP du nœud ZooKeeper dans le fichier de configuration :
```
/opt/apigee/apigee-setup/bin/setup.sh -p r|mp|qs|ps|ms|mo -f updatedConfigFile
```
REMARQUE : Si le routeur et le processeur de messages se trouvent sur le même nœud, utilisez -p rmp.
Répétez cette opération pour tous les nœuds Zookeeper.

Postgres

Cette section décrit une approche sans temps d'arrêt pour mettre à niveau les nœuds Postgres. Vous y trouverez les étapes à suivre. Des instructions détaillées pour chaque étape sont fournies dans les sous-sections suivantes.

Remplacez l'un des nœuds de secours existants par l'OS cible.
Promouvez le nouveau nœud de secours en tant que nœud maître.
Mettez hors service l'ancien maître.
Continuez à remplacer les nœuds de secours supplémentaires.

Avant de commencer le remplacement, il est recommandé d'arrêter le edge-qpid-server pour minimiser toute perte potentielle de messages analytiques.

apigee-service edge-qpid-server stop

Instance de secours

Obtenez l'UUID des nœuds edge-postgres-server :

curl http://pg_standby_ip:8084/v1/servers/self

Arrêtez Postgres :

apigee-service edge-postgres-server stop

apigee-service apigee-postgresql stop

Supprimez le Postgres de secours existant du groupe "analytics" en suivant ces étapes.

Désinstallez apigee-postgres et postgres-server :

apigee-service edge-postgres-server uninstall

apigee-service apigee-postgresql uninstall

Acquérir un nouveau nœud avec l'OS mis à niveau.
Appliquez les conditions préalables spécifiques à l'OS.
Téléchargez le programme d'amorçage de la version d'Apigee que vous utilisez, exécutez le programme d'amorçage pour obtenir apigee-service et installez apigee-setup.
Configurez la réplication maître-veille sur le maître existant en mettant à jour le fichier de configuration avec EXISTING_PG_MASTER_IP et NEW_PG_STANDBY_IP. Pour en savoir plus, consultez la documentation de référence sur le fichier de configuration :
```
PG_MASTER=EXISTING_PG_MASTER_IP
```
```
PG_STANDBY=NEW_PG_STANDBY_IP
```
```
apigee-service apigee-postgresql setup-replication-on-master -f updatedConfigFile
```

Installez, configurez et démarrez Postgres avec des configurations maître-veille sur le nouveau nœud de secours :

PG_MASTER=EXISTING_PG_MASTER_IP

PG_STANDBY=NEW_PG_STANDBY_IP

/opt/apigee/apigee-setup/bin/setup.sh -p ps -f updatedConfigFile

Vérifiez la configuration de secours :

apigee-service apigee-postgresql postgres-check-standby

Maître

Obtenez l'UUID du nœud maître Postgres existant :
```
curl http://pg_ip:8084/v1/servers/self
```
Promouvez le nouveau nœud de secours de l'OS mis à niveau en tant que nœud maître.

Arrêtez Postgres sur le nœud maître existant :

apigee-service apigee-postgresql stop

apigee-service edge-postgres-server stop

Promouvez le nouveau nœud de secours en tant que nœud maître :

apigee-service apigee-postgresql promote-standby-to-master EXISTING_PG_MASTER_IP

Supprimez l'ancien nœud maître des groupes "analytics" et "consumer".
Ajoutez le nouveau nœud maître aux groupes "analytics" et "consumer".
Si vous utilisez la monétisation, mettez à jour le nouveau nœud maître Postgres et procédez comme suit.
Une fois le nœud maître remplacé, le edge-qpid-server peut être démarré avec une configuration de nœud maître mise à jour :
```
apigee-service edge-qpid-server start
```
Si vous utilisez la monétisation, redémarrez également le serveur de gestion et le processeur de messages :
```
apigee-service edge-management-server restart
```

Arrêtez et désinstallez apigee-postgres et postgres-server sur l'ancien nœud maître :

apigee-service edge-postgres-server uninstall

apigee-service apigee-postgresql uninstall

Ajouter un nouveau remplaçant

Acquérir un nouveau nœud avec l'OS mis à niveau.
Appliquez les conditions préalables spécifiques à l'OS.
Téléchargez le bootstrap de la version Apigee utilisée, exécutez le bootstrap pour obtenir apigee-service et installez apigee-setup.
Configurez la réplication maître-veille à l'aide de la nouvelle adresse IP du maître et de la nouvelle adresse IP du nœud de secours dans le nouveau fichier de configuration du maître et du nœud de secours. Pour en savoir plus, consultez la documentation de référence sur le fichier de configuration :
```
apigee-service apigee-postgresql setup-replication-on-master -f updatedConfigFile
```

Installez et configurez le nouveau nœud de secours :

/opt/apigee/apigee-setup/bin/setup.sh -p ps -f updatedConfigFile

Ajoutez le nouveau serveur de secours aux groupes d'analyse en suivant la procédure de configuration maître/secours.
Remarque : Lorsque vous ajoutez des nœuds de secours à des groupes "analytics", assurez-vous de supprimer d'abord le serveur Postgres existant, puis de le rajouter en même temps que le nœud de secours.

LDAP

Le remplacement du nœud LDAP nécessiterait l'arrêt du serveur de gestion et toute API de gestion serait considérée comme indisponible pendant la durée de ce remplacement.

Arrêtez le serveur de gestion sur tous les nœuds :
```
apigee-service edge-management-server stop
```
Mise hors service du nœud LDAP existant :
REMARQUE : Si vous utilisez la version 4.53.01 ou ultérieure, veillez à utiliser mdb dans toutes les configurations LDAP. Si vous utilisez la version 4.53.00 ou une version antérieure, assurez-vous d'utiliser bdb dans la configuration LDAP.
1. Effectuez une sauvegarde/un instantané au niveau de la VM du nœud LDAP.
2. Avant d'arrêter LDAP, assurez-vous de capturer le nombre de données LDAP, qui pourra être vérifié ultérieurement. Par exemple :
```
ldapsearch -o ldif-wrap=no -b "dc=apigee,dc=com" -D "cn=manager,dc=apigee,dc=com" -H ldap://:10389 -LLL -x -w Secret123 | wc -l
```
3. Pour la configuration actif-passif :
  1. Passez du nœud passif au nœud actif en ajoutant un fichier mark_writable.ldif sur le nœud passif avec le contenu suivant :
```
dn: olcDatabase={2}bdb,cn=config
changetype: modify
replace: olcReadOnly
olcReadOnly: FALSE
```
  2. Exécutez la commande suivante sur le nœud passif pour l'activer :
```
ldapmodify -a -x -w "$APIGEE_LDAPPW" -D "$CONFIG_BIND_DN" -H "ldap://:10389" -f mark_writable.ldif
```
  3. Poursuivez avec l'étape d) pour le mode actif-actif afin de désactiver les nœuds.
4. Dans une configuration LDAP actif/actif, interrompez la réplication entre les deux nœuds LDAP et mettez à jour les configurations. Suivez les étapes décrites dans le document sur l'arrêt de LDAP.
5. Arrêtez et sauvegardez les données LDAP, puis désinstallez le nœud LDAP existant (ignorez cette étape pour la configuration actif-actif si vous l'avez déjà fait) :
```
apigee-service apigee-openldap stop
```
```
apigee-service apigee-openldap backup
```
```
apigee-service apigee-openldap uninstall
```
Acquérir un nouveau nœud avec l'OS mis à niveau.
Appliquez les conditions préalables spécifiques à l'OS.
Téléchargez le programme d'amorçage de la version d'Apigee que vous utilisez, exécutez le programme d'amorçage pour obtenir apigee-service et installez apigee-setup.
Configurez un nouveau nœud LDAP :
1. Mettez à jour configFile pour le nouveau nœud en fonction de la configuration. Pour ce faire, consultez la documentation de référence sur le fichier de configuration Edge, en fonction de la configuration active uniquement ou actif/actif :
  - LDAP_TYPE
  - LDAP_PEER
  - LDAP_SID
  - USE_LDAP_REMOTE_HOST=y/n
    Remarque : Définissez USE_LDAP_REMOTE_HOST sur "y" ou "n" selon que LDAP est configuré ou non sur le même nœud que le serveur de gestion.
2. Configurez et démarrez LDAP sur le nouveau nœud avec updatedConfigFile :
```
/opt/apigee/apigee-setup/bin/setup.sh -p ld -f updatedConfigFile
```
3. Sauvegardez les données LDAP des anciens nœuds (si la configuration actif-actif peut être ignorée) :
  1. Effectuez une sauvegarde échantillon sur le nouveau nœud afin de générer un dossier/chemin de sauvegarde par défaut :
```
apigee-service apigee-openldap backup
```
  2. Déplacez les données sauvegardées de l'ancien nœud vers le dossier de sauvegarde généré.
  3. Arrêtez apigee-openldap avant de restaurer les données :
```
apigee-service apigee-openldap stop
```
  4. Restaurez la sauvegarde effectuée à partir de l'ancien nœud :
```
apigee-service apigee-openldap restore backup_file
```
    Exemple :
```
apigee-service apigee-openldap restore 2026.02.09,10.28.20
```
Répétez l'opération pour les autres nœuds LDAP (si le mode actif-actif est utilisé).
Reconfigurez et démarrez le serveur de gestion avec les configurations d'hôte LDAP mises à jour :
```
/opt/apigee/apigee-setup/bin/setup.sh -p mt -f updatedConfigFile
```

Reconfigurez et démarrez le SSO (le cas échéant) :

apigee-service apigee-sso setup -f updatedConfigFile

apigee-service apigee-sso restart

(Facultatif) Configurez le deuxième annuaire actif en lecture seule en suivant les étapes de la documentation.

Qpid

Pour remplacer un nœud Qpid existant par un nœud OS mis à niveau, nous devons suivre les étapes suivantes :

Arrêtez de recevoir des messages dans la file d'attente de nœuds existante à partir des processeurs de messages.
Drainez les messages existants dans la file d'attente.
Arrêtez et mettez hors service le nœud existant.

Mise hors service des nœuds existants. Pour vous assurer qu'aucun message ne se perd, vous pouvez prendre les mesures supplémentaires suivantes :

Arrêtez le broker Qpid :
```
apigee-service apigee-qpidd stop
```
Bloquez le trafic entrant sur le port 5672 depuis tous les processeurs de messages :
```
iptables -A INPUT -p tcp --dport 5672 -s MP_IP -j DROP
```
Redémarrez le courtier Qpid pour vider les messages existants :
```
apigee-service apigee-qpidd start
```
Avant de commencer la mise hors service, assurez-vous que tous les messages de la file d'attente ont été transmis au consommateur.

Obtenez l'UUID du nœud edge-qpid-server :

curl http://qpid_node_ip:8083/v1/servers/self

Suivez les étapes de mise hors service ou de suppression de Qpid des analyses pour apigee-qpidd et edge-qpid-server.

Arrêtez et désinstallez apigee-qpidd et edge-qpid-server :

apigee-service apigee-qpidd stop

apigee-service edge-qpid-server stop

apigee-service apigee-qpidd uninstall

apigee-service edge-qpid-server uninstall

Ajouter un nœud :

Acquérir un nouveau nœud avec l'OS mis à niveau.
Appliquez les conditions préalables spécifiques à l'OS.
Téléchargez le programme d'amorçage de la version d'Apigee que vous utilisez, exécutez le programme d'amorçage pour obtenir apigee-service et installez apigee-setup.
Configurez et exécutez les services Qpid sur le nouveau nœud, puis ajoutez-les aux groupes de consommateurs en suivant ces étapes. Suivez les mêmes étapes pour ajouter d'autres groupes, comme pour la monétisation.
Si le service de monétisation est activé, redémarrez le serveur de gestion et le processeur de messages :
```
apigee-service edge-management-server restart
```
```
apigee-service edge-message-processor restart
```
Répétez l'opération sur tous les nœuds Qpid.

Message-processor

Obtenez l'UUID du nœud edge-message-processor :
```
curl http://mp_ip:8082/v1/servers/self
```
Mettez hors service et désinstallez le nœud du processeur de messages.
Si le service de monétisation est activé, désinstallez edge-mint-message-processor.

Désinstallez le processeur de messages :

apigee-service edge-message-processor uninstall

Acquérir un nouveau nœud avec l'OS mis à niveau.
Appliquez les conditions préalables spécifiques à l'OS.
Téléchargez le programme d'amorçage de la version d'Apigee que vous utilisez, exécutez le programme d'amorçage pour obtenir apigee-service et installez apigee-setup.
Ajoutez, configurez et démarrez le processeur de messages dans le cluster en suivant les étapes.
Si la monétisation est activée, configurez le service de monétisation avec le processeur de messages. Pour en savoir plus, consultez la documentation suivante.

Routeur

Obtenez l'UUID du nœud edge-router :

curl http://router_ip:8081/v1/servers/self

Désactivez la joignabilité et vérifiez si elle est accessible :

iptables -A INPUT -i eth0 -p tcp --dport 15999 -j REJECT

curl -vvv -X GET http://router_ip:15999/v1/servers/self/reachable

Mettez hors service et désinstallez le nœud du routeur.
Désinstaller le routeur :
```
apigee-service edge-router uninstall
```
Acquérir un nouveau nœud avec l'OS mis à niveau.
Appliquez les conditions préalables spécifiques à l'OS.
Téléchargez le programme d'amorçage de la version d'Apigee que vous utilisez, exécutez le programme d'amorçage pour obtenir apigee-service et installez apigee-setup.
Ajoutez, configurez et démarrez le routeur dans le cluster.

Serveur de gestion

Un seul serveur de gestion

Acquérir un nouveau nœud avec l'OS mis à niveau.
Appliquez les conditions préalables spécifiques à l'OS.
Téléchargez le programme d'amorçage de la version d'Apigee que vous utilisez, exécutez le programme d'amorçage pour obtenir apigee-service et installez apigee-setup.
Ajoutez le serveur de gestion à l'aide de l'adresse IP et du fichier de configuration mis à jour (voir ici), puis exécutez la commande d'installation :
```
/opt/apigee/apigee-setup/bin/setup.sh -p mt -f updatedConfigFile
```
Reconfigurez et redémarrez l'interface utilisateur avec la nouvelle configuration de l'adresse IP de gestion.
```
/opt/apigee/apigee-setup/bin/setup.sh -p ui -f updatedConfigFile
```
Reconfigurez le SSO avec la nouvelle configuration de l'adresse IP de gestion (le cas échéant) :
```
/opt/apigee/apigee-setup/bin/setup.sh -p sso -f updatedConfigFile
```
Reconfigurez la nouvelle interface utilisateur (UE) avec la nouvelle configuration de l'adresse IP de gestion (le cas échéant) :
```
/opt/apigee/apigee-setup/bin/setup.sh -p ue -f updatedConfigFile
```
Si la monétisation est activée :
1. Reconfigurez le MS de monétisation avec la nouvelle configuration de l'adresse IP de gestion (le cas échéant), en vous référant à la documentation sur la configuration de la monétisation.
```
/opt/apigee/apigee-setup/bin/setup.sh -p mo -f updatedConfigFile
```
2. Redémarrez le serveur de gestion :
```
apigee-service edge-management-server restart
```
Mettez hors service le serveur de gestion sur l'ancien nœud existant en suivant la procédure.

Si la monétisation est activée, supprimez l'UUID du serveur de gestion des groupes d'analyse. Exemple :

curl -v -u AdminEmail:AdminPassword -X DELETE "http://localhost:8080/v1/analytics/groups/ax/mint_axgroup/servers?uuid=MS_UUID&type=consumer-server"

Désinstallez le serveur de gestion de la monétisation :
```
apigee-service edge-mint-management-server uninstall
```

Plusieurs serveurs de gestion

Mettez hors service l'un des serveurs de gestion à l'aide de l'autre sur le nœud existant en suivant les étapes.

Arrêtez et désinstallez le serveur de gestion :

apigee-service edge-management-server stop

apigee-service edge-management-server uninstall

Acquérir un nouveau nœud avec l'OS mis à niveau.
Appliquez les conditions préalables spécifiques à l'OS.
Téléchargez le programme d'amorçage de la version d'Apigee que vous utilisez, exécutez le programme d'amorçage pour obtenir apigee-service et installez apigee-setup.
Ajoutez le serveur de gestion à l'aide de l'adresse IP et du fichier de configuration mis à jour (voir ici), puis exécutez la commande d'installation :
```
/opt/apigee/apigee-setup/bin/setup.sh -p mt -f updatedConfigFile
```
Reconfigurez et redémarrez l'interface utilisateur avec la configuration de l'adresse IP de gestion mise à jour :
```
/opt/apigee/apigee-setup/bin/setup.sh -p ui -f updatedConfigFile
```
(Uniquement si le SSO est activé) Reconfigurez et redémarrez le SSO avec la configuration IP de gestion mise à jour :
```
/opt/apigee/apigee-setup/bin/setup.sh -p sso -f updatedConfigFile
```
(Uniquement si la nouvelle interface utilisateur est activée) Reconfigurez et redémarrez la nouvelle interface utilisateur avec la configuration de l'adresse IP de gestion mise à jour :
```
/opt/apigee/apigee-setup/bin/setup.sh -p ue -f updatedConfigFile
```
Répétez l'opération pour les autres serveurs de gestion.

UI/UE

Effectuez une sauvegarde/un instantané de VM du nœud d'interface utilisateur.

Arrêter et désinstaller l'UI :

apigee-service edge-ui stop

apigee-service edge-ui uninstall

(Si vous utilisez la nouvelle UI uniquement) Arrêtez et désinstallez la nouvelle UI :
```
apigee-service edge-management-ui stop
```
```
apigee-service edge-management-ui uninstall
```
Acquérir un nouveau nœud avec l'OS mis à niveau.
Appliquez les conditions préalables spécifiques à l'OS.
Téléchargez le programme d'amorçage de la version d'Apigee que vous utilisez, exécutez le programme d'amorçage pour obtenir apigee-service et installez apigee-setup.
Configurez et exécutez edge-ui sur le nouveau nœud, avec les configurations d'adresse IP mises à jour :
```
/opt/apigee/apigee-setup/bin/setup.sh -p ui -f updatedConfigFile
```
(Uniquement si le SSO est activé) Reconfigurez et exécutez le SSO avec les configurations de l'adresse IP du nouveau nœud de l'UI, le cas échéant :
```
/opt/apigee/apigee-setup/bin/setup.sh -p sso -f updatedConfigFile
```

(Uniquement si la nouvelle UI est activée) Configurez et exécutez la nouvelle UI sur le nouveau nœud, avec les configurations d'adresse IP mises à jour :

/opt/apigee/apigee-setup/bin/setup.sh -p ue -f updatedConfigFile

apigee-service edge-management-ui configure-sso -f updatedConfigFile

apigee-service edge-ui configure-sso -f updatedConfigFile

SSO

Effectuez une sauvegarde/un instantané de VM du nœud d'interface utilisateur.

Arrêtez et désinstallez le SSO :

apigee-service apigee-sso stop

apigee-service apigee-sso uninstall

Acquérir un nouveau nœud avec l'OS mis à niveau.
Appliquez les conditions préalables spécifiques à l'OS.
Téléchargez le programme d'amorçage de la version d'Apigee que vous utilisez, exécutez le programme d'amorçage pour obtenir apigee-service et installez apigee-setup.
Ajoutez des configurations et des clés pour l'authentification unique en suivant le guide, en tenant compte de la nouvelle adresse IP du nœud.

Configurez et démarrez l'authentification unique :

/opt/apigee/apigee-setup/bin/setup.sh -p sso -f updatedConfigFile

Mettez à jour la configuration avec les nouvelles adresses IP des nœuds SSO et reconfigurez le SSO pour l'UI :
```
apigee-service edge-ui configure-sso -f updatedConfigFile
```
(Si vous utilisez la nouvelle interface utilisateur) Exécutez configure-sso sur le nœud de la nouvelle interface utilisateur, en vous référant à la documentation :
```
apigee-service edge-management-ui configure-sso -f updatedConfigFile
```
```
apigee-service edge-ui configure-sso -f updatedConfigFile
```