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.

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
kubectl -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
./bin/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:

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

To download UiPath.OrganizationMigrationApp, see Downloading the installation packages.

To see which UiPath.OrganizationMigrationApp version is compatible with your environment, see Compatibility matrix.

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\`""