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

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 .

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.

Enabling Insights after merging organizations

If you migrate Insights, log in to each organization after completing the merge and enable Insights for each tenant that previously had Insights enabled in the standalone (MSI) environment.

This step is required because the Insights database that Automation Suite uses after migration already has Insights enabled. If you skip this step, Automation Suite may enter a state where Insights appears to be enabled for a tenant, but the platform does not have the corresponding Insights instance registered.

Note: Enable Insights in each tenant before updating the connection string. Doing so ensures that Insights is correctly linked to the migrated database and prevents configuration inconsistencies.

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.