Realizar una migración de un solo tenant

Realiza una migración de tenant único a Automation Suite utilizando la herramienta de migración.

La herramienta puede migrar a Automation Cloud™ o a Automation Suite, pero esta página describe el proceso de migración a Automation Suite. Para obtener instrucciones sobre la migración a Automation Cloud, consulta la documentación de Automation Cloud .

Puede utilizar la herramienta de migración Automation Cloud™ de UiPath para migrar automáticamente las entidades de su instancia de Orchestrator independiente al servicio de Orchestrator en Automation Suite.

Antes de empezar

Al planificar tu migración de On-Premises Orchestrator a Automation Suite, es recomendable que sigas los siguientes pasos:

1. Actualiza a una versión de Orchestrator local compatible.
2. Migrar de carpetas clásicas a modernas, ya que las carpetas clásicas tienen restricciones en Automation Suite.
3. Ejecuta la herramienta de migración para migrar de On-Premises Orchestrator a Automation Suite.

Entidades migradas

Cuando se ejecuta la herramienta de migración Automation Cloud, se crean automáticamente las siguientes entidades en Automation Suite para que coincidan con la configuración de la instancia de Orchestrator independiente:

Entidad	Migrado	No migrado
Configuración	Sí, con excepciones (véanse a la derecha).	Algunos ajustes que se muestran al tenant en la ruta de lectura no pueden modificarse en Automation Suite, como el logo o el color del host. Las contraseñas de la tabla de Configuración no se pueden exportar porque la API elimina los valores de la respuesta. Por lo tanto, no se migrarán las contraseñas. Esto afecta a las alertas por correo electrónico (contraseña SMTP) y a las fuentes externas con autenticación básica.
Paquetes	Migra todos los paquetes y todas las versiones de estos. Si una fuente de paquetes es externa y está configurada con autenticación básica, será necesario introducir las credenciales una vez finalizada la migración.	Si una fuente de paquetes es externa y no es accesible a través de Internet, las entidades que dependen de estos paquetes no se migran.
Librerías	Solo se alimenta a nivel de tenant.	Si la fuente de una biblioteca se encuentra en el nivel del host o es externa y no es accesible a través de Internet, las entidades que dependen de estas bibliotecas no se migran.
Calendarios	Sí	N/D
Máquinas	Sí, pero si no hay suficientes licencias para acomodar las asignaciones de ranuras de la máquina, la máquina se importará con todas las ranuras establecidas en 0.	Las claves de la máquina no se migran.
Carpetas	Sí Puedes elegir migrar todas las carpetas de forma masiva, así como carpetas individuales.	Las carpetas del espacio de trabajo personal no se migran.
Entornos	Sí, para las carpetas clásicas.	N/A para carpetas modernas.
Robots (clásico)	Sí, pero si no hay suficientes licencias para la creación de un robot, este se omite durante la importación.	Se omite cuando se agotan las licencias y se registra un error para cada una.
Robots (modernos)	Los robots modernos se migran si el usuario con el que están asociados existe en Automation Suite y tiene la misma dirección de correo electrónico.	Si el usuario no existe en Automation Suite, la migración de ese robot específico falla. Se omite cuando se agotan las licencias y se registra un error para cada una.
Asociaciones de entorno	Se migra la asignación robot-entorno.	N/D
Procesos	Los procesos se migran. La herramienta puede referirse a ellos como Releases.	N/D
Colas	Sí	N/D
Desencadenadores	Los desencadenadores se han migrado, pero están todos desactivados.
Activos	Los tipos de activos booleanos, de texto y enteros son totalmente compatibles. Los activos de credenciales también se migran, pero se utiliza una contraseña ficticia porque la herramienta no puede migrar las contraseñas. Tendrá que actualizar manualmente las contraseñas para cada activo de credenciales después de la migración. Los activos de credenciales se asignan al almacén de credenciales predeterminado en Automation Suite. Los valores por robot también se migran, pero si el robot no fue migrado, este valor se omite y se registra una advertencia de importación.	No se admiten valores de activos por usuario en carpetas modernas. El activo se importa con el valor por defecto o se omite si no se establece ninguno.
Asociaciones de máquinas	Se migran las asignaciones robot-máquina.	N/D

Entidades no migradas

Las siguientes entidades no son migradas por la herramienta:

• Fuentes de la carpeta
• Usuarios
• 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)
• Registros

Requisitos previos

Antes de abrir la herramienta, realiza los siguientes preparativos:

1. Asegúrate de tener suficientes licencias de robot en Automation Suite para que coincida con el número de robots que se están migrando (Admin > Licencias > Robots y servicios). La herramienta solo migra los robots mientras haya licencias disponibles, después de lo cual comienza a omitir los robots.
2. Debe tener credenciales de administrador para la instancia de Orchestrator y permisos Ver para todas las entradas que se están migrando. Si no se tiene el permiso de Vista para algunas entidades, estas no se migran.
3. Debe ser un administrador de la organización en Automation Suite.
4. Para ejecutar la herramienta, se necesita una máquina que:
   1. puede conectarse a la instancia de Orchestrator independiente y a Automation Suite (tiene acceso a Internet)
   2. tenga el sistema operativo Windows
   3. si se conecta a Automation Suite a través de un proxy, tiene las variables HTTP_PROXY, HTTPS_PROXY y NO_PROXY establecidas como variables de entorno del sistema, con NO_PROXY enumerando los hosts a los que debe llegar la herramienta directamente, como tu Orchestrator independiente. Sin estas variables, el paso de importación falla.
5. Descarga la herramienta en la máquina mencionada desde este enlace.
6. Registre la herramienta como una aplicación externa en la organización de Automation Suite de destino.

Registro de la herramienta como aplicación externa

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

1. Sigue estas instrucciones para añadir la herramienta como una nueva aplicación externa con las siguientes características:
   • 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

La herramienta puede migrar un tenant a la vez. Puede ejecutar la herramienta varias veces para cada uno de sus tenants.

Con cada ejecución, la herramienta:

1. Se conecta a su instancia de Orchestrator independiente para exportar las entidades para el tenant determinado.
2. Se conecta a Automation Suite para importar y crear las entidades migradas en el tenant de Orchestrator.

Para obtener más información sobre las entidades que están sujetas a migración, consulta Entidades que se están migrando.

Para ejecutar la herramienta:

1. Extrae el archivo ZIP que has descargado para la herramienta y luego ejecuta el EXE de la herramienta.

2. Para el método de activación, elija Conectar a la ubicación local:

   

3. Rellene la información para permitir que la herramienta se conecte a su instancia de Orchestrator independiente:

   

   Asegúrate de que las credenciales que facilitas son de una cuenta de administrador que también tiene permisos de Vista en todas las entidades que quieres migrar.

4. Selecciona Iniciar exportación para conectarte a tu Orchestrator independiente y descargar la información de configuración. La exportación comienza y puede tardar un poco en completarse:

   ![docs image](https://dev-assets.cms.uipath.com/assets/images/automation-suite/automation-suite-docs-image-206727-6126cce3.webp)
   

   Al terminar, el resumen de la exportación enumera todas las entidades que se han exportado con éxito:

   ![docs image](https://dev-assets.cms.uipath.com/assets/images/automation-suite/automation-suite-docs-image-205823-3dfeedcf.webp)
   

   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.

6. Para el método de activación elija esta vez Conectar con Automation Suite.

7. Complete la información para permitir que la herramienta se conecte a Automation Suite para cargar la información de configuración:

   

   Campo	Detalles
   URL de Automation Suite	La URL donde se aloja Automation Suite, incluido el protocolo y que termina con una barra inclinada (/). Puede elegir esta URL de la barra de direcciones de su navegador mientras está en Automation Suite, pero no incluya la parte de la URL que comienza con el nombre de la organización. Por ejemplo, si la URL en tu navegador es https://mySite.com/docs/Migration/orchestrator_/?tid=34&fid=82, siendo docs el nombre de la organización, debes especificar solo https://mySite.com/ en este campo.
   ID de la aplicación cliente	El valor de ID de la aplicación asociado con el registro de la aplicación externa en Automation Suite. 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 la URL de Automation Suite. Los administradores de la organización pueden encontrar esta información en el campo Nombre de la organización en Admin > Configuración de la organización. 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://mySite.com/``myOrgName, añade myOrgName al campo.
   Nombre del tenant	El nombre exacto del tenant de Automation Suite en el que quiere añadir la información migrada. Los datos migrados serán visibles en el tenant de Orchestrator especificado.

8. Seleccione Iniciar importación para conectarse a Automation Suite y comenzar a migrar la información al tenant de Orchestrator de destino.

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

   

   Para conectarse a Automation Suite 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 Suite. 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 tenant de Orchestrator en Automation Suite:

   

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

Como la herramienta no puede migrar todo, hay algunas tareas finales que debe realizar manualmente para obtener la misma configuración que en su instancia de Orchestrator independiente.

1. En Automation Suite, inicie sesión en la organización del tenant que era el destino de la importación y, seguidamente, abra Orchestrator,

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

3. Asigne licencias de robot y servicio para Orchestrator.

   Durante la importación, las máquinas se crean y reciben licencias mientras existen licencias. Una vez agotadas las licencias, las máquinas siguen creándose sin licencias, por lo que debe actualizar estas máquinas para asignar el número adecuado de licencias.

   Nota:

   Si migró sin activar su licencia de Automation Suite, debe activarla en esta fase para continuar con la configuración.

4. Carga manualmente cualquier fuente de la biblioteca que la herramienta no haya migrado.

5. Si se ha omitido algún robot durante la exportación o la importación, créalo manualmente.

6. Crea cualquier webhook, catálogo de tareas, almacén de credenciales u otra información que la herramienta no migre.

   La sección Entidades que se migran contiene una lista de lo que la herramienta no migra.

7. Conecte robots manualmente al servicio de Automation Suite Orchestrator.

8. Habilita manualmente los desencadenadores según sea necesario.

   Mientras la herramienta migra los desencadenadores, todos están deshabilitados y debe habilitarlos manualmente.

9. 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 estos archivos, sería útil saber:

• La versión de su instancia de Orchestrator independiente
• Los nombres de su organización e tenants de Automation Suite.