Pré-requisitos de migração

Antes de iniciar a migração, certifique-se de atender aos seguintes pré-requisitos:

.NET Runtime 6.0

É necessário ter o .NET Runtime 6.0 ou posterior para executar a ferramenta UiPath.OrganizationMigrationApp. Você deve baixá-lo e instalá-lo antes de executar o UiPath.OrganizationMigrationApp.

Linux

Se o .NET Runtime 6.0 ou posterior não estiver presente, baixe e instale o .NET Runtime para Linux antes de usar o UiPath.OrganizationMigrationApp.

Para instalar.NET Runtime 6.0 no RHEL, execute o seguinte comando:

sudo yum install dotnet-sdk-6.0 -y

Windows

A ferramenta UiPath.OrganizationMigrationApp requer o .NET Runtime 6.0 ou superior. Se o .NET Runtime 6.0 e posterior não estiver presente, baixe e instale o .NET Runtime 6.0 para Windows antes de usar o UiPath.OrganizationMigrationApp.

Docker/Podman

Para concluir o processo de migração, você deve usar um cliente Docker ou Podman que tenha sido autenticado com o registro privado. Isso permite que os migradores sejam executados nos bancos de dados MSI, tornando-os compatíveis com os bancos de dados do Automation Suite.

Docker

• Para baixar os binários do Docker, consulte a documentação oficial Instalar o mecanismo do Docker.
• Para autenticar o registro do Docker, consulte a documentação oficial do login do docker. Como alternativa, você pode usar o seguinte comando para substituir as credenciais de amostra por suas credenciais de registro reais:

  docker login my.registry.io:443 --username "admin" --password "secret"
  

Podman

• Para baixar os binários do Podman, consulte as Instruções oficiais de instalação do Podman.
• Para se autenticar no registro do Podman, consulte a documentação oficial de login do Podman. Como alternativa, você pode usar o seguinte comando para substituir as credenciais de amostra por suas credenciais de registro reais:

  podman login my.registry.io:443 --username "admin" --password "secret"
  

Configuraçãode criação de bucket do Orchestrator

Para garantir que os buckets do Orchestrator sejam criados automaticamente com a política de CORS correta, você deve executar o seguinte comando. O comando requer que o utilitário jq esteja instalado na sua máquina.

cd <AS install directory>
rm -f values.json && rm -f appsettings.json
oc -n <uipath> get cm orchestrator-customconfig -o jsonpath='{.data.values\.json}' | jq '.' > values.json
jq '.AppSettings' values.json > appsettings.json
jq '.["Storage.CreateBucket.OnTenantCreation.Enabled"] = "true"' appsettings.json > temp.json && mv -f temp.json appsettings.json
uipathctl config orchestrator update-config --app-settings appsettings.json

Para instalar jq, use uma das seguintes opções:

• Opção 1: execute o seguinte comando:

  yum install -y epel-release yum install -y jq
  

• Opção 2: execute os seguintes comandos:

  shell
  curl https://download-ib01.fedoraproject.org/pub/epel/7/x86_64/Packages/j/jq-1.6-2.el7.x86_64.rpm --output /tmp/jq-1.6-2.el7.x86_64.rpm
  yum localinstall /tmp/jq-1.6-2.el7.x86_64.rpm
  

AVISO:

Não habilitar a configuração do Orchestrator, que garante que os buckets sejam criados automaticamente com a política do CORS correta, causa problemas com o download de buckets de armazenamento, que você deve resolver fazendo atualizações manuais na política do CORS.

Para confirmar que a configuração foi habilitada, execute o seguinte comando:

oc -n <uipath> get cm orchestrator-customconfig -o jsonpath='{.data.values\.json}' | jq

Se a configuração tiver sido habilitada, o comando deve retornar a seguinte resposta:

{
  "AppSettings": {
    "Storage.CreateBucket.OnTenantCreation.Enabled": "true"
  }
}

UiPath.OrganizationMigrationApp

A ferramenta UiPath.OrganizationMigrationApp ajuda você a executar operações como mover os dados de identidade de todos os tenants de independentes para o Automation Suite e mesclar organizações.

Para baixar o UiPath.OrganizationMigrationApp, consulte Download dos pacotes de instalação.

Para verificar qual versão do UiPath.OrganizationMigrationApp é compatível com seu ambiente, consulte Matriz de compatibilidade.

Ferramenta para gerenciar o Microsoft SQL Server

Você deve baixar e instalar o SQL Server Management Studio (SSMS) ou uma ferramenta semelhante para gerenciar o Microsoft SQL Server. Essa ferramenta ajuda você a restaurar o banco de dados do Orchestrator para a instância do SQL Server do Automation Suite ou uma instância diferente do SQL Server.

1. Baixe e instale o SQL Server Management Studio.
2. Faça login no SQL Server independente usando a string de conexão SQL independente.
3. Abra a porta 1433 para o banco de dados de origem e destino.

Regras de escape de caractere especial para senhas da string de conexão

Na maioria das instâncias, as senhas de conexão são encapsuladas dentro de uma única aspa ('). No entanto, quando a senha inclui caracteres especiais, como ` e $, é necessária uma abordagem diferente.

Nesses casos, a senha deve ser formatada como \`"<password>\`", substituindo <password> pela senha verdadeira. Além disso, você também deve aderir às regras de escape conforme detalhado na seguinte tabela:

Formato original no ADUC	Formato escapado na string do PowerShell
cn=James $ Smith	"cn=James `$ Smith"
cn=Sally Wilson + Jones	"cn=Sally Wilson \+ Jones"
cn=William O'Brian	"cn=William O'Brian"
cn=William O`Brian	"cn=William O``Brian"
cn=Richard #West	"cn=Richard #West"
cn=Roy Johnson$	"cn=Roy Johnson$"

Exemplo

Presuma que a senha original seja 7'8:<=XMe$y[@vC?_4ZeY8c-~y'W!1dU4gnczuf'/p>j<I. Aderindo às regras de escape de caractere especial, ele se torna: Password=\`"7'8:<=XMe`$y[@vC?_4ZeY8c-~y'W!1dU4```gnczuf'/p>```j<I\`".

O comando completo, com a senha configurada na string de conexão de destino, tem a seguinte aparência:

./UiPath.OrganizationMigrationApp.exe migrate -a -m -s "Server=tcp:abc.com,1433;Initial Catalog=UiPath_20230531;Persist Security Info=False;User ID=username;Password=asiodhyf;MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=True;Connection Timeout=30;" -d "Server=tcp:cde.net,1433;Initial Catalog=AutomationSuite_Platform;Persist Security Info=False;User Id=[e-mail];Password=\`"7'8:<=XMe`$y[@vC?_4ZeY8c-~y'W!1dU4```gnczuf'/p>```j<I\`""

Requisito de configuração de grupo do administrador

Antes de iniciar a migração, você deve adicionar o grupo Administrador em cada tenant.

Se você estiver executando uma mesclagem da organização e o grupo Administrator não estiver adicionado em todos os tenants, você poderá se bloquear da instância do Orchestrator após a conclusão da mesclagem.

Adicionar o grupo Administrador em cada tenant garante que o acesso administrativo seja preservado durante todo o processo de migração e mesclagem.

Script de migração do Test Manager

O script de migração do Test Manager (testmanager_migrator.sh) ajuda você a executar várias operações automáticas para migrar várias configurações e arquivos, como:

• Execute operações kubectl , como atualizar mapas de segredos e configurações.
• Realize sincronizações do ArgoCD por meio do CLI.
• Substitua as configurações e reinicie as implantações.
• Adicione arquivos de armazenamento ao armazenamento de objetos do Ceph.
• Restaure e atualize o DataEncryptionKey nos segredos do Kubernetes a partir da instância do MSI.
• Sincronize o Test Manager no ArgoCD.
• Migre pastas ou arquivos de um armazenamento de arquivos do Windows para o armazenamento de objetos de destino, criando a hierarquia de diretórios necessária no bucket definido por segredos do Kubernetes.

Requisitos de ambiente para executar o script de migração do Test Manager

Para executar com êxito o script de migração do Test Manager, você precisa garantir que atende aos seguintes requisitos de ambiente:

• Configure kubectl com uma conexão ao cluster do Automation Suite.
  Importante:

  Certifique-se de que kubeconfig esteja definido como uma variável de ambiente.

• Instale o utilitário jq usando o seguinte comando yum install jq.
• Instale a CLI argocd . Acesse Instalação do Argo CD para obter mais informações.
• Instale o Rclone. Acesse a documentação do RClone para obter mais informações.
  Observação:

  A versão mínima exigida para o Rclone é 1.56.0.

Observação:

Se sua Identidade for gerenciada no Azure, certifique-se de executar o script usando uma máquina do Azure.

Comandos comuns de script de migração do Test Manager

Verifique os seguintes comandos que você pode executar usando o script de migração do Test Manager:

 ./testmanager_migrator.sh -d -y \
  -k \"enc key value\" \
  -s blobstoragefolder
    -k|--encryption-key
        The value of the encryption key that will override the key generated during installation.
    -s|--storage-folder
        The location of the storage folder on the local disk.
    -is-|--use-incluster-storage
        Use in cluster Ceph object store.
    -d|--dry-run
        Do not update Test Manager with the new values
    -y|--accept-all
        Do not prompt for confirmation of actions