Paso 1: Mover los datos de la organización de identidad de independiente a Automation Suite

Las versiones independientes y de Automation Suite deben ser iguales o, de lo contrario, la migración fallará debido a problemas de conflicto con el esquema de la base de datos. Si experimenta un error de compatibilidad, asegúrese de actualizar sus instalaciones independientes y de Automation Suite a la última versión.

Ejecutar la herramienta de migración en Linux

Antes de empezar, ten en cuenta lo siguiente:

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

Nota:

Asegúrate de seguir las instrucciones generales de escape de la herramienta de Shell que elijas. Por ejemplo, en Bash, debes añadir \ antes de los caracteres especiales.

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 los datos de identidad de todos los tenants de modo independiente a Automation Suite , extrae el archivo y ejecuta el siguiente 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>'
  

  Nota:

  • Asegúrese de agregar TrustServerCertificate=True para todas las conexiones SQL en la entrada.

  • El nombre del tenant de Automation Suite es el mismo que el nombre del tenant original en Orchestrator independiente. Este es el tenant al que migrarás los productos independientes.

  • Si migras un tenant independiente a una organización de Automation Suite para todos los tenants, puedes ejecutar el comando una vez para todas las migraciones. Sin embargo, si migras varios tenants independientes a una organización de Automation Suite, debes ejecutar el comando por separado para cada tenant, ya que es posible que tengas que resolver los conflictos de usuario entre los tenants. El siguiente ejemplo muestra cómo ejecutar el comando por separado 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.

• Si la operación falló a la mitad, revierte el cambio ejecutando el siguiente 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>'
  

• Corrige el problema en función del mensaje de error e intenta mover los datos de identidad de todos los tenants de la versión independiente a Automation Suite. Por ejemplo, consulta los siguientes mensajes de error y lo que significan:

  • El siguiente mensaje de error significa que el tenant ya está creado y el programa omitiría su creación. No tienes que hacer 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)"}
    

  • El siguiente mensaje de error significa que la URL de Automation Suite no es válida. Asegúrate de proporcionar la URL de Automation Suite correcta.

    	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.
    

  • El siguiente mensaje de error significa que el secreto de cliente OMS S2S no es válido. Asegúrate de proporcionar el secreto de cliente OMS S2S correcto.

    	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"}
    

  • El siguiente mensaje de error significa que ya hay un tenant en la organización de Automation Suite con el mismo nombre de tenant que el nombre del tenant independiente. Para resolver el conflicto, debes cambiar el nombre del tenant en la organización de 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.
    

Ejecutar la herramienta de migración en Windows

Antes de empezar, ten en cuenta los siguientes 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.

Nota:

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 los datos de identidad de todos los tenants de modo independiente a Automation Suite , extrae el archivo y ejecuta el siguiente comando.

  Nota:

  • Asegúrese de agregar TrustServerCertificate=True para las entradas de conexión SQL de origen y de destino.

  • El nombre del tenant de Automation Suite es el mismo que el nombre del tenant original en Orchestrator independiente. Este es el tenant al que migrarás los productos independientes.

  • Si migras un tenant independiente a una organización de Automation Suite para todos los tenants, puedes ejecutar el comando una vez para todas las migraciones. Sin embargo, si migras varios tenants independientes a una organización de Automation Suite, debes ejecutar el comando por separado para cada tenant, ya que es posible que tengas que resolver los conflictos de usuario entre los tenants. El siguiente ejemplo muestra cómo ejecutar el comando por separado 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>"
  

• Si la operación falló a la mitad, revierte el cambio ejecutando el siguiente 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>"
  

• Corrige el problema en función del mensaje de error e intenta mover los datos de identidad de todos los tenants de independientes a Automation Suite de nuevo. Por ejemplo, consulta los siguientes mensajes de error y lo que significan:

  • El siguiente mensaje de error significa que el tenant ya está creado y el programa omitiría su creación. No tienes que hacer 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)"}
    

  • El siguiente mensaje de error significa que la URL de Automation Suite no es válida. Asegúrate de proporcionar la URL de Automation Suite correcta.

    	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.
    

  • El siguiente mensaje de error significa que el secreto de cliente OMS S2S no es válido. Asegúrate de proporcionar el secreto de cliente OMS S2S correcto.

    	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"}
    

  • El siguiente mensaje de error significa que ya hay un tenant en la organización de Automation Suite con el mismo nombre de tenant que el nombre del tenant independiente. Para resolver el conflicto, debes cambiar el nombre del tenant en la organización de 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 de la herramienta de migración

La siguiente tabla describe los parámetros que admite la herramienta Uipath.Organization.Migration.App. Puedes utilizar estos parámetros en Linux y Windows.

Nombre del parámetro	Nombre corto	Descripción
Conexión de la base de datos de identidad del producto independiente	i	La conexión de la base de datos de Identity del producto independiente. Si Identity y Orchestrator comparten la misma base de datos, utiliza la cadena de conexión de esa base de datos.
Conexión de la base de datos de identidad de Automation Suite	j	La conexión de la base de datos de identidades de Automation Suite .
Conexión de la base de datos de Orchestrator del producto independiente	o	La conexión de la base de datos de Orchestrator del producto independiente. Si Identity y Orchestrator comparten la misma base de datos, utiliza la cadena de conexión de esa base de datos.
Lista de ID de la organización del producto independiente	s	La lista de ID de la organización para el producto independiente que se va a fusionar. Debes utilizar el siguiente formato: orgId1,orgId2,...,orgId5. El tamaño de la lista de ID de la organización tanto para el producto independiente como para Automation Suite debe ser el mismo. Para obtener una lista de ID de la organización para el producto independiente, ejecuta el siguiente comando en la base de datos independiente y utiliza GlobalId con el nombre de la partición/organización relacionado en la base de datos restaurada: SELECT * FROM [identity].[Partitions]
Lista de ID de la organización de Automation Suite	d	La lista de ID de la organización para Automation Suite. Debes utilizar el siguiente formato: orgId1,orgId2,...,orgId5. El tamaño de la lista de ID de la organización tanto para el producto independiente como para Automation Suite debe ser el mismo. Para obtener una lista de ID de la organización para Automation Suite, ejecuta el siguiente comando en la base de datos AutomationSuite_Platform en Automation Suite SQL SELECT * FROM [identity].[Partitions]
Reversión	r	El parámetro utilizado para revertir un cambio.
URL de Automation Suite	p	La URL de Automation Suite. Por ejemplo, https://ci-asaks5380983.devtest-ascloudgen-ea.infra.uipath-dev.com/
Secreto de cliente OMS S2S	c	El secreto de cliente utilizado para llamar a la API de OMS para crear el tenant. Para obtener el secreto de cliente OMS S2S a partir del secreto de Kubernetes, ejecuta el siguiente comando: kubectl get secret identity-client-oms -n uipath -o "jsonpath={.data.OMSS2SClient\.ClientSecret}" | base64 -d