Pular para o conteúdo principal
Versão Next

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 CLI, 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, --pg-version=(11-17). => Versão majoritária do PostgreSQL a ser instalada. Será usada a release mais recente da versão escolhida.

  • -a, --agent= <agent>. => Define o alias, hostname ou IP do servidor onde um Agente do PgSmart está instalado.

  • -h, --help. => Mostra a ajuda.

  • -q, --quiet. => Execução não interativa para a instalação dos serviços. Usada juntamente com --service, --pgversion 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. 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 o Componente de alta disponibilidade desejado (agent|dcs|proxy).

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

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

  6. Confirme a instalação:

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

    7.1. Em caso positivo, selecione Informar e:

    • Informe a URL do repositório desejado.

    • Informe o código de identificação.

    • Informe o nome do repositório.

    • Informe um usuário de acesso ao repositório. (opcional no caso de um repositório diferente do padrão Tecnisys).

    • Informe uma senha de acesso ao repositório (opcional no caso de um repositório diferente do padrão Tecnisys).

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

      • Em caso afirmativo, informe o caminho para o arquivo da chave GPG.

        nota

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

          Por exemplo, para distribuições RHEL 8, Acesse:

          Caminho de arquivo
              https://repo.tecnisys.com.br/repository/yum/pgsys/repos/4.0.0/rhel-8-x86_64/RPM-GPG-KEY-PGSYS
          • Os arquivos compactados (tar.gz) dos pacotes de instalação de componentes e utilitários já contemplam 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 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