Etapa 1: mover os dados da organização do Identity, de independente para o Automation Suite

As versões autônoma e do Automation Suite devem ser as mesmas, caso contrário a migração falhará devido a problemas de conflito de esquema do banco de dados. Se você enfrentar uma falha de compatibilidade, certifique-se de atualizar suas instalações independentes e do Automation Suite para a versão mais recente.

Executando a ferramenta de migração no Linux

Antes de começar, leve em consideração o seguinte:

• Make sure you download and install .NET Runtime 6.0 before running UiPath.OrganizationMigrationApp. For details, see Migration prerequisites.
• To download UiPath.OrganizationMigrationApp, see Migration prerequisites.

Observação:

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

This section describes some common operations that you may need to perform using the Uipath.Organization.Migration.App tool. For details on the parameters that the Uipath.Organization.Migration.App tool supports, see Migration tool parameters.

• Para mover os dados de Identidade de todos os tenants da versão independente para o Automation Suite , extraia o arquivo e execute o seguinte comando:

  ./UiPath.OrganizationMigrationApp migrate -m -i '<identity database connection of the standalone product>' -j '<identity database connection of Automation Suite>' -o '<orchestrator database connection of the standalone product>' -s '<list of tenant IDs of the standalone product>' -d '<list of organization IDs of Automation Suite>' -p '<URL of Automation Suite>' -c '<OMS S2S client secret>'
  

  Observação:

  • Certifique-se de adicionar TrustServerCertificate=True para todas as conexões SQL na entrada.

  • O nome do tenant do Automation Suite é o mesmo que o nome do tenant original no Orchestrator independente. Este é o tenant para o qual você migrará os produtos independentes.

  • 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'
    

    For instructions on how to address user conflicts when migrating multiple standalone tenants to a single Automation Suite organization, see Solving user conflicts.

• Se a operação falhar no meio, reverta a alteração executando o seguinte comando:

  ./UiPath.OrganizationMigrationApp migrate -m -r -i '<identity database connection of the standalone product>' -j '<identity database connection of Automation Suite>' -o '<orchestrator database connection of the standalone product>' -s '<list of tenant IDs of the standalone product>' -d '<list of organization IDs of Automation Suite>' -p '<URL of Automation Suite>' -c '<OMS S2S client secret>'
  

• Corrija o problema de acordo com a mensagem de erro e tente mover os dados de Identity de todos os tenants do Automation Suite novamente. Por exemplo, consulte as seguintes mensagens de erro e o que elas significam:

  • A seguinte mensagem de erro significa que o tenant já está criado e o programa ignoraria a criação do tenant. Você não precisa fazer nada.

    	Call to API Service failed for Method=POST, StatusCode=Conflict on url=https://ci-asaks5379291.devtest-ascloudgen-ea.infra.uipath-dev.com/organization/api/organization/0dad76a9-7d44-447a-84d6-ce713a5324d8/tenants
    	Http Response Content:{"StatusCode":409,"StatusDescription":"Conflict","ErrorCode":1002,"Message":"Found duplicated tenant with requested Id b26f486f-a585-4420-83fd-f2741385b3c8 under organization 0dad76a9-7d44-447a-84d6-ce713a5324d8 (1002)"}
    

  • A seguinte mensagem de erro significa que o URL do Automation Suite não é válido. Certifique-se de fornecer o URL correto do Automation Suite.

    	Unhandled exception. UiPath.IdentityServer.PartitionMerge.PartitionMergeException: Can not create tenant ID with target organiztion ID 0dad76a9-7d44-447a-84d6-ce713a5324d8, tenant name tenant_0dad76a9, platform url https://ci-asaks5379291.devtest-ascloud.infra.uipath-dev.com.
    	 ---> System.Net.Http.HttpRequestException: No such host is known. (ci-asaks5379291.devtest-ascloud.infra.uipath-dev.com:443)
    	 ---> System.Net.Sockets.SocketException (11001): No such host is known.
    

  • A seguinte mensagem de erro significa que o segredo do cliente OMS S2S não é válido. Certifique-se de fornecer o segredo correto do cliente OMS S2S.

    	Call to API Service failed for Method=POST, StatusCode=BadRequest on url=https://ci-asaks5379291.devtest-ascloudgen-ea.infra.uipath-dev.com/identity_/connect/token
    	Http Response Content:{"error":"invalid_client"}
    

  • A seguinte mensagem de erro significa que já existe um tenant na organização do Automation Suite com o mesmo nome de tenant que o nome do tenant independente. Para resolver o conflito, você deve alterar o nome do tenant para o tenant na organização do Automation Suite.

    Source tenant ID: 38f03b05-3aab-422c-844b-bf3668fa54ee, target organization ID: f7d80050-9654-4f44-8a34-3a9e46380dc9, confilict tenant name: test_tenan1
    Source tenant ID: b35020b1-ee9f-4026-abd1-bb721b148e24, target organization ID: f7d80050-9654-4f44-8a34-3a9e46380dc9, confilict tenant name: test_tenant2
    Tenant name conflicts detected. You need to rename the tenant to be a different name than conflict tenant name in target organization to unblock tenant creation.
    

Executando a ferramenta de migração no Windows

Antes de começar, considere os seguintes aspectos:

• You must download and install .NET Runtime 6.0 before running UiPath.OrganizationMigrationApp. For details, see Migration prerequisites.
• To download UiPath.OrganizationMigrationApp, see Migration prerequisites.

Observação:

To successfully run the UiPath.OrganizationMigrationApp tool, you must escape your SQL password if it contains special characters. For example, replace every instance of $ with \$`. For more guidelines on how to escape special characters in connection string passwords, refer to Special character escape rules for connection string passwords.

This section describes some common operations that you may need to perform using the Uipath.Organization.Migration.App tool. For details on the parameters that the Uipath.Organization.Migration.App tool supports, see Migration tool parameters.

• Para mover os dados de Identidade de todos os tenants da versão independente para o Automation Suite , extraia o arquivo e execute o comando a seguir.

  Observação:

  • Certifique-se de adicionar TrustServerCertificate=True para as entradas de conexão SQL de origem e destino.

  • O nome do tenant do Automation Suite é o mesmo que o nome do tenant original no Orchestrator independente. Este é o tenant para o qual você migrará os produtos independentes.

  • 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'
    

    For instructions on how to address user conflicts when migrating multiple standalone tenants to a single Automation Suite organization, see Solving user conflicts.

  ./UiPath.OrganizationMigrationApp migrate -m -i "<identity database connection of the standalone product>" -j "<identity database connection of Automation Suite>" -o "<orchestrator database connection of the standalone product>" -s "<list of tenant IDs of the standalone product>" -d "<list of organization IDs of Automation Suite>" -p "<URL of Automation Suite>" -c "<OMS S2S client secret>"
  

• Se a operação falhar no meio, reverta a alteração executando o seguinte comando:

  ./UiPath.OrganizationMigrationApp migrate -m -r -i "<identity database connection of the standalone product>" -j "<identity database connection of Automation Suite>" -o "<orchestrator database connection of the standalone product>" -s "<list of tenant IDs of the standalone product>" -d "<list of organization IDs of Automation Suite>" -p "<URL of Automation Suite>" -c "<OMS S2S client secret>"
  

• Corrija o problema com base na mensagem de erro e tente mover os dados do Identity de todos os tenants de independentes para o Automation Suite novamente. Por exemplo, consulte as seguintes mensagens de erro e o que elas significam:

  • A seguinte mensagem de erro significa que o tenant já está criado e o programa ignoraria a criação do tenant. Você não precisa fazer nada.

    	Call to API Service failed for Method=POST, StatusCode=Conflict on url=https://ci-asaks5379291.devtest-ascloudgen-ea.infra.uipath-dev.com/organization/api/organization/0dad76a9-7d44-447a-84d6-ce713a5324d8/tenants
    	Http Response Content:{"StatusCode":409,"StatusDescription":"Conflict","ErrorCode":1002,"Message":"Found duplicated tenant with requested Id b26f486f-a585-4420-83fd-f2741385b3c8 under organization 0dad76a9-7d44-447a-84d6-ce713a5324d8 (1002)"}
    

  • A seguinte mensagem de erro significa que o URL do Automation Suite não é válido. Certifique-se de fornecer o URL correto do Automation Suite.

    	Unhandled exception. UiPath.IdentityServer.PartitionMerge.PartitionMergeException: Can not create tenant ID with target organiztion ID 0dad76a9-7d44-447a-84d6-ce713a5324d8, tenant name tenant_0dad76a9, platform url https://ci-asaks5379291.devtest-ascloud.infra.uipath-dev.com.
    	 ---> System.Net.Http.HttpRequestException: No such host is known. (ci-asaks5379291.devtest-ascloud.infra.uipath-dev.com:443)
    	 ---> System.Net.Sockets.SocketException (11001): No such host is known.
    

  • A seguinte mensagem de erro significa que o segredo do cliente OMS S2S não é válido. Certifique-se de fornecer o segredo correto do cliente OMS S2S.

    	Call to API Service failed for Method=POST, StatusCode=BadRequest on url=https://ci-asaks5379291.devtest-ascloudgen-ea.infra.uipath-dev.com/identity_/connect/token
    	Http Response Content:{"error":"invalid_client"}
    

  • A seguinte mensagem de erro significa que já existe um tenant na organização do Automation Suite com o mesmo nome de tenant que o nome do tenant independente. Para resolver o conflito, você deve alterar o nome do tenant para o tenant na organização do Automation Suite.

    Source tenant ID: 38f03b05-3aab-422c-844b-bf3668fa54ee, target organization ID: f7d80050-9654-4f44-8a34-3a9e46380dc9, confilict tenant name: test_tenan1
    Source tenant ID: b35020b1-ee9f-4026-abd1-bb721b148e24, target organization ID: f7d80050-9654-4f44-8a34-3a9e46380dc9, confilict tenant name: test_tenant2
    Tenant name conflicts detected. You need to rename the tenant to be a different name than conflict tenant name in target organization to unblock tenant creation.
    

Parâmetros da ferramenta de migração

A tabela a seguir descreve os parâmetros com os quais a ferramenta Uipath.Organization.Migration.App é compatível. Você pode usar esses parâmetros no Linux e no Windows.

Nome do parâmetro	Nome curto	Description
Conexão com o banco de dados do Identity do produto independente	i	A conexão com o banco de dados do Identity do produto independente. Se o Identity e o Orchestrator compartilharem o mesmo banco de dados, use a string de conexão desse banco de dados.
Conexão do banco de dados de identidade do Automation Suite	j	A conexão de banco de dados de Identidade do Automation Suite .
Conexão com o banco de dados do Orchestrator do produto independente	o	A conexão com o banco de dados do Orchestrator do produto independente. Se o Identity e o Orchestrator compartilharem o mesmo banco de dados, use a string de conexão desse banco de dados.
Lista de IDs da organização do produto independente	s	A lista de IDs da organização para o produto independente a ser mesclado. Você deve usar o seguinte formato: orgId1,orgId2,...,orgId5. O tamanho da lista de IDs da organização para o produto independente e o Automation Suite deve ser o mesmo. Para obter uma lista de IDs da organização para o produto independente, execute o seguinte comando no banco de dados independente e use GlobalId com a partição/nome da organização relacionada no banco de dados restaurado: SELECT * FROM [identity].[Partitions]
Lista de IDs da organização do Automation Suite	d	A lista de IDs da organização para Automation Suite. Você deve usar o seguinte formato: orgId1,orgId2,...,orgId5. O tamanho da lista de IDs da organização para o produto independente e o Automation Suite deve ser o mesmo. Para obter uma lista de IDs da organização para o Automation Suite, execute o seguinte comando no AutomationSuite_Platform banco de dados do Automation Suite SQL Sever: SELECT * FROM [identity].[Partitions]
Reverter	r	O parâmetro usado para reverter uma alteração.
URL do Automation Suite	p	O URL do Automation Suite. Por exemplo, https://ci-asaks5380983.devtest-ascloudgen-ea.infra.uipath-dev.com/
Segredo do cliente OMS S2S	c	O segredo do cliente usado para chamar a API do OMS para criar o tenant. Para obter o segredo do cliente OMS S2S do segredo do Kubernetes, execute o seguinte comando: kubectl get secret identity-client-oms -n uipath -o "jsonpath={.data.OMSS2SClient\.ClientSecret}" | base64 -d