Pular para o conteúdo principal
Versão 4.0

Instalação do Pool de Conexões

Para ativar o Pool de Conexões, o PgSmart integra-se com o PgBouncer.

Pré-Requisitos

  • Instalação do PgSmart CLI, atendendo aos requisitos mínimos.

  • Repositório de Pacotes adicionais para resolver dependências indirectas. De acordo com as políticas de segurança e suporte de cada organização, a Tecnisys não disponibiliza tais pacotes. No entanto, para o ajudar, informamos que para as distribuições da família Enterprise Linux, os Extra Packages for Enterprise Linux - EPEL fornecem geralmente as dependências indirectas necessárias.

  • Inicie o serviço PgSmart Agent em todas as máquinas do ambiente de Bases de Dados.

    Terminal input
      systemctl start pgsmart-agent

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

    Terminal input
      su - pgsmart

  • Registro de Agentes do PgSmart através do cliente PgSmart.

Sintaxe do Comando
Terminal input
    pgsmart install -s pool [Flags]
Terminal input
    pgsmart install --service=pool [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=<value> => Alias, hostname ou IP do servidor onde um Agente do PgSmart está instalado.
  • -h, --help => Ajuda.
  • -q, --quiet => Execução não interativa para a instalação dos serviços. Usada em conjunto com as opções --service, --pgversion e --agent.
  • -s, --service=pool => Serviço Pool de Conexõesda Plataforma PostgreSYS.
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=pool
Figura 1 -Instalação Pool - Não Interativa
Figura 1 -Instalação Pool - Não Interativa
Instalação Interativa
Terminal input
    pgsmart install

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

  2. Selecione o serviço Pool de Conexões (a seleção deve ser feita com espaço, desmarcando a seleção Banco de Dados, que é o padrão).

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

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

  5. Confirme a instalação:

  6. Confirme se deseja instalar/atualizar o Repositório de Pacotes do PostgreSYS.

    6.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 Pool - Interativa
        Figura 2 -Instalação Pool - Interativa

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

Alguns parâmetros podem ser repassados previamente no comando; entretanto, a execução continua interativa, ou seja, durante a instalação, os parâmetros informados deverão ser confirmados, juntamente com os valores "Default" para aqueles parâmetros não informados.

Exemplos:

  • Execução interativa com o serviço de pool de conexões já escolhido. Versão base do PostgreSQL padrão: 15.

    Terminal input
        pgsmart install --service=pool

  • Execução interativa com a versão base do banco de dados já escolhida. Serviço: pool de conexões.

    Terminal input
        pgsmart install --service=pool --pg-version=15
Notas Finais
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