Etapa 4: 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, poderá 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, deverá 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:

  ./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 lidar com 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ário.

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, poderá 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, deverá 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:

  ./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 lidar com conflitos de usuário ao migrar vários tenants de produtos 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 logon.
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.

Solução de conflitos de usuários

A migração de vários tenants independentes para uma única organização do Automation Suite pode levar a conflitos de usuários. O exemplo a seguir mostra uma mensagem de erro para esse conflito:

[03:18:08 WRN] We found users in the target organization have the same email as those from the source organization. If you continue, we will keep the users in the target organization, but none of the application data for the source organization users will be moved.
The format is orgId -> list of emails.
[03:18:08 WRN] 3d8d01e6-3300-4988-87db-071bd8c8e786 -> [e-mail],[e-mail],[e-mail],[e-mail]
[03:18:08 WRN] We found users without emails in the target organization have the same username with the users without emails from the source organization.If you continue, we will keep the users in the target organization, but none of the application data for the source organization users will be moved.
The format is orgId -> list of usernames.
[03:18:08 WRN] 3d8d01e6-3300-4988-87db-071bd8c8e786 -> user1
[03:18:08 INF] Do you want to continue? Type (y/n)

Você pode resolver conflitos de usuário de duas maneiras:

• Digite n para encerrar o processo de mesclagem e, em seguida, exclua os usuários com conflitos na organização do Automation Suite e execute o comando de mesclagem novamente. Ao escolher essa opção, você perde as informações do usuário excluídas.
• Digite y para continuar o processo de mesclagem. Ao escolher esta opção, você substitui todos os IDs de usuário de origem por IDs de usuário de destino. Se um produto em execução no Automation Suite, como o Insights, tiver uma referência a um ID de usuário, você perderá os dados de qualquer usuário mesclado do ambiente independente. Por exemplo, vamos supor que dois usuários:

  • um usuário com o nome de usuário user1 e endereço de e-mail [e-mail], de tenant1 em um ambiente independente.
  • outro uso com o mesmo nome de usuário e endereço de e-mail, de tenant2 em um ambiente independente.
  Se você mesclar tenant1 pela primeira vez em uma organização no Automation Suite, nenhum conflito ocorrerá. No entanto, se você mesclar tenant2 com a mesma organização do Automation Suite, ocorrerá um conflito, pois dois usuários têm o mesmo endereço de e-mail, [e-mail]. Se você digitar y para continuar o processo de mesclagem, você perderá os dados do usuário para os quais o produto tem uma referência para o usuário de tenant2.

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.