Versões comparadas

Chave

  • Estas linhas foram adicionadas. Esta palavra foi adicionada.
  • Estas linhas foram removidas. Esta palavra foi removida.
  • Formatting was changed.
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

  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 acumulo de informações faz com que o tamanho da base de dados aumente, pelo menos 150 GB.

Instalação

  1. Executar o setup (postgresql-9.0.3-1-windows.exe se for 32 bits ou postgresql-9.0.3-1-windows_x64.exe se for 64 bits);
  2. Pasta de Instalação: Deve-se escolher uma pasta de instalação do PostgreSQL. De padrão, vem selecionado C:/Arquivos de Programas/PostgreSQL/9.0. Pressione Next para prosseguir.;
  3. Pasta Data: Na tela do Data Directory é a pasta onde ficarão as bases de dados. Normalmente é colocada dentro da pasta de instalação do PostgreSQL (utilizado na Configuração). Recomendamos manter no caminho padrão;
  4. Seleção do Locale: Na próxima tela, selecionar Locale C;
  5. Senha: Senha padrão dtcinfpostgresql. Se não aceitar, .
  6. 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.
  7. Precisa ser liberada a Porta do BANCO no Firewall.

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

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
    titleExecutação pgAdmin loading travado

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

    image.pngImage 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.

     

     

    (informação) 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
    1. , 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
    2. linha
      1. seção # IPv4 local connections
    3. :
      1. e adicionar
    4. , 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
    5. houverem
        • 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'

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

    9.0, parar e iniciar novamente. 
    Login Roles
    Executar as duas linhas abaixo (aviso) Antes de subir qualquer base de dados: (aviso)

    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
    themeConfluence
    languagesql
    CREATE ROLE dcompany LOGIN
      ENCRYPTED PASSWORD 'md55851ffbd7be5094d37a90eb746d93039'
      SUPERUSER INHERIT CREATEDB CREATEROLE;
    Bloco de código
    themeConfluence
    languagesql
    
     
    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;

     

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

    1.  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();
    2. 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

    (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