Utilizar la herramienta de migración de Automation Cloud

La herramienta de migración de Automation Cloud es una aplicación de escritorio diseñada para simplificar el proceso de migración de una opción de implementación a otra. La herramienta automatiza varios pasos de migración, lo que facilita la transición de tu independiente o Automation Suite Orchestrator a Automation Cloud, Sector público de Automation Cloud o a Automation Suite.

Las instrucciones de esta página se aplican a la migración de tu Orchestrator local, independiente o a través de Automation Suite, a Automation Cloud.

Nota:

Al planificar tu actualización o migración, se recomienda que sigas las mejores prácticas.

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:

Comprueba que el plan de licencias Enterprise o Enterprise Trial está activo en Automation Cloud (Admin > Licencias).
Asegúrate de que tienes suficientes licencias de robots en Automation Cloud para que coincidan con el número de robots que se van a migrar (Admin > Licencias > Robots y Servicios). La herramienta solo migra los robots mientras haya licencias disponibles, después de lo cual empieza a omitir los robots.
Asegúrate de tener credenciales de administrador para Orchestrator local y el permiso Ver para todas las entidades que se migran. Si no tienes el permiso Ver para algunas entidades, esas entidades no se migrarán.
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. puede conectarse a la Orchestrator;
2. puede acceder a Automation Cloud (tiene acceso a Internet y un navegador compatible);
3. ejecuta el sistema operativo de Windows;
4. tiene .NET Core Desktop Runtime para x64 instalado.
Descarga la herramienta de migración en la máquina que cumple los requisitos en el paso 5.

Entidades migradas por la herramienta de migración

Al utilizar la herramienta de migración, las siguientes entidades se crean automáticamente en Automation Cloud para duplicar tu configuración de Orchestrator:

Entidad	Migrado	No migrado
Configuración	Sí, con excepciones.	Algunas configuraciones locales, como las contraseñas y ciertas configuraciones expuestas a los tenants
Paquetes	Todos los paquetes y versiones de paquetes.	Entidades que dependen de fuentes de paquetes externos que requieren autenticación. La autenticación es necesaria después de completar la migración para fuentes de paquetes externos configuradas con autenticación básica
Librerías	Solo se alimenta a nivel de tenant.	Entidades que dependen de bibliotecas con configuraciones a nivel de host o bibliotecas externas inaccesibles.
Calendarios	Sí	N/D
Máquinas	Sí Nota: Posibles limitaciones de asignación de ranuras de máquina debido a la falta de licencias .	Claves de la máquina
Carpetas	Sí	Carpetas de espacio de trabajo personal.
Entornos	Sí, para las carpetas clásicas.	N/D (para carpetas modernas)
Robots (clásico)	Sí Nota: Posibles limitaciones de creación de robots debido a la falta de licencias.	Se omite cuando se agotan las licencias, con un error registrado para cada robot omitido.
Robots (modernos)	Sí Nota: Si se cumplen ciertas condiciones, los robots se asocian a un usuario local que tiene una dirección de correo electrónico y ese mismo correo electrónico ya fue invitado a Automation Cloud y está asociado a un usuario.	Se omite cuando se agotan las licencias, con un error registrado para cada robot omitido. Falla si un usuario en Automation Cloud no existe.
Asociaciones de entorno	La asignación de entorno del robot	N/D
Procesos	Sí Nota: La herramienta de migración puede hacer referencia a Procesos como Versiones.	N/D
Colas	Sí	N/D
Desencadenadores	Sí, pero se establecen como deshabilitados.	N/D
Activos	Ciertos tipos de activos son totalmente compatibles, con algunas consideraciones para los activos de credenciales.	Valores de activo por usuario en carpetas modernas
Fuentes de la carpeta	Sí	N/D

Entidades no migradas por la herramienta de migración

Las siguientes entidades no son migradas por la herramienta:

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

La herramienta de migración debe conectarse a la API del servicio Orchestrator en Automation Cloud para crear las entidades migradas. Utiliza el flujo OAuth y, por tanto, debe registrarse en Automation Cloud como una aplicación externa.

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

Añade la herramienta como una nueva aplicación externa siguiendo las instrucciones de Añadir una aplicación externa. Asegúrate de utilizar la siguiente configuración:
- 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.
Se conecta a Automation Cloud para importar y crear las entidades migradas en Orchestrator.

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

Extrae el archivo .zip que has descargado para la herramienta y luego ejecuta el EXE de la herramienta .exe.
Para el método de activación, elige MSI local.
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.
Haz clic en Iniciar exportación para conectarte a tu entorno de origen y descargar la información de configuración.La exportación comienza y puede tardar un poco en completarse.

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.
Haz clic en Inicio para volver a la primera pantalla de la herramienta de migración.
Para el método de activación, esta vez elige Conectar con Automation Cloud.

Completa la información para permitir que la herramienta se conecte a Automation Cloud para cargar la información de configuración.

Campo	Detalles
ID de la aplicación cliente	El valor del ID de la aplicación asociado al registro de la aplicación externa en Automation Cloud. Puedes encontrar este valor en la página Admin > Aplicaciones externas.
Nombre de la organización	La parte específica de la organización de tu URL de Automation Cloud. Los administradores de la organización pueden localizar esta información en el campo URL en Administración > Configuración de la organización. 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	El nombre exacto del tenant de Automation Cloud en el que quieres añadir la información migrada. Los datos migrados serán visibles en el servicio Orchestrator asociado a ese tenant.

Selecciona Iniciar importación para conectarte a Automation Cloud y comenzar a migrar la información al servicio de Orchestrator de destino.
La importación comienza y puede tardar un poco en completarse.
Para conectarse a Automation Cloud mediante OAuth, un usuario con los permisos adecuados para los ámbitos añadidos al registrar la aplicación externa debe iniciar sesión en Automation Cloud. Cuando lo hacen, se abre una nueva ventana con un mensaje de éxito si el flujo OAuth se ha realizado correctamente.

Al finalizar, el resumen de la importación enumera todas las entidades que se han importado con éxito al servicio de Orchestrator en Automation Cloud.
Todo lo que no se ha importado aparece como un error y las importaciones parciales aparecen como advertencias. Puedes hacer clic en Ver informe para obtener más detalles sobre qué entidades experimentaron un error o una advertencia.
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.

En Automation Cloud, selecciona el tenant que era el destino de la importación y abre Orchestrator. Comprueba que las carpetas y entidades se han migrado correctamente. Puedes utilizar el resumen de importación para comprobar los elementos específicos que tenían advertencias o errores.
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 los robots manualmente al servicio cloud Orchestrator.
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: