Utilizar la herramienta de migración de Automation Cloud

The Automation Cloud Migration Tool is a desktop application designed to simplify the process of migration from one deployment option to another. The tool automates various migration steps, making it easier to transition either your standalone or Automation Suite Orchestrator to Automation Cloud, Automation Cloud Public Sector, or Automation Suite.

Instructions on this page apply for migrating your on-premises Orchestrator, either standalone or via Automation Suite, to Automation Cloud^TM.

When planning your migration from on-premises Orchestrator to Automation Cloud^TM, it is advisable that you take the following steps:

Actualiza a una versión local compatible de Orchestrator.
Migrate from classic to modern folders, as classic folders have restrictions in Automation Cloud^TM.
Run the migration tool to migrate from on-premises Orchestrator to Automation Cloud^TM.

Nota:

Aunque técnicamente son posibles otras secuencias, este es el enfoque más común.
La herramienta de migración de Automation Cloud funciona de forma independiente y no se ajusta a nuestro ciclo de vida del producto estándar.

Requisitos

Para utilizar la herramienta de migración, debes cumplir los siguientes criterios:

Tu versión de Orchestrator independiente debe ser compatible. Para obtener más información sobre la versión específica, consulta nuestra documentación del ciclo de vida del producto.
Necesitas una licencia Pro, Pro Trial o Enterprise en Automation Cloud. Aunque puedes utilizar la herramienta durante una prueba de Pro para la evaluación, pueden aplicarse algunas limitaciones, como las restricciones de licencia de tenant y robot. Para obtener más información, consulta nuestra documentación de Licencias.

Requisitos previos

Antes de abrir la herramienta de migración de Automation Cloud, realiza los siguientes preparativos:

Check that the Enterprise or Enterprise Trial licensing plan is active in Automation Cloud^TM (Admin > Licenses).
Make sure you have sufficient robot licenses to match the number of robots being migrated (Admin > Licenses > Robots & Services). The tool migrates robots as long as there are licenses available, after which it starts to skip robots.
Make sure you have administrator credentials for the on-premises Orchestrator
Make sure you have View permission for all entities being migrated. If you do not have the View permission for some entities, those entities will not be migrated.
Asegúrate de que eres administrador de la organización en Automation Cloud para registrar la herramienta como aplicación externa.
Asegúrate de que la máquina en la que ejecutas la herramienta de migración de Automation Cloud cumpla los siguientes requisitos:
1. Can connect to the on-premises Orchestrator;
2. Can access Automation Cloud^TM (has internet access and a supported browser);
3. Runs the Windows operating system;
4. Has .NET Core Desktop Runtime for x64 installed.
Download the migration tool on the machine that meets the requirements in the previous step.

Entidades migradas por la herramienta de migración

When using the migration tool, the following entities are automatically created in Automation Cloud^TM to mirror your Orchestrator setup:

Entidad	Migrado	No migrado
Configuración	Yes, with exceptions	Algunas configuraciones locales, como las contraseñas y ciertas configuraciones expuestas a los tenants
Paquetes	All packages and package versions	Entities that rely on external package feeds requiring authentication Nota: Authentication is required after migration is completed for external package feeds configured with basic authentication
Librerías	Tenant-level feeds only	Entities that rely on libraries with host-level configurations or inaccessible external libraries
Calendarios	Sí	N/D
Máquinas	Sí Nota: Potential machine slot assignments limitations due to missing licenses	Claves de la máquina
Carpetas	Sí	Personal workspace folders
Entornos	Sí, para las carpetas clásicas.	N/D (para carpetas modernas)
Robots (clásico)	Sí Nota: Potential robot creation limitations due to missing licenses	Skipped when licenses run out, with an error logged for each skipped robot
Robots (modernos)	Sí Nota: If certain conditions are met, robots are associated with an on-premises user that has an email address, and that same email was already invited to Automation Cloud^TM and is associated to a user.	Skipped when licenses run out, with an error logged for each skipped robot Fails if a user in Automation Cloud^TM does not exist
Asociaciones de entorno	La asignación de entorno del robot	N/D
Procesos	Sí Nota: The migration tool may refer to processes as releases	N/D
Colas	Sí	N/D
Desencadenadores	Yes, but they are set as disabled	N/D
Activos	Certain asset types are fully supported, with some considerations for credential assets	Valores de activo por usuario en carpetas modernas
Fuentes de la carpeta	Sí	N/D

Entidades no migradas por la herramienta de migración

The migration tool does not migrate the following entities:

Permisos de usuario y robot
Asignaciones de roles
Artículos en cola
Catálogos de acciones
Webhooks
Entidades de pruebas (conjuntos de pruebas, casos de pruebas, ejecuciones de pruebas, programas de pruebas, colas de datos de pruebas)
Depósitos de almacenamiento
Registros

Registrar la herramienta de migración como aplicación externa

The migration tool must connect to the Orchestrator service API in Automation Cloud^TM to create the migrated entities. It uses the OAuth flow for this and, therefore, must be registered as an external application.

Para registrar la herramienta de migración de Automation Cloud como una aplicación externa, sigue los siguientes pasos:

Add the tool as a new external application by following the instructions in Adding an external application. Make sure to use the following configuration:
- Tipo: no confidencial
- Recursos: API de Orchestrator
- Ámbitos de usuario: OR.Folders, OR.Settings, OR.Robots, OR.Machines, OR.Execution, OR.Assets, OR.Users, OR.Jobs y OR.Queues.
- Redirigir URL: http://127.0.0.1:8888/auth/
Guarda el ID de la aplicación para usarlo más tarde.

Ejecutar la herramienta de migración

La herramienta de migración puede migrar un tenant a la vez. Puedes ejecutar la herramienta para cada uno de tus tenants. Con cada ejecución, la herramienta realiza las siguientes operaciones:

Se conecta a tu On-Premises Orchestrator para exportar entidades para el tenant dado.
Connects to Automation Cloud^TM to import and create the migrated entities in Orchestrator.

Para obtener más información sobre las entidades sujetas a migración, consulta Entidades migradas por la herramienta de migración.

Extract the .zip file you downloaded for the tool, and then run the .exe tool.
To choose your export environment, take one of the following steps:
- Selecciona MSI local si migras desde Orchestrator independiente.
- Selecciona Automation Suite para conectarte a la aplicación externa y rellenar el formulario de entrada de exportación si migras desde Automation Suite Orchestrator.
Rellena la información para permitir que la herramienta se conecte a tu On-Premises Orchestrator.

Nota: asegúrate de que las credenciales que proporcionas sean para una cuenta de administrador que también tenga permisos de Ver en todas las entidades que quieres migrar.
Select Start Export to connect to your source environment and download the setup information. The export begins and may take a while to complete.

Al terminar, el resumen de la exportación enumera todas las entidades que se han exportado con éxito. Puedes seleccionar Abrir archivo para ver el archivo local creado para el resumen de la exportación, que incluye algunos detalles más.
Select Home to return to the first screen of the migration tool.
For the activation method, this time choose Connect to Automation Cloud^TM.

Fill in the information to allow the tool to connect to Automation Cloud^TM to upload the setup information.

Campo	Detalles
ID de la aplicación cliente	The Application ID value associated with the external application registration in Automation Cloud^TM. Puedes encontrar este valor en la página Admin > Aplicaciones externas.
Nombre de la organización	The organization-specific part of your Automation Cloud^TM URL. Organization administrators can find this information in the URL field in Admin > Organization Settings. Nota: no es necesario incluir la URL completa, solo la parte editable, que es específica de tu organización. Por ejemplo, si la URL es `https://cloud.uipath.com/myOrgName`, añade `myOrgName` al campo.
Nombre del tenant	The exact name of the Automation Cloud^TM tenant where you want to add the migrated information. The migrated data will be visible in the Orchestrator service associated to that tenant.

Select Start Import to connect to Automation Cloud^TM and start to migrate the information to the target Orchestrator service.

La importación comienza y puede tardar un poco en completarse.

To connect to Automation Cloud^TM using OAuth, a user with the adequate permissions for the scopes added when you registered the external application must log in to Automation Cloud^TM. When they do, a new window opens with a success message, if the OAuth flow was successful.

When finished, the import summary lists all entities that were successfully imported into the Orchestrator service in Automation Cloud^TM.

Anything that was not imported is listed as an error and partial imports are listed as warnings. You can select View Report for more details about exactly which entities encountered an error or warning.
Cuando hayas terminado, selecciona Listo para cerrar la herramienta.

Consejo: Si es necesario, puedes volver a ejecutar la herramienta para migrar los datos de otros tenants.

Tareas posteriores a la migración

Debido a que la herramienta de migración de Automation Cloud no puede migrar todos los datos, hay algunas tareas finales que debes realizar manualmente.

In Automation Cloud^TM, select the tenant that was the import target, and open Orchestrator. Check that folders and entities were successfully migrated. You can use the import summary to check the specific items that had warnings or errors.
Asigne licencias de robot y servicio para Orchestrator. Las máquinas se crean y conceden licencias mientras existan licencias disponibles, pero una vez agotadas las licencias, se siguen creando máquinas sin licencias, por lo que hay que actualizarlas para asignarles el número adecuado de licencias.
Carga manualmente cualquier fuente de la biblioteca que la herramienta no haya migrado.
Si se ha omitido algún robot durante la exportación o la importación, créalo manualmente.
Cree cualquier webhook, catálogo de tareas, almacén de credenciales u otra información que la herramienta no migre. La sección Entidades migradas por la herramienta de migración también incluye una lista de lo que la herramienta no migra.
Conecta manualmente los robots al servicio Orquestador de la nube.
Habilita manualmente los desencadenadores según sea necesario.
Comprueba las ubicaciones de Orchestrator en las que se requiere una contraseña y añádela: Robots, Configuración y Activos de credenciales.

Obtener ayuda

Si necesitas ayuda con un problema detectado durante la exportación, la importación o después de la importación, abre un ticket de soporte e incluye los siguientes archivos: