Pular para o conteúdo principal
Versão 3.1.1

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 Base de Dados.

    Terminal input
    systemctl start pgsmart-agent

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

      Terminal input
      su - PgSmart

  • Registo 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 Bases 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 pretendido 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 a sua execução utiliza os valores padrão (default) para os parâmetros não informados. Contudo, esta opção é desativada na primeira instalação, devido à necessidade de criação do Repositório de pacotes do PostgreSYS com base 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. Escolha o Agente do PgSmart (ou Registar um novo Agente).

  2. Escolha o serviço Alta Disponibilidade .

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

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

  5. Escolha o Componente de alta disponibilidade pretendido (agent|dcs|proxy)

  6. Confirme a instalação:

  7. Confirme se deseja instalar 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 ficheiro 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 ficheiro 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