- Introdução
- Introdução
- Opções do Usuário
- Como fazer logon no Orchestrator
- Redefinição da sua senha
- Meu Perfil
- Atualização automática de componentes de cliente
- Lista de verificação de configuração do Orchestrator
- Melhores práticas
- Tenant
- Contexto de Pastas
- Automações
- Processos
- Trabalhos
- Gatilhos
- Logs
- Monitoramento
- Filas
- Ativos
- Armazenar Buckets
- Test Suite - Orchestrator
- Outras configurações
- Integrações
- Robôs Clássicos
- Administração do host
- Sobre o nível do host
- Gerenciamento dos administradores do sistema
- Gerenciando Tenants
- Configurando notificações de e-mail do sistema
- Logs de auditoria para o portal do host
- Modo de Manutenção
- Administração da organização
- Solução de problemas
Atualização automática de componentes de cliente
Este recurso permite que os administradores atualizem os clientes 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.
- Orchestrator, Studio e Robot 2021.10 ou posterior.
- Studio e/ou Robot 2021.10 ou posterior instalado na máquina cliente e conectado ao Orchestrator.
Lado do cliente
-
Aplicativos clientes:
- Robô
- Assistente
- 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)
- Update Service - um serviço ou processo do Windows (quando a instalação rápida é usada) 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.
UiPath.UpdateService.Worker.exe
e UiPath.UpdateService.Agent.exe
.
Dependendo do tipo de instalação do Studio/Robô, eles são instalados e executados de uma forma diferente:
- Robô não assistido:
UiPath.UpdateService.Worker.exe
é instalado como um Serviço do Windows eUiPath.UpdateService.Agent.exe
não está instalado. - Robô assistido:
UiPath.UpdateService.Worker.exe
é instalado como um Serviço do Windows;UiPath.UpdateService.Agent.exe
é instalado como uma tarefa de logon no Agendador de Tarefas. -
Instalação rápida (modo usuário):
UiPath.UpdateService.Worker.exe
eUiPath.UpdateService.Agent.exe
são instalados como tarefas de logon no Agendador de Tarefas.Importante: ao instalar Studio e Robô por 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.
O serviço de atualização na máquina comunica-se com o servidor de atualização durante a verificação regular e, quando encontra uma mudança na política, confere os aplicativos clientes para descobrir se estão prontos para iniciar o processo de atualização.
Para que um produto receba uma atualização, ele 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 reabrindo a notificação a partir do ícone da interface gráfica na bandeja do sistema e clicando em buscar atualizações.
Quando o usuário aceita a janela de 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.
Se houver qualquer processo em execução na máquina, o usuário será solicitado a interromper o processo ou aguardar até que ele seja concluído para continuar com a atualização. Se uma sessão do Studio estiver aberta, o usuário será solicitado a salvar o progresso.
Se o usuário não reagir, o Studio fecha e o processo é salvo como está naquele momento e pode ser recuperado depois que a atualização for concluída. O robô espera que algum processo seja concluído e inicia o processo de atualização em seguida.
Passos do processo de atualização
O processo de atualização é dividido em sete etapas:
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.
%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 a partir de seu início. 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 novamente na próxima vez que uma solicitação for recebida.
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.
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.
As políticas podem ser definidas para usuários, grupos de usuários (recomendado para casos de uso assistidos) ou máquinas (recomendado para casos de uso não assistidos).
A configuração de políticas de atualização para usuários ou grupos de usuários permite que os administradores controlem a versão do Studio, Robot e Assistant para um usuário ou grupo de usuários específico.
- Usuário específico - para atualizar de forma granular os componentes vinculados a um usuário específico.
- Grupo de usuários - para atualizar o acesso a todos os membros do grupo sem a necessidade de definir o nível de acesso para cada usuário individualmente.
As políticas são configuradas editando um usuário ou grupo específico na guia Gerenciar Acesso no Orchestrator.
- Navegue até Tenant > Gerenciar acesso. A janela Usuários é exibida.
- Para o usuário/grupo de usuário desejado, clique em Editar. A janela Editar Usuário é exibida.
- Na seção Configurações da política de atualização, altere a política de atualização automática para um dos seguintes valores:
Por usuário
Por grupo
None
, mas ele também fizer parte de um grupo que possui um conjunto de políticas específico (por exemplo, atualização mais recente), a política de grupo se aplica. Se quiser que os componentes desse usuário específico não sejam atualizados, você deve removê-los do grupo que possui a política ou definir a política de atualização para a versão atual instalada.
Se o usuário tiver uma política definida para enviar uma versão específica e também fizer parte de um grupo com uma política diferente, a política de nível de usuário terá precedência.
Configurar uma política de atualização para objetos de máquina permite que os administradores atualizem as versões do robô em todas as máquinas conectadas ao Orchestrator usando essa chave de máquina. A configuração é feita no nível do objeto da máquina:
Caso uma política em nível de usuário, uma política em nível de grupo e uma política em nível de máquina se apliquem ao mesmo robô, a política em nível de usuário tem precedência.
Exemplo
- Máquina_1 tem uma versão 2021.10 do Robot e Studio instalada.
- Na máquina_1, o robô é conectado ao Orchestrator por meio do logon interativo com o usuário fulano@domínio.com.
- Uma política de atualização se aplica a fulano@domínio.com, que está configurada para enviar a versão 2021.10.2.
- john.doe@domínio.com também faz parte do grupo_1.
- Uma política de atualização se aplica ao grupo_1, que está definido para enviar a versão 2021.10.3.
-
Uma política de atualização se aplica a máquina_1, que está configurada para enviar a versão 2022.4.
Resultado: quando as políticas de atualização são disparadas, os componentes dessa máquina são atualizados para a versão 2021.10.2.
Disponibilidade de versão nas políticas
Ao criar uma política de atualização, você pode escolher uma das seguintes opções:
Versão principal mais recente |
Patch mais recente |
Patch específico |
---|---|---|
Instala a versão mais recente disponível encontrada no servidor de atualização. |
Instala o patch mais recente disponível para cada uma das versões compatíveis. (por exemplo, patch 2021.10 mais recente, patch 2022.4 mais recente). |
Instala um patch específico da lista dos disponíveis no servidor de atualização. |
%localappdata%/Uipath/UpdateService/logs
.
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 conectou-se.
Isso também pode impactar os logs do Orchestrator, pois várias máquinas têm os mesmos identificadores, logs duplicados podem aparecer.
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 - este 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.
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.
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
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, marque a caixa de seleção Binários do 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.
Se sua instância do Orchestrator tiver acesso à Internet, por padrão, o gerenciamento de versão é feito pela UiPath, e a lista de versões disponíveis nas políticas é preenchida automaticamente. Se você quiser gerenciar manualmente as versões, acesse Configurações no nível do host, selecione Geral e, em seguida, limpe a caixa de seleção Preencher automaticamente versões do produto disponíveis.
Se você optar por não ter o gerenciamento de versão feito pela UiPath ou se sua instância do Orchestrator não tiver acesso à Internet, você deve baixar manualmente os instaladores dos componentes do cliente do Customer Portal Download Center e carregá-los no servidor de atualização usando a página etapas abaixo:
Obter versões disponíveis
.\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 uma nova versão no servidor de atualização
.\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"
Excluir uma versão específica do servidor de atualização
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 uma nova versão na máquina do 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>"
Com base nos requisitos, as seguintes IDs de produto podem ser usadas nos scripts:
IdDoProduto | Produto |
---|---|
FD97813F-44F7-45A0-BB55-0DAF0088F568 | UiPath Assistant para Mac (x64) |
46C978F2-A5FE-4F71-AD88-D6A07118F790 | UiPath Assistant para Mac (arm64) |
B69FDACF-6DD0-46FB-88C7-AF2D87CAF5AA | Pacote de automação UiPath (UiPathStudio.msi) |
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.
Quando uma atualização falha, você pode usar a Ferramenta de Diagnóstico para coletar logs que podem ser enviados para nossa equipe de suporte, usados então para uma investigação mais aprofundada sobre o erro específico.
- Sobre
- Pré-requisitos
- Componentes que participam do processo de atualização
- Como isso funciona
- Implantações de robôs em modo de serviço versus modo de usuário
- Configuração de políticas
- Configuração de políticas para usuários/grupos de usuário
- Configuração de políticas para objetos de máquina
- Prioridade de política
- Atualizar logs
- Status de versão
- Status da versão para máquinas
- Status da versão para usuários
- Gerenciamento das versões de atualização
- Proxy Configuration
- Coletando Logs de Erros
- Mensagem de Erro
- Configuração de Ferramenta de Diagnóstico