Instalação do High Availability Add-on

Visão Geral da Instalação

Observação: oferecemos compatibilidade retroativa com o Orchestrator, mas recomendamos a atualização para a versão mais recente do HAA.

Existem duas maneiras de instalar o Complemento de alta disponibilidade (HAA) para sua instância do Orchestrator:

• quick – by downloading and executing a provided script; used when you want to set up HAA inside a single data center.

  Para obter detalhes, consulte Instalação rápida.

• advanced – by performing some complex operations, including cluster DNS configuration, and cluster creation and setup; used when you want to set up HAA inside multiple data centers.

  Para obter detalhes, consulte Instalação da recuperação de desastres ativa/ativa.

Before proceeding with your HAA installation, make sure that you meet the hardware and software requirements.

Observação: o HAA requer uma licença separada do Orchestrator. O modelo de implantação de Active/Active Disaster Recovery requer duas licenças de HAA. Entre em contato com a UiPath para obter mais detalhes.

Pré-requisitos

Os pré-requisitos a seguir são idênticos para os métodos de instalação rápida e avançada. Antes de iniciar a instalação do HAA, certifique-se de que você:

• é o usuário-raiz ou têm acesso ao sudo para o usuário-raiz;
• tenha direitos de criação do usuário:
• Certifique-se de ter um certificado SSL/TLS válido. Consulte a documentação do Redis para obter instruções sobre como atualizar seus certificados;
• habilitou o serviço do firewall.
  Observação:

  As permissões-raiz são necessárias apenas para instalação e atualização; o usuário administrador do HAA não precisa de permissões escalonadas para administrar os serviços do cluster.

  Nos seguintes daemons executados pelo usuário administrador do HAA, os bits de capacidade foram definidos para permitir ao executável os privilégios mínimos necessários para operar:

  /opt/redislabs/bin/dmcproxy = cap_sys_resource+ep

  /opt/redislabs/bin/redis-server-4.0 = cap_sys_resource+ep

  /opt/redislabs/bin/redis-server-4.0-big = cap_sys_resource+ep

  /opt/redislabs/bin/redis-server-5.0 = cap_sys_resource+ep

  /opt/redislabs/bin/redis-server-5.0-big = cap_sys_resource+ep

  /opt/redislabs/bin/sentinel_service = cap_sys_resource+ep

  /opt/redislabs/sbin/pdns_server = cap_net_bind_service+ep

  /opt/redislabs/sbin/smaps = cap_sys_ptrace+ep

  Isso permite que o usuário administrador do HAA execute esses serviços com privilégios sem exigir que o usuário tenha os privilégios atribuídos.

  1. Desabilite swap:

     sudo swapoff -a

  2. Para que essa alteração permaneça pelas reinicializações, exclua a partição swap no arquivo etc/fstab.
  3. Install the wget package. Make sure to use a download command supported by your Linux distribution. For example, if you use CentOS, run:

     yum install wget

  4. Repita esse processo em todos os nós nos quais planeja instalar o HAA.

     Verifique se o inglês faz parte da lista de idiomas.

     Dependendo do seu idioma e conjunto de caracteres (codificação), você pode ter problemas ao executar o script de instalação. É recomendável verificar primeiro se o inglês faz parte da lista de idiomas, da seguinte forma:

     1. View information about the currently installed locale by running either or the following commands:

        locale -alocalectl

        localectl

     2. Set English as the language and encoding for the current session, by running:

        $ export LANG="en_US.utf8"

Instalação rápida

Importante: antes de prosseguir com a instalação rápida do HAA, certifique-se de que todos os seus nós atendam aos pré-requisitos.

Instalar o nó primário

Para instalar o HAA no nó primário, execute os seguintes passos:

1. SSH o nó primário com permissões-raiz.
2. Crie o diretório no qual você deseja baixar e extrair o HAA, por exemplo:

   mkdir haa

3. Baixe o script de instalação get-haa.sh:

   wget https://download.uipath.com/haa/get-haa.sh

   Observação: consulte a seção Parâmetros do script para obter mais detalhes.
4. Torne o script get-haa.sh executável:

   chmod a+x get-haa.sh

5. Instale o nó primário. Certifique-se de fornecer um endereço de e-mail e senha para a conta de administrador. Você pode usar um endereço de e-mail temporário. Você também deve especificar o sistema operacional (SO) em execução no nó.
   Observação: para inserir seu sistema operacional no formato correto ao executar o comando de instalação, execute get-haa.sh -h primeiro e observe o valor relevante do sistema operacional no menu de ajuda.

   Os valores possíveis do sistema operacional são atualmente Rhel8, Rhel9 ou UbuntuFocal.

   sudo ./get-haa.sh -u <email> -p <password> -o <OS> --accept-license-agreement

Importante:

Para instalar o HAA em um local personalizado, execute o script install-haa.sh para configuração avançada (isso não cria nenhum cluster), sem esquecer de que todos os locais devem ser diferentes. Por exemplo:

sudo ./install-haa.sh --install-dir /opt/haa-uipath --config-dir /etc/opt/haa-uipath --var-dir /var/opt/haa-uipath.

Verifique duas vezes o caminho de instalação selecionado. Não é possível mover uma instalação de um local para outra pós-instalação.

Instalação do nó secundário

Após instalar o nó primário, execute os seguintes passos em cada nó secundário:

1. SSH o nó secundário com permissões-raiz.
2. Criar o diretório no qual você planeja baixar e extrair o HAA, por exemplo:

   mkdir haa

3. Mude para o diretório recém-criado:

   cd /<path-to>/haa/

4. Baixe o script de instalação get-haa.sh:

   wget https://download.uipath.com/haa/get-haa.sh

   Observação:

   Consulte a seção Parâmetros do script para obter mais detalhes.

5. Torne o script get-haa.sh executável:

   chmod a+x get-haa.sh

6. Instale o nó secundário:
   Observação: para inserir seu sistema operacional no formato correto ao executar o comando de instalação, execute get-haa.sh -h primeiro e observe o valor relevante do sistema operacional no menu de ajuda.

   Os valores possíveis do sistema operacional são atualmente Rhel8, Rhel9 ou UbuntuFocal.

   sudo ./get-haa.sh -u <email> -p <password> -o <OS> -j <IP_address_of_the_master_node> --accept-license-agreement

   Importante: forneça o endereço de email, senha e endereço IP definidos ao criar o nó primário.

Script parameters

A tabela a seguir descreve os parâmetros disponíveis ao executar o script de instalação do High Availability Application (HAA):

Parâmetro	Descriptografia
-u	O nome de usuário do administrador do cluster do HAA. Por exemplo, -u [e-mail].
-p	A senha para o usuário administrativo, definida ao instalar o nó primário. Por exemplo, -p SuperSecret_Password.
-j	O endereço IP do nó primário. Quando fornecido, um nó secundário (escravo) é instalado. Por exemplo, -j 10.10.22.10.
--install-dir	Indique o caminho para o diretório de instalação do HAA (apenas ao executar o script install-haa.sh para instalação avançada). Observação: 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.
--config-dir	Indique o caminho para o diretório de configuração do HAA (apenas ao executar o script install-haa.sh para instalação avançada).
--var-dir	Indique o caminho para o diretório de variáveis do HAA (apenas ao executar o script install-haa.sh para instalação avançada).
-h	Usado para exibir o guia de ajuda da instalação.
-l	O código de licença para seu cluster do HAA. Insira a licença sem --- LICENSE START --- à direta e esquerda ou --- LICENSE END ---, e sem quaisquer caracteres new line.
--accept-license-agreement	Aceitar o contrato de licença da UiPath
--offline	Para a instalação offline. Assume-se que o pacote esteja na pasta atual, a mesma que o script de instalação. O link para o pacote pode ser encontrado no script get-haa.sh.

Configurando UiPath.Orchestrator.dll.config

Importante:

Essa etapa é necessária apenas se você usar o HAA para o Orchestrator independente.

Você deve configurar o Orchestrator independente para usar o HAA e adicionar todos os nós do HAA ao arquivo de configuração do Orchestrator usando os parâmetros LoadBalancer.UseRedis e LoadBalancer.Redis.ConnectionString. Por exemplo:

<add key="LoadBalancer.UseRedis" value="true" />
<add key="LoadBalancer.Redis.ConnectionString" value="10.10.20.184:10000,10.10.24.148:10000,10.10.22.114:10000,password=SuperSecret_Password" />

Configuração do cluster_config.json

Importante:

Essa etapa é necessária apenas se você usar o HAA para o Automation Suite.

Você deve configurar o Automation Suite para usar o HAA atualizando a seção fabric.redis no arquivo cluster_config.json. Para obter mais detalhes, consulte Configuração do High Availability Add-on.

Verificação da instalação do cluster

Após você ter instalado todos os nós do seu cluster do HAA, confirme a configuração bem-sucedida da seguinte maneira:

1. Direcione seu navegador para o endereço IP de qualquer nó do HAA na porta 8443. Por exemplo: https://10.10.20.196:8443/. A página de logon do HAA é exibida.
   
   

   

   
   
2. Insira o nome de usuário e a senha fornecidos durante a instalação para fazer logon.
3. Selecione a aba nós e verifique se todos os nós instalados são exibidos com status de OK.
   
   

   

   
   
4. Selecione a aba bancos de dados e confirme se ouipath-orchestratorbanco de dados aparece com status de OK.
5. Se for implantada em mais de um nó, certifique-se de que Replicação esteja habilitada nas configurações do banco de dados e de que dois nós estejam exibindo uma contagem de fragmentos de 1. Isso garante que o banco de dados seja replicado em dois nós.
   Observação: por padrão, esse banco de dados é criado na porta 10000 com a senha fornecida na instalação.

Licenciamento HAA

Para adicionar ou atualizar sua licença de Complemento de alta disponibilidade, execute os seguintes passos:

1. Usando seu navegador, vá até o endereço IP de qualquer nó HAA na porta 8443. Por exemplo: https://10.10.20.196:8443/. A página de logon do HAA é exibida.
2. Insira o nome de usuário e senha fornecidos durante a instalação para fazer logon.
3. Selecione Configurações > aba Geral.
4. No campo Chave de cluster, insira sua chave de licença.
5. Selecione Salvar.

Your HAA cluster is now ready, and you can proceed with the Orchestrator installation, as described in the The Windows Installer.