Mettre à niveau Cloud Exchange en tant que machine virtuelle

Utilisez ces étapes pour mettre à jour Cloud Exchange en tant que machine virtuelle, autonome ou HA, vers la dernière version. Pour les chemins de mise à niveau pris en charge et l'autre type de déploiement, reportez-vous à Mettre à jour Cloud Exchange.

Avant de commencer la mise à niveau, assurez-vous que votre instance respecte les exigences système de Cloud Exchange.

Conditions préalables

Allez dans le répertoire d’installation Cloud Exchange : /opt/cloudexchange/cloudexchange
Exécutez ces commandes pour télécharger le script de vérification de la mise à jour/migration et pour rendre le script exécutable :
```
curl -fsSL -O https://raw.githubusercontent.com/netskopeoss/ta_cloud_exchange/main/ce_healthcheck
chmod +x ce_healthcheck
```
Exécutez le script de vérification de mise à jour/migration. Pour plus de détails sur sa sortie, reportez-vous à Comprendre les résultats.
```
sudo python3 ./ce_healthcheck
```
- Pour les nœuds secondaires, exécutez la commande donnée ci-dessous. Ceci s’applique uniquement aux déploiements en HA.
```
sudo python3 ./ce_healthcheck --deployment HA
```
  Note
  
  Si l’une des vérifications échoue, veuillez les traiter avant de passer à l’étape suivante.
Si vous effectuez une mise à niveau depuis Cloud Exchange v5.1.0 ou version antérieure, mettez d'abord à niveau le système d'exploitation Ubuntu sous-jacent de la version 20.04 à la version 22.04. Pour plus de détails, reportez-vous aux articles de la base de connaissances Cloud Exchange.
Si vous effectuez une mise à niveau depuis la version 5.1.1 de Cloud Exchange, 5.1.2, 6.0.0, 6.0.1 ou 6.1.0 vers une version plus récente de CE en tant que déploiement de VM, assurez-vous de mettre à niveau la version du système d’exploitation Ubuntu sous-jacente vers la version 24.04 — consultez les articles de la base de connaissances Cloud Exchange.
Assurez-vous que la VM peut se connecter à https://cloud-exchange-store.s3.us-east-1.amazonaws.com.
Désactivez tous les plugins source dans tous les modules et attendez que les tâches en file d'attente se terminent :
1. Attendez 20 à 30 minutes après avoir désactivé les plugins sources.
2. Accédez à Settings > Logging, cliquez sur Filter Query, entrez ce filtre dans le champ Filtres, puis cliquez sur Load.
```
message Like "Ingested " || message Like "Stored " || message Like "task(s)" || message Like "Completed storing"
```
3. Surveillez les logs filtrés. Lorsque plus aucun New log n’apparaît, poursuivez avec la mise à niveau.
4. Une fois la mise à niveau terminée, activez les plugins source que vous avez désactivés.
Gardez le mot de passe de maintenance à portée de main. Vous en aurez besoin pour effectuer certaines étapes.

Important

Si vous perdez le mot de passe de maintenance, vos données existantes ne pourront pas être conservées.

La migration des données RabbitMQ n'est pas prise en charge, car le type de file d'attente est passé de Classique à Quorum.

Si vous exécutez Cloud Exchange en tant que VM (OVA ou Hyper-V) sur une version antérieure à v5.1.1, vous avez besoin des informations d'identification racine de la machine virtuelle.
Nom d'utilisateur : root
Mot de passe : M5#w6V+.T^8gv?%,

Si vous exécutez Cloud Exchange en tant que VM sur Azure ou AWS, vous pouvez effectuer ces étapes vous-même.

Déploiement autonome

Vers la v7.0.0 à partir de la v5.1.1, v5.1.2, v6.0.0, v6.0.1, V6.1.0 Déploiement autonome

Avant de commencer, remplissez les prérequis et effectuez une sauvegarde. Pour plus de détails, consultez Sauvegarder Cloud Exchange.

Accédez au répertoire /opt/cloudexchange/cloudexchange et arrêtez Cloud Exchange :
```
cd /opt/cloudexchange/cloudexchange
sudo ./stop
```

Ajoutez la clé publique Cloud Exchange en tant que clé GPG approuvée :

curl -fsSL https://cloud-exchange-store.s3.us-east-1.amazonaws.com/cloudexchange/upgrade-packages/cloud-exchange-public.gpg | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/cloud-exchange.gpg

Ajoutez l'URL S3 de Cloud Exchange en tant que source de package :

echo "deb https://cloud-exchange-store.s3.us-east-1.amazonaws.com/cloudexchange/upgrade-packages stable main" | sudo tee /etc/apt/sources.list.d/cloud-exchange.list

Mettre à jour les sources du paquet :
```
sudo apt update
```
Mettez à niveau Cloud Exchange et attendez que la mise à niveau soit terminée :
```
sudo apt install cloud-exchange=7.0.0-1
```
Avant d’exécuter cette commande, assurez-vous que toutes les conditions système requises pour Cloud Exchange sont remplies pour la v7.0.0.
Exécutez le script de configuration :
```
sudo python3 ./setup
```
Démarrez le Cloud Exchange :
```
sudo ./start
```
Fermez toutes vos fenêtres de navigateur Cloud Exchange. Videz ensuite le cache du navigateur ou connectez-vous à nouveau dans une fenêtre de navigation privée. L’interface utilisateur de Cloud Exchange est disponible à l’adresse http(s)://<ip>.

Les plugins CLS qui utilisent l’authentification TLS doivent être mis à jour vers une version compatible CE 7.0.0 avant de pouvoir être configurés ou utilisés sur CE 7.0.0. Consultez la base de connaissances pour connaître les plugins concernés.

Déploiement HA

De la v5.1.1 à la v7.0.0, v5.1.2, v6.0.0, v6.0.1, v6.1.0 Déploiement autonome

Avant de commencer, remplissez les prérequis et effectuez une sauvegarde. Pour plus de détails, consultez Sauvegarder Cloud Exchange.

Le nœud autonome existant devient le nœud principal du cluster HA. Pour plus de détails sur les paramètres HA et sur la configuration du cluster, reportez-vous à la section Haute disponibilité de Cloud Exchange.

Une fois que vous êtes passé en haute disponibilité (HA), Cloud Exchange peut répondre lentement pendant les premières minutes pendant que les données sont répliquées sur tous les nœuds.

Sur le nœud autonome (New nœud primaire)

Accédez au répertoire /opt/cloudexchange/cloudexchange et arrêtez le déploiement autonome :
```
cd /opt/cloudexchange/cloudexchange
sudo ./stop
```

Ajoutez la clé publique Cloud Exchange en tant que clé GPG approuvée :

curl -fsSL https://cloud-exchange-store.s3.us-east-1.amazonaws.com/cloudexchange/upgrade-packages/cloud-exchange-public.gpg | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/cloud-exchange.gpg

Ajoutez l'URL S3 de Cloud Exchange en tant que source de package :

echo "deb https://cloud-exchange-store.s3.us-east-1.amazonaws.com/cloudexchange/upgrade-packages stable main" | sudo tee /etc/apt/sources.list.d/cloud-exchange.list

Mettre à jour les sources du paquet :
```
sudo apt update
```
Mettez à niveau Cloud Exchange et attendez que la mise à niveau soit terminée :
```
sudo apt install cloud-exchange=7.0.0-1
```
Avant d’exécuter cette commande, assurez-vous que toutes les conditions système requises pour Cloud Exchange sont remplies pour la v7.0.0.
Copiez l’exemple de fichier de configuration et ouvrez-le pour le modifier :
```
cp cloudexchange.config.example cloudexchange.config
vi cloudexchange.config
```
Dans cloudexchange.config, définissez les valeurs de ces champs. Définissez également les champs facultatifs que vous utilisez ou personnalisez, tels que la configuration du proxy et le port de l’interface utilisateur.
```
MAINTENANCE_PASSWORD=<old cloud exchange maintenance password>
JWT_SECRET=<old cloud exchange JWT secret>
```
JWT_SECRET est optionnel. Si vous le laissez vide, le script d’installation génère un New secret JWT.
Supprimer le fichier .env :
```
sudo rm -rf .env
```
Exécutez le script de configuration :
```
sudo python3 ./setup
```
Démarrez le Cloud Exchange :
```
sudo ./start
```
Ouvrez l’interface utilisateur du nœud principal dans votre navigateur à l’adresse https://<ip> et connectez-vous avec vos identifiants Cloud Exchange existants.
Accédez à Settings > General Settings > Node Configurations et activez le commutateur Enable HA. Dans la fenêtre contextuelle Confirmer l’action, saisissez l’adresse IP ou le FQDN de Cloud Exchange uniquement si vous devez les modifier, puis cliquez sur Enable HA.

Important

Pendant que la HA est activée, Cloud Exchange est temporairement indisponible et peut redémarrer plusieurs fois.

Sur les nœuds secondaires

Effectuez les étapes 1 à 8 sur chaque nœud secondaire. Ajoutez ensuite les nœuds secondaires depuis l'interface utilisateur du nœud primaire.

Déployez la dernière version de Cloud Exchange en tant qu’image de machine virtuelle (OVA, AMI, Azure, Hyper-V ou KVM).
Accédez au répertoire /opt/cloudexchange/cloudexchange :
```
cd /opt/cloudexchange/cloudexchange
```

Sur le nœud principal, copiez le contenu du fichier de clé CA :

/opt/cloudexchange/cloudexchange/data/ssl_certs/mongodb_rabbitmq_certs/tls_cert_ca.key

Sur le nœud secondaire, créez le fichier de clé d’autorité de certification, collez la clé que vous avez copiée et enregistrez le fichier. La clé d’autorité de certification correspondante permet au nœud secondaire de communiquer avec le cluster HA.
```
sudo vi /opt/cloudexchange/cloudexchange/data/ssl_certs/mongodb_rabbitmq_certs/tls_cert_ca.key
```
Supprimer le fichier .env :
```
sudo rm -rf .env
```
Copiez l’exemple de fichier de configuration et ouvrez-le pour le modifier :
```
cp cloudexchange.config.example cloudexchange.config
vi cloudexchange.config
```
Dans cloudexchange.config, définissez les valeurs de ces champs :

Important

Le secret JWT et la clé CA d'un nœud secondaire doivent correspondre à ceux du nœud principal. S'ils diffèrent, l'ajout du nœud secondaire au cluster HA échouera avec une erreur d'authentification. Si vous ne connaissez pas le secret JWT du nœud principal, générez-en un New et appliquez-le. Pour les étapes, reportez-vous à la section Dépannage de Cloud Exchange.
```
JWT_SECRET=<JWT_SECRET value of the primary node>
MAINTENANCE_PASSWORD=<old maintenance password>
```
Exécutez le script de configuration :
```
sudo python3 ./setup
```
Dans l’interface utilisateur du nœud principal, accédez à Settings > General Settings > Node Configurations et ajoutez les nœuds secondaires un par un.

Il n’est pas nécessaire d’exécuter le script de démarrage sur les nœuds secondaires. Il s’exécute automatiquement lorsque vous ajoutez un nœud secondaire depuis l’interface utilisateur du nœud principal.

Vers la version 7.0.0 à partir de la version 5.1.1, version 5.1.2, version 6.0.0, version 6.0.1, version 6.1.0 Déploiement HA

Avant de commencer, remplissez les prérequis et effectuez une sauvegarde. Pour plus de détails, consultez Sauvegarder Cloud Exchange.

Sur tous les nœuds

Arrêtez d'abord les nœuds secondaires, puis le nœud primaire, afin que Cloud Exchange s'arrête correctement :
```
cd /opt/cloudexchange/cloudexchange
sudo ./stop
```

Ajouter la clé publique Cloud Exchange en tant que clé GPG approuvée. Commencer par le nœud principal, puis continuer avec les nœuds secondaires :

curl -fsSL https://cloud-exchange-store.s3.us-east-1.amazonaws.com/cloudexchange/upgrade-packages/cloud-exchange-public.gpg | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/cloud-exchange.gpg

Ajoutez l'URL S3 de Cloud Exchange en tant que source de package :

echo "deb https://cloud-exchange-store.s3.us-east-1.amazonaws.com/cloudexchange/upgrade-packages stable main" | sudo tee /etc/apt/sources.list.d/cloud-exchange.list

Mettre à jour les sources du paquet :
```
sudo apt update
```
Mettez à niveau Cloud Exchange et attendez que la mise à niveau soit terminée :
```
sudo apt install cloud-exchange=7.0.0-1
```
Avant d’exécuter cette commande, assurez-vous que toutes les conditions système requises pour Cloud Exchange sont remplies pour la v7.0.0.

Sur le nœud principal

Copiez l’exemple de fichier de configuration et ouvrez-le pour le modifier :
```
cp cloudexchange.config.example cloudexchange.config
vi cloudexchange.config
```
Dans cloudexchange.config, définissez les valeurs de ces champs. Définissez également les champs facultatifs que vous utilisez ou personnalisez, tels que la configuration du proxy et le port de l’interface utilisateur.
```
HA_ENABLED=True
HA_CURRENT_NODE=<current node ip>
HA_PRIMARY_NODE_IP=<current node ip>
HA_IP_LIST=<current node ip>
MAINTENANCE_PASSWORD=<old maintenance password>
JWT_SECRET=<old cloud exchange JWT secret>
```
JWT_SECRET est optionnel. Si vous le laissez vide, le script d’installation génère un New secret JWT.
Supprimer le fichier .env :
```
sudo rm -rf .env
```
Exécutez le script de configuration :
```
sudo python3 ./setup
```
Démarrez le Cloud Exchange :
```
sudo ./start
```

Sur les nœuds secondaires

Effectuez les étapes 1 à 6 sur chaque nœud secondaire. Ajoutez ensuite les nœuds secondaires à partir de l'interface utilisateur du nœud primaire.

Sur le nœud principal, copiez le contenu du fichier de clé CA :

/opt/cloudexchange/cloudexchange/data/ssl_certs/mongodb_rabbitmq_certs/tls_cert_ca.key

Sur le nœud secondaire, créez le fichier de clé d’autorité de certification, collez la clé que vous avez copiée et enregistrez le fichier. La clé d’autorité de certification correspondante permet au nœud secondaire de communiquer avec le cluster HA.
```
sudo vi /opt/cloudexchange/cloudexchange/data/ssl_certs/mongodb_rabbitmq_certs/tls_cert_ca.key
```
Supprimer le fichier .env :
```
sudo rm -rf .env
```
Copiez l’exemple de fichier de configuration et ouvrez-le pour le modifier :
```
cp cloudexchange.config.example cloudexchange.config
vi cloudexchange.config
```
Dans cloudexchange.config, définissez les valeurs de ces champs :

Important

Le secret JWT et la clé CA d'un nœud secondaire doivent correspondre à ceux du nœud principal. S'ils diffèrent, l'ajout du nœud secondaire au cluster HA échouera avec une erreur d'authentification. Si vous ne connaissez pas le secret JWT du nœud principal, générez-en un New et appliquez-le. Pour les étapes, reportez-vous à la section Dépannage de Cloud Exchange.
```
JWT_SECRET=<JWT_SECRET value of the primary node>
MAINTENANCE_PASSWORD=<old maintenance password>
```
Exécutez le script de configuration :
```
sudo python3 ./setup
```
Dans l’interface utilisateur du nœud principal, accédez à Settings > General Settings > Node Configurations et ajoutez les nœuds secondaires un par un.

Il n’est pas nécessaire d’exécuter le script de démarrage sur les nœuds secondaires. Il s’exécute automatiquement lorsque vous ajoutez un nœud secondaire depuis l’interface utilisateur du nœud principal.