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.

para Linux

Observação:

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 UiPath.OrganizationMigrationApp, consulte Pré- requisitos de migração.

Executando a ferramenta

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.

A ferramenta UiPath.OrganizationMigrationApp é compatível com os seguintes parâmetros:

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

Aqui estão algumas operações comuns que você pode precisar realizar:

• 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 organization 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.
• 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 organization 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"}

para Windows

Observação:

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 UiPath.OrganizationMigrationApp, consulte Pré- requisitos de migração.

Executando a ferramenta

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.

Aqui estão algumas operações comuns que você pode precisar realizar:

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

  ./UiPath.OrganizationMigrationApp.exe migrate -a -m -s "<identity DB connection of MSI>" -d "<dentity DB connection of Automation Suite>"

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

  ./UiPath.OrganizationMigrationApp.exe migrate -a -m -r -s "<identity DB connection of MSI>" -d "<dentity DB connection of Automation Suite>"

• Corrija o problema com base na mensagem de erro e tente mover os dados de identidade de todos os tenants do modo independente para o Automation Suite novamente.

• After running the previous command, a new tenant named tenant_xxxxxxxx is created, where xxxxxxxx are random characters. This is the tenant to which you will migrate the standalone products.