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 Orchestrator independiente o de Automation Suite a Automation Cloud, Automation Cloud Dedicated, Sector público de Automation Cloud o Automation Suite.

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

Al planificar tu migración desde On-Premises Orchestrator a Automation Cloud^TM Dedicated, es recomendable que sigas los siguientes pasos:

1. Actualiza a una versión local compatible de Orchestrator.

2. Migrar de carpetas clásicas a modernas,

3. Ejecuta la herramienta de migración para migrar de On-Premises Orchestrator a Automation Cloud^TM Dedicated.

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.

Requisitos previos

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

1. Asegúrate de tener suficientes licencias de robot para que coincida con el número de robots que se están migrando (Admin > Licencias > Robots y servicios). La herramienta migra los robots siempre que haya licencias disponibles, después de lo cual comienza a omitir los robots.

2. Asegúrate de tener credenciales de administrador para el entorno desde el que migras.

3. Asegúrate de tener permiso de visualización para todas las entidades que se van a migrar. Si no tienes el permiso Ver para algunas entidades, esas entidades no se migrarán.

4. Asegúrate de que eres administrador de la organización en Automation Cloud para registrar la herramienta como aplicación externa.

5. 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 Orchestrator independiente, Orchestrator en Automation Cloud u Orchestrator en Automation Suite.

   2. Can access Automation Cloud^TM Dedicated (has internet access and a supported browser);

   3. Ejecuta el sistema operativo Windows.

6. Descarga la herramienta de migración en la máquina que cumple los requisitos del paso anterior.

Entidades migradas por la herramienta de migración

Al utilizar la herramienta de migración, las siguientes entidades, como se describe en la tabla, se crean automáticamente en Automation Cloud^TM Dedicado para reflejar 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 externas que requieren autenticación Nota: Se requiere autenticación después de completar la migración para las fuentes de paquetes externas configuradas con autenticación básica
Librerías	Solo fuentes 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 del 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 determinadas 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 ha sido invitado a Automation CloudTM Dedicado 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 CloudTM Dedicated no existe
Asociaciones de entorno	La asignación de entorno del robot	N/D
Procesos	Sí Nota: La herramienta de migración puede referirse a los procesos como versiones	N/D
Colas	Sí	N/D
Desencadenadores	Sí, pero están configurados 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

La herramienta de migración no migra las siguientes entidades:

• 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

• Tareas

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

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

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

1. 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/

2. 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^TM Dedicado a importar y crear las entidades migradas en Orchestrator.

For more information about entities that are subject to migration, refer to Entities migrated by the migration tool.

1. Extrae el archivo .zip que descargaste para la herramienta y, a continuación, ejecuta la herramienta .exe .
2. Para elegir tu entorno de exportación, sigue uno de los siguientes pasos:

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

     
3. 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.
4. Selecciona 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.

   
5. Selecciona Inicio para volver a la primera pantalla de la herramienta de migración.
6. Para el método de activación, esta vez elige Conectar a Automation Cloud^TM Dedicado.
7. Rellena la información para permitir que la herramienta se conecte a Automation Cloud^TM Dedicado para cargar la información de configuración. La siguiente tabla describe los campos necesarios para conectarse a Automation Cloud^TM Dedicated.
   

   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 CloudTM Dedicated. 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 dedicada de Automation CloudTM . Los administradores de la organización pueden encontrar esta información en el campo URL en Admin > 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://<customURL>.dedicated.uipath.com/myOrgName, añade myOrgName al campo.
   Nombre del tenant	El nombre exacto del tenant dedicado de Automation CloudTM al que quieres añadir la información migrada. Los datos migrados serán visibles en el servicio de Orchestrator asociado a ese tenant.

8. Selecciona Iniciar importación para conectarte a Automation Cloud^TM Dedicated y comenzar a migrar la información al servicio de destino de Orchestrator.

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

   Para conectarse a Automation Cloud^TM Dedicado 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^TM Dedicado. 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 importación enumera todas las entidades que se importaron correctamente al servicio de Orchestrator en Automation Cloud^TM Dedicado.

   

   Todo lo que no se haya importado se muestra como un error y las importaciones parciales se muestran como advertencias. Puedes seleccionar Ver informe para obtener más detalles sobre exactamente qué entidades encontraron un error o una advertencia.
9. 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.

1. En Automation Cloud^TM Dedicado, selecciona el tenant que era el destino de la importación y abre Orchestrator. Comprueba que las carpetas y entidades se hayan migrado correctamente. Puedes utilizar el resumen de importación para comprobar los elementos específicos que tenían advertencias o errores.
2. 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.
3. Carga manualmente cualquier fuente de la biblioteca que la herramienta no haya migrado.
4. Si se ha omitido algún robot durante la exportación o la importación, créalo manualmente.
5. Create any webhooks, task catalogs, credential stores, or other information that the tool does not migrate. The section Entities migrated by the migration tool also includes a list of what the tool does not migrate.
6. Conecta manualmente los robots al servicio Orquestador de la nube.
7. Habilita manualmente los desencadenadores según sea necesario.
8. 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:

• Archivo de registro (en la subcarpeta de logs)

• Archivo de informe de exportación (en la subcarpeta MigrationAssets)

• Archivo de informe de importación (en la subcarpeta MigrationAssets)

Además de los archivos anteriores, sería útil saber lo siguiente:

• La versión de tu Orchestrator local;

• Tus nombres de organización y tenant de Automation Cloud^TM Dedicated .