PostgreSQL 12: Instalação e Configuração

Excerpt

Note

Este manual serve de referência APENAS para a versão 12.X do banco de dados PostgreSQL, pois é a versão mais recente homologada para o TI9 atualmente.

Não utilize qualquer outra versão não homologada para uso com o Ti9.

Pré-Requisitos

Recomendamos ter uma boa quantidade de espaço físico disponível no drive onde for instalado o banco de dados PostgreSQL - pelo menos 150 GB - visto que com o passar do tempo o acúmulo acumulo de informações faz com que o tamanho da base de dados aumente.

Instalação

Através Mais importante ainda, a instalação do PostgreSQL deve ser realizada sempre que possível em servidores dedicados/exclusivos ao banco de dados. Para melhor desempenho de preferência ao Sistema Operacional Linux.
Precisa ser liberada a Porta do BANCO no Firewall.

Instalação

Como explicação, seguiremos nestas instruções baseadas na instalação para Windows. Para instalação em ambiente Linux recomendamos utilizar diretamente o pacote Source (em vez de binários/RPM).

Download do instalador do PostgreSQL para Windows

Acesse este link para realizar o download do instalador Windows: Instalador do PostgreSQL para Microsoft Windows

Ou este link para realizar o download do arquivo "tar.gz", para Linux: Arquivo Source - PostgreSQL para Linux

através da página: https://www.postgresql.org/download/ é possível realizar o download do instalador

da versão Windows, ou seguir as orientações para as versões BSD, MacOS, Solaris e Linux.
Como explicação, seguiremos nestas instruções baseadas na instalação Windows.
Diretório de Instalação (Installation Directory): local onde serão instalados os

para outras versões menos populares como MacOS e Solaris.

Passo a passo da instalação do PostgreSQL

Passo 1. Duplo clique no arquivo baixado, o instalador será executado.

Image Added

Passo 2. Clique no botão "Next".

Image Added

Passo 3. Local para instalação dos arquivos do PostgreSQL. Recomendamos manter o padrão

;

Tela de Seleção de Componentes (Select Components): aqui é possível selecionar quais componentes serão instalados, dentre eles o próprio serviço do banco de dados (PostgreSQL Server) e o gerenciador padrão do banco de dados, pgAdmin. Recomendamos manter as opções padrão;

Pasta Data (Data Directory): Na tela do Data Directory é a pasta

. Clique em "Next".

Image Added

Passo 4. Seleção dos componentes para a instalação. Aqui, desmarque APENAS a opção "Stack Builder". Depois, clique no botão "Next".

Image Added

Passo 5. Este local determina onde ficarão as bases de dados

. Normalmente é colocada dentro da pasta de instalação do PostgreSQL (utilizado na Configuração

(arquivos).

Recomendamos manter o padrão;

Seleção do Locale: Na próxima tela, selecionar Locale C;

Senha: Senha padrão dtcinfpostgresql. Se não aceitar,

Recomendamos fortemente que este local seja em uma unidade de disco com alta performance e capacidade de armazenamento.
Clique no botão "Next".

Image Added

Passo 6. Nesta etapa, crie uma senha para o usuário padrão do banco (postgres). Recomenda-se utilizar uma senha que contenha letra maiúscula, minúscula e números.

Não esquecer de alterar a senha do usuário postgres para dtcinfpostgresql após a instalação.Porta: Porta 5432 ou

Image Added

Passo 7. Digite a porta padrão para o serviço do banco de dados. Porta 5432 ou 5433. A porta padrão

é

é 5432.

Desmarcar a opção do StackBuilder.

Fechar a tela do Wizard do PostgreSQL 9.0.

Configuração

Após instalado, entre no pgAdmin3. Caso a senha, durante a instalação, não foi dtcinfpostgresql, entrar em ‘Logon Role’, usuário postgres > Properties. Em password, colocar dtcinfpostgresql e repetir a senha.

pg_hba.conf

Ir na

Mantenha o padrão caso não tenha certeza.

Image Added

Passo 8. selecionar Locale C.

Image Added

Passo 9. Configurações básicas realizadas, estamos prontos para iniciar a instalação. Clique no botão "Next".

Image Added

A instalação pode levar alguns minutos para concluir.

Image Added

Passo 10. Clique no botão "Finish" para completar a instalação do PostgreSQL.

Image Added

Configurando o PostgreSQL

Passo 1. Após instalado, abra o programa pgAdmin4.

Image Added

Info

title	Executação pgAdmin loading travado

Importante: Se o pgAdmin ficar em modo loading etern (carregamento eterno), deve o seguinte procedimento a seguir:

Image Added

Acessar o Registro do Windows (regedit).
Localiza o .js através do caminho "Computador\HKEY_CLASSES_ROOT\.js", na opção "Content Type", altere o valor "text/plain" para "text/javascript" e salve.

Image Added

No Gerenciador de Tarefas, aba Detalhes localize e encerre o processo do pgadmin; Ou reinicie o servidor pgadmin.

Abra o executavel no pgAdmin, e sistema carregará corretamente.

Se for solicitada a senha "Master", digite a mesma que foi configurada no passo 6 do processo de instalação. Pressione OK.

Image Added

Passo 2. Será necessário configurar um servidor para as bases de dados. Clique com o botão direito sobre "Servers" > "Create" > "Server".

Image Added

Passo 3. Em "Name", coloque um nome de preferência para seu servidor PostgreSQL 12.

Image Added

Passo 4. Na aba "Connection", coloque o IP da máquina servidora do banco de dados. Se for a mesma máquina onde foi realizada a instalação, então o padrão é "localhost". A porta ("Port") padrão também é 5432.

No campo "Password", será necessário também informar a senha configurada no passo 6 do processo de instalação, para o usuário "postgres". Clique em "Save".

Image Added

Passo 5. Será criado então o servidor e uma base de dados padrão chamada "postgres".

Image Added

As etapas seguintes contemplam as configurações necessárias nos Arquivos do PostgreSQL.

Passo 6. pg_hba.conf

1. Acesse a pasta \data, onde foi instalado o PostgreSQL

, e abrir

1. . Localize o arquivo pg_hba.conf e abra-o com o editor de texto bloco de notas.
  Image Added
2. Neste arquivo, procurar a

linha

1. seção # IPv4 local connections

:

1. e adicionar

, abaixo da linha host, uma nova (exemplo)

1. esta nova linha abaixo:
  - host all all 192.168.0.1/24 md5
  - O IP a ser inserido deve ser o IP da rede interna. Se

houverem

1. - houver mais de 1 IPs com bases diferentes, deve-se criar linhas novas. Utilizar final .1 para abranger todo o range de um determinado IP.
    /24 se a máscara for 255.255.255.0 e /16 se a máscara for 255.255.0.0 (Iniciar > Executar > cmd > ipconfig para ver o IP da máscara).
    Image Added
  - Após ajustado, salve e feche o arquivo.

Passo 7. postgresql.conf

Ainda na pasta data,

abrir

editar o arquivo postgresql.conf.

Neste arquivo,

alterar as linhas de código

edite cada um dos parâmetros, de modo que fiquem conforme abaixo:

listen_addresses = '*' # what IP address(es) to listen on;

max_connections =

300

200

logging_collector = on

log_min_messages = error

log_line_prefix = '%d|%a|%u|%r|%p|%t|%i> '

log_statement = 'mod'

datestyle = 'iso, mdy'

timezone = '

Brazil

America/

East'Ir em Iniciar

Araguaina'

log_timezone = 'America/Araguaina'

lc_messages = 'C'

lc_monetary = 'C'

lc_numeric = 'C'

lc_time = 'C'

Se estes parâmetros estiverem com # no início da linha, é necessário removê-lo.

Após ajustado, salve e feche o arquivo.

Ir em Iniciar > Executar > services.msc, procurar PostgreSQL Server 12 (ou postgresql-

9.0, parar e iniciar novamente.

Login Roles

Executar as duas linhas abaixo

Antes de subir qualquer base de dados:

x64-12), clicar com o botão direito neste serviço. Selecione PARAR, depois, repita o procedimento clicando em INICIAR.

Passo 8. config_local.py

Abra o editor de texto bloco de notas e adicione a linha abaixo neste novo arquivo:

MASTER_PASSWORD_REQUIRED=False

Salve este arquivo no seguinte caminho: pasta onde foi instalado o PostgreSQL, pasta PgAdmin4, pasta web.

Renomeie o arquivo e sua extensão, para que fique como "config_local.py".

Exemplo:

Image Added

Passo 9. Criação dos usuários no servidor PostgreSQL.

Agora, conecte na base de dados "postgres", (exibida no passo 5 acima). Botão direito sobre a base de dados, selecione "Query Tool".

Image Added

Usuários e senhas padrões

Na janela que abrir, copie e cole as linhas abaixo, e execute pressionando <F5>:

Bloco de código

theme	Confluence
language	sql

CREATE ROLE dcompany LOGIN
  ENCRYPTED PASSWORD 'md55851ffbd7be5094d37a90eb746d93039'
  SUPERUSER INHERIT CREATEDB CREATEROLE;

Bloco de código

theme	Confluence
language	sql


 
CREATE ROLE implantacao LOGIN
  ENCRYPTED PASSWORD '

md50a75bf0958df8d962d57ec026448342e

md566b4d0c98396581e57a68e6cdafdfb94'
  SUPERUSER INHERIT CREATEDB CREATEROLE;
 
CREATE ROLE dev LOGIN
  ENCRYPTED PASSWORD 'md534c9e0a52dcb521345f57ee7b923b138'
  SUPERUSER INHERIT CREATEDB CREATEROLE;
 
CREATE ROLE suporte LOGIN
  ENCRYPTED PASSWORD 'md5f140c8d861a1ac3e4352062c447d0e0f'
  SUPERUSER INHERIT CREATEDB CREATEROLE;
 
CREATE ROLE helpdesk LOGIN
  ENCRYPTED PASSWORD 'md5b78d3de8ddb0b99cfc1c78fc8a8f0913'
  SUPERUSER INHERIT CREATEDB CREATEROLE;
 
CREATE ROLE ti9_atualizador LOGIN
  ENCRYPTED PASSWORD 'md5f8cf9602ca7a87f6175abc54755f4fb7'
  SUPERUSER INHERIT CREATEDB CREATEROLE;
 
CREATE ROLE ti9_api LOGIN
  ENCRYPTED PASSWORD 'md512f263668246a82e67d42f112fee9040'
  SUPERUSER INHERIT CREATEDB CREATEROLE;
 
CREATE ROLE api LOGIN
 ENCRYPTED PASSWORD 'md5220c9332152ea0060eb1a879f4c5733a'
 NOSUPERUSER INHERIT NOCREATEDB NOCREATEROLE;
 
GRANT ALL PRIVILEGES ON ALL TABLES IN SCHEMA public TO api;
GRANT ALL PRIVILEGES ON ALL SEQUENCES IN SCHEMA public TO api;

Este passo é necessário antes de restaurar qualquer base de dados. É imprescindível seguir esta instrução

Ir em

Iniciar

Iniciar > Executar > services.msc, procurar PostgreSQL Server 12 (ou postgresql-

9.0, parar e iniciar novamente.

Após instalado e configurado, criar uma nova base de dados, sendo o nome desta base o nome do cliente.

Criação de uma base de dados

A partir do passo 8 do seção acima, já é possível criar uma base de dados. Para isso,

x64-12), clicar com o botão direito

sobre Databases e selecionar New Database.

No campo Name, colocar o nome da base de dados;

No campo Owner, colocar postgres;

No campo Encoding, selecionar SQL_ASCII;

No campo Template, selecionar template0;

Pressionar Ok. Feito isso, clicar com o botão direito sobre a nova base criada e escolher a opção "Restore..."

Selecione o arquivo de backup para criar esta nova base.

Info
Após a instalação do banco de dados PostgreSQL 9.0.X, verifique o arquivo PG_CONF.ini (encontrado na pasta \Acesso, no diretório de aplicações do Ti9), para que este aponte para o novo IP do servidor do banco de dados. Acesse Instalação e Configuração TI9 para mais informações do PG_CONF.ini.

Configuração Horário de Verão

Esta configuração tem como finalidade evitar problemas referente à transmissão de Notas Fiscais, quando está ativo o horário de verão (após 00:00).

No Servidor do banco de dados é necessário conferir o horário do PostgreSQL, comparando com o Windows.
1. No pgAdmin, abra uma consulta com a base de dados e execute o comando SELECT now();
Caso o horário esteja diferente é possível realizar um dos 2 procedimentos abaixo. (Caso não for este o problema sugiro abrir um ticket para avaliarmos).
1. Alterar o horário do Windows Manualmente.
  1. Desmarcar o horário de verão do Windows e ajustar o relógio manualmente.
2. Alterar o Fuso Horário no PostgreSQL.
  1. Alterar um arquivo de configuração do banco de dados (postgresql.conf, que se encontra na pasta de instalação\data) atualizando a variável "timezone" para "Brazil\East" da seguinte forma (remover o #, se tiver): timezone = 'Brazil/East';
  2. Reiniciar o serviço do PostgreSQL (Ir em Iniciar > Executar > services.msc, procurar postgresql-9.0, parar e iniciar novamente).
3. Feito um destes passos, consulte novamente o horário: SELECT now();

neste serviço. Selecione PARAR, depois, repita o procedimento clicando em INICIAR.

FIM

A configuração do seu banco de dados está realizada.

Configurações Adicionais - Ajustes de Performance

Sugerimos realizar mais alguns ajustes simples para ter uma ótima performance do banco de dados PostgreSQL. Para isto, acesse este passo a passo: Configuração para otimização da performance do banco PostgreSQL 12

PostgreSQL 12: Instalação e Configuração

Versões comparadas

Old Version 4

Nova versão Current

Chave

Download do instalador do PostgreSQL para Windows

Passo a passo da instalação do PostgreSQL

pg_hba.conf

Configurando o PostgreSQL

As etapas seguintes contemplam as configurações necessárias nos Arquivos do PostgreSQL.

Passo 6. pg_hba.conf

Passo 7. postgresql.conf

Login Roles

Passo 8. config_local.py

Usuários e senhas padrões

Configurações Adicionais - Ajustes de Performance