Guia de instalação do High Availability Add-on

Última atualização 22 de ago de 2024

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ê quer configurar o HAA dentro de um único datacenter.

Para obter detalhes, consulte Instalação rápida.
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 dentro de vários datacenters.

Para obter detalhes, consulte Instalação de Active/Active Disaster Recovery.

Antes de prosseguir com sua instalação do HAA, certifique-se de atender ao .

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 -asudo 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 wgetyum 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 -alocalectllocale -alocalectl
    localectllocalectl
  2. Defina o inglês como idioma e codificação para a sessão atual, executando:
    $ export LANG="en_US.utf8"$ 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:

SSH o nó primário com permissões-raiz.
Crie o diretório no qual você deseja baixar e extrair o HAA, por exemplo:
```
mkdir haamkdir haa
```
Baixe o script de instalação get-haa.sh:
```
wget https://download.uipath.com/haa/get-haa.shwget https://download.uipath.com/haa/get-haa.sh
```
Observação: consulte a seção para obter mais detalhes.
Torne o script get-haa.sh executável:
```
chmod a+x get-haa.shchmod a+x get-haa.sh
```
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-agreementsudo ./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:

SSH o nó secundário com permissões-raiz.
Criar o diretório no qual você planeja baixar e extrair o HAA, por exemplo:
```
mkdir haamkdir haa
```
Mude para o diretório recém-criado:
```
cd /<path-to>/haa/cd /<path-to>/haa/
```
Baixe o script de instalação get-haa.sh:
```
wget https://download.uipath.com/haa/get-haa.shwget https://download.uipath.com/haa/get-haa.sh
```
Observação: consulte a seção para obter mais detalhes.
Torne o script get-haa.sh executável:
```
chmod a+x get-haa.shchmod a+x get-haa.sh
```
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-agreementsudo ./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

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 documentation@uipath.com`.
`-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" /><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 externo.

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:

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.
Insira o nome de usuário e a senha fornecidos durante a instalação para fazer logon.
Selecione a guia Nós e verifique se todos os nós instalados aparecem aqui com um status de OK.
Selecione a guia Bancos de dados e confirme se o banco de dados uipath-orchestrator aparece aqui com um status de OK.
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:

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.
Insira o nome de usuário e senha fornecidos durante a instalação para fazer logon.
Selecione Configurações > guia Geral.
No campo Chave de cluster, insira sua chave de licença.
Clique em Salvar.