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
```
Acesso com o usuário local psgmart. Por exemplo:
```
su - pgsmart
```
Registro dos Agentes do PgSmart.

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

O Agente de Alta Disponibilidade, representado pelo componente Patroni, deve ser instalado no mesmo servidor do Serviço de Banco de Dados, representado pelo componente PostgreSQL.

Sintaxe do Comando

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

Flags:

*-M, --pg-version=(11|12|13|14|15) ⇒ Default: 15. Versão majoritária do PostgreSQL, independentemente do serviço. Será usada a release (versão minoritária)mais recente da versão majoritária escolhida.
-a, --agent=<agent> ⇒ 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 com --service, --pg-major-version e --agent.
--ha-components=(agent|dcs|proxy) ⇒ Componentes do serviço de Alta Disponibilidade. Usada com as opções --quiet, --service=ha e --agent. Sendo:
- agent ⇒ Agente de Alta Disponibilidade
- dcs ⇒ Repositório de Configurações Distribuído
- proxy ⇒ Proxy de Alta Disponibilidade

Instalação Não Interativa

Este modo de instalação é ativado pela opção quiet (--quiet, -q) e sua execução utiliza os valores padrão (default) para os parâmetros não informados. Contudo, esta opção é desabilitada na primeira instalação, visto a necessidade de criação do repositório de pacotes do PostgreSYS baseado nas informações solicitadas interativamente.

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

Instalação Interativa

pgsmart install

Selecione o Agente do PgSmart ou registre um novo.

Selecione o serviço "Alta Disponibilidade" (utilize a tecla <ESPAÇO> para marcar e desmarcar os serviços desejados).

Selecione a versão majoritária do PostgreSQL do ambiente.

Selecione a release da versão majoritária do PostgreSQL do ambiente.

Selecione o componente de alta disponibilidade desejado (agent|dcs|proxy).

Confirme a instalação:

Confirme se deseja instalar o repositório de pacotes do PostgreSYS.
Informe a URL do repositório de pacotes.

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

Resultado da instalação

O processo de instalação pode ser acompanhado pelo arquivo de log do PgSmart:

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

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

O PgSmart define variáveis de ambiente (PGDATA, PGBIN, entre outras) no arquivo bash_profile do usuário corrente que serão carregadas em novas sessões. Caso deseje carregar imediatamente estas variáveis execute o comando abaixo após a instalação:

source ~/.bash_profile

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

Alguns parâmetros podem ser repassados previamente, no comando, entretanto, sem a opção quiet (--quiet, -q) a execução continua interativa, sendo estes parâmetros utilizados com os valores padrão (default) nos prompts.

Exemplos:

pgsmart install --service=cluster

pgsmart install --pg-version=15