Pular para o conteúdo principal
Versão 3.1.0

Inicialização da Instância

Inicialização da Instância do Banco de Dados​

Antes de qualquer atividade, é necessário inicializar o cluster, ou instância, um agrupamento de bancos de dados gerenciados por um único processo master do Sistema de Gerenciamento de Banco de Dados PostgreSQL.

Em termos de sistemas de arquivos, o cluster é um diretório no sistema de arquivos sob o qual todos os dados e metadados serão armazenados. Chamamos esta área de diretório de dados da instância ou PGDATA.

nota

Nesta opção, o PgSmart executa o comando initdb do PostgreSQL, repassando as principais opções necessárias para a criação de um cluster.

nota

O PgSmart cria um arquivo de drop-in para cada instância inicializada, com o número da porta no nome do arquivo. Este arquivo contém as variáveis de ambiente necessárias para a execução do serviço de banco de dados. O PgSmart também inclui e habilita o serviço de banco de dados no systemd.

Pré-Requisitos
Sintaxe do Comando
Terminal input
pgsmart cluster init [Flags]

Flags:​

  • -D, --pgdata=<valor> => Diretório de dados da instância PostgreSQL.
  • -M, --pgversion=(11|12|13|14|15) => Versão majoritária do PostgreSQL.
  • -a, --agent=<agent> => Alias, hostname ou IP do servidor onde um PgSmart Agent está instalado.
  • -h, --help => Ajuda.
  • -t, --template => Indica que é para utilizar um template de inicialização da instância.
Execução Não-Interativa

A execução não interativa está desabilitada para esta operação.

Execução Interativa
Terminal input
pgsmart cluster init

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

  2. Selecione a versão majoritária do PostgreSQL dentre as identificadas.

  3. Informe o Diretório de dados da instância PostgreSQL (PGDATA).

  4. Informe o Diretório de logs transacionais (WALDIR).

  5. Informe a codificação de caracteres padrãoENCODE.

  6. Selecione a Representação regional padrão de dados e valores monetários ([LOCALE]. (/docs_comuns/terminologias#locale)).

  7. Informe a Porta da instância (PGPORT).

  8. Selecione as Interfaces de rede por meio das quais se dará o acesso (LISTEN_ADDRESSES).

  9. Confirme se deseja Exportar o template, com toda a configuração de instância feita, para reuso posterior (Opcional).

  10. Confirme a criação da Instância.

    Figura 1 - Inicialização do Cluster
    Figura 1 - Inicialização do Cluster
    nota

    Os valores Default podem ser confirmados(<ENTER>) ou modificados pelo usuário.

    nota

    O Diretório de Dados da Instância, o Diretório de Logs transacionais e o número da porta da instância devem ser únicos para cada instância.

    nota

    O Diretório de instalação de binários e o Diretório de dados da instância somente serão solicitados se as variáveis de ambiente PGDATA e [PGBIN] não forem encontradas pelo PgSmart.

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

Alguns parâmetros podem ser repassados previamente, no comando, entretanto, a execução continua interativa, ou seja, os parâmetros informados deverão ser confirmados, juntamente com os valores <Default> para aqueles parâmetros não informados.

Exemplos:

Execução interativa usando a Versão base do PostgreSQL padrão: 15.

Terminal input
pgsmart cluster init --pgversion 15
Criação do cluster usando os templates de inicialização

Ao inicializar o cluster, o PgSmart pode salvar os dados dessa inicialização, fornecendo um ponto de partida para operações de inicialização posteriores.

Estes templates ficam guardados dentro do diretório do PgSmart opt/PgSmart-client/templates, no formato JSON.

Estes templates são identificados pelo timestamp relativo à data e hora de criação e podem ser reutilizados em uma outra configuração, de outro servidor, por exemplo, bastando, para isto, que o template desejado seja copiado para dentro do diretório templates do servidor alvo.

O comando para inicialização do cluster, usando templates é:

Terminal input
pgsmart cluster init -t

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

  2. O template desejado pode ser selecionado na lista apresentada, de templates disponíveis.

  3. Após a confirmação do template, as informações abaixo serão apresentadas com base no template selecionado:

    • A versão majoritária do PostgreSQL.

    • O Diretório de dados da instância PostgreSQL PGDATA.

    • O Diretório de logs transacionais WALDIR.

    • A codificação de caracteres padrão ENCODING.

    • A Representação regional padrão de dados e valores monetários LOCALE.

    • A Porta da instância PGPORT.

    • As Interfaces de rede por meio das quais se dará o acesso LISTEN_ADDRESSES.

    3.1. Confirme o template selecionado.

    3.2. Modifique o template, caso desejado.

    3.3. Confirme a criação da instância.

    Figura 2 - Inicialização do Cluster - Template
    Figura 2 - Inicialização do Cluster - Template
nota

Para criação de uma nova instância no mesmo servidor (modo localhost), as variáveis config_pgdata, initdb_waldir e a porta de conexão devem ser alteradas de forma manual, acessando diretamente o arquivo do template desejado.

Notas Finais
nota

O PgSmart define variáveis de ambiente no arquivo bash_profile do Linux, para o usuário, que podem ser recarregadas nas sessões do Linux quando realizado um novo Login. Para carregar estas variáveis imediatamente após a instalação, execute o seguinte comando (uma única vez):

Terminal input
   source ~/.bash_profile