Atualizando o Windows Installer

AVISO: Tenha em mente que essas informações pertencem à versão para a qual você está atualizando, NÃO à versão a partir da qual você está atualizando. Dessa forma, certifique-se de ler os detalhes corretos antes de prosseguir.

Visão geral

O processo de atualização pode ser diferente, dependendo de se:

• a versão anterior foi configurada com o instalador do Windows;
• sua instância do Orchestrator está em um ambiente de vários nós.
  Importante:

  • Se você usar o Active Directory (AD) e estiver planejando atualizar para a versão 2023.4.0, é altamente recomendável que você pule diretamente para a versão 2023.4.3, pois 2023.4.0, 2023.4.1 e 2023.4.2 são impactados por um problema do AD.

  • Antes de atualizar, visite as páginas Requisitos de hardware, Requisitos de software e pré-requisitos, para a versão que você está atualizando, já que eles podem ter sido alterados. Você precisa garantir que atenda a todos os requisitos antes da atualização.
  • Após a atualização, recomendamos reiniciar todos os seus robôs para que eles apliquem as novas configurações.
  • Se seus pacotes (atividades e/ou fluxos de trabalho) forem armazenados em uma pasta compartilhada, observe que o instalador UiPathOrchestrator.msi requer acesso de gravação para o diretório mencionado acima.
  • Iniciando com a v2020.4, há mais requisitos para o certificado SSL do Orchestrator. Certifique-se de atender a todos os pré-requisitos. Para saber como alterar seu certificado existente, consulte Como usar um certificado para o protocolo HTTPS
  • Verifique duas vezes o caminho de instalação selecionado. Não é possível mover uma instalação de um local para outro pós-instalação.
  • É recomendável preservar o tipo de identidade anterior do Pool de Aplicativos do Orchestrator também para o Identity Server e Webhooks. Caso contrário, podem ocorrer problemas ao acessar o servidor SQL.
  • Se você estiver pensando em instalar o Insights, certifique-se de selecionar a função db_owner, pois isso é necessário quando você define a configuração do Insights SQL Server.
  • Se você atualizar de uma versão anterior a 2021.10 que tenha a opção Autenticação do Windows selecionada, certifique-se de executar o instalador como um usuário AD.

Versão anterior instalada com o instalador do Windows

Para atualizar o Orchestrator a partir de uma versão que foi instalada anteriormente usando o instalador do Windows, execute as seguintes ações:

1. Faça backup dos seus pacotes de automação, arquivos web.config e UiPath.Orchestrator.dll.config e banco de dados.
2. Execute o instalador UiPathOrchestrator.msi. O Orchestrator é instalado com o nome UiPathOrchestrator, o banco de dados é atualizado e todos os seus dados são migrados. Você também pode atualizar as configurações do Identity Server e do Servidor de Atualização nesta fase.
3. Se você estiver usando HAA para o gerenciamento de cache, libere todas as chaves de cache de HAA usando o seguinte comando: redis-cli -h <hostname> -p <portnumber> -a <password> flushall. Observe que o HAA usa a porta 10000 por padrão. Por exemplo:

   redis-cli -h redis-12345.c24.us-east-mz-1.ec2.cloud.redislabs.com -p 10000 -a xyz flushall

4. Se você usar o Insights, certifique-se de fazer backup do banco de dados do Insights antes da atualização do Orchestrator .

Ambiente de vários nós

Em um ambiente de vários nós, a atualização é feita de forma diferente nos nós primários e secundários. As etapas abaixo precisam ser seguidas para atualizar todos os seus nós.

Observação: Embora você forneça as senhas de administrador no nível de host e padrão do tenant, elas não são levadas em consideração. Use suas senhas anteriores para fazer logon.

Arquivos de backup

Faça backup dos seus pacotes de automação, arquivos web.config e UiPath.Orchestrator.dll.config e banco de dados.

Instalação do nó primário

Para instalação assistida: execute a partir do prompt de comando de administrador o seguinte comando:

UiPathOrchestrator.msi OUTPUT_PARAMETERS_FILE=c:\temp\upgradeParams.json /lvx* upgrade.log

Para instalação não assistida: execute a partir do prompt de comando de administrador o seguinte comando:

UiPathOrchestrator.msi PUBLIC_URL=https://hostname.local APPPOOL_USER_NAME=serviceAccount APPPOOL_PASSWORD=pass OUTPUT_PARAMETERS_FILE=c:\temp\upgradeParams.json /lvx* upgrade.log /Q

Siga com a instalação conforme descrito aqui.

Importante: Não se esqueça de fazer backup do arquivo de configuração upgradeParams.json gerado pela instalação. Isso deve ser usado em instalações de nós secundários subsequentes.

Instalação dos nós secundários

É recomendável executar a instalação não assistida, usando o arquivo de configuração do upgradeParams.json, produzido no nó primário. Execute a partir do prompt de comando de administrador o seguinte comando:

UiPathOrchestrator.msi SECONDARY_NODE=1 PARAMETERS_FILE=c:\temp\upgradeParams.json /lvx* upgrade.log CONFIRM_BLOCK_CLASSIC_EXECUTIONS=1 /Q

Flush Keys

Se você estiver usando o HAA para gerenciamento de cache, libere todas as chaves de cache do HAA de um banco de dados Ativo-Ativo usando o seguinte comando:

crdb-cli crdb flush --crdb-guid <guid> [ --no-wait ]

Importante: se você quiser usar o tipo de licença Concurrent Runtime , observe que ao atualizar de uma versão anterior à v2020.4, se você tiver robôs de alta densidade configurados, o número de tempos de execução por máquina será automaticamente definido como 1, e não o número total de robôs nessa máquina.