Pular para o conteúdo principal
Versão 3.1.0

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. Para distribuições da família Enterprise 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.

    Terminal input
    systemctl start pgsmart-agent

  • Acesso com o usuário local psgmart. Por exemplo:

    Terminal input
    su - PgSmart

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

    alerta

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

    alerta

    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
Terminal input
pgsmart install -a <agent> --service ha --ha-components={agent|dcs|proxy) [Flags]

Flags​

  • -M, --pgversion=(11/12/13/14/15) => Default: 15. => Versão majoritária do PostgreSQL, independentemente do serviço. Será usada a release mais recente da versão majoritária escolhida.
  • -a, --agent= <agent>. => Alias, hostname ou IP do servidor onde o PgSmart Agent desejado 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.
  • --ha-components=(agent|dcs|proxy). => Componentes do serviço de Alta Disponibilidade. Usada em conjunto 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.

Terminal input
    pgsmart install -q -a <agent> --service=ha --ha-components={agent|dcs|proxy)
Figura 1 -Instalação HA - Não Interativa
Figura 1 -Instalação HA - Não Interativa
Instalação Interativa
Terminal input
pgsmart install

  1. Selecione o Agente do PgSmart (ou Registrar um novo Agente).

  2. Selecione o serviço Alta Disponibilidade .

  3. Selecione a Versão majoritária base do PostgreSQL.

  4. Selecione a Release da versão majoritária do PostgreSQL.

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

  6. Confirme a instalação:

  7. Confirme se deseja instalar/atualizar o Repositório de pacotes do PostgreSYS..

    nota

    A opção de instalação do Repositório de pacotes não é realizada se os repositórios pgsys-utils já estiverem presentes ou mapeados na máquina.

    Figura 2 -Instalação HA - Interativa
    Figura 2 -Instalação HA - Interativa

    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:

    Terminal input
    pgsmart install --service=ha
    Terminal input
    pgsmart install --ha-components=agent
Notas Finais
nota

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

Terminal input
tail -f /var/log/pgsmart-agent/pgsmart.log
Terminal input
tail -f /var/log/pgsmart-client/pgsmart.log
nota

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:

Terminal input
source ~/.bash_profile