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

  1. 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 de informações faz com que o tamanho da base de dados aumente.
  2. 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.

Instalação

(informaçã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: Instaladores para PostgreSQL no site da EnterpriseDB

(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)

Clique no link para download, conforme demonstrado abaixo:

Passo a passo da instalação do PostgreSQL

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

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

Install PostgreSQL - step 1

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

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

Passo 5. Este local determina onde ficarão as bases de dados (arquivos).
(aviso) Recomendamos fortemente que este local seja em uma unidade de disco com alta performance e capacidade de armazenamento.
Clique no botão "Next".

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.

Passo 7. Digite a porta padrão para o serviço do banco de dados. Porta 5432 ou 5433. A porta padrão é 5432. Mantenha o padrão caso não tenha certeza.

Passo 8. selecionar Locale C.

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

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

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

 

Configurando o PostgreSQL

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

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

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

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

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".

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

 

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. Localize o arquivo pg_hba.conf e abra-o com o editor de texto bloco de notas.


    2. Neste arquivo, procurar a seção # IPv4 local connections e adicionar 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 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).
      • Após ajustado, salve e feche o arquivo.

Passo 7. postgresql.conf

Ainda na pasta data, editar o arquivo postgresql.conf.

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

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

max_connections = 300

logging_collector = on

log_min_messages = error

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

log_statement = 'mod'

datestyle = 'iso, mdy'

timezone = 'America/Araguaina'

(aviso) 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-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:

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".

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

CREATE ROLE dcompany LOGIN
  ENCRYPTED PASSWORD 'md55851ffbd7be5094d37a90eb746d93039'
  SUPERUSER INHERIT CREATEDB CREATEROLE;
 
CREATE ROLE implantacao LOGIN
  ENCRYPTED PASSWORD 'md50a75bf0958df8d962d57ec026448342e'
  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'
  NOSUPERUSER NOINHERIT NOCREATEDB NOCREATEROLE;

 

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

 

Ir em Iniciar > Executar > services.msc, procurar PostgreSQL Server 12 (ou postgresql-x64-12), clicar com o botão direito neste serviço. Selecione PARAR, depois, repita o procedimento clicando em INICIAR.

 

FIM

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


 

(aviso) 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