Projeto de Atualização PostgreSQL (pg_upgrade)

Este projeto automatiza a migração de uma versão antiga do PostgreSQL para uma versão mais nova, cuidando de instalação, migração de dados e ajustes de configuração.

Funcionalidades

• Instalação automática da versão nova informada pelo usuário.
• Criação de diretórios e ajuste de permissões para o novo cluster.
• Otimizações pré-configuradas no postgresql.conf (buffers, cache, timeouts, logs, timezone).
• Migração de dados via pg_upgrade, parando/ativando clusters conforme necessário.
• Ajuste de portas para coexistência das versões antiga e nova.
• Vacuum e outras manutenções pós-upgrade.

Requisitos

• Linux (Debian/Ubuntu) com gerenciador de pacotes apt.
• Acesso administrativo (sudo).
• PostgreSQL ≥ 12 disponível nos repositórios oficiais.

Como usar

git clone https://github.com/omatheusgit/pg_upgrade.git
cd pg_upgrade
chmod +x upgrade.sh
./upgrade.sh

Dica: Siga as instruções na tela, informando as versões e diretórios conforme solicitado. Leia atentamente os processos que estão sendo executados e exibidos em tela.

Parâmetros solicitados

• Versão antiga: versão atualmente em uso do PostgreSQL.
• Versão nova: versão desejada para upgrade.
• Diretório atual: local dos dados da versão antiga (data dir).
• Diretório novo: pasta/destino da nova versão do PostgresSQL.

Tuning essencial (pg_tune)

O script aplica modificações de parâmetros fundamentais para otimização nas configurações do postgresql.conf. Baseado no pg_tune.

• listen_addresses
  Define em quais interfaces o servidor escuta conexões (padrão localhost, alterado para * para permitir acesso remoto).

• idle_in_transaction_session_timeout
  Tempo máximo (em milissegundos) que uma transação inativa pode ficar aberta antes de ser encerrada (ex.: 20000).

• deadlock_timeout
  Tempo de espera antes de o PostgreSQL verificar se há deadlocks ativos (ex.: 5s).

• max_locks_per_transaction
  Número máximo de locks que cada transação pode obter (ex.: 128).

• shared_buffers
  Quantidade de memória reservada para buffers compartilhados (≈ 25 % da RAM).

• effective_cache_size
  Estimativa de memória disponível para o cache do sistema operacional (≈ 75 % da RAM).

• max_connections
  Número máximo de conexões simultâneas permitidas ao banco (ex.: 600).

• maintenance_work_mem
  Memória alocada para operações de manutenção (VACUUM, REINDEX etc., ex.: 512MB).

• checkpoint_segments (legacy tuning)
  Controla quantos segmentos de WAL podem ser escritos antes de forçar um checkpoint (ex.: 10).

• synchronous_commit
  Define se o commit de transações aguarda confirmação de gravação no disco (padrão on; desativar com off aumenta o throughput).

Atenção

• Faça backup completo antes de iniciar.
• Teste em ambiente controlado; não execute direto em produção.
• Revise os parâmetros do postgresql.conf caso tenha necessidades específicas de carga de trabalho.

Autor

• Desenvolvido por Matheus Rafael.