Atualização PostgreSQL 12 para versão16

Antes do upgrade para versão 16  deve realizar-se  o upgrade para a versão  22.04  do SO Ubuntu.

Atualização

Preparação

Este procedimento trata-se de atualização do sistema gerenciador de banco de dados (SGBD) PostgreSQL, repositório do MD2 QualityManager, da versão 12 para versão 16. Atente-se aos requisitos e alertas deste tópico antes de iniciar a atualização.

• Faça backup da máquina virtual (VM) antes de iniciar o procedimento. Pode ser adotado outro procedimento de backup. A sugestão é backup por snapshot pois o RTO (Recovery Time Objective) é menor.
• Se programe para a indisponibilidade. O procedimento pode demorar pelo menos 60 minutos. Variará de acordo com o tamanho do banco de dados e capacidade dos recursos. Considere na estimativa o tempo de retorno em caso de incidente.
• Garanta que o banco de dados não está em uso, seja pela aplicação MD2 QualityManager ou outro.
• Garanta que a máquina virtual tenha acesso ao repositório oficial do PostgreSQL:
  https://​​​​​​​postgresql.org​​​​​​​
• A depender da origem do servidor, se é oriunda da OVA padrão distribuída pela MD2 QualityManager, o usuário "md2net" pode não ter permissão para executar alguns comandos. Recomendamos a avaliação prévia ou a utilização do usuário "root".

Ao final do procedimento a aplicação MD2 QualityManager executará apontando para a nova versão de banco de dados de forma transparente.

Atualização

Para garantir que não há nenhuma conexão no banco de dados, desligue o Tomcat e reinicie o PostgreSQL:

$ sudo systemctl stop tomcat10.service

$ sudo systemctl restart postgresql.service

Para iniciar o upgrade, o usuário deverá estar logado com o usuário ROOT e executar os comandos abaixo:

$ apt install -y postgresql-common
$ /usr/share/postgresql-common/pgdg/apt.postgresql.org.sh
$ apt update

Instalação do PostgreSQL versão 16:

$ sudo apt install postgresql-16

Conferência de 3 instâncias, uma da versão 12, outra da 14 e a nova, versão 16:

$ sudo pg_lsclusters

Ver Cluster Port Status Owner    Data directory               Log file
12 main    5432 online  postgres /var/lib/postgresql/12/main /var/log/postgresql/postgresql-12-main.log
14 main    5433 online  postgres /var/lib/postgresql/14/main /var/log/postgresql/postgresql-14-main.log
16 main    5434 online  postgres /var/lib/postgresql/16/main /var/log/postgresql/postgresql-16-main.log

Parando o serviço do PostgreSQL:

$ sudo systemctl stop postgresql

Acessando com o usuário postgres:

$ su - postgres

Renomeando a instância da versão 16:

$ pg_renamecluster 16 main main16

Atualizando a instância 12.

Este procedimento pode demorar algumas horas pois faz a migração de dados:

$ pg_upgradecluster 12 main 

Logout do  usuário postgres:

$ exit

Iniciando o serviço do postgreSQL:

$ systemctl start postgresql
$ systemctl status postgresql

Acessando com o usuário postgres:

$ su - postgres

Conferir a existência de 4 instâncias:

$ pg_lsclusters

Ver Cluster Port Status Owner    Data directory               Log file
12 main    5432 online postgres /var/lib/postgresql/12/main /var/log/postgresql/postgresql-12-main.log
14 main    5433 online postgres /var/lib/postgresql/14/main /var/log/postgresql/postgresql-14-main.log
16 main    5435 down postgres /var/lib/postgresql/16/main /var/log/postgresql/postgresql-16-main.log
16 main16  5434 online postgres /var/lib/postgresql/16/main16 /var/log/postgresql/postgresql-16-main16.log

Remover a antiga instância 12, 14 e a 16, desnecessárias:

$ pg_dropcluster 12 main --stop
$ pg_dropcluster 14 main --stop
$ pg_dropcluster 16 main16 --stop

Logout do  usuário postgres:

$ exit

Parando o serviço do postgreSQL:

$ systemctl stop postgresql

Mudando a porta do postgreSQL, mude para a porta 5432:

$ vim /etc/postgresql/16/main/postgresql.conf

Arquivo antes da edição:



Arquivo após edição:

Iniciando o serviço do PostgreSQL:

$ sudo systemctl start postgresql

Verifique que o serviço do PostgreSQL subiu com sucesso:

$ systemctl status postgresql

Em caso de erro em algum passo no procedimento, recomenda-se a execução do procedimento de restauração do backup.