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:

• rápido - baixando e executando um script fornecido; usado quando você deseja configurar o HAA dentro de um único data center.

  For details, refer to Quick installation.

• avançado – executando algumas operações complexas, incluindo configuração de DNS de cluster e criação e configuração de cluster; usado quando você deseja configurar o HAA em vários data centers.

  For details, refer to Active/Active Disaster Recovery Installation.

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. Instale o pacote wget. Certifique-se de usar um comando de download suportado pela sua distribuição Linux. Por exemplo, se você usar o CentOS, execute:

     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. Visualize informações sobre o locale instalado atualmente executando um dos comandos a seguir:

        locale -alocalectl

        localectl

     2. Defina o inglês como idioma e codificação para a sessão atual, executando:

        $ 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" />

Observação: você pode usar endereços IP ou registros DNS para os nós do cluster Redis no parâmetro LoadBalancer.Redis.ConnectionString. No entanto, para ambientes de produção, o uso de registros DNS é mais escalável e recomendado. Para obter mais detalhes, consulte Configurar DNS do cluster.

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.

Seu cluster do HAA agora está pronto e você pode prosseguir com a instalação do Orchestrator, conforme descrito no Instalador do Windows.