Etapa 5: mesclando organizações no Automation Suite

Entrada da ferramenta de migração

Ao executar a ferramenta UiPath.OrganizationMigrationApp, é necessário fornecer os seguintes detalhes:

• A lista de IDs da organização para o produto independente
• A lista de IDs da organização para o Automation Suite

Para obter mais detalhes, consulte Parâmetros da ferramenta de migração.

Observação:

Certifique-se de usar as mesmas IDs da organização que as identificadas na Etapa 1: migração dos dados da organização do Identity de independente para o Automation Suite.

para Linux

Observação:

Certifique-se de seguir as instruções gerais de escape para a ferramenta Shell de sua escolha. Por exemplo, no Bash você deve adicionar \ antes de caracteres especiais.

Para mesclar organizações no Automation Suite , execute o seguinte comando:

./UiPath.OrganizationMigrationApp merge -i '<identity database connection of Automation Suite>' -o '<restored orchestrator DB in Automation Suite connection string>' -s '<list of tenant IDs of the standalone product separated by comma, e.g. tenantID1,tenantID2>' -d '<list of organization IDs of Automation Suite separated by comma, e.g. orgID1,orgID2>'

Observação:

• Certifique-se de adicionar TrustServerCertificate=True para as conexões SQL de origem e destino na entrada.
• Se você tiver vários pares de organizações para mesclar, certifique-se de que a sequência de IDs da organização para o produto independente e a sequência de IDs da organização para o Automation Suite correspondam.
• Se você migrar um tenant independente para uma organização do Automation Suite para todos os tenants, você pode executar o comando uma vez para todas as migrações. No entanto, se você migrar vários tenants independentes para uma organização do Automation Suite, você deve executar o comando separadamente para cada tenant, pois pode precisar resolver conflitos de usuário entre os tenants. O exemplo a seguir mostra como executar o comando separadamente para cada tenant: atribuição

./UiPath.OrganizationMigrationApp merge -i '<identity database connection of Automation Suite>' -o '<restored orchestrator DB in Automation Suite connection string>' -s 'tenant1' -d 'orgId1'
./UiPath.OrganizationMigrationApp merge -i '<identity database connection of Automation Suite>' -o '<restored orchestrator DB in Automation Suite connection string>' -s 'tenant2' -d 'orgId1'
./UiPath.OrganizationMigrationApp merge -i '<identity database connection of Automation Suite>' -o '<restored orchestrator DB in Automation Suite connection string>' -s 'tenant3' -d 'orgId1'

Para obter instruções sobre como resolver conflitos de usuário ao migrar vários tenants independentes para uma única organização do Automation Suite, consulte Solução de conflitos de usuários.

para Windows

Para mesclar organizações no Automation Suite , execute o seguinte comando:

./UiPath.OrganizationMigrationApp merge -i "<identity database connection of Automation Suite>" -o "<restored orchestrator DB in Automation Suite connection string>" -s "<list of tenant IDs of the standalone product separated by comma, e.g. tenantID1,tenantID2>" -d "<list of organization IDs of Automation Suite separated by comma, e.g. orgID1,orgID2>"

Observação:

• Certifique-se de adicionar TrustServerCertificate=True para strings de conexão SQL de origem e destino na entrada.
• Se você migrar um tenant independente para uma organização do Automation Suite para todos os tenants, você pode executar o comando uma vez para todas as migrações. No entanto, se você migrar vários tenants independentes para uma organização do Automation Suite, você deve executar o comando separadamente para cada tenant, pois pode precisar resolver conflitos de usuário entre os tenants. O exemplo a seguir mostra como executar o comando separadamente para cada tenant: atribuição

./UiPath.OrganizationMigrationApp merge -i '<identity database connection of Automation Suite>' -o '<restored orchestrator DB in Automation Suite connection string>' -s 'tenant1' -d 'orgId1'
./UiPath.OrganizationMigrationApp merge -i '<identity database connection of Automation Suite>' -o '<restored orchestrator DB in Automation Suite connection string>' -s 'tenant2' -d 'orgId1'
./UiPath.OrganizationMigrationApp merge -i '<identity database connection of Automation Suite>' -o '<restored orchestrator DB in Automation Suite connection string>' -s 'tenant3' -d 'orgId1'

Para obter instruções sobre como resolver conflitos de usuário ao migrar vários tenants independentes para uma única organização do Automation Suite, consulte Solução de conflitos de usuários.

Mesclar expectativas

Usuários

Observação:

Apenas usuários que são originalmente do Orchestrator independente têm acesso ao Orchestrator após a migração para o Automation Suite.

A tabela a seguir fornece informações sobre vários cenários de migração e como eles afetam os usuários:

Condição	O usuário de origem tem um endereço de email?	O usuário de destino tem um endereço de email?	O email do usuário de origem é o mesmo do usuário de destino?	O nome de usuário de origem é o mesmo de destino?	Resultado
1	✅	✅	❌	❌	O usuário de origem é movido para a organização de destino; o usuário da organização de destino tem acesso ao Orchestrator independente.
2	✅	✅	❌	✅	O usuário de origem é movido para a organização de destino; o usuário da organização de destino tem acesso ao Orchestrator independente. Após a mesclagem, dois usuários têm o mesmo nome de usuário e devem usar o endereço de e-mail para fazer login.
3	✅	✅	✅	✅ ou ❌	O usuário de origem é mesclado com o usuário de destino; o usuário de destino tem acesso ao Orchestrator independente.
4	❌	❌	N/A	❌	O usuário de origem é movido para a organização de destino; o usuário da organização de destino tem acesso ao Orchestrator independente.
5	❌	❌	N/A	✅	O usuário de origem é mesclado com o usuário de destino; o usuário de destino tem acesso ao Orchestrator independente.
6	✅	❌	N/A	❌	O usuário de origem é movido para a organização de destino; o usuário da organização de destino tem acesso ao Orchestrator independente.
7	✅	❌	N/A	✅	Você deve configurar manualmente o endereço de e-mail para o usuário de destino ou remover o usuário de destino. Se você configurar o endereço de e-mail, o usuário de origem será mesclado com o usuário de destino, e o usuário de destino terá acesso ao Orchestrator independente. Se você remover o usuário de destino, o usuário de origem será movido para a organização de destino, e o usuário da organização de destino terá acesso ao Orchestrator independente.
8	❌	✅	N/A	❌	O usuário de origem é movido para a organização de destino, e o usuário da organização de destino tem acesso ao Orchestrator independente.
9	❌	✅	N/A	✅	Você deve configurar o endereço de e-mail para ficar vazio para o usuário de destino ou remover o usuário de destino. Se você configurar o endereço de e-mail como vazio, o usuário de origem será mesclado com o usuário de destino, e o usuário de destino terá acesso ao Orchestrator independente. Se você remover o usuário de destino, o usuário de origem será movido para a organização de destino, e o usuário da organização de destino terá acesso ao Orchestrator independente.

Usuários do Robot

Se os nomes de usuários dos Robots de origem e destino forem os mesmos, o usuário do Robot de origem receberá o ID do usuário e será movido para a organização de destino.

Nome de usuário do Robot de origem	Nome de usuário do robô de destino	Nome de usuário do robô de origem movido
Mesmo Robô	Mesmo Robô	sameRobot_47a26d4a-2180-4fdd-8e1e-2379300a1162

Grupos

Se os nomes dos grupos de robôs de origem e destino forem os mesmos, uma string será anexada ao usuário do robô de origem e ele será movido para a organização de destino.

Nome do grupo de origem	Nome do grupo de destino	Nome de usuário do grupo de origem movido
mesmo grupo	mesmo grupo	sameGroup_db39a5c6-f73c-4011-b40e-4ea620fe3d01

Configurações

Se as configurações de origem e as configurações de destino tiverem o mesmo nome, o valor de configuração do destino será usado.

Habilitação do Insights após mesclar organizações

Se você migrar o Insights, faça login em cada organização após concluir a mesclagem e habilite o Insights para cada tenant que tinha o Insights habilitado anteriormente no ambiente independente (MSI).

Essa etapa é necessária porque o banco de dados do Insights que o Automation Suite usa após a migração já tem o Insights habilitado. Se você pular essa etapa, o Automation Suite pode entrar em um estado em que o Insights parece estar habilitado para um tenant, mas a plataforma não tem a instância do Insights correspondente registrada.

Observação:

Habilite o Insights em cada tenant antes de atualizar a string de conexão. Fazer isso garante que o Insights esteja vinculado corretamente ao banco de dados migrado e evita inconsistências de configuração.

Se a mesclagem da organização falhar

Se a mesclagem da organização falhar, verifique os logs. Dependendo se a migração do Identity ou do Orchestrator falhar, siga as seguintes etapas:

Falha na migração do Identity

Se a migração do Identity falhar, basta corrigir o erro e executar o comando de mesclagem da organização novamente. Isso reverteria todas as alterações, pois definimos uma transação para operações para Identity.

Falha na migração do Orchestrator

Se a migração do Orchestrator falhar, o banco de dados do Orchestrator será revertido, mas o banco de dados do Identity não será revertido. Como resultado, você deve restaurar o backup do banco de dados do Identity e substituir a string de conexão para usar o novo banco de dados. Após corrigir o erro, execute o comando de mesclagem da organização novamente.

Se a migração do Orchestrator falhar, siga as seguintes etapas:

1. Restaure o backup do banco de dados do Identity.

   1. Clique com o botão direito do mouse no diretório do banco de dados e selecione Importar aplicativo da camada de dados.

      

   2. Selecione o arquivo de banco de dados de backup.

      

   3. Insira o nome do banco de dados de backup.

      

   4. Aguarde até o processo ser concluído.

   

2. Substitua a string de conexão de identidade.

   `"platform": {
       "sql_connection_str": "<dotnet connection string>",   (added line)
       "enabled": true, 
   },`
   

3. Corrija o erro e use a nova string de conexão da plataforma para executar o comando de mesclagem novamente.