En esta guía se detallarán los pasos para realizar una actualización del servidor de aplicaciones Tomcat de Thuban para entornos Windows como Linux. Para la misma se asumirán lo siguientes puntos:

  1. Se utiliza como servidor de aplicaciones Tomcat vigente entregado por Vivatia.

  2. La instalación actual de Thuban está realizada siguiendo los lineamientos de instalación del árticulo Nueva Instalación de Thuban.

  3. Cuentas con los permisos de administración necesarios en el Sistema Operativo.

Para solicitar una versión actualización del Apache Tomcat para Thuban deberán solicitarlo ingresando al Portal de Soporte de Clientes o bien al Portal de Servicios Internos según corresponda.

Actualización en ambiente Windows

Para la actualización en un ambiente Windows se deberán seguir los siguientes pasos:

Paso 1

Abrir el panel de servicios de Windows, allí localizar el servicio de Thuban.

Seleccionarlo y hacer click en “Detener”.

Paso 2

Dirigirse a la carpeta de instalación de Thuban y realizar un backup de la carpeta “server” renombrándola a “server_fecha_backup”.

Por ejemplo:

Ir a C:\AplicacionesJ2EE\Thuban\appserver

Y renombrar la carpeta server a server_20210125_backup.

En caso de que la nueva versión de Tomcat requiera también de una nueva versión de java. Realizar el mismo backup hecho con la carpeta server con la carpeta “java” que se encuentra en la misma ubicación.

Paso 3

Descomprimir el paquete de actualización entregado por Vivatia en la carpeta de instalación de Thuban. En caso de que la carpeta no se llame server, renombrar la misma a server.

En caso de que el paquete incluya una nueva versión de java, asegurarse que la carpeta de la misma se llame “java” y se encuentre en el mismo directorio que la carpeta “server”.

Ejemplo de como debería de quedar la carpeta:

Paso 4

Dirigirse dentro de la carpeta server a la carpeta “conf” y abrir el archivo server.xml.

Por ejemplo: C:\AplicacionesJ2EE\Thuban\appserver\server\conf

En el mismo editar el puerto de “Shutdown” y el “conector http” ingresando los mismos datos que tenía el archivo “server.xml” de la carpeta server anterior.

Puerto Shutdown

<Server port="8005" shutdown="SHUTDOWN">

Conector http

<Connector port="8080" protocol="HTTP/1.1"
      connectionTimeout="20000"
      redirectPort="8443" />

Paso 5

Dirigirse dentro de la carpeta server a la carpeta “bin”, por ejemplo: C:\AplicacionesJ2EE\Thuban\appserver\server\bin.

Aquí debemos buscar los archivos llamados “tomcat8.exe” y “tomcat8w.exe” o similar dependiendo de la versión de Tomcat. Seleccionarlos, copiarlos y pegarlos en la misma carpeta. Tomar los nuevos archivos y renombrarlos con el nombre del servicio de Thuban que vamos a instalar. Por ejemplo: “Thuban.exe” y “Thubanw.exe”.

Paso 6

Dentro de la misma carpeta bin, ubicar el archivo “InstallTomcatV3.bat” y abrirlo en el editor de texto de preferencia.

En el mismo se deben editar las siguientes propiedades:

  • THUBAN_NAME → Este es el nombre del .exe (no del w) del “Paso 5”.

  • THUBAN_HOME → Es el Directorio de la carpeta donde está la instalación raíz de Thuban.

Una vez modificados estos valores guardar los cambios y cerrar el archivo.

Ejemplo del archivo completo:

@echo off
SETLOCAL
REM en esta variable de entorno poner elo nombre del ejecutable con extencion
REM El nombre del ejecutable solo pude tener caractes del tipo A-Za-z0-9 sino da error de Apha45

SET THUBAN_NAME=Thuban.exe

REM en esta variable poner el ROOT de la instancia con barras invertidas 

SET THUBAN_HOME=C:\AplicacionesJ2EE\Thuban


@ECHO Estas son las variables definidas
@ECHO ---------------------------------
@ECHO %THUBAN_NAME%
@ECHO %THUBAN_NAME:~0,-4%
@ECHO %THUBAN_HOME%
pause
%THUBAN_NAME%//IS//%THUBAN_NAME:~0,-4% --DisplayName=%THUBAN_NAME:~0,-4% --Description=Servidor_de_aplicaciones_para_Thuban --StartClass org.apache.catalina.startup.Bootstrap --StopClass org.apache.catalina.startup.Bootstrap --StartParams start --Startup=manual
%THUBAN_NAME%//US//%THUBAN_NAME:~0,-4% --StartMode=jvm --StopParams stop --StopMode=jvm --Jvm=%THUBAN_HOME%\appserver\java\bin\server\jvm.dll --Classpath=%THUBAN_HOME%\appserver\Server\bin\bootstrap.jar;%THUBAN_HOME%\appserver\Server\lib\tomcat-juli.jar --JvmMs=512 --JvmMx=1024 --LogPath=%THUBAN_HOME%\appserver\Server\logs --StdOutput=%THUBAN_HOME%\appserver\Server\logs\console.log --LogLevel=error
%THUBAN_NAME%//US//%THUBAN_NAME:~0,-4% --JvmOptions=-Dcatalina.home=%THUBAN_HOME%\appserver\Server;-Dcatalina.base=%THUBAN_HOME%\appserver\Server;-Djava.endorsed.dirs=%THUBAN_HOME%\appserver\Server\common\endorsed;-Duser.timezone=GMT-03:00;-Dthuban.context=%THUBAN_HOME%\config\context\;-Dthuban.security=%THUBAN_HOME%\config\security\;-Djava.io.tmpdir=%THUBAN_HOME%\appserver\Server\temp;-Duser.language=en;-XX:+UseConcMarkSweepGC;-XX:+CMSParallelRemarkEnabled;-XX:+UseCMSInitiatingOccupancyOnly;-XX:CMSInitiatingOccupancyFraction=70;-XX:+ScavengeBeforeFullGC;-XX:+CMSScavengeBeforeRemark;-XX:+PrintGCDateStamps;-verbose:gc;-XX:+PrintGCDetails;-Xloggc:%THUBAN_HOME%\appserver\Server\logs\logsGC\thubangc.log;-XX:+UseGCLogFileRotation;-XX:NumberOfGCLogFiles=10;-XX:GCLogFileSize=100M;-Dsun.net.inetaddr.ttl=60;-XX:+HeapDumpOnOutOfMemoryError;-XX:HeapDumpPath=%THUBAN_HOME%\appserver\Server\logs\memDumps\`date`.hpr

Paso 7

Ir a la carpeta webapps de la carpeta “server” antigua (en el ejemplo: server_20210125_backup) y copiar el archivo “thuban-web.war”.

Dirigirse a la carpeta webapps de la nueva instalación en server\webapps y pegar el archivo “thuban-web.war” recién copiado.

Paso 8

Abrir un “CMD” de Windows como Administrador.

Dentro del cmd escribir el comando que se encuentra en la columna de la derecha -->

Reemplazando [NombreServicioThuban] con el nombre del servicio de Thuban existente. Por ejemplo -->

Si la ejecución es exitosa, el servicio existente de Thuban ha sido eliminado como servicio de Windows.

sc.exe delete [NombreServicioThuban]

sc.exe delete Thuban

La ejecución de este comando no elimina archivos ni carpetas, solo la configuración como servicio de Thuban.

Paso 9

Dentro del cmd que abrimos en el paso 8, dirigirse a la carpeta bin del servidor de aplicaciones nuevo. Ej:

cd C:\AplicacionesJ2EE\Thuban\appserver\server\bin

y allí ejecutar el bat “InstallTomcatV3.bat”

Si ves un resultado como este entonces habrás instalado correctamente el servicio de Thuban.

Paso 10

Dirigirse al panel de servicios de Windows y localizar el servicio creado en el Paso 9.

Seleccionarlo y hacer click en iniciar.

note

Verificar en el log de la aplicación que haya iniciado correctamente. Ej: C:\AplicacionesJ2EE\Thuban\appserver\server\logs

Abrir el archivo console.log

Verificar en el log de la aplicación que haya iniciado correctamente. Ej: C:\AplicacionesJ2EE\Thuban\appserver\server\logs

Abrir el archivo console.log

De no encontrar errores en el log, Thuban ya está funcionando y accesible desde un navegador web.

El servidor Tomcat ya se encuentra actualizado y ejecutando Thuban normalmente. Algunas cosas a recordar:

  • Restaurar cualquier configuración custom que se haya hecho al servicio, por ejemplo la ejecución del mismo con una cuenta de usuario determinada.

  • Si tenía la configuración por https, copiar del resguardo o del java la información del certificado digital y en el Paso 4 restaurar el conector https que ya estaba configurado en el server anterior.

  • Verifica que el servicio este configurado para ejecución automática, así, en caso de reinicio el mismo iniciará automáticamente.

note

Pasado un tiempo prudencial desde la instalación de la nueva versión del Apache Tomcat y viendo que todo funciona correctamente, se puede proceder a eliminar el backup de la instalación anterior.

Pasado un tiempo prudencial desde la instalación de la nueva versión del Apache Tomcat y viendo que todo funciona correctamente, se puede proceder a eliminar el backup de la instalación anterior.

Si el Firewall de Windows se encuentra activo, es posible que necesites crear una regla de entrada para que otros se puedan conectar a Thuban desde el navegador. Consulta el siguiente articulo para ver cómo hacerlo: Thuban está levantado pero no llego desde mi PC

Actualización en ambiente Linux

Para la actualización en un ambiente Linux se deberán seguir los siguientes pasos:

Las instrucciones que aquí se despliegan fueron realizadas sobre un Linux de tipo Debian (por ejemplo: Ubuntu) sin embargo en el caso de un Linux de tipo RHEL deberían funcionar de la misma forma sin problemas. Todas las instrucciones se ejecutan por consola (“Terminal”).

Paso 1

Abrir una consola (Terminal) y detener la ejecución del servicio (demonio) de Thuban.

sudo systemctl stop [Nombre Servicio]

Por ejemplo:

sudo systemctl stop thuban

Paso 2

Dirigirse a la carpeta de instalación de Thuban y realizar un backup de la carpeta “server” ejecutando el siguiente comando -->

Reemplazando [Fecha] por la fecha del día y [CarpetaInstalación] por la carpeta donde se encuentra el Apache Tomcat actual -->

user@myLinux:[CarpetaInstalación]$ mv server server_[Fecha]_backup

Por ejemplo

user@myLinux:home$ cd /AplicacionesJ2EE/Thuban/appserver
user@myLinux:/AplicacionesJ2EE/Thuban/appserver$ mv server server_20210125_backup
user@myLinux:/AplicacionesJ2EE/Thuban/appserver$ ls
java server_20210125_backup

En caso de que la nueva instalación requiere de una nueva versión de java que haya sido incluida en el paquete de actualización, estos mismos comandos deben ser ejecutados sobre dicha carpeta de instalación de “java”.

Paso 3

Descomprimir el paquete de actualización entregado por Vivatia en la carpeta de instalación del servidor de aplicaciones de Thuban, donde se realizaron los backups del Paso 2

Siguiendo el ejemplo, el contenido de la carpeta debería verse así:

user@myLinux:/AplicacionesJ2EE/Thuban/appserver$ ls
java server server_20210125_backup

En caso de también actualizar la carpeta “java”, se vería así:

user@myLinux:/AplicacionesJ2EE/Thuban/appserver$ ls
java java_20210125_backup server server_20210125_backup

Paso 4

Le otorgamos al usuario que ejecuta Thuban los permisos necesarios sobre la nueva carpeta y subcarpetas del servidor de aplicaciones. Lo haremos ejecutando los siguientes comandos -->

En caso de que la nueva instalación requiere de una nueva versión de java que haya sido incluida en el paquete de actualización, estos mismos comandos deben ser ejecutados sobre dicha carpeta de instalación de “java”. Se podrían incluso simplificar ejecutándolos sobre la raíz del appserver que contiene a “java” y “server”.

Por ejemplo: /AplicacionesJ2EE/Thuban/appserver

Otorgamos los permisos de propietario a la carpeta de instalación de Thuban al grupo del Tomcat.

sudo chgrp -R [GRUPO] [CARPETA]

Siguiendo nuestro ejemplo quedaría así:

sudo chgrp -R tomcat /AplicacionesJ2EE/Thuban/appserver/server

Luego otorgamos los permisos de propietario al usuario del tomcat la nueva carpeta server.

sudo chown -R [USUARRIO] [CARPETA]

Siguiendo nuestro ejemplo, quedaría así:

sudo chown -R tomcat /AplicacionesJ2EE/Thuban/appserver/server

Finalmente le otorgamos los permisos generales a la nueva carpeta server de Thuban de modo que todo funcione correctamente. En este caso se asignan los permisos a nivel 755, es decir, lectura y ejecución para todos los usuarios y de escritura únicamente para el propietario de la carpeta.

sudo chmod -R 755 [CARPETA]

Siguiendo nuestro ejemplo, quedaría así:

sudo chmod -R 755 /AplicacionesJ2EE/Thuban/appserver/server

Paso 5

En la carpeta de de backup de la instalación anterior de Tomcat (por ej: server_20210125_backup), ingresamos a la carpeta bin y buscamos y copiamos el archivo “setenv.sh” a la nueva carpeta de instalación de Tomcat.

user@myLinux:[CarpetaInstalación]/[instalaciónVieja]/bin$ cp setenv.sh [NuevaUbicación]/bin/setenv.sh

Por ejemplo:

user@myLinux:home$ cd /AplicacionesJ2EE/Thuban/appserver/server/bin
user@myLinux:/AplicacionesJ2EE/Thuban/appserver/server/bin$ cp setenv.sh ../../server/bin/setenv.sh

Paso 6

Al igual que en el Paso 5, copiamos el archivo “thuban-web.war” de la carpeta webapps de la instalación antigua a la nueva.

user@myLinux:[CarpetaInstalación]/[instalaciónVieja]/webapps$ cp thuban-web.war [NuevaUbicación]/webapps/thuban-web.war

Por ejemplo:

user@myLinux:home$ cd /AplicacionesJ2EE/Thuban/appserver/server/webapps
user@myLinux:/AplicacionesJ2EE/Thuban/appserver/server/webapps$ cp webapps.war ../../server/webapps/thuban-web.war

Paso 7

Dirigirse a la carpeta “conf” de la nueva instalación del servidor de aplicaciones. En nuestro ejemplo seria /AplicacionesJ2EE/Thuban/appserver/server/conf. Allí ubicar y abrir el archivo server.xml

Se debe editar este archivo configurando los puertos “Shutdown” y “HttpConnector” reemplazando los valores por los que tenían en la instalación antigua en el mismo archivo.

Una vez modificados estos valores, guardar los cambios y cerrar el archivo.

note

Si en la instalación original estaba configurado el conector https en vez del http. Copiar dicha configuración en vez de la del ejemplo.

Si en la instalación original estaba configurado el conector https en vez del http. Copiar dicha configuración en vez de la del ejemplo.

Abrir el archivo ejecutando el siguiente comando:

sudo nano [CarpetaInstalación]/conf/server.xml

Por ejemplo:

sudo nano /AplicacionesJ2EE/Thuban/appserver/server/conf/server.xml

Editar los siguientes componentes:

Shutdown (Al principio del archivo)

<Server port="8005" shutdown="SHUTDOWN">

Conector http

<Connector port="8080" protocol="HTTP/1.1"
      connectionTimeout="20000"
      redirectPort="8443" />

Paso 8

Ahora únicamente resta iniciar el servicio de nuestro Thuban. Para ello ejecutamos el siguiente comando -->

El servicio ya existente sigue siendo válido en tanto y en cuanto se hayan mantenido los nombres y las rutas de la instalación original. Caso contrario se deberán hacer las modificaciones pertinentes al archivo descriptor del servicio (demonio)

sudo systemctl start [Nombre Servicio]

Que en nuestro ejemplo sería:

sudo systemctl start thuban

Paso 9

Verificamos que el servicio haya iniciado correctamente ejecutando el comando -->

Y verificamos los logs de la aplicación para ver que Thuban haya iniciado correctamente con el siguiente comando -->

systemctl status thuban
tail -f /AplicacionesJ2EE/Thuban/appserver/server/logs/console.log

Listo! Nuestro Thuban está listo para utilizarse.

note

Para detener el servicio de Thuban, utilizaríamos el siguiente comando:

sudo systemctl stop [NombreDelServicio]

Por ejemplo: sudo systemctl stop thuban

Y si queremos que el servicio arranque automáticamente al iniciar el sistema operativo, por ejemplo ante el evento de un reinicio, debemos ejecutar el siguiente comando:

sudo systemctl enable [NombreDelServicio]

Por ejemplo: udo systemctl enable thuban-prueba-2020

Para detener el servicio de Thuban, utilizaríamos el siguiente comando:

sudo systemctl stop [NombreDelServicio]

Por ejemplo: sudo systemctl stop thuban

Y si queremos que el servicio arranque automáticamente al iniciar el sistema operativo, por ejemplo ante el evento de un reinicio, debemos ejecutar el siguiente comando:

sudo systemctl enable [NombreDelServicio]

Por ejemplo: udo systemctl enable thuban-prueba-2020

note

Pasado un tiempo prudencial desde la instalación de la nueva versión del Apache Tomcat y viendo que todo funciona correctamente, se puede proceder a eliminar el backup de la instalación anterior. Esto se logra ejecutando el siguiente comando: (ATENCIÓN! Esta operación no se puede deshacer. proceder con cuidado)

rm -R [DirectorioInstalación]/[CarpetaDeBackup]

Por ejemplo:

rm -R /AplicacionesJ2EE/Thuban/appserver/server_20210525_backup/

Pasado un tiempo prudencial desde la instalación de la nueva versión del Apache Tomcat y viendo que todo funciona correctamente, se puede proceder a eliminar el backup de la instalación anterior. Esto se logra ejecutando el siguiente comando: (ATENCIÓN! Esta operación no se puede deshacer. proceder con cuidado)

rm -R [DirectorioInstalación]/[CarpetaDeBackup]

Por ejemplo:

rm -R /AplicacionesJ2EE/Thuban/appserver/server_20210525_backup/

Si el Linux sobre el cuál estas trabajando tiene el servicio de Firewall instalado y activo, es posible que necesites crear una regla de entrada para que otros se puedan conectar a Thuban desde el navegador. Consulta el siguiente articulo para ver cómo hacerlo: Thuban está levantado pero no llego desde mi PC

¿Qué hacer en caso de que falla la nueva instalación?

En caso de que la nueva instalación tenga problemas, se puede restaurar la versión anterior de la cuál hicimos el backup. Para ellos hay que seguir los siguientes pasos generales:

  1. Detener el servicio de Thuban

    1. En el caso de ser Windows, se debe eliminar el servicio (Ver Paso 8 de la guía sobre Windows)

  2. Eliminar la carpeta server (y java si también fue actualizada) de la nueva instalación

    1. En caso de Linux, esto se logra con el siguiente comando: rm -R [DirectorioInstalación]/appserver/server. Por ejemplo: rm -R /AplicacionesJ2EE/Thuban/appserver/server

  3. Renombrar la carpeta de backup a “server” (hacer lo mismo en caso de haber actualizado java)

    1. Para Windows renombrar la carpeta desde el explorador de Windows

    2. En el caso de linux, ejecutar el comando: mv [DirectorioInstalacion]/server_[Fecha]_backup [DirectorioInstalación]/server. Por ejemplo mv /AplicacionesJ2EE/Thuban/appserver/server_20210125_backup/ /AplicacionesJ2EE/Thuban/appserver/server/

  4. Volver a iniciar el servicio de Thuban.

    1. En el caso de Windows, se debe volver a crear dicho servicio, ver Paso 9 de la guía de Windows.

  5. Verificar que Thuban haya iniciado y funcione correctamente.

En caso de tener problemas que con la presente guía no puede resolver, por favor solicitar asistencia a través del Portal de Servicios Internos o del Portal de Soporte de Clientes según corresponda.

Artículos Relacionados