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 .

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.

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.