Actualización automática de los componentes del cliente

Acerca de

Esta función permite a los administradores actualizar los clientes de UiPath Robot, Studio y UiPath Assistant a las nuevas versiones desde Orchestrator. Esto proporciona una manera fácil de entregar una actualización de versión a una gran base de máquinas desde una ubicación centralizada, lo que ayuda a eliminar la fricción del usuario y agiliza el proceso de actualización.

Nota: La función de actualización automática de componentes del cliente solo funciona para actualizar los productos Robot, Studio y UiPath Assistant ya instalados a una versión más reciente. Si se necesita una degradación de versión, el proceso de degradación debe realizarse manualmente o utilizando herramientas independientes de UiPath.

Requisitos previos

1. Orchestrator, Studio y Robot 2021.10 o posterior.
2. Studio y/o Robot 2021.10 o posterior instalado en el equipo cliente y conectado a Orchestrator.

Componentes que intervienen en el proceso de actualización

Parte del cliente

• Aplicaciones para clientes:

  • Robot
  • Asistente
  • Studio
• Servicio de robots
• Agente de actualización: proceso de Windows responsable de la comunicación entre el usuario y el servicio de actualización. (solo presente en el modo usuario y en la instalación de robots asistidos)
• Servicio de actualización: un servicio de Windows responsable de la comunicación entre la máquina cliente y el servidor de actualización.

Parte del servidor

• Orchestrator: proporciona la interfaz de usuario para que los administradores establezcan políticas de actualización automática y comprueben el estado de la versión de las aplicaciones cliente.
• Servidor de actualización: servicio centralizado encargado de gestionar las políticas de actualización automática y de mantener la comunicación con los equipos cliente a través del servicio de actualización.

Cómo funciona

Como administrador, puedes elegir la versión específica que se desplegará en una máquina concreta.

Para ello, cuando se instalan Studio y Robot, se añaden también dos ejecutables a la máquina: UiPath.UpdateService.Worker.exe y UiPath.UpdateService.Agent.exe.

Se instalan de forma diferente dependiendo del tipo de instalación de Studio/Robot.

• Robot desatendido: UiPath.UpdateService.Worker.exe se instala como servicio de Windows y UiPath.UpdateService.Agent.exe no está instalado.
• Robot atendido: UiPath.UpdateService.Worker.exe se instala como servicio de Windows; UiPath.UpdateService.Agent.exe se instala como tarea de inicio de sesión en el Programador de tareas.
• Instalación rápida (modo usuario): UiPath.UpdateService.Worker.exe y UiPath.UpdateService.Agent.exe se instalan como tareas de inicio de sesión en el Programador de tareas.
  Importante: Al instalar UiPath Studio y Robot en el equipo en modo de usuario asistido, para que el servicio de actualización se conecte al servidor de actualización, asegúrate de añadir la URL de Orchestrator durante la configuración. Si la URL de Orchestrator no se añade durante la instalación, un usuario con derechos de administrador en la máquina debe iniciar sesión y conectar el robot a Orchestrator.

Cuando se define o modifica una nueva política, el servidor de actualización envía un comando al servicio de actualización en el equipo cliente, que pregunta a las aplicaciones cliente si están listas para iniciar el proceso de actualización.

Para estar listo para recibir una actualización, un producto debe estar en un estado neutral:

• Studio: no hay procesos en ejecución ni sesiones activas.
• Robot: no hay trabajos ni procesos en ejecución.
• Assistant: no hay procesos en ejecución ni actividades pendientes (procesos de instalación o descarga).
  Nota: durante el proceso de actualización, el UiPath Robot no inicia ningún trabajo hasta que se complete la actualización.

En el escenario atendido, se muestra un aviso de actualización que ofrece al usuario dos opciones:

• Update Now: detiene todos los trabajos que se están ejecutando y cierra todas las instancias de Studio en esa máquina para proceder a la actualización.
• Later: silencia la notificación y el proceso de actualización puede reanudarse dirigiéndote al icono de la interfaz de usuario en la bandeja del sistema y haciendo clic en Buscar actualizaciones.

  Cuando el usuario acepta la solicitud, se envía la confirmación al servicio de actualización y se inicia el proceso de actualización. Si no se responde en 24 horas desde la primera notificación, la actualización se instalará automáticamente.

En el escenario desatendido, el servicio de actualización confirma que la aplicación cliente esté en un estado neutro (como se ha descrito anteriormente) antes de enviar la confirmación al servidor de actualización.

Nota:

Si hay algún proceso en ejecución en la máquina, se le pide al usuario que elija entre detener el proceso o esperar a que termine y continuar con la actualización. Si hay una sesión de Studio abierta, se pide al usuario que guarde el progreso.

Si el usuario no reacciona, Studio se cierra y el proceso se guarda como está en ese momento y puede recuperarse después de que se complete la actualización; mientras que el UiPath Robot espera a que se complete cualquier proceso y comienza el proceso de actualización después.

Pasos del proceso de actualización

El proceso de actualización se divide en siete etapas:

1. Descargando
   • El servicio de actualización comprueba el servidor de actualización cada tres horas en busca de una solicitud de actualización. Si se recibe la solicitud de actualización, el proceso de actualización inicia el proceso de descarga. Si el proceso de descarga se ha iniciado con éxito, la solicitud de actualización se añade a la base de datos del servidor de actualización con el estado Downloading.
2. descargado
   • El estado Downloaded actúa como un marcador para que el servicio de actualización pueda iniciar la fase de postprocesamiento. Este estado indica que el archivo de actualización se ha descargado con éxito.
3. Procesamiento
   • Este paso se encarga del postprocesamiento del archivo descargado. En este paso se comprueba el archivo y, si no aparecen errores, se inicia el proceso de instalación.
4. Listo para instalar
   • El agente de actualización informa al usuario de que una actualización está a la espera de ser instalada y pide la aprobación o comprueba que las aplicaciones cliente están preparadas para recibir la actualización.
5. Instalación aprobada
   • Cuando el servicio de actualización recibe la aprobación, se inicia la instalación propiamente dicha.
6. Instalando
   • La nueva versión se instala en la máquina manteniendo la misma configuración que la versión anterior.
7. Éxito / Error
   En función del resultado de la instalación, el estado de la actualización se comunica al servidor de actualización.

   Nota: si la extensión de Chrome ya estaba instalada en la máquina del robot, la funcionalidad de actualización automática también la actualiza. De lo contrario, la extensión debe instalarse manualmente.

Mecanismo de reintento

Durante el proceso de actualización, si el archivo no puede recuperarse en la primera descarga, el servicio de actualización lo reintenta tres veces más. Los intervalos de reintento son: una hora después del primer intento, dos horas después del primer reintento y cuatro horas después del último reintento. Antes de cada reintento, se informa al usuario a través del sistema de notificación.

Para cada intento de descarga, los registros se añaden en los registros de actualización de Orchestrator y localmente en la máquina, en el archivo %localappdata%/Uipath/UpdateService/logs.

El proceso es similar para la instalación, por lo que si se produce un error en la primera instalación, el servicio de actualización lo vuelve a intentar tres veces con la misma frecuencia (una hora después del intento inicial, luego dos después del primer reintento y cuatro horas después del último reintento).

El servidor de actualizaciones espera 72 horas para que la actualización se complete desde su inicio. Si la nueva versión no se instala después de este intervalo, se añade un error detallado a los registros. La actualización se vuelve a intentar la próxima vez que se reciba una solicitud.

También puedes reintentar manualmente la actualización utilizando el botón si la actualización automática falla.

Despliegue de robots en modo servicio y en modo usuario

Los aspectos técnicos del servidor son idénticos para las implantaciones en modo servicio y en modo usuario, ya que utilizan el mismo tipo de conexión entre el servidor y el servicio de actualización. La diferencia consiste en la forma en que el servicio de UiPath Robot se comunica con el servicio de actualización en la máquina cliente, como se explica a continuación.

Modo de servicio

En las implantaciones en modo servicio, el servicio del robot y el servicio de actualización se ejecutan en la sesión de la cuenta local del sistema.

Modo de usuario

En las implementaciones en modo usuario, el servicio de robot se ejecuta en la sesión del usuario y el servicio de actualización se ejecuta en la sesión de la cuenta local del sistema.

Importante: cuando el UiPath Robot y Studio se despliegan en modo usuario, el envío del comando de actualización a un UiPath Robot de la máquina afecta a todos los usuarios de esa máquina específica.

Advertencia: una vez finalizado el proceso de actualización, Studio y UiPath Robot deben iniciarse manualmente.

Configurar las políticas

Las políticas pueden establecerse para usuarios, grupos de usuarios (recomendado para casos de uso atendidos) o máquinas (recomendado para casos de uso desatendidos).

Configuración de políticas para usuarios/grupos de usuarios

La configuración de políticas de actualización para usuarios o grupos de usuarios permite a los administradores controlar la versión de Studio, UiPath Robot y Assistant para un usuario o grupo de usuarios específico.

• Usuario específico: para actualizar de forma granular los componentes vinculados a un usuario específico.

• Grupo de usuarios: para actualizar el acceso a todos los miembros del grupo sin necesidad de establecer el nivel de acceso para cada usuario individualmente.

  Importante: para los usuarios que tienen asignada la licencia Automation Express, la política de actualización no se puede editar y se establece para entregar la última versión de la empresa.

Las políticas se configuran editando un usuario o grupo específico desde la sección Administrar acceso en Orchestrator.

1. Dirígete a Tenant > Administrar acceso. Se mostrará la ventana Usuarios.
2. Para el usuario/grupo de usuarios deseado, haz clic en Editar. Se mostrará la ventana Editar usuario.
3. En la sección Actualizar la configuración de la política, cambia la política de actualización automática a uno de los siguientes valores:

Por usuario

Por grupo

Nota:

Si la política aplicada al usuario está configurada como None, pero también forma parte de un grupo que tiene una política específica (por ejemplo, el último parche), se aplica la política de grupo. Si quieres que no se actualicen los componentes de ese usuario concreto, debes eliminarlos del grupo que tiene la política o establecer la política de actualización a la versión actual que está instalada.

Si el usuario tiene una política configurada para enviar una versión específica y también forma parte de un grupo que tiene una política diferente, la política a nivel de usuario tiene prioridad.

Por objetos de máquina

La configuración de una política de actualización para los objetos de la máquina permite a los administradores actualizar las versiones del robot en todas las máquinas conectadas a Orchestrator usando una clave de máquina específica.

Para configurar las políticas de actualización de los objetos máquina, sigue estos pasos:

1. Dirígete a Tenant > Máquinas. Se mostrará la ventana Máquinas
2. Para el objeto de la máquina deseada, haz clic en Editar. Se mostrará la ventana Editar máquina.
3. Accede a la pestaña Mantenimiento. Aparece el menú de configuración Actualización automática.
4. Configura la política de actualización.
   

Nota: Fe de erratas 28 de abril de 2023

Para habilitar esta característica, debes añadir el parámetro Features.MachineMaintenanceSchedule.Enabled al archivo UiPath.Orchestrator.dll.config y establecerlo en true.

Programar actualización automática

En la pestaña Mantenimiento también puedes programar la actualización para que se inicie a una hora y fecha determinadas con el fin de que coincida con otras ventanas de mantenimiento en tu empresa. También puedes establecer la duración de la ventana de mantenimiento. Si transcurre el tiempo establecido para la ventana de mantenimiento y la actualización no se ha iniciado, se programa durante el siguiente intervalo disponible.

Política de prioridades

En caso de que una política a nivel de usuario, una política a nivel de grupo y una política a nivel de máquina se apliquen al mismo UiPath Robot, la política a nivel de usuario tiene prioridad.

Ejemplo:

• Machine_1 tiene instalada la versión 2021.10 de UiPath Robot y Studio.
• En machine_1, el robot se conecta a Orchestrator a través del registro interactivo con el usuario [e-mail].
• Se aplica una política de actualización a [e-mail] que está configurada para implementar la versión 2021.10.2.
• [e-mail] también forma parte de group_1.
• Se aplica una política de actualización a group_1 configurada para implementar la versión 2021.10.3.

• Se aplica una política de actualización a machine_1 que está configurada para implementar la versión 2022.4.

  Resultado: cuando se activan las políticas de actualización, los componentes de esa máquina se actualizan a la versión 2021.10.2.

  Nota: cuando utilice cuentas de robot , tenga en cuenta que se utiliza la política a nivel de máquina para gestionar la actualización.

Disponibilidad de la versión en las políticas

Al crear una política de actualización, puedes elegir una de las siguientes opciones:

Última versión principal	Último parche	Parche específico
Instala la última versión disponible que se encuentra en el servidor de actualizaciones.	Instala el último parche disponible para cada una de las versiones compatibles. (por ejemplo, el último parche 2021.10, el último parche 2022.4).	Instala un parche específico de la lista de los parches disponibles en el servidor de actualización.

Registros de actualización

En la interfaz de usuario de Orchestrator, los registros de actualización están disponibles para las actualizaciones fallidas y con éxito. Los registros completos de la actualización se encuentran en la máquina en el archivo %localappdata%/Uipath/UpdateService/logs.

ADVERTENCIA:

Cuando los robots se despliegan en entornos virtuales en los que se clonan las máquinas, el nombre de la máquina, el guid, el ID de la unidad y la dirección mac son los mismos. Esto puede causar conflictos, ya que Orchestrator recibe diferentes estados de actualización de varias máquinas con los mismos identificadores.

En este escenario, el estado de actualización en Orchestrator se muestra en base a la última máquina conectada.

Esto también puede afectar a los registros de Orchestrator, ya que si varias máquinas tienen los mismos identificadores, pueden aparecer registros duplicados.

Estados de la versión

El Estado de la versión te permite comprobar el estado de la versión del UiPath Robot para tus máquinas con respecto a la política asociada.

Están disponibles los siguientes valores:

• Sin política: no se define ninguna política
• Actualización en curso: este estado se presenta cuando el proceso de actualización está en curso en la máquina
• Compatible: la versión del robot en la máquina coincide con la política de actualización.
• No compatible: la versión del robot en la máquina es diferente a la configurada en la política. (por ejemplo, la versión del robot es 2021.10.3 y la política está configurada como 2021.10.1)
• Error de actualización: este estado se muestra cuando el proceso de actualización ha dado error. Puedes encontrar más detalles en los registros de actualización.
• N/A: este estado se muestra cuando la configuración para excluir máquinas inactivas está activada y el robot no se ha conectado durante un tiempo, o cuando el tipo de máquina no es compatible con el proceso de actualización automática.

Estado de la versión de las máquinas

La columna Estado de la versión en la pestaña Máquinas de Orchestrator te permite comprobar el estado de la versión del UiPath Robot para tus máquinas con respecto a la política asociada.

Importante: Los Robots de Linux no son compatibles con la función de actualización automática. Para estos, el estado de la versión se muestra como N/A con el texto: «La actualización automática no es aplicable a este tipo de máquina».

Exclusión de las máquinas inactivas

Si hay varias máquinas conectadas a Orchestrator con la misma clave y una de ellas está inactiva, el estado de la versión de la plantilla de la máquina pasa a ser Non compliant. Esto ocurre porque la plantilla de máquinas se comunica con el servidor de actualización utilizando la misma clave de máquina, y si una de las máquinas conectadas no puede recibir una actualización, el estado general de la plantilla de máquinas se ve afectado.

Para evitarlo, accede a la sección General del menú Configuración en el contexto del tenant, selecciona la casilla Binarios del cliente, y establece el intervalo de inactividad preferido. Esto excluye a las máquinas inactivas del proceso de actualización, y ya no las tiene en cuenta cuando se informa del estado de actualización.

Estado de la versión para los usuarios

La columna Estados de la versión en la pestaña Robots de Orchestrator te permite comprobar el estado de la versión del componente cliente para tus usuarios con respecto a la política asociada.

Gestionar versiones de actualización

Si tu instancia de Orchestrator tiene acceso a Internet, por defecto, la gestión de versiones la realiza UiPath, y la lista de versiones disponibles en las políticas se rellena automáticamente. Si deseas gestionar manualmente las versiones, dirígete a Configuración > General, y desactiva la casilla Autocompletar versiones de productos disponibles.

Si decides que UiPath no se encargue de la gestión de versiones o tu instancia de Orchestrator no tiene acceso a Internet, deberás descargar manualmente los instaladores de los componentes del cliente desde el Customer Portal de UiPath - página de descarga de productos y cargarlos en el servidor de actualizaciones siguiendo los pasos que se indican a continuación:

1. Adquiere -InstallationToken de Identity Server siguiendo los pasos descritos en Token de acceso a la instalación.
2. Para establecer los valores para ClientId y ClientSecret, ejecuta el script a continuación:
   Nota:

   Los scripts necesarios para los siguientes comandos se encuentran en la carpeta de instalación (la ruta predeterminada es C:\Program Files (x86)\UiPath\Orchestrator\Tools\UpdateServerScripts) en la máquina de Orchestrator.

   Las versiones de productos compatibles que se utilizarán en los scripts se encuentran en la página de documentación del ciclo de vida del producto. Para los scripts de actualización, se utiliza el formato corto de la versión (por ejemplo, 22.4.3 en lugar de 2022.4.3).

   .\Provision-IdentityClient.ps1 -IdentityUri "<IDENTITY_URL>" -InstallationToken "<INSTALLATION_TOKEN>" -ClientId "<CLIENT_ID>" -ClientSecret "<CLIENT_SECRET>"

   Los valores establecidos para ClientId y ClientSecret deben utilizarse más tarde al llamar al script Product-Versions.ps1

Obtener las versiones disponibles

.\Product-Versions.ps1 get -ApiBaseUri "<ORCHESTRATOR_URL>" -IdentityUri "<IDENTITY_URL>" -ClientId "<CLIENT_ID>" -ClientSecret "<CLIENT_SECRET>"

Publicar una nueva versión en el servidor de actualizaciones

.\Product-Versions.ps1 register -ApiBaseUri "<ORCHESTRATOR_URL>" -IdentityUri "<IDENTITY_URL>" -ClientId "<CLIENT_ID>" -ClientSecret "<CLIENT_SECRET>" -ProductId "b69fdacf-6dd0-46fb-88c7-af2d87caf5aa" -Version "<NEW_VERSION>" -DownloadUri "<DOWNLOAD_URL>".\Product-Versions.ps1 register -ApiBaseUri "https://intranet/orchestrator_" -IdentityUri "https://intranet/identity_" -ClientId "<CLIENT_ID>" -ClientSecret "<CLIENT_SECRET>" -ProductId "b69fdacf-6dd0-46fb-88c7-af2d87caf5aa" -Version "22.4.3" -DownloadUri "https://download.uipath.com/versions/22.10.3/UiPathStudio.msi"

Eliminar una versión específica del servidor de actualizaciones

DELETE
.\Product-Versions.ps1 delete -ApiBaseUri "<ORCHESTRATOR_URL>" -IdentityUri "<IDENTITY_URL>" -ClientId "<CLIENT_ID>" -ClientSecret "<CLIENT_SECRET>" -ProductId "b69fdacf-6dd0-46fb-88c7-af2d87caf5aa" -Version "<NEW_VERSION>"

Publicar una nueva versión en la máquina cliente

.\Provision-IdentityClient.ps1 -IdentityUri "<IDENTITY_URL>" -InstallationToken "<INSTALLATION_TOKEN>" -ClientId "<CLIENT_ID>" -ClientSecret "<CLIENT_SECRET>"

Según los requisitos, se pueden utilizar los siguientes ID de producto en los scripts:

ProductId	Producto
FD97813F-44F7-45A0-BB55-0DAF0088F568	Asistente de Uipath para Mac (x64)
46C978F2-A5FE-4F71-AD88-D6A07118F790	Asistente de Uipath para Mac (ARM64)
B69FDACF-6DD0-46FB-88C7-AF2D87CAF5AA	Paquete de automatización de UiPath (UiPathStudio.msi)

Configuración de proxy

En los casos en los que los robots se encuentran detrás de un proxy, para que la función de actualización automática funcione, puede ser necesario realizar ajustes adicional. Según el tipo de instalación, las configuraciones del proxy pueden heredarse de la configuración del proxy a nivel de usuario, o establecerse manualmente editando el archivo config.

Tipo de instalación	Implementación de robots	Servicio de actualización	Agente de actualización	Configuración de Proxy
Robot desatendido	Servicio de Windows	Servicio de Windows	N/D 1	Desde del archivo uipath.config.
Robot atendido	Ejecución a nivel de usuario	Servicio de Windows	Ejecución a nivel de usuario	Desde del archivo uipath.config.
Instalación rápida	Ejecución a nivel de usuario	Ejecución a nivel de usuario	Ejecución a nivel de usuario	Desde la configuración del proxy a nivel de usuario.

1 cuando el robot se instala en modo desatendido, el agente de actualización no se añade a la máquina.

Recopilación de registros de errores

Cuando una actualización produce un error, puedes utilizar la Herramienta de diagnóstico para recopilar registros y enviarlos a nuestro equipo de soporte, los cuales se usan para investigar más a fondo el error específico.

Mensaje de error

Configuración de la herramienta de diagnóstico