Migrating data between objectstores

Você pode precisar migrar seus dados do Objectstore se quiser executar qualquer uma das seguintes operações:

• Faça um backup único dos dados do Objectstore;
• Migre os dados do Objectstore de um cluster do Automation Suite para outro.

Requisitos

Antes de iniciar a migração de dados do Objectstore, certifique-se de atender aos seguintes requisitos:

• Você baixou os seguintes arquivos:

  • 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.

• Você tem armazenamento temporário, necessário para baixar e carregar no Objectstore. O tamanho do armazenamento temporário depende do tamanho dos dados armazenados no Objectstore. Para identificar o tamanho de armazenamento necessário, execute o seguinte comando em qualquer nó do servidor:

  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"
  

Preparando-se para uma instalação offline

Importante:

As instruções nesta seção são aplicáveis apenas se a configuração do Automation Suite estiver offline.

Você pode ter que executar essas etapas na máquina de onde você faz o download e aquela em que você carrega os dados do Objectstore.

Execute as etapas a seguir em qualquer um dos nós do servidor com acesso raiz.

1. Faça login no registro privado do docker na instalação offline:

   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. Envie o utilitário tarball para o registro privado do docker:

   1. Certifique-se de ter copiado o tarball do utilitário para o nó do servidor e navegue até seu local.

   2. Extraia e carregue a imagem em um registro privado do docker executando o seguinte comando:

      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
      

Download de dados do objectstore

Observação:

Make sure you have available storage space on the server node to take the Objectstore backup before proceeding with the following steps.

1. Copie o script objectstore-migration.sh para o nó do servidor onde você identificou o armazenamento disponível para fazer o backup.

2. Navegue até a pasta onde você copiou o script de migração.

3. Faça backup dos dados do Objectstore executando o seguinte comando:

   Observação:

   Before running the main script, make sure to provide the absolute folder path where the backup data will be stored. Use the CEPH_BACKUP_PATH variable to specify the path.

   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. Se o backup for bem-sucedido, você deverá ver a seguinte saída:

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

Upload de dados para o objectstore

Importante:

If you upload the data to a different Automation Suite Objectstore, make sure that the data backed up in the previous section is available on any server node. You can either mount the disk on the new cluster’s server node, or you can also transfer the data by any other means you may prefer.

Para fazer upload dos dados para o Objectstore, execute as seguintes etapas:

1. Copie o script objectstore-migration.sh para o nó do servidor onde você identificou o armazenamento disponível para fazer o backup.

2. Navegue até a pasta onde você copiou o script de migração.

3. Faça upload dos dados para o Objectstore executando o seguinte comando:

   Observação:

   Before running the main script, make sure to provide the absolute folder path where the backup data will be copied to the Objectstore. Use the CEPH_BACKUP_PATH variable to specify the path.

   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. Se o upload for bem-sucedido, você deverá ver a seguinte saída:

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