Etapa 3: migração dos 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:

• Certifique-se de baixar e instalar o .NET Runtime 6.0 antes de executar o UiPath.OrganizationMigrationApp. Para obter detalhes, consulte Pré-requisitos de migração.
• Para baixar o UiPath.OrganizationMigrationApp, consulte Pré-requisitos de migração.

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.

Esta seção descreve algumas operações comuns que você pode precisar realizar usando a ferramenta Uipath.Organization.Migration.App. Para obter detalhes sobre os parâmetros com os quais a ferramenta Uipath.Organization.Migration.App é compatível, consulte Parâmetros da ferramenta Migração.

• 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 '<restored & upgraded identity database connection of the standalone product>' -j '<identity database connection of Automation Suite>' -o '<restored & upgraded 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'
  

  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 .

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

  ./UiPath.OrganizationMigrationApp migrate -m -r -i '<restored & upgraded identity database connection of the standalone product>' -j '<identity database connection of Automation Suite>' -o '<restored & upgraded 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:

• Você deve baixar e instalar o .NET Runtime 6.0 antes de executar o UiPath.OrganizationMigrationApp. Para obter detalhes, consulte Pré-requisitos de migração.
• Para baixar o UiPath.OrganizationMigrationApp, consulte Pré-requisitos de migração.
  Observação:

  Para executar com sucesso a ferramenta UiPath.OrganizationMigrationApp, você deve escapar sua senha do SQL se ela contiver caracteres especiais. Por exemplo, substitua todas as instâncias de $ por \`$. Para obter mais diretrizes sobre como escapar de caracteres especiais em senhas da string de conexão, consulte Regras de escape de caracteres especiais para senhas da string de conexão.

Esta seção descreve algumas operações comuns que você pode precisar realizar usando a ferramenta Uipath.Organization.Migration.App. Para obter detalhes sobre os parâmetros com os quais a ferramenta Uipath.Organization.Migration.App é compatível, consulte Parâmetros da ferramenta Migração.

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

  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 .

  ./UiPath.OrganizationMigrationApp migrate -m -i "<restored & upgraded identity database connection of the standalone product>" -j "<identity database connection of Automation Suite>" -o "<restored & upgraded 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 "<restored & upgraded identity database connection of the standalone product>" -j "<identity database connection of Automation Suite>" -o "<restored & upgraded 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 restaurada e atualizada 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 restaurada e atualizada 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: oc get secret identity-client-oms -n <uipath> -o "jsonpath={.data.OMSS2SClient.ClientSecret}"