Migration des données entre les librairies

Vous devrez peut-être migrer vos données Objectstore si vous souhaitez effectuer l'une des opérations suivantes :

• Effectuez une sauvegarde unique des données de l'Objectstore ;
• Migrez les données Objectstore d'un cluster Automation Suite vers un autre.

Prérequis

Avant de démarrer la migration des données Objectstore, assurez-vous de répondre aux exigences suivantes :

• Vous avez téléchargé les fichiers suivants :

  • objectstore-migration.sh migration script. For download instructions, see objectstore-migration.sh.
  • automation-suite-util.tar.gz utility tarball. For download instructions, see automation-suite-util.tar.gz.

• Vous disposez d'un stockage temporaire, requis pour le téléchargement et le chargement vers l'Objectstore. La taille du stockage temporaire dépend de la taille des données stockées dans l'Objectstore. Pour identifier la taille de stockage requise, exécutez la commande suivante sur n'importe quel nœud de serveur :

  object_size=$(kubectl -n rook-ceph exec deploy/rook-ceph-tools -- ceph status --format json | jq -r '.pgmap.data_bytes')
  echo "You need '$(numfmt --to=iec-i $object_size)' storage space"
  

Préparation pour une installation hors ligne

Important :

Les instructions de cette section ne s'appliquent que si votre configuration Automation Suite est hors ligne.

Vous devrez peut-être effectuer ces étapes sur la machine à partir de laquelle vous téléchargez et sur celle sur laquelle vous chargez les données Objectstore.

Effectuez les étapes suivantes sur l’un des nœuds de serveur avec accès root.

1. Connectez-vous au registre Docker privé dans l'installation hors ligne :

   dpr_username=$(grep -m1 'username:' /etc/rancher/rke2/registries.yaml | awk -F 'username:' '{print $2}' | tr -d ' ')
   dpr_password=$(grep -m1 'password:' /etc/rancher/rke2/registries.yaml | awk -F 'password:' '{print $2}' | tr -d ' ')
   
   podman login localhost:30071 --username ${dpr_username} --password ${dpr_password} --tls-verify=false
   

2. Transférez l'archive tar de l'utilitaire vers le registre Docker privé :

   1. Assurez-vous d'avoir copié l'archive tar de l'utilitaire sur le nœud du serveur et accédez à son emplacement.

   2. Extrayez et chargez l'image dans un registre Docker privé en exécutant la commande suivante :

      gzip -dk -c automation-suite-util.tar.gz > sf-k8-utils-rhel_24_10_2.tar
      podman load -i sf-k8-utils-rhel_24_10_2.tar
      podman push --tls-verify=false localhost:30071/uipath/sf-k8-utils-rhel:24.10.2
      

Téléchargement des données à partir du magasin d'objets

Remarque :

Assurez-vous que vous disposez d'un espace de stockage disponible sur le nœud du serveur pour effectuer la sauvegarde du magasin d'objets avant de passer aux étapes suivantes.

1. Copiez le script objectstore-migration.sh sur le nœud du serveur où vous avez identifié le stockage disponible pour effectuer la sauvegarde.

2. Accédez au dossier dans lequel vous avez copié le script de migration.

3. Sauvegardez les données du magasin d'objets en exécutant la commande suivante :

   Remarque :

   Avant d'exécuter le script principal, assurez-vous de fournir le chemin d'accès absolu au dossier où les données de sauvegarde seront stockées. Utilisez la variable CEPH_BACKUP_PATH pour spécifier le chemin d'accès.

   export CEPH_BACKUP_PATH=/ceph/backup/path # please replace /ceph/backup/path with the path where you want to take the backup
   export CEPH_OPERATION=backup
   ./objectstore-migration.sh
   

4. Si la sauvegarde est réussie, vous devriez voir la sortie suivante :

   job.batch/ceph-objectstore-ondemand-backup-job created
   job.batch/ceph-objectstore-ondemand-backup-job condition met
   

Téléchargement des données vers le magasin d'objets

Important :

Si vous téléchargez les données vers un autre magasin d'objets Automation Suite, assurez-vous que les données sauvegardées dans la section précédente sont disponibles sur n'importe quel nœud de serveur. Vous pouvez soit monter le disque sur le nœud de serveur du nouveau cluster, soit transférer les données par tout autre moyen que vous préférez.

Pour télécharger les données vers l'Objectstore, procédez comme suit :

1. Copiez le script objectstore-migration.sh sur le nœud du serveur où vous avez identifié le stockage disponible pour effectuer la sauvegarde.

2. Accédez au dossier dans lequel vous avez copié le script de migration.

3. Téléchargez les données dans l'Objectstore en exécutant la commande suivante :

   Remarque :

   Avant d'exécuter le script principal, assurez-vous de fournir le chemin d'accès absolu au dossier dans lequel les données de sauvegarde seront copiées vers l'Objectstore. Utilisez la variable CEPH_BACKUP_PATH pour spécifier le chemin d'accès.

   export CEPH_BACKUP_PATH=/ceph/backup/path
   export CEPH_OPERATION=restore
   export CEPH_RESTORE_CLEAN=true # set this to false to allow restore without deleting existing data
   ./objectstore-migration.sh
   

4. Si le téléchargement réussit, vous devriez voir la sortie suivante :

   job.batch/ceph-objectstore-ondemand-restore-job created
   job.batch/ceph-objectstore-ondemand-restore-job condition met