Restaurer Cloud Exchange - Documentation technique Netskope

Pour effectuer la sauvegarde Cloud Exchange, veuillez consulter les étapes fournies dans la section Sauvegarde Cloud Exchange .

Before proceeding with the restore, identify your Cloud Exchange deployment type to ensure you follow the appropriate restore path. See How to Identify your Cloud Exchange Deployment Type.

Déploiement en conteneur

Prerequisites:

Avant de lancer une restauration, assurez-vous que le fichier de sauvegarde (ce_backup.zip) est stocké dans le dossier ta_cloud_exchange/data/.
Assurez-vous d'avoir le mot de passe de maintenance à portée de main, car il sera nécessaire pour effectuer certaines étapes de ce processus.

Important

Si le mot de passe de maintenance est perdu, les données ne peuvent pas être conservées.

Notes

La migration des données de RabbiMQ n'est pas prise en charge en raison du changement de type de file d'attente de Classic à Quorum.

Déploiement autonome

Allez dans le répertoire ta_cloud_exchange.
```
cd ta_cloud_exchange
```
Arrêtez les conteneurs.
```
sudo ./stop
```
Allez dans le répertoire de données.
```
cd data
```

Supprimez les données, les dépôts et les plugins de Mongo.

sudo rm -rf mongo-data/data/db/* repos/* plugins/* rabbitmq/data/*

Retournez dans le répertoire ta_cloud_exchange.
```
cd ..
```
Avant de continuer, vérifiez la version souhaitée du dépôt. Remplacez v6.1.0 par la version que vous souhaitez utiliser. Consultez les balises GitHub Netskope CE pour une liste des versions disponibles. Par exemple, pour consulter la version 6.1.0 :
```
git checkout v6.1.0
```
Allez dans le répertoire de données.
```
cd data
```

Fichier de décompression pour les données Mongo, les dépôts et les plugins.

sudo unzip ce_backup.zip "mongo-data/*" "repos/*" "plugins/*" "custom_plugins/*" -d .

Retournez dans le répertoire ta_cloud_exchange.
```
cd ..
```
Exécuter le script d'installation
```
sudo python3 ./setup
```
Exécutez le script de démarrage à l'aide de la commande ci-dessous.
```
sudo ./start
```

Déploiement HA

Pour les versions de CE antérieures à 6.0.0

On All Nodes (step: 1,2,3,4,5,6)

Allez dans le répertoire ta_cloud_exchange.
```
cd ta_cloud_exchange
```
Pour garantir un bon CE lors de l'arrêt de la VM, arrêtez les deux nœuds secondaires, puis le nœud primaire à l'aide de la commande ci-dessous :
```
sudo ./stop
```
Allez dans le répertoire de données.
```
cd data
```

Supprimez les données, les dépôts et les plugins de Mongo.

sudo rm -rf mongo-data/data/db/* repos/* plugins/* rabbitmq/data/*

Retournez dans le répertoire ta_cloud_exchange.
```
cd ..
```
Avant de continuer, vérifiez la version souhaitée du dépôt. Remplacez v5.1.2 par la version que vous souhaitez utiliser. Consultez les balises GitHub Netskope CE pour une liste des versions disponibles. Par exemple, pour emprunter la version 5.1.2 :
```
git checkout v5.1.2
```
On Primary Node (step: 7,8,9,10,11)
Allez dans le répertoire de données.
```
cd data
```
Fichier de décompression pour les données Mongo, les dépôts et les plugins. (When prompted with the replace confirmation message, enter A to select All and proceed with replacing all existing files.)
```
sudo unzip ce_backup.zip "mongo-data/*" -d .
sudo unzip ce_backup.zip "plugins/*" "repos/*" "custom_plugins/*" -d <shared_directory>
```
Retournez dans le répertoire ta_cloud_exchange.
```
cd ..
```
Exécuter le script d'installation
```
sudo python3 ./setup
```
Pour migrer les données Mongo, utilisez cette commande une seule fois.
```
sudo ./restore_ha_backup
```
On Secondary Nodes (step: 12)
Exécutez le script d'installation sur les nœuds secondaires avec l'option -location. Indiquez le chemin du répertoire monté sur NFS dans l'option -location. Indiquez l'adresse IP de la machine actuelle.
```
sudo python3 ./setup --location <shared_directory>
```
On All Nodes (step: 13)
Lancez Cloud Exchange sur le site primary node first. Le script attendra que les migrations soient terminées. Lancez ensuite Cloud Exchange sur les nœuds restants pour qu'ils rejoignent le cluster :
```
sudo ./start
```

Pour les versions 6.0.0 et New CE

On All Nodes (step: 1,2,3,4,5,6,7,8)

Allez dans le répertoire ta_cloud_exchange.
```
cd ta_cloud_exchange
```
Pour garantir un bon CE lors de l'arrêt de la VM, arrêtez les deux nœuds secondaires, puis le nœud primaire à l'aide de la commande ci-dessous :
```
sudo ./stop
```
Allez dans le répertoire de données.
```
cd data
```

Supprimez les données, les dépôts et les plugins de Mongo.

sudo rm -rf mongo-data/data/db/* repos/* plugins/* rabbitmq/data/*

Retournez dans le répertoire ta_cloud_exchange.
```
cd ..
```
Supprimez les certificats TLS en suivant les étapes ci-dessous :
```
sudo rm -rf data/ssl_certs/mongodb_rabbitmq_certs/tls_cert*
```
Avant de continuer, vérifiez la version souhaitée du dépôt. Remplacez v6.1.0 par la version que vous souhaitez utiliser. Consultez les balises GitHub Netskope CE pour une liste des versions disponibles. Par exemple, pour consulter la version 6.1.0 :
```
git checkout v6.1.0
```
Suivez la documentation Cloud Exchange Troubleshooting pour supprimer le volume de stockage partagé GlusterFS et les nœuds homologues.
On Primary Node (step: 9,10,11,12,13,14,15,16)
Allez dans le répertoire de données.
```
cd data
```
Fichier de décompression pour les données Mongo, les dépôts et les plugins. (When prompted with the replace confirmation message, enter A to select All and proceed with replacing all existing files.)
```
sudo unzip ce_backup.zip "mongo-data/*" -d .
sudo mkdir /opt/shared/data/ -p
sudo unzip ce_backup.zip "plugins/*" "repos/*" "custom_plugins/*" -d /opt/shared/data
```
Retournez dans le répertoire ta_cloud_exchange.
```
cd ..
```
Copiez et éditez le fichier de configuration de cloudexchange en utilisant les commandes ci-dessous :
```
cp cloudexchange.config.example cloudexchange.config
vi cloudexchange.config
```
Mettez à jour le fichier de configuration de cloudexchange avec les valeurs des champs obligatoires. Veillez également à configurer les champs facultatifs tels que la configuration du proxy, le port de l'interface utilisateur, etc. s'ils sont utilisés/personnalisés. JWT_SECRECT est optionnel, le script d'installation générera New JWT secret s'il n'est pas fourni.
```
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 cloud exchange maintenance password>
JWT_SECRECT=<old cloud exchange JWT secret>
```
Exécuter le script d'installation
```
sudo python3 ./setup
```
Pour migrer les données Mongo, utilisez cette commande une seule fois.
```
sudo ./restore_ha_backup
```
Exécutez le script de démarrage à l'aide de la commande ci-dessous.
```
sudo ./start
```
On Secondary Nodes (step: 17)
Pour configurer les nœuds secondaires, suivez les instructions fournies dans la page Cloud Exchange High Availability.

Déploiement de Cloud Exchange en tant que VM

Prerequisites:

Avant de lancer une restauration, assurez-vous que le fichier de sauvegarde (ce_backup.zip) est stocké dans le dossier /opt/cloudexchange/cloudexchange/data/.
Assurez-vous d'avoir le mot de passe de maintenance à portée de main, car il sera nécessaire pour effectuer certaines étapes de ce processus.

Important

Si le mot de passe de maintenance est perdu, les données ne peuvent pas être conservées.

Notes

La migration des données de RabbiMQ n'est pas prise en charge en raison du changement de type de file d'attente de Classic à Quorum.

Déploiement autonome

Allez dans le répertoire /opt/cloudexchange/cloudexchange.
```
cd /opt/cloudexchange/cloudexchange
```
Arrêtez les conteneurs.
```
sudo ./stop
```
Allez dans le répertoire de données.
```
cd data
```

Supprimez les données, les dépôts et les plugins de Mongo.

sudo rm -rf mongo-data/data/db/* repos/* plugins/* rabbitmq/data/*

Fichier de décompression pour les données Mongo, les dépôts et les plugins.

sudo unzip ce_backup.zip "mongo-data/*" "repos/*" "plugins/*" "custom_plugins/*" -d .

Retournez dans le répertoire /opt/cloudexchange/cloudexchange.
```
cd ..
```
Exécuter le script d'installation
```
sudo python3 ./setup
```
Exécutez le script de démarrage à l'aide de la commande ci-dessous.
```
sudo ./start
```

Déploiement HA

Pour les versions de CE antérieures à 6.0.0

On All Nodes (step: 1,2,3,4,5)

Allez dans le répertoire /opt/cloudexchange/cloudexchange.
```
cd /opt/cloudexchange/cloudexchange
```
Pour garantir un bon CE lors de l'arrêt de la VM, arrêtez les deux nœuds secondaires, puis le nœud primaire à l'aide de la commande ci-dessous :
```
sudo ./stop
```
Allez dans le répertoire de données.
```
cd data
```

Supprimez les données, les dépôts et les plugins de Mongo.

sudo rm -rf mongo-data/data/db/* repos/* plugins/* rabbitmq/data/*

Retournez dans le répertoire /opt/cloudexchange/cloudexchange.
```
cd ..
```
On Primary Node (step: 6,7,8,9,10)
Allez dans le répertoire de données.
```
cd data
```
Fichier de décompression pour les données Mongo, les dépôts et les plugins. (When prompted with the replace confirmation message, enter A to select All and proceed with replacing all existing files.)
```
sudo unzip ce_backup.zip "mongo-data/*" -d .
sudo unzip ce_backup.zip "plugins/*" "repos/*" "custom_plugins/*" -d <shared_directory>
```
Retournez dans le répertoire /opt/cloudexchange/cloudexchange.
```
cd ..
```
Exécuter le script d'installation
```
sudo python3 ./setup
```
Pour migrer les données Mongo, utilisez cette commande une seule fois.
```
sudo ./restore_ha_backup
```
On Secondary Nodes (step: 11)
Exécutez le script d'installation sur les nœuds secondaires avec l'option -location. Indiquez le chemin du répertoire monté sur NFS dans l'option -location. Indiquez l'adresse IP de la machine actuelle.
```
sudo python3 ./setup --location <shared_directory>
```
On All Nodes (step: 12)
Lancez Cloud Exchange sur le primary node first. Le script attendra que les migrations soient terminées. Lancez ensuite Cloud Exchange sur les nœuds restants pour rejoindre le cluster :
```
sudo ./start
```

Pour les versions 6.0.0 et New CE

On All Nodes (step: 1,2,3,4,5,6,7)

Allez dans le répertoire /opt/cloudexchange/cloudexchange.
```
cd /opt/cloudexchange/cloudexchange
```
Pour garantir un bon CE lors de l'arrêt de la VM, arrêtez les deux nœuds secondaires, puis le nœud primaire à l'aide de la commande ci-dessous :
```
sudo ./stop
```
Allez dans le répertoire de données.
```
cd data
```

Supprimez les données, les dépôts et les plugins de Mongo.

sudo rm -rf mongo-data/data/db/* repos/* plugins/* rabbitmq/data/*

Retournez dans le répertoire /opt/cloudexchange/cloudexchange.
```
cd ..
```
Supprimez les certificats TLS en suivant les étapes ci-dessous :
```
sudo rm -rf data/ssl_certs/mongodb_rabbitmq_certs/tls_cert*
```
Suivez la documentation de dépannage de Cloud Exchange pour supprimer le volume de stockage partagé GlusterFS et les nœuds homologues.
On Primary Node (step: 8,9,10,11,12,13,14,15)
Allez dans le répertoire de données.
```
cd data
```
Fichier de décompression pour les données Mongo, les dépôts et les plugins. (When prompted with the replace confirmation message, enter A to select All and proceed with replacing all existing files.)
```
sudo unzip ce_backup.zip "mongo-data/*" -d .
sudo mkdir /opt/shared/data/ -p
sudo unzip ce_backup.zip "plugins/*" "repos/*" "custom_plugins/*" -d /opt/shared/data
```
Retournez dans le répertoire /opt/cloudexchange/cloudexchange.
```
cd ..
```
Copiez et éditez le fichier de configuration de cloudexchange en utilisant les commandes ci-dessous :
```
cp cloudexchange.config.example cloudexchange.config
vi cloudexchange.config
```
Mettez à jour le fichier de configuration de cloudexchange avec les valeurs des champs obligatoires. Veillez également à configurer les champs facultatifs tels que la configuration du proxy, le port de l'interface utilisateur, etc. s'ils sont utilisés/personnalisés. JWT_SECRECT est optionnel, le script d'installation générera New JWT secret s'il n'est pas fourni.
```
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 cloud exchange maintenance password>
JWT_SECRECT=<old cloud exchange JWT secret>
```
Exécuter le script d'installation
```
sudo python3 ./setup
```
Pour migrer les données Mongo, utilisez cette commande une seule fois.
```
sudo ./restore_ha_backup
```
Exécutez le script de démarrage à l'aide de la commande ci-dessous.
```
sudo ./start
```
On Secondary Nodes (step: 16)
Pour configurer les nœuds secondaires, suivez les instructions fournies dans la page Cloud Exchange High Availability.