Migration des données vers le nouveau cluster

Migrer les données vers un nouveau cluster Automation Suite dans le cadre du processus de mise à niveau.

Hors ligne uniquement

1. Hydratez le registre Docker exécuté sur le cluster source avec le bundle correspondant avec la version vers laquelle vous prévoyez d'effectuer la mise à niveau. Assurez-vous de télécharger as.tar.gz sur la machine serveur du cluster source où vous avez associé le disque de bundle UiPath® au point de montage /uipath . L'emplacement préféré est /uipath/<new_version>/as.tar.gz.

2. Créez un emplacement temporaire pour décompresser le bundle.

   mkdir -p /uipath/tmp
   

3. Hydratez le registre Docker du cluster source avec le dernier bundle hors ligne.

   ./bin/uipathctl registry upload --offline-bundle /uipath/<new_version>/as.tar.gz --offline-tmp-folder /uipath/tmp
   

Remarque :

Vous pouvez exécuter le script de migration des données avant de mettre le cluster en mode de maintenance pour réduire le temps de migration pendant la période d'arrêt.

Clonage de vos bases de données de cluster source

Important :

• Vous pouvez autoriser le programme d'installation à créer les nouvelles bases de données avec les noms par défaut lors de l'installation des composants et services partagés. Pour plus de détails, consultez la section Configuration de Microsoft SQL Server.
• Si les noms de vos bases de données sont différents, vous devez supprimer les bases de données créées par le programme d'installation, copier les bases de données du SQL Server source vers le nouveau SQL Server et conserver les noms de bases de données.
• Si vous choisissez de modifier le nom de la base de données dans le nouveau SQL Server, vous devez modifier avec soin le fichier cluster_config.json pour chaque produit que vous installez.

1. Assurez-vous de récupérer le nouveau programme d'installation sur votre cluster source pour migrer les données vers le nouveau cluster cible.

   Suivez les étapes décrites dans Téléchargement du package d'installation et obtention des fichiers sur les machines sur l'un des nœuds de serveur du cluster source à partir duquel vous prévoyez de déclencher la migration.

2. Mettez le cluster source en mode maintenance :

   ./bin/uipathctl cluster maintenance enable
   

   Important :

   Le temps d'arrêt commence maintenant.

3. Copiez vos bases de données dans le cluster cible à l'aide de votre méthode préférée. Par exemple, vous pouvez utiliser l'assistant de copie de base de données.

Clonage de vos données de cluster source

1. Obtenez le fichier target_kubeconfig du cluster cible pour effectuer la migration des données en exécutant la commande suivante :

   ./bin/uipathctl config kubeconfig get --migration
   

   Remarque :

   Le fichier target_kubeconfig est requis pour récupérer les informations du magasin d'objets du cluster cible et effectuer la copie des données nécessaire pour la version cible.

2. Copiez le fichier généré dans le cluster source. Vous devrez utiliser ce fichier lors de la migration des données. Vous devez remplacer <target_kubeconfig> par ce chemin d'accès au fichier dans les étapes suivantes.

3. Copiez les données du cluster source vers le cluster cible en exécutant le script de migration des données sur le cluster source.

   cd /opt/UiPathAutomationSuite/<new_version>/installer
   ./bin/uipathctl cluster migration run cluster_config.json --target-kubeconfig <target_kubeconfig> --versions versions/helm-charts.json
   

   Remarque :

   • La commande de migration précédente est idempotente. Si la commande échoue entre les deux en raison de la connectivité réseau, vous pouvez la réexécuter et elle poursuivra le processus de migration là où il s'est arrêté.
   • Vous pouvez également effectuer une synchronisation différentielle de la migration des données en exécutant à nouveau la commande de migration.
   Important :

   Si le cluster utilise le magasin d'objets intégré au cluster (Ceph) et si vous avez opté pour la mise à niveau côte à côte (démarrage du nœud unique), la commande de migration peut échouer lors de la vérification des prérequis CEPH_SPACE_VALIDATION . Cela se produit parce que le cluster source dispose de trois répliques de données et que le cluster cible est non-HA avec un seul nœud. Vous pouvez ignorer la vérification des prérequis dans ce cas :

   ./bin/uipathctl cluster migration run cluster_config.json --target-kubeconfig
           <target_kubeconfig> --versions versions/helm-chart.json
     --skip-pre-reqs
   

4. Si vous utilisez un magasin d'objets externe dans le cluster source, clonez les compartiments du magasin d'objets.