Inicialização do cluster de 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.

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.

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:

Antes de inicializar a instância de banco de dados é necessário instalar o Serviço de Banco de Dados. Para maiores informações, consulte Instalação do Serviço de Banco de Dados.

Sintaxe do Comando

pgsmart cluster init [FLAGS]

Flags:

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

Inicialização não Interativa

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

Execução Interativa

pgsmart cluster init

Selecione o Agente do PgSmart ou registre um novo.

Selecione a versão majoritária do PostgreSQL dentre as identificadas.
Informe o Diretório de Dados da instância PostgreSQL (PGDATA).
Informe o Diretório de logs transacionais (WALDIR)).
Informe a codificação de caracteres padrão (ENCODE).
Selecione a representação regional padrão de dados e valores monetários (LOCALE).
Informe a porta da instância (PGPORT).
Selecione as interfaces de rede por meio das quais se dará o acesso (LISTEN_ADDRESSES)
Confirme se deseja Exportar o template, com toda a configuração de instância feita, para reuso posterior (Opcional).
Confirme a criação da Instância.

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.

Resultado da inicialização do Cluster:

Templates de Inicialização

Após a inicialização de um instância, o PgSmart oferece a opção de salvar os dados da operação, fornecendo um ponto de partida para inicializações posteriores.

Estes templates são salvos no diretório /opt/pgsmart-client/templates e possuem o formato JSON.

Estes templates são identificados pelo timestamp correspondente à data e hora de criação do arquivo.

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

pgsmart cluster init -t

Selecione o Agente do PgSmart ou registre um novo.

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

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).
- Confirme o template selecionado.
- Modifique o template, caso desejado.
- Confirme a criação da instância PostgreSQL.

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:

source ~/.bash_profile

Resultado da inicialização do Cluster: