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. |
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.
Execução Interativa
pgsmart cluster init
-
Selecione o Agente do PgSmart ou registre um novo.
![seleciona agente pgsmart](../../_images/pgsys-sel-agent-cluster.png)
-
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.
![informa dados instancia](../../_images/pgsys-adm-inic-instancia-dados.png)
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:
![informa resultado init](../../_images/pgsys-adm-cluster-init-resultado.png)
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.
![seleciona agente pgsmart](../../_images/pgsys-sel-agent-cluster.png)
-
O template desejado pode ser selecionado na lista de templates disponíveis.
![seleciona template](../../_images/pgsys-adm-cluster-init-template-sel.png)
-
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.
-
![confirma template](../../_images/pgsys-adm-cluster-init-template-confirma.png)
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:
|
-
Resultado da inicialização do Cluster:
![informa resultado init](../../_images/pgsys-adm-cluster-init-resultado.png)