Inicialização de uma Instância de Banco de Dados

Uma instância de banco de dados, ou cluster de banco de dados, é uma coleção de bancos de dados gerenciados pelo mesmo serviço PostgreSQL. Cada cluster é associado a uma porta de comunicação única, permitindo que múltiplos clusters coexistam em um mesmo sistema, cada um operando de forma independente.

Em termos de sistema de arquivos, uma instância de banco de dados é essencialmente um diretório de armazenamento físico no disco onde todos os dados, arquivos de log, configurações e outros componentes serão persistidos. Este diretório é frequentemente referido como o diretório de dados, área de dados ou PGDATA.

Através do PgSmart todo o processo de inicialização da instância de banco de dados é automático, incluindo a configuração de parâmetros de rede, codificação de caracteres, representação regional, criação de serviço, entre outros.

Pré-Requisitos:

Verifique se os binários do PostgreSQL estão instalados e acessíveis:

psql --version

Sintaxe do Comando

pgsmart cluster init [OPÇÕES]
OPÇÃO DESCRIÇÃO

-b, --bin

Diretório de instalação dos binários do PostgreSQL.

-d, --data

Diretório de dados da instância PostgreSQL.

-t, --template

Template de inicialização da instância PostgreSQL.

-h, --help

Exibe informações de ajuda.

Inicialização Interativa

pgsmart cluster init

  1. Informe o diretório de instalação dos binários do PostgreSQL (PGBIN).

  2. Informe o diretório de dados da instância PostgreSQL (PGDATA).

  3. Informe o diretório de logs transacionais (WALDIR).

    Os valores padrão podem ser aceitos simplesmente teclando ENTER.

  4. Escolha a codificação de caracteres padrão (ENCODE).

  5. Selecione a representação regional padrão de dados e valores monetários (LOCALE).

  6. Defina a porta da instância PostgreSQL (PGPORT).

    Inicialização cluster - dados da instância
    Os diretórios de dados e logs transacionais, e o número da porta devem ser únicos para cada instância.

  7. Selecione as interfaces de rede para acesso de aplicações e clientes (LISTEN_ADDRESSES).

    Inicialização cluster - seleção de interfaces

  8. Confirme se deseja exportar o template da instância para reutilização em inicializações futuras (opcional).

    Inicialização cluster - exportação de template

  9. Confirme a criação da instância PostgreSQL.

    Inicialização cluster - confirmação de criação

  10. Após a criação da instância, o PgSmart apresenta a situação do serviço PostgreSQL correspondente.

    Inicialização cluster - resultado

Inicialização com Template

O PgSmart permite salvar as configurações de inicialização em um template, o qual pode ser reutilizado em futuras inicializações. Os templates são salvos no diretório opt/pgsmart/templates em formato JSON, identificados pela data de criação.

Para inicializar um cluster usando um template utilize a opção -t:

pgsmart cluster init -t

  1. Selecione o template desejado na lista de templates disponíveis.

    Inicialização cluster - seleção do template

  2. Verifique as configurações importadas pelo template selecionado.

    Inicialização cluster - verificação do template

  3. Confirme a inicialização da instância PostgreSQL.

    Inicialização cluster - confirmação da inicialização
    Para criar uma nova instância na mesma máquina, altere manualmente as configurações referentes ao PGDATA, WALDIR e PGPORT no arquivo do template.

  4. Após a criação da instância, o PgSmart apresenta a situação do serviço PostgreSQL correspondente.

    Inicialização cluster - resultado com template

    O PgSmart define variáveis de ambiente no arquivo .bash_profile do Linux, as quais podem ser carregadas em novas sessões do sistema operacional. Para carregá-las imediatamente, execute o comando abaixo:

    source ~/.bash_profile