Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Este documento tem como objetivo auxiliar analistas na instalação e configuração básica do banco de dados PostgreSQL em ambientes locais , de desenvolvimento e /ou teste, em sistemas operacionais Linux. A instalação e configuração em ambientes de produção não é o foco deste documento.em Sistemas Operacionais Linux, e pode ser utilizado em um ambiente de produção como referência e apoio ao DBA. 

Neste manual, demonstramos a instalação do PostgreSQL 12, última versão homologada até a data de publicação deste documento
Informações
titlePré-requisitos e informações adicionais

Para melhor aproveitamento do conteúdo das páginas relacionadas, recomendamos:

  • Conhecimento do Protheus;
  • Noções básicas de instalação de aplicativos em Linux;
  • Familiaridade com terminologias de banco de dados e novas tecnologias.
Informações

Os links a seguir possuem conteúdos relevantes ao material apresentado nestas páginas:

Wiki Guia para Report de Problemas • Ferramentas para o PostgreSQLDocumentação do pgdumpLink para PGTuneLink para documentação DBAccessHome - PostgreSQLDocumentação initdb - criando um cluster do PostgreSQL

Nas páginas abaixo, é demonstrada a instalação do PostgreSQL 16 em sistema operacional RedHat Enterprise Linux release 9.6 - x86_64.

Aviso
titleAtenção - Ambientes de produção

Em ambientes de produção, o ideal é ter um DBA para apoiar na instalação e configuração, por conta de configurações específicas de cenário e tuning no banco de dados.

Nota
titleAtenção - Sistema Operacional

O sistema operacional utilizado como base para esta página foi o Red Hat Enterprise Linux release 8.3 - x86_64. Os comandos aqui apresentados são referentes ao Red Hat 8.

Instalando o PostgreSQL

Para baixar e instalar o PostgreSQL, execute os comandos abaixo. Atenção: estes comandos são referentes ao sistema operacional Red Hat 8.

Bloco de código
dnf install https://download.postgresql.org/pub/repos/yum/reporpms/EL-8-x86_64/pgdg-redhat-repo-latest.noarch.rpm

dnf module disable postgresql

sudo dnf install -y postgresql12-server postgresql-contrib 
Informações
titleMais detalhes sobre instalação e documento de referência

Você pode alterar a versão e verificar o comando para instalação em outras versões. Postgresql-RedHat

Criação do Cluster PostgreSQL

Após realizar o download do pacote e a instalação, execute o seguinte comando para a criação do novo Cluster de banco de dados. O Cluster é uma coleção de banco dados gerenciados em uma única instância. 

Bloco de código
/usr/pgsql-12/bin/postgresql-12-setup initdb

Posterior à criação do Cluster, vamos colocar na inicialização do Sistema Operacional:

Bloco de código
systemctl enable postgresql-12

E iniciar:

Bloco de código
systemctl start postgresql-12

Pode-se verificar o status da seguinte forma:

Bloco de código
systemctl status postgresql-12

Configuração para boa performance

Com o Cluster instalado e iniciado, é possível realizar a configuração mínima para boa performance do banco de dados com o ERP Protheus.

Informações
titleReferência para cálculo dos parâmetros

Foi utilizado, neste documento, a ferramenta PGConfig. Esta ferramenta é desenvolvida e mantida pela comunidade Open Source do PostgreSQL. Outra ferramenta amplamente utilizada é o PGTune.

Neste exemplo, os seguintes parâmetros foram alterados:

...

Operating System = GNU/Linux Based

Application Profile= ERP or Long Transaction Applications

Architecture= 64 Bits (x86-64)

PostgreSQL Version= 12

Storage Type= SSD Storage

Number of CPUs= 4  (De acordo com o Servidor do Banco de Dados)

Total Memory (GB)= 16 (De acordo com o Servidor do Banco de Dados)

Max Connections= 100 (Com dicionário no Banco de Dados coloque, no mínimo, o dobro de conexões do ERP)

Data Storage = SSD Storage (De acordo com o Servidor do Banco de Dados)

 

Utilize o PostgreSQL em Linux para ambientes de produção.

Exibir filhos

Após alterar todos os valores necessários, as recomendações para a configuração do banco de dados logo abaixo.

Aviso
titleAtenção

Estes ajustes são referentes ao sizing do servidor de exemplo, e os valores aqui retratados NÃO devem ser utilizados como base para seu ambiente de produção. O único valor que será utilizado para o Protheus é o Application Profile = ERP.

Do lado direito (Profile Comparison), será demonstrado os valores recomendados na coluna OLTP:

Image Removed

Caso você prefira entender cada parâmetro de forma mais detalhada, você pode clicar no mesmo que irá expandir um explicação básica e o link da documentação PostgreSQL com maiores detalhes:

Image Removed

A segunda possibilidade é “Export Config” do lado direito onde você em duas opções de formato para configuração:

  • “UNIX-Like config file”, onde você possui a configuração indicada para o arquivo postgresql.conf de acordo com o hardware indicado acima:

Image Removed

  • “ALTER SYSTEM commands”, onde podemos coletar os comandos para alteração diretamente na instância:

Image Removed

Ambas as maneiras trarão o mesmo resultado.

É possível executar os comandos ALTER SYSTEM pelo PGAdmin ou por linha de comando, pelo psql. 

No pgAdmin, clique com o botão direito sobre sua database, clique em Query Tool e cole o conteúdo. Após isto, clique em Executar ou aperte F5:

Image Removed

Por linha de comando, no psql, cole as linhas de configuração. 

Image Removed

Aviso
titleAtenção

Estes ajustes são referentes ao sizing do servidor de exemplo, e os valores aqui retratados NÃO devem ser utilizados como base para seu ambiente de produção. O único valor que será utilizado para o Protheus é o Application Profile = ERP.

Com um limite de 200 a 300 conexões no Protheus, o Linux default pode atender à demanda, mas é importante que o postgreSQL também esteja em Linux. Em determinados casos, é importante efetuar ajustes no sistema operacional para garantir uma boa performance do cenário. 

Ao aplicar as alterações, seja pelo pgAdmin ou psql, você pode verificar as alterações que foram realizadas no arquivo:

/var/lib/pgsql/12/data/postgresql.auto.conf

Esse arquivo não pode ser alterado. Mas caso queira alterar manualmente o arquivo de configuração, realize a alteração do arquivo: /var/lib/pgsql/12/data/postgresql.conf. 

Lembre-se de reiniciar a instância após a alteração para que todos os parâmetros sejam aplicados.

  • Criação de Usuário e Base de Dados para o ERP Protheus;

Após realizar a alteração ou no arquivo postgresql.conf ou com linha de comando para melhor performance, podemos prosseguir com a criação do banco de dados.

Neste exemplo, vamos criar os usuários ‘tpprd’, ‘tphml’ e ‘tpdev’ com a senha igual ao usuário no Cluster PostgreSQL. Mas atenção: por questões de segurança, não adote esta prática em seu ambiente de produção.

Você pode escolher outro nome e senha para a criação, esse padrão que utilizamos segue a seguinte definição e indicações de nomenclatura:

...

Acesse o linux, e entre com a usuário criado automaticamente na instalação do PostgreSQL:

su - postgresql

Certifique-se que este usuário tem acesso a pasta para criação dos datafiles do banco de dados.

Diretamente no Sistema Operacional com a ferramenta psql:

  •  Create User
Bloco de código
psql -c “CREATE USER tpprd WITH LOGIN NOSUPERUSER INHERIT CREATEDB NOCREATEROLE NOREPLICATION CONNECTION LIMIT -1 PASSWORD 'tpprd'.”
psql -c “CREATE USER tphml WITH LOGIN NOSUPERUSER INHERIT CREATEDB NOCREATEROLE NOREPLICATION CONNECTION LIMIT -1 PASSWORD 'tphml'”
psql -c “CREATE USER tpdev WITH LOGIN NOSUPERUSER INHERIT CREATEDB NOCREATEROLE NOREPLICATION CONNECTION LIMIT -1 PASSWORD 'tpdev'”

Ou com a ferramenta pgAdmin:

Bloco de código
CREATE USER tpprd WITH LOGIN NOSUPERUSER INHERIT CREATEDB NOCREATEROLE NOREPLICATION CONNECTION LIMIT -1 PASSWORD 'tpprd'
CREATE USER tphml WITH LOGIN NOSUPERUSER INHERIT CREATEDB NOCREATEROLE NOREPLICATION CONNECTION LIMIT -1 PASSWORD 'tphml'
CREATE USER tpdev WITH LOGIN NOSUPERUSER INHERIT CREATEDB NOCREATEROLE NOREPLICATION CONNECTION LIMIT -1 PASSWORD 'tpdev'

Pode-se verificar a criação do usuário no PgAdmin no “Login/Group Roles”

Image Removed

Ou com a seguinte query:

Bloco de código
SELECT usename FROM pg_user;

Image Removed

Após a criação do usuário, vamos criar os tablespaces e dar permissão ao usuário criado.

  •  Permissão para usuário Postgre

chown -R postgres:postgres /pgdata/ (pgdata é o path criado no sistema operacional exclusivo para datafiles protheus, pode ser especificado qual é seu path)

  •  Criação de Path para Datafiles

su - postgres

cd /pgdata

mkdir tpprd/data

mkdir tpprd/index

mkdir tphml/data

mkdir tphml/index

mkdir tpdev/data

mkdir tpdev/index

  •  Tablespace para Dados

Diretamente no Sistema Operacional com a ferramenta psql:

su - postgres

#(Ambiente Produção)

psql -c "CREATE TABLESPACE tpprd_data OWNER tpprd LOCATION '/pgdata/tpprd/data'";

psql -c "CREATE TABLESPACE tpprd_index OWNER tpprd LOCATION '/pgdata/tpprd/index'";

#(Ambiente Homologação)

psql -c "CREATE TABLESPACE tphml_data OWNER tphml LOCATION '/pgdata/tphml/data'";

psql -c "CREATE TABLESPACE tphml_index OWNER tphml LOCATION '/pgdata/tphml/index'";

#(Ambiente Desenvolvimento)

psql -c "CREATE TABLESPACE tpdev_data OWNER tpdev LOCATION '/pgdata/tpdev/data'";

psql -c "CREATE TABLESPACE tpdev_index OWNER tpdev LOCATION '/pgdata/tpdev/index'";

Ou com a ferramenta pgAdmin:

CREATE TABLESPACE tpprd_data OWNER tpprd LOCATION '/pgdata/tpprd/data';

CREATE TABLESPACE tpprd_index OWNER tpprd LOCATION '/pgdata/tpprd/index';

CREATE TABLESPACE tphml_data OWNER tphml LOCATION '/pgdata/tphml/data';

CREATE TABLESPACE tphml_index OWNER tphml LOCATION '/pgdata/tphml/index';

CREATE TABLESPACE tpdev_data OWNER tpdev LOCATION '/pgdata/tpdev/data';

CREATE TABLESPACE tpdev_index OWNER tpdev LOCATION '/pgdata/tpdev/index';

Observação

Para ambientes que utilizam serviços da AWS "RDS" não tem necessidade de criar tablespace.

No pgAdmin podemos visualizar os tablespaces criados:

Ou com a seguinte query:

SELECT spcname FROM pg_tablespace;

Agora vamos para criação dos bancos de dados vinculando aos Schema “tpprd”, “tphml” e “tpdev” criados anteriormentes: