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:

• the previous version was set up with the Windows installer;

• your Orchestrator instance is in a multi-node environment.

  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.
  • Before upgrading, please visit the Hardware Reqirements, Software Reqirements and prerequisites pages, for the version you are upgrading to, as they may have changed. You need to ensure you meet all requirements prior to upgrade.
  • 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.
  • Starting with v2020.4, there are more requirements for the SSL certificate of Orchestrator. Make sure you meet all prerequisites. For how to change your existing certificate, see Using a Certificate for the HTTPS Protocol
  • 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 com a opção de Autenticação do Windows selecionada, certifique-se de executar o instalador como um usuário do 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. Baixe o arquivo UiPathOrchestrator.msi do Customer Portal, selecionando sua versão.

3. 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.

4. 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
   

5. 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

Follow through with the installation as described here.

Importante:

Não se esqueça de fazer backup do arquivo de configuração do 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ê deseja usar o tipo de licença Concurrent Runtime, observe que ao atualizar de uma versão mais antiga que v2020.4,Se você tiver Robôs de alta densidade configurados, o número de execuções por máquina é automaticamente definido como 1 e não o número total de Robôs nessa máquina.