Pular para o conteúdo principal
Versão 4.1.0

Instalação do Serviço de Alta Disponibilidade

Os componentes do Ecossistema PostgreSQL com os 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 CLI, cumprindo os requisitos mínimos.

  • Repositório de Pacotes extras para resolver dependências indiretas. De acordo com as políticas de segurança e suporte de cada organização, a Tecnisys não fornece esses pacotes. Para distribuições da família Enterprise Linux, o repositório Extra Packages for Enterprise Linux - EPEL geralmente fornece as dependências necessárias.

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

Terminal input
    systemctl start pgsmart-agent
  • Acesso utilizando o usuário local pgsmart. Por exemplo:
Terminal input
    su - pgsmart
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 Base de Dados, representado pelo componente PostgreSQL.

Sintaxe do Comando
Terminal input
    pgsmart install -a <agent> --service=ha --ha-components={agent|dcs|proxy}

Flags​

  • -M, --pg-version=(11/12/13/14/15): Padrão: 15 (rhel 7); 16 (rhel 8 | sles 15). => Versão majoritária do PostgreSQL a instalar, independentemente do serviço. Será usada a última release da versão majoritária escolhida.
  • -a, --agent=<agent> => Define o alias, hostname ou IP onde está instalado um Agente do PgSmart.
  • -h, --help => Mostra a ajuda.
  • -q, --quiet => Execução não interativa para instalação dos serviços. Usada juntamente com --service, --pg-version e --agent.
  • -s, --service=(adm|db|backup|pool|ha|obs) => Serviços da Plataforma PostgreSYS.
  • --ha-components=(agent|dcs|proxy) => Componentes do serviço de Alta Disponibilidade:
    • 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 utiliza valores padrão para parâmetros não fornecidos. Contudo, é desativado na primeira instalação devido à necessidade de criação do repositório de pacotes.

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 Registar um novo Agente).
  2. Selecione o serviço Alta Disponibilidade.
  3. Selecione o Componente de Alta Disponibilidade pretendido (agent|dcs|proxy).
  4. Selecione a Versão Majoritária Base do PostgreSQL.
  5. Selecione a Release da versão majoritária.
  6. Confirme a instalação.
  7. Confirme se deseja instalar/atualizar o repositório de pacotes PostgreSYS.

7.1 Em caso afirmativo, selecione Informar e:

  • Indique a URL do repositório

  • Indique o código de identificação

  • Indique o nome do repositório

  • Indique um usuário de acesso (opcional se diferente do padrão Tecnisys)

  • Indique uma palavra-passe de acesso (opcional se diferente do padrão Tecnisys)

  • Confirme se deseja ativar a verificação da chave GPG

    • Se sim, indique o caminho para o ficheiro da chave GPG
nota

  • Para uma instalação local, não se esqueça de descarregar e importar a chave pública GPG dos repositórios (PGSYS-GPG-KEY).

    Por exemplo, para distribuições Enterprise Linux (RHEL-like), acesse:

    URL da Chave GPG
    https://repo.tecnisys.com.br/repository/yum/pgsys/components/4.1.0/rhel-8-x86_64/PGSYS-GPG-KEY/PGSYS-GPG-KEY

    Para distribuições SUSE e similares, acesse:

    URL da Chave GPG
    https://repo.tecnisys.com.br/repository/zypp/pgsys/components/4.1.0/sles-15-x86_64/PGSYS-GPG-KEY/PGSYS-GPG-KEY

    Para distribuições Debian, Ubuntu e similares, acesse:

    URL da Chave GPG
    https://repo.tecnisys.com.br/repository/apt/pgsys/components/4.1.0/PGSYS-GPG-KEY.asc

  • Os pacotes compactados (tar.gz) já incluem a chave pública GPG.

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 passados previamente no comando; no entanto, sem a opção quiet (--quiet, -q), a execução permanece interativa e utiliza valores padrão.

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

O processo de instalação pode ser monitorizado através do 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 atual, que serão carregadas em novas sessões. Para carregá-las imediatamente após a instalação:

Terminal input
    source ~/.bash_profile