Content Comparison

En esta guía se detallarán los pasos para realizar una nueva instalación de Thuban Web tanto para entornos Windows como Linux. Para la misma se asumirán lo siguientes puntos:

El motor de base de datos y la base de datos para Thuban ya se encuentran disponibles.
Se utiliza como servidor de aplicaciones el conjunto entregado por Vivatia que consta de:
1. Apache Tomcat (con archivo de instalación en el caso de MS Windows)
2. instalación portable de Java para uso exclusivo de Thuban.
Cuentas con los permisos de administración necesarios en el Sistema Operativo.

Table of Contents

maxLevel	2

...

Paso 1

Descomprimir el paquete de instalación en la carpeta deseada para la misma. Ej: C:\AplicacionesJ2EE.

Debería de quedar una carpeta Llamada Thuban-Suite que dentro contiene todos los elementos antes mencionados.

Info
Si dentro de appserver hay dos carpetas java, elegir una y renombrarla como java

Paso 2

Renombrar la carpeta Thuban-Suite al nombre deseado. Por ej: Thuban-Prueba

Paso 3

Dirigirse a la carpeta “conf” del servidor de aplicaciones. En nuestro ejemplo seria C:\AplicacionesJ2EE\Thuban-Prueba\appserver\server\conf. Allí ubicar y abrir el archivo server.xml

Se deben seleccionar los puertos a utilizar para “Shutdown” y “HttpConnector” reemplazando los valores por los elegidos. En nuestro ejemplo 8005 y 8080.

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

Shutdown (Al principio del archivo)

Code Block

language	xml

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

Conector http

Code Block

language	xml

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

Note
Verificar que los números de puertos seleccionados no se encuentren actualmente en uso por otra aplicación o instalación de Thuban.

Paso 4

Dirigirse a la carpeta “bin” del servidor de aplicaciones, por ejemplo: C:\AplicacionesJ2EE\Thuban-Prueba\appserver\server\bin.

Aquí debemos buscar los archivos llamados “tomcat8.exe” y “tomcat8w.exe”. 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: “ThubanPrueba8080.exe” y “ThubanPrueba8080w.exe”.

Notar que se le agrego al nombre el puerto http configurado en el Paso 3. Esto es para identificar fácilmente en qué puerto está escuchando la aplicación. Puede no agregarse y dejarlo simplemente con el nombre.

Note
Es muy importante que el nombre no contenga caracteres especiales y asegurarse que en el caso de “w” se mantenga la w en minúsculas y antes del .exe. Ej: ThubanPruebaw.exe

Paso 5

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 4”.
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:

Code Block

language	text

@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=ThubanPrueba.exe

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

SET THUBAN_HOME=C:\AplicacionesJ2EE\Thuban-Prueba


@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 6

Dirigirse a la carpeta Context de Thuban y allí ubicar y abrir, en el editor de texto de preferencia, el archivo “context.properties”. Ej: C:\AplicacionesJ2EE\Thuban-Prueba\config\Context”

Allí se debe configurar la conexión a la base de datos. Para ello se deben configurar las siguientes propiedades:

hibernate.dialect → Dialecto de la base de datos
jdbc.driverClassName → Driver de conexión a la base de datos
jdbc.url → String de conexión a la base de datos

Una vez modificado el archivo, guardar y cerrarlo.

Ejemplo de configuración para SQL Server:

Code Block

language	text

hibernate.dialect=org.hibernate.dialect.SQLServerDialect
jdbc.driverClassName= net.sourceforge.jtds.jdbc.Driver
jdbc.url= jdbc:jtds:sqlserver://127.0.0.1:1433/THUBAN_PRUEBA;sendStringParametersAsUnicode=false

Donde:

127.0.0.1 es la IP del servidor donde está la base de datos.
1433 es el puerto donde escucha por conexiones la base de datos
THUBAN_PRUEBA es el nombre de la base de datos.

Info
Ejemplos de configuración para otros motores de base de datos al final del articulo.

Warning
Si no funciona la conexion porque hay multiples instancias de servidor SQL revisar el siguiente link: Armado de connection string para SQL con multiples instancias

Paso 7

Dirigirse a la carpeta Security de Thuban y allí ubicar y abrir el archivo “security.properties”. Ej: C:\AplicacionesJ2EE\Thuban-Prueba\config\Security.

Allí se deben configurar las siguientes propiedades:

jdbc.username
jdbc.password

Guardar los cambios y cerrar el archivo.

Ejemplo:

Code Block

language	text

jdbc.username=thuban
jdbc.password=passThuban

Paso 8

Opcionalmente se podría configurar a Thuban para que al arrancar inicie el motor de tareas programas (Scheduler) para tener acceso a la configuración de procesos Batch. Si esto no es de interés, ir al Paso 9.

Dirigirse a la carpeta Context de Thuban y allí ubicar y abrir, con el editor de xml de preferencia, el archivo “user-application-context.xml”. Ej: C:\AplicacionesJ2EE\Thuban-Prueba\config\Context.

En el mismo ubicar el “bean” llamado “schedulerHosts” y en el listado agregar la IP y/o nombre del equipo donde se está instalando Thuban.

Persistir los cambios y cerrar el archivo.

En general el paquete básico ya incluye este “bean” en el archivo listo para configurar de esta forma:

Code Block

language	xml

<!-- HABILITAR EL SCHEDULER -->
<bean id="schedulerHosts" class="java.util.ArrayList">
	<constructor-arg>
		<list>
			<value>IP/ServerName</value>
		</list>
	</constructor-arg>
</bean>

En caso de no estar, agramarlo. Luego configurarlo con el equipo deseado, por ejemplo:

Code Block

language	xml

<!-- HABILITAR EL SCHEDULER -->
<bean id="schedulerHosts" class="java.util.ArrayList">
	<constructor-arg>
		<list>
			<value>127.0.0.1</value>
			<value>MYPC</value>
		</list>
	</constructor-arg>
</bean>

Paso 9

Abrir un “CMD” de Windows como Administrador. Dentro del cmd dirigirse a la carpeta bin del servidor de aplicaciones. Ej:

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

y allí ejecutar el bat “InstallTomcatV3.bat”

Note
No ejecutar el .bat directamente haciendo doble click sobre el mismo. Eso no siempre funciona, aún ejecutándolo como administrador, y puede traer comportamiento extraños.

Tip
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.

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

Abrir el archivo console.log

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

...

Version	Old Version 21	New Version Current
Changes made by	Paula Abramovich	Leonardo Vazquez Conde
Saved on	Mar 17, 2022	Feb 28, 2023

Versions Compared

Key

Paso 1

Paso 2

Paso 3

Paso 4

Paso 5

Paso 6

Paso 7

Paso 8

Paso 9

Paso 10