Pular para o conteúdo principal
Versão 3.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, 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 Extra Packages for Enterprise Linux - EPEL geralmente fornece as dependências indiretas necessárias.

  • O Agente do PgSmart deve estar instalado e em execução na máquina em que será instalado o serviço de Banco de Dados.

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

Sintaxe do Comando
Terminal input
    pgsmart install -s cluster [Flags]
Terminal input
    pgsmart install --service=cluster [Flags]

Flags:​

  • -M, --pg-version=(11/12/13/14/15): Default: 15. => Versão majoritária do PostgreSQL a ser instalada.
  • -a, --agent= <agent>. => Define o alias, hostname ou IP do servidor onde o PgSmart Agent 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, --pg-major-version e --agent.
  • --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 Sistema Gerenciamento Banco de Dados​

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

Instalação extensão Geo-component​

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

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

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

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

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

  5. Selecione o Tipo de componente desejado.

    nota

    Dependendo da escolha do componente do serviço de Banco de Dados a ser instalado, o processo irá variar, conforme abaixo.

5.1 Instalação do Sistema de Gerenciamento de Banco de Dados:

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

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

5.1.3. Inicialização da Instância

  • Depois de completar a instalação do componente, a próxima etapa é inicializar uma instância do 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 do 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 cluster interativa
Figura 3 -Instalação cluster interativa

5.2 Instalação das Extensões de Banco de Dados:

5.2.1. Selecione o Componente das extensões a ser instalado.

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

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

5.2.4. 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 4 -Instalação extensão interativa
Figura 4 -Instalação extensão 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=cluster
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