Pular para o conteúdo principal
Versão 4.1.0

Instalação do Serviço de Banco de Dados

O PostgreSYS, através do PgSmart, oferece um caminho simples, fácil, rápido e customizável para a instalação do PostgreSQL e da extensão PostGIS para georreferenciamento.

Além de oferecermos, em um só lugar, todos os pacotes de instalação necessários, em uma única operação guiada é possível instalar os binários do PostgreSQL e inicializar uma instância/cluster de banco de dados, incluindo a criação de um respectivo serviço no sistema operacional.

Pré-Requisitos

  • Instalação do PgSmart CLI, observando os requisitos mínimos.

  • Repositório de Pacotes adicionais 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 tais pacotes. No entanto, para ajudar, 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.

  • O Agente PgSmart deve estar instalado e em execução na máquina onde o serviço de banco de dados será instalado.

  • Registro de Agentes do PgSmart.

Sintaxe do Comando
Terminal input
    pgsmart install -s db [Flags]
Terminal input
    pgsmart install --service=db [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=db => Serviço de Banco de Dados da Plataforma PostgreSYS
  • --geo-component. => Instala o componente de Georreferenciamento (PostGIS), usado com a opção --quiet.
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.

Instalação Não-Interativa - Sistema Gerenciamento Banco de Dados​

Terminal input
    pgsmart install -a <agent> -q --service=db --pg-version=(11|12|13|14|15|16)
Figura 1 -Instalação do Banco de Dados - Não interativa
Figura 1 -Instalação do Banco de Dados - Não interativa

Instalação Não-Interativa - Extensão PostGIS​

Terminal input
    pgsmart install -a <agent> -q --geo-component -M 15
Figura 2 -Instalação da Extensão - não interativa
Figura 2 -Instalação da Extensão - não interativa
Instalação Interativa
Terminal input
    pgsmart install

Instalação Interativa - Serviço de Banco de Dados​

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

    1.1. Selecione o Serviço de Banco de Dados.

    1.3. Selecione Sistema de Gerenciamento de Banco de Dados .

    1.4. Selecione a Versão majoritária do PostgreSQL .

    1.5. Selecione a Release da versão majoritária do PostgreSQL desejada (relativa à versão majoritária selecionada).

    1.6. Confirme se deseja atualizar o Repositório de Pacotes da Plataforma PostgreSYS.

    1.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 (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 arquivos compactados (tar.gz) dos pacotes de instalação de componentes e utilitários já contemplam a chave pública GPG.

    1.7. Inicialização da Instância

    • Depois de completar a instalação do componente, a próxima etapa é inicializar uma instância de banco de dados. Este passo é crucial para preparar o banco de dados para uso, configurando e iniciando os serviços necessários.

    • Confirme se deseja inicializar uma instância de banco de dados neste momento.

    • Caso a inicialização seja confirmada, o sistema seguirá o processo de Inicialização da Instância.

      Figura 3 -Instalação banco de dados interativa
      Figura 3 -Instalação banco de dados interativa

Instalação Interativa - Extensões de Banco de Dados​

  1. Selecione a Extensão de Banco de Dados a ser instalado.

    2.1. Confirme a instalação da extensão:

    2.2. Confirme se deseja instalar/atualizar o repositório dos pacotes do PostgreSYS (esta instalação é necessária para dar continuidade, caso o repositório ainda não esteja configurado).

    2.3. 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 do pgsys já estiverem presentes ou mapeados na máquina.

    Figura 4 -Instalação extensão PostGIS interativa
    Figura 4 -Instalação extensão PostGIS interativa
    Figura 5 -Instalação extensão pgvector interativa
    Figura 5 -Instalação extensão pgvector interativa
    Figura 6 -Instalação extensão pgembed interativa
    Figura 6 -Instalação extensão pgembed interativa

  2. Conecte-se ao banco de dados e execute o comando abaixo correspondente à extensão que você instalou:

    Terminal input
        CREATE EXTENSION POSTGIS;
        CREATE EXTENSION vector;
        CREATE EXTENSION pgembed;

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

Lembre-se de verificar os logs de instalação para qualquer aviso ou erro durante o processo. Os arquivos de log podem fornecer informações valiosas em caso de problemas ou para a realização de ajustes finos na configuração.

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