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 o .NET Runtime 6.0 no RHEL, execute o seguinte comando:

sudo yum install dotnet-sdk-6.0 -y

Windows

A ferramenta UiPath.OrganizationMigrationApp requer, no mínimo, .NET Runtime 6.0. Se o .NET Runtime 6.0 ou 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 docker login. 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 de instalação oficiais 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ção de 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 de CORS correta, causa problemas no download de buckets de armazenamento, que você deve resolver fazendo atualizações manuais na política de 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\`""