Pular para o conteúdo principal
Versão 3.1.1

Instalação do Serviço de Pool de Conexões

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

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. De toda forma, visando auxiliá-los, informamos que 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

  • Log por meio do usuário PgSmart na máquina cliente:

    Terminal input
        su - PgSmart

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

Sintaxe do Comando
Terminal input
    pgsmart install -s pool [Flags]
Terminal input
    pgsmart install --service=pool [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.
  • --pg-major-version=(11|12|13|14|15) [Default:15]. => Versão majoritária base do PostgreSQL, independentemente do serviço. Será usada a release mais recente da versão majoritária escolhida.
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. Caso tenha optado por instalar/atualizar o Repositório de pacotes, informe a URL do Repositório de pacotes.

    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 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