Skip to main content

Processo de atualização TomCat

Antes de fazer a atualização do Tomcat, será necessário verificar a compatibilidade com a versão do Quality Manager configurada no servidor. 

Versão do Quality Manager Tomcat
2.60 Apache Tomcat 9.0.43
2.64 Apache Tomcat 9.0.65
2.67+ Apache Tomcat 9.0.69

Para fazer a atualização do Tomcat, os comandos abaixo deverão ser executados por um usuário com permissões administrativas no servidor.

Parando o servido do Tomcat e criando uma variáveis de ambiente para facilitar o processo de atualização:

systemctl stop tomcat9.service
sudo export DIR_TOMCAT = "/var/lib/tomcat9/"
sudo export BKP_TOMCAT = "/var/lib/tomcat9_bkp/"
sudo export ATT_TOMCAT = "<versão a ser instalada>"

Renomeando diretório do Tomcat antigo para ficar como backup:

mv $DIR_TOMCAT $BKP_TOMCAT

Faça o download dos binários da nova versão do Tomcat:

cd /tmp
wget https://archive.apache.org/dist/tomcat/tomcat-9/v$ATT_TOMCAT/bin/apache-tomcat-$ATT_TOMCAT.zip -O tomcat$ATT_TOMCAT.zip

Descompacte o arquivo baixado e manipule os arquivos executando os comandos abaixo:

unzip tomcat$ATT_TOMCAT.zip
sudo mv apache-tomcat$ATT_TOMCAT/ tomcat9
sudo mv tomcat9/ /var/lib
cd /$DIR_TOMCAT/webapps/
sudo rm -rf *

Transfira os arquivos da aplicação do Tomcat antigo para o atual:

sudo cp $BKP_TOMCAT/webapps/*.war .
sudo cp -r $BKP_TOMCAT/webapps/mensageria .
sudo cp -r $BKP_TOMCAT/webapps/conf .
sudo mkdir -p $DIR_TOMCAT/conf/Catalina/localhost
sudo cp $BKP_TOMCAT/conf/Catalina/localhost/rewrite.config $DIR_TOMCAT/conf/Catalina/localhost
cd $DIR_TOMCAT/conf
sudo mv context.xml context_bkp.xml
sudo cp $BKP_TOMCAT/conf/context.xml .
sudo mv server.xml server_bak.xml
sudo cp $BKP_TOMCAT/conf/server.xml .
sudo mv web.xml web_bak.xml
sudo cp $BKP_TOMCAT/conf/web.xml .

Se o Tomcat estiver com a configuração de contexto, execute o comando abaixo para transferir os arquivos referentes ao Quality Manager:

sudo cp -r $BKP_TOMCAT/apps/ $DIR_TOMCAT
sudo cp $BKP_TOMCAT/conf/Catalina/localhost/ROOT.xml $DIR_TOMCAT/conf/Catalina/localhost

Caso o Portal do Titular esteja configurado no mesmo servidor que o Quality Manager, transfira também os arquivos de configurações que estão no Tomcat antigo para o atual:

sudo cp $BKP_TOMCAT/conf/configPortal.* $DIR_TOMCAT/conf

Altere as permissões no diretório do Tomcat atualizado e inicie o serviço:

cd $DIR_TOMCAT
chown -R tomcat:tomcat *
chmod -R 755 *
systemctl start tomcat9.service

Obs:

  • Alguns clientes possuem o banco de dados do Quality Manager hospedado em outro servidor. Neste caso, será necessário copiar o arquivo qm.app.properties para o Tomcat atualizado utilizando o comando abaixo:
sudo cp $BKP_TOMCAT/lib/qm.app.properties $DIR_TOMCAT/lib/
sudo chown -R tomcat:tomcat $DIR_TOMCAT/lib/qm.app.properties
  • Para instalações que possuem a configuração HTTPS habilitada e o certificado esteja hospedado dentro da pasta do Tomcat, este certificado deverá ser copiado para o Tomcat atualizado:

Exemplo: 

sudo cp $BKP_TOMCAT/conf/certificado.jks $DIR_TOMCAT/conf/