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 Actualizar automáticamente los componentes del cliente solo funciona para actualizar los productos Robot, Studio y 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 o proceso de Windows (cuando se utiliza la instalación rápida ) responsable de la comunicación entre la máquina cliente y el servidor de actualizaciones.

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

Cuando se instalan Studio y Robot, también se añaden 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 Studio y Robot por máquina en el modo de usuario attended, 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.

El servicio de actualización en la máquina se comunica con el servidor de actualización durante el sondeo regular, y cuando encuentra un cambio en la política, comprueba con las aplicaciones cliente para ver si están listas para iniciar el proceso de actualización.

Para que un producto reciba una actualización, debe estar en un estado neutro:

• 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 abriendo de nuevo la notificación desde el 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 cerrará y el proceso se guardará en el estado que tenga en ese momento y se podrá recuperar después de que la actualización termine. El robot espera a que se completen todos los procesos y a continuación inicia el proceso de actualización.

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 gestiona el procesamiento 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 los componentes del cliente están preparados 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 actualización 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.

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.

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.

Configuración de políticas para los objetos de la 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 esa clave de máquina. La configuración se realiza a nivel de objeto máquina:

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. En la sección Actualizar la configuración de la política, cambia la política de actualización a uno de los siguientes valores:
   
   

   

   
   

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.
• Una política de actualización se aplica a group_1 que está configurado 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.

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 incorrectas y satisfactorias y pueden copiarse directamente mediante el botón situado junto a cada registro. 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

If your Orchestrator instance has Internet access, by default, version management is done by UiPath, and the list of available versions in the policies is automatically populated. If you want to manually manage the versions, go to Settings at the host level, then select General, and then clear the Auto-fill available product versions checkbox.

Si decide que UiPath no gestione las versiones o su instancia de Orchestrator no tiene acceso a Internet, debe descargar manualmente los instaladores de los componentes del cliente desde la página Customer Portal de UiPath: descargas de productos y cargarlos en el servidor de actualizaciones mediante la herramienta pasos a continuación:

1. El token de instalación se adquiere después de iniciar sesión en el host tenant/org como administrador de host, abriendo una nueva pestaña y yendo a https://baseURL/identity_/api/Account/ClientAccessToken.
2. Para establecer los valores para ClientId y ClientSecret, ejecuta el script a continuación:
   Nota:

   Los scripts necesarios para los siguientes comandos se pueden recuperar descargando los scripts del servidor de actualización de UiPath desde la sección de Descargas de productos en el Customer Portal.

   Las versiones de producto 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 (p. Ej. 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.

Importante: tanto el servicio de actualización en la máquina cliente como el servidor de actualización en Orchestrator deben tener acceso a `https: // descargar.uipath.com` en el puerto 443. El servicio de actualización lo necesita para descargar los archivos de actualización, mientras que el servidor de actualización de Orchestrator lo necesita para obtener las versiones de las políticas de actualización.

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