Instalação

A instalação do High Availability Add-on (HAA) para sua instância do Orchestrator é executada baixando e executando um script fornecido.

Antes de prosseguir com sua instalação do HAA, certifique-se de cumprir os Requisitos de Hardware e Software.

Observação:

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

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

Instalação

Pré-requisitos

Antes de iniciar a instalação do HAA, certifique-se de que você:

• são o usuário-raiz ou têm acesso a sudo ao 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."

• Desabilite a troca:

1. Desabilite o swap com o comando: sudo swapoff -a.
2. Para que essa alteração continue por meio de reinicializações, comente a entrada swap no arquivo etc/fstab, executandosudo sed -i.bak '/ swap / s/^(.*)$/#1/g' /etc/fstab.
3. Instale o pacote wget, usado para baixar o arquivo de instalação do RS, executando o comando yum install wget.
4. Repita esse processo em todos os nós nos quais você estiver instalando o HAA.

Além disso, dependendo do seu idioma e do conjunto de caracteres (codificação), você pode ter problemas ao executar o script de instalação. Recomenda-se verificar primeiro se inglês foi adicionado à lista de idiomas:

1. Exibir informações sobre o locale atual instalado usado: execute locale -a ou localectl.
2. Defina o inglês como o idioma e codificação para a sessão atual, executando:$ export LANG="en_US.utf8".

Nó mestre

1. Baixe o script de instalação, executando wget https://raw.githubusercontent.com/UiPath/Infrastructure/main/Setup/get-haa.sh.
2. Torne o script executável, executando chmod a+x get-haa.sh.
3. Instale o nó mestre com o seguinte comando: sudo ./get-haa.sh -u <email> -p <password>.

   Forneça o e-mail e a senha desejados para o administrador da conta, além dos diretórios de instalação.

   Importante:

   • Para instalar o HAA em um local personalizado, execute o script install.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.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 outro pós-instalação.

Nós secundários

Após você ter instalado o nó primário (mestre), a partir de cada nó adicional:

1. Crie o diretório no qual o HAA deve ser baixado e extraído, como por exemplo: mkdir haa.
2. Altere para o diretório recém-criado usando o comando: cd /<path-to>/haa/.
3. Baixe o script de instalação, executando wget https://raw.githubusercontent.com/UiPath/Infrastructure/main/Setup/get-haa.sh.
4. Torne o script executável, executando chmod a+x get-haa.sh.
5. Instale o nó com o seguinte comando: sudo ./get-haa.sh -u <email> -p <password> -j <IP_address_of_the_master_node>.

   Forneça o e-mail e a senha definidos ao criar o nó mestre e o endereço IP do nó primário.

Parâmetros do script

Os seguintes parâmetros estão disponíveis ao executar o script de instalação do 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.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.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.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.

UiPath.Orchestrator.dll.config Configuration

Você deve configurar o Orchestrator para usar o HAA, e adicionar todos os nós do HAA ao arquivo UiPath.Orchestrator.dll.config 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" />

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 guia Nós e verifique se todos os nós instalados aparecem aqui com um status de OK.
   
   

   

   
   
4. Selecione a guia Bancos de dados e confirme se o banco de dados uipath-orchestrator aparece aqui com um 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 do HAA

Para adicionar ou atualizar sua licença do High Availability Add-on, siga estas etapas:

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 Configurações > guia Geral.
4. No campo Chave do cluster, insira sua chave de licença.
5. Clique em Salvar.

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