Orchestrator
2021.10
False
Imagen de fondo del banner
Guía del usuario de Orchestrator
Última actualización 28 de feb. de 2024

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)
  • Update Service - a Windows service or process (when quick install is used) responsible for the communication between the client machine and the update server.

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.
    Note: If the Chrome extension was already installed on the robot machine, the auto-update functionality updates it as well. Otherwise, the extension has to be installed manually.

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 John.Doe@domain.com.
  • Se aplica una política de actualización a john.doe@domain.com que está configurada para implementar la versión 2021.10.2.
  • john.doe@domain.com 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

In the Orchestrator user interface, the update logs are available for failed and successful updates and can be copied directly using the docs image button next to each log. Complete logs for the update are found on the machine in the %localappdata%/Uipath/UpdateService/logs file.


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:

  • docs image Sin política: no se define ninguna política
  • docs image Actualización en curso: este estado se presenta cuando el proceso de actualización está en curso en la máquina.
  • docs image Compatible: la versión del robot en la máquina coincide con la política de actualización.
  • docs image 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)
  • docs image 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: Linux Robots are not compatible with the Auto-Update feature. For these, the version status shows as N/A with the "Auto-update is not applicable for this type of machine" tooltip.

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.

If you choose not to have the version management done by UiPath or your Orchestrator instance does not have Internet access, you must manually download the installers of the client components from the UiPath Customer Portal - Product Downloads page and upload them to the update server using the steps below:

  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. To set the values for ClientId and ClientSecret, run the script below:
    Nota:

    Los scripts necesarios para los siguientes comandos pueden recuperarse descargando los scripts de UiPath Update Server en la sección Descargas de productos en Customer Portal.

    The supported product versions to be used in the scripts are found in the Product Lifecycle documentation page. For the update scripts, the short format of the version is used (e.g. 22.4.3 instead of 2022.4.3).

    .\Provision-IdentityClient.ps1 -IdentityUri "<IDENTITY_URL>" -InstallationToken "<INSTALLATION_TOKEN>" -ClientId "<CLIENT_ID>" -ClientSecret "<CLIENT_SECRET>".\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>".\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".\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>"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>".\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:

ProductIdProducto
FD97813F-44F7-45A0-BB55-0DAF0088F568Asistente de Uipath para Mac (x64)
46C978F2-A5FE-4F71-AD88-D6A07118F790Asistente de Uipath para Mac (ARM64)
B69FDACF-6DD0-46FB-88C7-AF2D87CAF5AAPaquete 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



Was this page helpful?

Obtén la ayuda que necesitas
RPA para el aprendizaje - Cursos de automatización
Foro de la comunidad UiPath
Logotipo blanco de UiPath
Confianza y seguridad
© 2005-2024 UiPath. All rights reserved.