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.

para Linux

Nota:

Asegúrese de descargar e instalar .NET Runtime 6.0 antes de ejecutar UiPath.OrganizationMigrationApp. Para obtener más información, consulta Requisitos previos de la migración.

Para descargar UiPath.OrganizationMigrationApp, consulta Requisitos previos de la migración.

Ejecutar la herramienta

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.

La herramienta UiPath.OrganizationMigrationApp admite los siguientes parámetros:

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

A continuación se muestran algunas operaciones comunes que puedes necesitar realizar:

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

para Windows

Nota:

Asegúrese de descargar e instalar .NET Runtime 6.0 antes de ejecutar UiPath.OrganizationMigrationApp. Para obtener más información, consulta Requisitos previos de la migración.

Para descargar UiPath.OrganizationMigrationApp, consulta Requisitos previos de la migración.

Ejecutar la herramienta

Nota:

Para ejecutar correctamente la herramienta UiPath.OrganizationMigrationApp, debes escapar de tu contraseña SQL si contiene caracteres especiales. Por ejemplo, reemplaza cada instancia de $ por \`$. Para obtener más directrices sobre cómo escapar de los caracteres especiales en las contraseñas de la cadena de conexión, consulta Reglas de escape de caracteres especiales para las contraseñas de la cadena de conexión.

A continuación se muestran algunas operaciones comunes que puedes necesitar realizar:

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

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

• Si la operación falló a la mitad, revierte el cambio ejecutando el siguiente comando:

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

• Corrija el problema basado en el mensaje de error e intente mover los datos de identidad de todos los tenants de forma independiente a Automation Suite .

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