| 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.
- 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 WindowsAcesse 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 Passo a passo da instalação do PostgreSQLPasso 1. Duplo clique no arquivo baixado, o instalador será executado. 
Passo 2. Clique no botão "Next".  Image Removed Image Added
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".  Image Removed Image Added
Passo 5. Este local determina onde ficarão as bases de dados (arquivos).
 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.  Image Removed 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. Mantenha o padrão caso não tenha certeza.  Image Removed Image Added
Passo 8. selecionar Locale C. 
Passo 9. Configurações básicas realizadas, estamos prontos para iniciar a instalação. Clique no botão "Next".  Image Removed Image Added
A instalação pode levar alguns minutos para concluir.  Image Removed Image Added
Passo 10. Clique no botão "Finish" para completar a instalação do PostgreSQL.  Image Removed Image Added
Configurando o PostgreSQLPasso 1. Após instalado, abra o programa pgAdmin4. 
| 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. 
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 - 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.
- 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.confAinda 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 = 300200 logging_collector = on log_min_messages = error log_line_prefix = '%d|%a|%u|%r|%p|%t|%i> ' log_statement = 'mod' datestyle = 'iso, mdy' timezone = 'America/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-x64-12), clicar com o botão direito neste serviço. Selecione PARAR, depois, repita o procedimento clicando em INICIAR.
Passo 8. config_local.pyAbra 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". 
Usuários e senhas padrõesNa 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;
CREATE ROLE implantacao LOGIN
ENCRYPTED PASSWORD 'md50a75bf0958df8d962d57ec026448342emd566b4d0c98396581e57a68e6cdafdfb94'
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 > 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.
Configurações Adicionais - Ajustes de Performance
|