Atualização Ubuntu
Este documento visa esclarecer todos os passos para uma atualização segura do sistema operacional da template do QM seguindo do Ubuntu 16.04 para a versão 20.04.
- Processo de atualização
- Upgrade
- Processo Pós Atualização do SO - Versão do Tomcat
- Processo Pós Atualização do SO - Versão do Java
- Processo Pós Atualização do SO - Versão do PostgreSQL
Processo de atualização
Antes de iniciar a atualização é recomendável que seja feito um backup (snapshot) do servidor e esteja ciente que todo processo de atualização pode durar no mínimo 2 horas pois será necessário fazer a atualização da versão 16.0.4 para a versão 18.0.4 e na sequencia fazer a atualização da versão 18.0.4 para a versão final 20.0.4.
Para dar início ao processo de atualização é necessário acessar o servidor desejado via ssh, verificar o status do firewall do servidor e caso esteja ativo, deve-se liberar a porta de administração de emergência, utilizando os comandos abaixo:
$ sudo ufw status
$ sudo ufw allow 1022
Upgrade
Como mencionado anteriormente, este processo deverá ser feito duas vezes:
- Upgrade da versão 16.04 para a versão 18.04
- Upgrade da versão 18.04 para a versão 20.04
Para iniciar o upgrade, o usuário deverá estar logado com o usuário ROOT e executar os comandos abaixo:
$ apt update
$ apt upgrade
$ reboot now
$ do-release-upgrade
Durante a execução do ultimo comando listado aparecerão na tela algumas opções que deverão ser selecionadas conforme os prints abaixo:
-
Processo de upgrade da versão 16.04 para a versão 18.04:
Conferindo a versão do SO após o reboot da primeira etapa do Upgrade:
$ cat /etc/os-release
-
Processo de upgrade da versão 18.04 para a versão 20.04:
Conferindo a versão do SO após o reboot da primeira etapa do Upgrade:
$ cat /etc/os-release
Processo Pós Atualização do SO - Versão do Tomcat
Após a atualização do Sistema Operacional, alguns pontos precisam ser validados e modificados, tais como:
-
- Versão do Tomcat
- Versão do PostgreSQL
- Versão do Java (JDK)
1. Versão do Tomcat
Ao atualizar o sistema operacional, o Tomcat7 será descartado e será utilizado apenas o Tomcat 9.0.43. Para fazer a instalação do mesmo, basta executar os seguintes comandos:
$ vim /etc/apt/sources.list.d/ubuntu-tomcat9.0.43.list
Adicionar a linha abaixo e salvar (:x):
deb http://us.archive.ubuntu.com/ubuntu/ hirsute universe
Executar os comandos:
$ apt update
$ apt install tomcat9
Após a instalação concluída, deve-se seguir ao diretório do serviço do tomcat para alterar o arquivo tomcat9.service:
$ vim /lib/systemd/system/tomcat9.service
Adicionar o parâmetro abaixo no grupo #Security e executar os comandos:
ReadWritePaths=/opt/qm_static/
$ systemctl daemon-reload
$ chown -R tomcat:tomcat /opt/qm_static
$ mv /var/lib/tomcat7/webapps/qualityManager-prj.war /var/lib/tomcat9/webapps/
$ systemctl restart tomcat9.service
$ rm -rf /etc/apt/sources.list.d/ubuntu-tomcat9.0.43.list
$apt update
Processo Pós Atualização do SO - Versão do Java
Após a atualização do SO, o java costuma ser atualizado para uma versão que não está homologada para receber a aplicação. Sendo assim, será necessário conferir a versão e caso o mesmo tenha sido atualizado, a versão correta deverá ser instalada.
A versão correta do JAVA é a versão 1.8.0_292.
Conferindo a versão:
$ java -version
Instalando a versão correta:
$ apt install openjdk-8-jdk
$ update-alternatives --config java
Escolhendo a opção correta do java:
Processo Pós Atualização do SO - Versão do PostgreSQL
Durante a atualização do SO é instalado o PostgreSQL 13, versão na qual não está homologada para receber o repositório do Quality Manager.
É de extrema importância que os comando a seguir sejam executados:
- Verificando a versão que foi instalada após o processo de atualização do SO.
$ psql -V
- Verificando as versões instaladas no servidor:
$ pg_lsclusters
A versão que está homologada para receber o repositório do Quality Manager é a 12:
- Apagando o PostgreSQL13 e deixando apenas a versão homologada:
$ pg_dropcluster --stop 13 main
Obs: Em alguns casos, durante a atualização do SO é instalado a versão 10 do PostgreSQL. Nestes casos, basta executar o comando abaixo:
$ pg_dropcluster --stop 10 main
- Validando o acesso ao banco de dados:
$ psql -h 127.0.0.1 -U md2net -d qualitymanager