Pular para o conteúdo principal
Versão 3.1.0

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

O PostgreSYS, através do PgSmart, oferece um caminho simples, fácil, rápido e personalizável para instalar o PostgreSQL e a extensão PostGIS para georreferenciamento. Além de oferecer todos os pacotes de instalação necessários num único local, numa única operação guiada, é possível instalar os binários do PostgreSQL e inicializar uma instância/cluster, incluindo a criação dum respetivo serviço no sistema operativo.

Pré-Requisitos

  • Instalação do PgSmart, 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 Base de Dados será instalado.

  • Registo de Agentes do PgSmart através do PgSmart-Client.

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

Flags:​

  • -M, --pgversion=(11/12/13/14/15): Padrão: 15. => Versão predominante do PostgreSQL a ser instalada.
  • -a, --agent= <agent>. => Define o alias, nome do host, ou IP do servidor onde o Agente PgSmart está instalado.
  • -h, --help. => Mostra a ajuda.
  • -q, --quiet. => Execução não interativa para instalação do serviço. Usado em conjunto com --service, --pg-major-version e --agent.
  • --geo-component. => Instala o componente de Georrefestão (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 a sua execução utiliza os valores padrão (default) para os parâmetros não informados. Contudo, esta opção é desativada na primeira instalação, devido à necessidade de criação do Repositório de pacotes do PostgreSYS com base nas informações solicitadas interativamente.

Instalação Sistema Gestão de Bases 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. Escolha o Agente do PgSmart pretendido (ou Registar um novo Agente).
  2. Escolha o Serviço Banco de Dados
  3. Escolha a Versão predominante do PostgreSQL do ambiente.
  4. Escolha a Release da versão majoritária do PostgreSQL .
  5. Escolha o tipo de componente desejado.
nota

Dependendo da escolha do componente do Serviço de Base de Dados, o processo variará, como segue.

5.1 **Instalação do Sistema de Gestão de Base de Dados (SGBD)*:

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

5.1.2. Caso tenha optado por instalar/atualizar o Repositório de pacotes, introduza 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

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

  • Confirme se deseja inicializar uma instância da Base de Dados.

  • 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 Bases de Dados:

5.2.1. Escolha o componente da extensão a ser instalado.

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

5.2.3. Confirme se deseja instalar o Repositório de pacotes de pacotes do PostgreSYS.

5.2.4. Introduza o URL do Repositório de pacotes.

Figura 4 -Instalação extensão interativa
Figura 4 -Instalação extensão interativa
nota

Esta pergunta não é feita se os repositórios pgsys-utils já estiverem presentes ou mapeados na máquina.

Variações de 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 ficheiros 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 ficheiro 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