Histórico da Página
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.
| Informações | ||
|---|---|---|
| ||
Para melhor aproveitamento do conteúdo das páginas relacionadas, recomendamos:
| ||
| 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 PostgreSQL • Documentação do pgdump • Link para PGTune • Link para documentação DBAccess • Home - PostgreSQL • Documentaçã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 | ||
|---|---|---|
| ||
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 | ||
| ||
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 | ||
|---|---|---|
| ||
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 | ||
|---|---|---|
| ||
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 | ||
|---|---|---|
| ||
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:
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:
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:
- “ALTER SYSTEM commands”, onde podemos coletar os comandos para alteração diretamente na instância:
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:
Por linha de comando, no psql, cole as linhas de configuração.
| Aviso | ||
|---|---|---|
| ||
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”
Ou com a seguinte query:
| Bloco de código |
|---|
SELECT usename FROM pg_user; |
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:






