Atualização automática de componentes de cliente

Atualize os clientes Robot, Studio e UiPath Assistant para versões mais recentes a partir de um local centralizado do Orchestrator.

Sobre

Essa funcionalidade permite que os administradores atualizem os clientes do UiPath Robot, Studio e UiPath® Assistant para versões mais recentes do Orchestrator. Isso oferece uma maneira fácil de entregar uma atualização de versão a uma ampla base de máquinas de um local centralizado, ajudando a remover o atrito do usuário e simplificando o processo de atualização.

Observação:

A funcionalidade Atualização automática de componentes de cliente funciona apenas para atualizar produtos Robô, Studio e UiPath Assistant já instalados para uma versão mais recente. Se for necessário realizar um downgrade de versão, o processo deve ser feito manualmente ou usando ferramentas independentes da UiPath.

Pré-requisitos

1. Orchestrator, Studio e Robot 2021.10 ou posterior.
2. Studio e/ou Robot 2021.10 ou posterior instalado na máquina cliente e conectado ao Orchestrator.
   Observação:

   Para habilitar a funcionalidade de atualização automática de componentes do cliente para o Robô, você deve instalar o aplicativo Robot usando o instalador UiPathStudio.msi , com uma versão de 2021.10 ou posterior, ou instalador UiPathRobot.msi com uma versão de 2024.10 ou posterior. UiPathRobot.msi As versões do instalador anteriores à 2024.10 não são compatíveis com a atualização automática de componentes do cliente. Se você instalou o Robot usando uma versão do instalador UiPathRobot.msi anterior à versão 2024.10, você pode atualizar manualmente o aplicativo do Robot usando uma versão 2024.10 ou posterior do instalador UiPathRobot.msi .

Componentes que participam do processo de atualização

Lado do cliente

• Aplicativos clientes:
  • Robot
  • Assistant
  • Studio
• Serviço de robôs
• Agente de atualização - um processo do Windows responsável pela comunicação entre o usuário e o serviço de atualização. (presente apenas no modo de usuário e instalação do robô assistido)
• Serviço de atualização - um serviço do Windows responsável pela comunicação entre a máquina cliente e o servidor de atualização.

Lado do servidor

• Orchestrator: fornece a interface do usuário para que os administradores definam políticas de atualização automática e vejam o status da versão para aplicativos cliente.
• Servidor de atualização: serviço centralizado responsável por gerenciar as políticas de atualização automática e manter a comunicação com as máquinas clientes através do serviço de atualização.

Como isso funciona

Como administrador, você pode escolher a versão específica a ser implantada em uma máquina específica.

Para que isso aconteça, quando o Studio e o Robot estiverem instalados, dois executáveis também são adicionados à máquina: UiPath.UpdateService.Worker.exe e UiPath.UpdateService.Agent.exe.

Dependendo do tipo de instalação do Studio/UiPath Robot, elas são instaladas de uma maneira diferente:

• Unattended Robot: UiPath.UpdateService.Worker.exe é instalado como Serviço do Windows, enquanto UiPath.UpdateService.Agent.exe não está instalado.
• Attended Robot: UiPath.UpdateService.Worker.exe é instalado como Serviço do Windows, enquanto UiPath.UpdateService.Agent.exe é instalado como uma Tarefa de LogOn no Agendador de tarefas.
• Instalação rápida (modo de usuário): UiPath.UpdateService.Worker.exe e UiPath.UpdateService.Agent.exe são instalados como Tarefas de logon no Agendador de tarefas.
  Importante:

  Ao instalar o UiPath Studio e o UiPath Robot na máquina em modo de usuário assistido, para que o serviço de atualização se conecte ao servidor de atualização, certifique-se de adicionar o URL do Orchestrator durante a configuração. Se o URL do Orchestrator não for adicionado durante a instalação, um usuário com direitos de administrador na máquina precisa fazer login na máquina e conectar o robô ao Orchestrator.

Quando uma nova política é definida ou alterada, o servidor de atualização envia um comando para o serviço de atualização na máquina cliente, que pergunta aos aplicativos cliente se eles estão prontos para iniciar o processo de atualização.

Para estar pronto para receber uma atualização, um produto deve estar em um estado neutro:

• Studio - sem processos em execução ou sessões ativas.
• UiPath Robot — sem trabalhos ou processos em execução.
• Assistant - sem processos em execução ou atividades pendentes (instalar ou baixar processos).
  Observação:

  Durante o processo de atualização, o UiPath Robot não inicia nenhum trabalho até a atualização ser concluída.

No cenário assistido, uma solicitação de atualização é exibida dando ao usuário duas opções:

• Update Now - interrompe todos os trabalhos em execução e fecha todas as instâncias do Studio nessa máquina, em seguida, prossegue com a atualização.
• Later - silencia a notificação e o processo de atualização pode ser retomado acessando o ícone da interface gráfica na bandeja do sistema e clicando em verificar atualizações.

Quando o usuário aceita a solicitação, a confirmação é enviada ao serviço de atualização e o processo de atualização é iniciado. Se nenhuma resposta for fornecida dentro de 24 horas após a primeira notificação, a atualização será instalada automaticamente.

No cenário não assistido, o serviço de atualização confirma que o aplicativo cliente está em um estado neutro (conforme descrito acima) antes de enviar a resposta de confirmação ao servidor de atualização.

Observação:

• Se quaisquer processos estiverem em execução na máquina, o usuário do UiPath Robot será solicitado a interromper o processo ou aguardar que ele seja concluído antes que a atualização possa prosseguir. Se uma sessão do Studio for aberta, o usuário do UiPath Robot será solicitado a salvar seu progresso.
• Se o usuário do Robô não reagir a tempo, o Studio será encerrado e salvará o processo como está naquele momento. O processo pode ser recuperado após a atualização ser concluída.
• Todos os Robôs que estão ativos no momento da atualização são colocados no modo de manutenção, garantindo que eles não tomam trabalhos novos antes da atualização ser concluída.
• Para Robôs no modo de usuário, é aplicado um tempo de espera máximo de 1.440 minutos.

Passos do processo de atualização

O processo de atualização é dividido em sete etapas:

1. Fazendo o download
   • O serviço de atualização verifica o servidor de atualização a cada três horas para uma solicitação de atualização. Se a solicitação de atualização for recebida, o processo de atualização inicia o processo de download. Se o processo de download for iniciado com sucesso, a solicitação de atualização é adicionada ao banco de dados do servidor de atualização com o status Downloading.
2. baixou
   • O estado Downloaded atua como um marcador para que o serviço de atualização possa iniciar a fase de pós-processamento. Este estado marca o fato de que o arquivo de atualização foi baixado com sucesso.
3. Processando
   • Esta etapa trata do pós-processamento do arquivo baixado. Nesta etapa, o arquivo é verificado e, se nenhum erro aparecer, o processo de instalação é iniciado.
4. Pronto para instalar
   • O agente de atualização informa ao usuário que uma atualização está aguardando instalação e pede aprovação, ou verifica se os aplicativos cliente estão prontos para receber a atualização.
5. Instalação Aprovada
   • Assim que a aprovação for recebida pelo serviço de atualização, a instalação em si será iniciada.
6. Instalando
   • A nova versão é instalada na máquina mantendo as mesmas configurações da versão anterior.
7. Sucesso / Erro

Com base no resultado da instalação, o status da atualização é relatado ao servidor de atualização.

Observação:

Se a extensão do Chrome já foi instalada na máquina do robô, a funcionalidade de atualização automática também a atualizará. Caso contrário, a extensão deve ser instalada manualmente.

Mecanismo de retentativa

Durante o processo de atualização, se o arquivo não puder ser recuperado no primeiro download, o serviço de atualização tentará novamente mais três vezes. Os intervalos de tentativa são: uma hora após a tentativa inicial, duas horas após a tentativa inicial e quatro horas após a última tentativa. Antes de cada nova tentativa, o usuário é informado pelo sistema de notificação.

Para cada tentativa de download, os registros são adicionados aos logs de atualização do Orchestrator e localmente na máquina, no arquivo %localappdata%/Uipath/UpdateService/logs.

O processo é semelhante para a instalação, o que significa que se a primeira instalação falhar, o serviço de atualização tentará novamente três vezes com a mesma frequência (uma hora após a tentativa inicial, duas horas após a tentativa inicial e quatro horas após a última tentativa).

O servidor de atualização espera 72 horas para que a atualização seja concluída desde que foi iniciada. Se a nova versão não for instalada após a expiração desse intervalo, um erro detalhado será adicionado aos logs. A atualização é repetida na próxima vez que uma solicitação for recebida.

Você também pode tentar novamente manualmente a atualização usando o botão se a atualização automática falhar.

Implantações de robôs em modo de serviço versus modo de usuário

Os aspectos técnicos no lado do servidor são idênticos para implementações no modo de serviço e no modo de usuário, pois usam o mesmo tipo de conexão entre o servidor de atualização e o serviço de atualização. A diferença consiste na forma como o Serviço de Robôs da UiPath se comunica com o serviço de atualização na máquina cliente, conforme explicado a seguir.

Modo de Serviço

Nas implantações no modo de serviço, o Serviço de Robôs da UiPath e o serviço de atualização são executados na sessão da conta do sistema local.

Figura 1. Diagrama de implantações de modo de serviço

Modo de Usuário

Em implantações no modo de usuário, o Serviço de Robôs da UiPath é executado na sessão do usuário, e o serviço de atualização é executado na sessão da conta do sistema local.

Importante:

Quando o UiPath Robot e o Studio são implantados no modo de usuário, o envio do comando de atualização para um robô na máquina afeta todos os usuários naquela máquina específica.

Figura 2. Diagrama de implantações de modo de usuário

AVISO:

Após a conclusão do processo de atualização, o Studio e o Robot devem ser iniciados manualmente.

Policy configuration levels

Auto-update policies are configured in Orchestrator at three levels: user, user group, and machine. Each level controls what version is deployed to the target scope.

Importante:

Auto-update is controlled entirely through Orchestrator policies. Installation settings during setup do not determine whether or how auto-update operates. If you want to prevent auto-update, you must configure the policy in Orchestrator (not through the installer).

Configure auto-update for users

Configuring update policies for a specific user allows you to control the Studio, Robot, and Assistant versions for that individual.

1. Navigate to Tenant > Manage Access > Access Rules tab.
2. Select the Users tab.
3. Select Assign user. The Assign access rules page is displayed.
4. Search for and select the desired user. The Summary card appears on the right showing the user's current permissions.
5. Select Edit to modify access rules.
6. Under Settings, locate Client binaries (Robot, Assistant and Studio) auto-update policy.
7. Choose the auto-update policy for that user:
   • None: no policy is applied.
   • Latest patch: installs the latest patch available for each supported version (for example, latest 2022.10 patch, latest 2023.4 patch).
   • Latest version: installs the latest available version from the update server.
   • Specific version: installs a specific version from the list available on the update server.
8. Select Update to save your changes.

Importante:

For users that have an Express User license (previously Autopilot Express; Automation Express in legacy assignments), the update policy cannot be edited and is set to deliver the latest enterprise version. For the current license capabilities, check Express User license.

Configure auto-update for user groups

Configuring update policies for a user group allows you to apply the same policy to all group members without configuring each user individually. This is the recommended approach for attended use cases.

1. Navigate to Tenant > Manage Access > Access Rules tab.
2. Selecione a guia Grupos.
3. Select Assign group. The Assign access rules page is displayed.
4. Search for and select the desired group. The Summary card appears on the right showing the group's current settings.
5. Select Edit to modify access rules.
6. Under Settings, locate Client binaries (Robot, Assistant and Studio) auto-update policy.
7. Choose the auto-update policy for that group:
   • None: no policy is applied.
   • Latest patch: installs the latest patch available for each supported version (for example, latest 2022.10 patch, latest 2023.4 patch).
   • Latest version: installs the latest available version from the update server.
   • Specific version: installs a specific version from the list available on the update server.
8. Select Update to save your changes.

Observação:

Under the union of privileges model, users inherit settings from their groups, but if a user has an explicit policy configured, it takes precedence over the group policy. To prevent a user in a policy group from receiving updates, either remove them from the group or configure an explicit policy for that user set to their current installed version.

Configure auto-update for machines

Configuring update policies for machines allows you to manage versions across your unattended or attended fleet based on machine identity rather than user identity. This is the recommended approach for unattended use cases.

1. Navigate to Tenant > Machines. The Machines window is displayed.
2. Locate and select the desired machine object, then select Edit. The Edit Machine window is displayed.
3. Select the Maintenance tab. The Auto Update configuration menu is displayed.
4. Choose the auto-update policy for that machine:
   • None — No policy is applied.
   • Latest patch — Installs the latest patch available for each supported version.
   • Latest version — Installs the latest available version from the update server.
   • Specific version — Installs a specific version from the list available on the update server.
5. Selecione Salvar.

Auto-update scheduling

From the Maintenance tab, you can also schedule when updates start to align with your maintenance windows.

1. In the Auto Update configuration menu, specify a start time and date.
2. Optionally set the duration of the maintenance window.
3. Selecione Salvar.

If the maintenance window elapses before the update completes, it is rescheduled during the next available window.

Observação:

For machines using the same machine key, the policy applies to all machines connected with that key.

Understanding policy priority

When multiple policies target the same Robot, they don't all apply equally. Orchestrator resolves conflicts using a strict priority order.

Priority order (highest to lowest):

1. User-level policy
2. Group-level policy
3. Machine-level policy

The priority order applies when comparing policies at different levels. Between user-level and group-level policies, the newer version takes precedence regardless of priority order. When either user or group policies are set (and differ from machine-level policies), they override the machine-level policy.

Examples of policy conflicts

Example 1: User policy overrides machine policy

A machine has Robot 2023.4.0 installed. The machine-level policy is set to 2023.4.12, but the user logging into that machine has a user-level policy set to 2024.10.1. The Robot updates to 2024.10.1 (user policy wins).

Example 2: Group policy applies when user has no policy

A user has no individual policy (set to None), but belongs to a group with Latest Patch policy. The user's Robot updates to the latest patch available for their installed major version (group policy applies).

Example 3: Newer version wins between user and group

A machine has Robot 2023.4.0 installed. The user has a policy set to 2023.4.12, and their group has a policy set to 2024.10.1. The Robot updates to 2024.10.1 because it is the newer version (even though the user-level policy technically has higher priority, the group's newer version is selected).

Observação:

When using Robot Accounts (unattended robots), the machine-level policy is used to handle updates, not the user policy.

Atualizar logs

Na interface de usuário do Orchestrator, os logs de atualização estão disponíveis para atualizações com falha e bem-sucedidas.

Para visualizar os registros de atualização para uma máquina, no contexto do tenant, navegue até Máquinas e, em seguida, selecione Mais ações para a máquina desejada. No menu Mais ações, selecione Exibir versões instaladas e logs.Na grade Versões instaladas e logs, selecione Exibir logs de atualização automática para a entrada desejada.

Os logs completos para a atualização também estão disponíveis na máquina no seguinte local:

• No modo de serviço: %ProgramData%\UiPath\UpdateService\Logs
• No modo de usuário: %LocalAppData%\UiPath\UpdateService\Logs
  AVISO:

  Quando os robôs são implantados em ambientes virtuais onde as máquinas são clonadas, o nome da máquina, guid, id da unidade e endereço mac são os mesmos. Isso pode causar conflitos, pois o Orchestrator recebe diferentes status de atualização de várias máquinas com os mesmos identificadores. Nesse cenário, o status de atualização no Orchestrator é mostrado com base na última máquina que se conectou. Isso também pode impactar os logs do Orchestrator, pois várias máquinas têm os mesmos identificadores, logs duplicados podem aparecer.

Status de versão

A coluna de Status da versão permite que você verifique o status da versão do UiPath Robot para suas máquinas em relação à política associada.

Os seguintes valores estão disponíveis:

• Nenhuma política - nenhuma política é definida
• Atualização em andamento — esse status é apresentado quando o processo de atualização está em andamento na máquina
• Em conformidade - a versão do robô na máquina está de acordo com a política de atualização.
• Não compatível - a versão do robô na máquina é diferente da que foi configurada na política. (por exemplo, a versão do robô é 2021.10.3, a política está definida como 2021.10.1)
• Falha na atualização - este status mostra quando o processo de atualização falhou. Mais detalhes podem ser encontrados nos logs de atualização.
• N/A - este status aparece quando a configuração para excluir máquinas inativas está habilitada e o robô não está conectada há algum tempo, ou quando o tipo de máquina não é compatível com o processo de atualização automática.

Status da versão para máquinas

A coluna Status da versão na guia Máquinas do Orchestrator permite que você verifique o status da versão do UiPath Robot para suas máquinas em relação à política associada.

Importante:

Robôs Linux não são compatíveis com a funcionalidade de Atualização automática. Para eles, o status da versão é exibido como N/A , com a dica de contexto "A atualização automática não se aplica a este tipo de máquina".

Removendo máquinas inativas

Se várias máquinas estiverem conectadas ao Orchestrator usando a mesma chave e uma delas estiver inativa, o status da versão do modelo de máquina se torna Non compliant. Isso acontece conforme o modelo da máquina se comunica com o servidor de atualização usando a mesma chave da máquina e, se uma das máquinas conectadas não puder receber uma atualização, o status geral do modelo da máquina será afetado.

Para evitar isso, acesse a seção Geral do menu Configurações no contexto do tenant, selecione a caixa de seleção Binários de cliente e defina o intervalo de inatividade preferido. Isso exclui máquinas inativas do processo de atualização e não as leva mais em consideração quando o status da atualização é relatado.

Status da versão para usuários

A coluna Status da versão na guia Sessões do usuário da janela Monitoramento permite que você verifique o status da versão do componente do cliente para seus usuários em relação à política associada.

Proxy Configuration

Para cenários em que os robôs estão atrás de um proxy, para que o recurso de atualização automática funcione, pode ser necessária uma configuração adicional. De acordo com o tipo de instalação, as configurações de proxy podem ser herdadas das configurações de proxy de nível de usuário ou definidas manualmente editando o arquivo de configuração.

Tipo de Instalação	Implantação de robôs	Atualizar Serviço	Agente de atualização	Configurações de Proxy
Robô unattended	Serviço do Windows	Serviço do Windows	N/A 1	Do arquivo uipath.config.
Robô Attended	Executável de nível de usuário	Serviço do Windows	Executável de nível de usuário	Do arquivo uipath.config.
Instalação rápida	Executável de nível de usuário	Executável de nível de usuário	Executável de nível de usuário	Das configurações de proxy do nível do usuário.

1 quando o robô é instalado no modo não assistido, o agente de atualização não é adicionado à máquina.

Collecting error logs

Quando uma atualização falhar, você pode usar a Ferramenta de diagnóstico para coletar logs que você pode enviar para a nossa Equipe de Suporte para uma investigação mais aprofundada sobre o erro específico.