Pular para o conteúdo principal
Versão 4.1.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, cumprindo os 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 ajudar, informamos que para as distribuições da família Enterprise Linux, o repositório Extra Packages for Enterprise Linux - EPEL geralmente fornece 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

  • Registo 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, --pgversion=(12|13|14|15) [padrão: 15 (rhel 7); 16 (rhel 8 | sles 15)] => Versão majoritária do PostgreSQL, independentemente do serviço. Será usada a última release disponível da versão majoritária escolhida.
  • -a, --agent=<valor> => Alias, hostname ou IP do servidor onde o 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 em conjunto com as opções --service, --pgversion e --agent.
  • -s, --service=pool => Serviço de Pool de Conexões da Plataforma PostgreSYS.
Instalação Não-Interativa

Este modo de instalação é activado pela opção quiet (--quiet, -q) e utiliza os valores padrão para parâmetros não especificados. Contudo, esta opção é desativada na primeira instalação, pois é necessário criar o repositório de pacotes do PostgreSYS de forma interativa.

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 registe um novo).
  2. Selecione o serviço Pool de Conexões (certifique-se de desmarcar a opção padrão Banco de Dados).
  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/actualizar o Repositório de Pacotes do PostgreSYS.

6.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 a verificação da chave GPG

    • Se afirmativo, forneça 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 Pool - Interativa
      Figura 2 - Instalação Pool - Interativa

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

Alguns parâmetros podem ser passados previamente; contudo, a execução permanece interativa e os valores informados deverão ser confirmados nos prompts.

Exemplos:

Terminal input
    pgsmart install --service=pool
Terminal input
    pgsmart install --service=pool --pg-version=15
Notas Finais
nota

O PgSmart define variáveis de ambiente (PGDATA, PGBIN, entre outras) no ficheiro bash_profile do usuário actual, que serão carregadas em novas sessões. Para carregar as variáveis imediatamente após a instalação:

Terminal input
    source ~/.bash_profile