Como realizar a migração do PostgreSQL 9.5 para o PostgreSQL 17 no DOC-Backup

Data da publicação: 21/09/2026
Data da última revisão: 21/09/2026 (Daniel José)

Software a que se aplica este artigo: DOC-Windows

Implementado na versão/release: r.3.20.5 (DOC-Backup) / v4.82 (DOC-Windows)

Em atendimento às exigências do Provimento Nº 213 do Conselho Nacional de Justiça (CNJ), que estabelece os requisitos mínimos de tecnologia da informação e comunicação para as serventias extrajudiciais, torna-se obrigatória a atualização do gerenciador de banco de dados para uma versão moderna e com suporte ativo. Este artigo apresenta o procedimento completo para executar a migração automatizada do PostgreSQL 9.5 para o PostgreSQL 17 utilizando a ferramenta integrada no DOC-Backup.

Passo a passo

• 1º Passo – Verificações prévias e requisitos do sistema
  
  • Certifique-se de que o sistema DOC-Windows está na versão 4.82 ou superior e que o DOC-Backup está na versão 3.21 ou superior.
  • Verifique no Gerenciador de Serviços do Windows se o PostgreSQL 9.5 está operacional e em execução.
  • Confirme se o Serviço de Backup e o Serviço do Selador SP (obrigatório para cartórios do Estado de São Paulo) estão ativos.
  • Certifique-se de que não existe uma instalação prévia isolada do PostgreSQL 17 no servidor.
  • Atenção: É indispensável desativar o antivírus temporariamente antes de prosseguir. Algumas ferramentas de segurança identificam os scripts de migração como falsos positivos e excluem arquivos críticos, inviabilizando o processo.
• 2º Passo – Inicialização da migração no DOC-Backup
  
  • Abra o DOC-Backup e clique na opção EXIBIR CONFIGURAÇÕES AVANÇADAS, localizada no canto superior direito da tela.
  • Acesse o menu CONFIGURAÇÕES -> UTILITÁRIOS.
  • Localize e clique no botão MIGRAR PARA O POSTGRESQL 17.
  • Na caixa de diálogo que questiona se deseja iniciar o processo de atualização do PostgreSQL 9.5 para o 17, confirme clicando em SIM.
• 3º Passo – Concessão de acesso administrativo e execução
  
  • Quando exibida a janela de Controle de Conta de Usuário (UAC) do Windows, clique em SIM para conceder privilégios administrativos ao migrador.
  • Uma janela de prompt de comando será aberta e executará as etapas de forma automatizada: backup das bases, download e instalação do PostgreSQL 17 (com encoding UTF-8), finalização e transferência dos serviços na pasta BD9.5 para a pasta BD17 e restauração dos dados.
  • Atenção: Não feche a janela do prompt e aguarde o processamento, cujo tempo de duração será proporcional ao tamanho das bases de dados da serventia.
• 4º Passo – Registro das novas credenciais e finalização
  
  • Ao término da primeira fase, o prompt exibirá a mensagem com a nova senha do usuário SUPERVISOR e as senhas temporárias dos usuários.
  • Atenção Crítica: Anote imediatamente todas as senhas exibidas. Os usuários deverão utilizá-las para realizar o primeiro login no DOC-Windows, ocasião em que o sistema exigirá obrigatoriamente a criação de uma nova senha pessoal. (Caso não anote, consulte o log salvo na pasta temporária do DOC-Backup em TEMP\UpgradePostgreSQL).
  • Após anotar os dados de acesso, clique na janela do prompt e pressione a tecla 9 no teclado para que o migrador conclua as rotinas finais de segurança (aplicação do SCRAM-SHA-256) e reinicialização dos serviços.
  • Aguarde a mensagem indicando a conclusão com sucesso. O PostgreSQL 17, o Serviço de Backup e o Serviço do Selador SP estarão devidamente habilitados, liberando o acesso normal ao DOC-Windows.
  • Nota de Segurança: O PostgreSQL 9.5 não é desinstalado da máquina; ele é apenas desativado por precaução, podendo ser reativado caso haja necessidade de contingência.

(Resumo Final) A utilização do Migrador do PostgreSQL 17 garante a total conformidade do cartório com as diretrizes do Provimento Nº 213 do CNJ, proporcionando maior estabilidade operacional, recursos aprimorados de segurança com criptografia de ponta e ganhos de desempenho nas rotinas diárias do DOC-Windows.