Instalação do Serviço de Alta Disponibilidade

Os componentes do Ecossistema PostgreSQL com as quais o PgSmart se integra para fornecer o serviço de alta disponibilidade são: Patroni, etcd e HAProxy.

Pré-Requisitos

  • Instalação do PgSmart, observando os requisitos mínimos.

  • Repositório de pacotes extras para resolver dependências indiretas. Em conformidade com as políticas de segurança e suporte de cada organização, a Tecnisys não fornece tais pacotes. De toda a forma, visando auxiliá-los, informamos que para distribuições da familía Entreprise Linux o repositório Extra Packages for Enterprise Linux (EPEL) geralmente fornece as dependências indiretas necessárias.

  • Inicialização do serviço do Agente do PgSmart em todas as máquinas do ambiente de banco de dados.

    systemctl start pgsmart-agent

  • Log por meio do usuário pgsmart na máquina cliente:

    su - pgsmart

  • Registro dos Agentes do PgSmart por meio do PgSmart-Client.

Recomendamos servidores exclusivos para cada componente do serviço de Alta Disponibilidade.

Sintaxe do Comando

pgsmart install -a <valor> --service ha --ha-components=[agent|dcs|proxy]

Flags :

  • -a, --agent=<valor> ⇒ Alias, hostname ou IP do servidor onde Um PgSmart Agent está instalado.

  • -h, --help ⇒ Ajuda

  • -q, --quiet ⇒ Execução não interativa para a instalação dos serviços. Usada juntamente com --service, --pg-major-version, --agent.

  • -pg-major-version=(11|12|13|14|15) [Default:15] ⇒ Versão majoritária base do PostgreSQL, independentemente do serviço. Será usada a release (versão minoritária) mais recente da versão majoritária escolhida.

  • --ha-components=(agent|dcs|proxy)⇒ Componentes do serviço de alta disponibilidade. Usada em conjunto com as opções --quiet, --service=ha, --agent.

    • agent Agente de alta disponibilidade.

    • dcs Repositório de Configurações Distribuído.

    • proxy Proxy de alta disponibilidade.

Instalação não-interativa

Esta opção é viabilizada pela opção "quiet" (-q) e sua execução utiliza os valores "Default" para os parâmetros não informados. Contudo, nos comandos de instalação (pgsmart install), o repositório de pacotes do pgsys já deve ter sido instalado em execuções anteriores. A opção (-q) é, portanto, desabilitada na primeira instalação.

 pgsmart install -a <valor> -q --service=ha --ha-components=[agent|dcs|proxy]

Instalação interativa

pgsmart install

  1. Selecionar o agente do PgSmart (ou registrar novo Agente).

seleciona agente pgsmart

  1. Selecionar o serviço "alta disponibilidade" (É necessário desmarcar o serviço de banco de dados e selecionar o novo serviço com <espaços>.

seleciona serviço

  1. Selecionar a versão majoritária base do PostgreSQL.

seleciona versão majoritária

  1. Selecionar a release da versão majoritária.

seleciona release versão majoritária

  1. Selecionar o componente de alta disponibilidade a ser instalado. =[agent|dcs|proxy]

seleciona release versão majoritária

  1. Confirmar se deseja instalar o repositório dos pacotes e a URL do repositório, se solicitada (esta instalação é necessária para dar continuidade, caso o repositório ainda não esteja configurado)

confirma instalação repositorio pacotes

Esta pergunta não é realizada se os repositórios pgsys-utils já estiverem presentes ou mapeados na máquina.

A instalação do repositório conterá o registro de onde os pacotes dos componentes da plataforma PostgreSYS podem ser baixados.

Resultado da instalação

confirma instalação ha

Todos os passos da instalação podem ser acompanhados pelo log:

tail -f /var/log/pgsmart/pgsmart.log

O PGSmart define variáveis de ambiente no arquivo bash_profile do Linux, para o usuário, que podem ser recarregadas nas sessões do Linux quando realizado um novo Login. Para carregar imediatamente estas variáveis execute o comando abaixo ao final da instalação (execução única):

 
source~/.bash_profile

Variações do Comando para Instalação interativa

Alguns parâmetros podem ser repassados previamente, no comando, entretanto, a execução continua interativa, ou seja, durante a instalação os parâmetros informados deverão ser confirmados, juntamente com os valores <Default> para aqueles parâmetros não informados.

Exemplos:

Execução interativa com o serviço de ha-agent já escolhido. Versão base do PostgreSQL padrão: 15.

pgsmart install -a <valor> --service=ha

Execução interativa com a versão base do banco de dados já escolhida. Serviço: HA-Agent.

pgsmart install -a <valor> --ha-components=agent