Pular para o conteúdo principal
Versão 4.0

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

O PostgreSYS, através do PgSmart, oferece uma forma simples, fácil, rápida e personalizável de instalar o PostgreSQL e a extensão PostGIS para georreferenciação.

Além de disponibilizar todos os pacotes de instalação num único local, é possível, através de uma única operação guiada, instalar os binários do PostgreSQL e inicializar uma instância/cluster de base de dados, incluindo a criação do respetivo serviço no sistema operativo.

Pré-Requisitos

  • Instalação do PgSmart CLI, cumprindo 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. Contudo, 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 será instalado o serviço de base de dados.

  • Registo 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/12/13/14/15): Padrão: 15 (rhel 7); 16 (rhel 8 | sles 15). => Versão majoritária do PostgreSQL a ser instalada, independentemente do serviço. Será utilizada a versão mais recente da versão majoritária selecionada.
  • -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, --pg-version e --agent.
  • -s, --service=db => Serviço de Base de Dados da Plataforma PostgreSYS.
  • --geo-component => Instala o componente de Georreferenciaçã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 utiliza os valores padrão 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 baseado em informações fornecidas interativamente.

Instalação do Sistema de Gestão de Base de Dados​

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

Instalação da 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

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

  1. Selecione o Agente do PgSmart (ou Registar um novo Agente).
  2. Selecione o Serviço de Base de Dados.
  3. Selecione o Sistema de Gestão de Base de Dados.
  4. Selecione a Versão Majoritária do PostgreSQL.
  5. Selecione a Release da versão majoritária selecionada.
  6. Confirme se deseja atualizar o repositório de pacotes da Plataforma PostgreSYS.

6.1. Se sim, 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 se deseja ativar a verificação da chave GPG

    • Em caso 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 (RPM-GPG-KEY-PGSYS).

    Por exemplo, para distribuições RHEL 8, aceda:

Caminho do ficheiro
    https://repo.tecnisys.com.br/repository/yum/pgsys/repos/4.0.0/rhel-8-x86_64/RPM-GPG-KEY-PGSYS
  • Os pacotes de instalação compactados (tar.gz) já incluem a chave pública GPG.

1.7 Inicialização da Instância

  • Após completar a instalação do componente, a próxima etapa é inicializar uma instância de base de dados. Este passo é crucial para preparar a base de dados para utilização, configurando e iniciando os serviços necessários.
  • Confirme se deseja inicializar uma instância agora.
  • Em caso afirmativo, o sistema prosseguirá com o processo de Inicialização da Instância.
Figura 3 - Instalação da Base de Dados - Interativa
Figura 3 - Instalação da Base de Dados - Interativa

Instalação das Extensões da Base de Dados​

  1. Selecione o Componente das Extensões a ser instalado.

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

2.2 Confirme se deseja instalar/atualizar o repositório de pacotes (necessário caso ainda não esteja configurado).

2.3 Caso opte por instalar/atualizar, forneça a URL do repositório.

nota

A instalação do repositório de pacotes não será realizada se os repositórios do pgsys já estiverem presentes ou mapeados na máquina.

Figura 4 - Instalação da extensão Espacial - Interativa
Figura 4 - Instalação da extensão Espacial - Interativa

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

Alguns parâmetros podem ser passados previamente no comando, mas sem a opção quiet (--quiet, -q), a execução continua interativa e os parâmetros serão utilizados como valores padrão nos prompts.

Exemplos:

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

Lembre-se de verificar os registos de instalação para quaisquer avisos ou erros durante o processo. Estes ficheiros de registo podem fornecer informações valiosas em caso de problemas ou para ajustes finos de 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 atual, que serão carregadas em novas sessões. Caso queira carregá-las imediatamente, execute:

Terminal input
    source ~/.bash_profile