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.

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)

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

Conector http

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

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

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:

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

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.

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:

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:

<!-- 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:

<!-- 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”

Paso 10

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

Seleccionarlo y hacer click en iniciar.

Paso 1

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

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

Paso 2

Renombrar la carpeta “Thuban-Suite” al nombre deseado.

Paso 3

Es recomendado que el servidor de aplicaciones corra con un usuario propio sin privilegios por razones de seguridad. Para ellos debemos crear el grupo al que pertenecerá el usuario y el usuario propiamente dicho. Para ellos ejecutamos los comandos de la columna derecha -->

Creamos el grupo

sudo groupadd tomcat

Donde “tomcat” es el nombre del grupo.

Luego creamos el usuario, lo agregamos al grupo y establecemos su “Home”

sudo useradd -s /bin/false -g tomcat -d /opt/tomcat tomcat

Al usuario también lo llamamos “tomcat”. De querer llamarlo de otra forma se deben reemplazar la siguiente parte:

-d /opt/[NombreDesaeado] [NombreDeseado]

Por ejemplo:

sudo useradd -s /bin/false -g tomcat -d /opt/tomcatusr tomcatusr

Paso 4

Le otorgamos al usuario recién creado los permisos necesarios sobre las carpetas de instalación de Thuban. Lo haremos ejecutando los siguientes comandos -->

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-Prueba

Luego otorgamos los permisos de propietario al usuario del tomcat que creamos en el Paso 3 anterior sobre la carpeta de instalación de Thuban.

sudo chown -R [USUARRIO] [CARPETA]

Siguiendo nuestro ejemplo, quedaría así:

sudo chown -R tomcat /AplicacionesJ2EE/Thuban-Prueba

Finalmente le otorgamos los permisos generales a la carpeta de instalación 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-Prueba

Debemos asugurarnos también el el usuario pueda acceder a la carpeta raíz, es decir, a /AplicionesJ2EE, por ello sobre esa carpeta ejecutaremos también la instrucción anterior:

sudo chmod -R 755 /AplicacionesJ2EE

En este caso el usuario del Tomcat tendrá acceso de lectura y ejecución sobre /AplicacionesJ2EE pero no de escritura, ya que no es el propietario. Sin embargo sí las tendrá sobre la instalación en sí mismo en /AplicacionesJ2EE/Thuban-Prueba.

Paso 5

Dirigirse a la carpeta “conf” del servidor de aplicaciones. En nuestro ejemplo seria /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.

Abrir el archivo ejecutando el siguiente comando:

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

Por ejemplo:

sudo nano /AplicacionesJ2EE/Thuban-Prueba/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 6

Ahora vamos a crear un servicio de sistema para nuestro Thuban. De estar forma podremos iniciarlo y apagarlo como si de un servicio del sistema se tratase y también podremos indicarle que inicie el mismo al iniciar el sistema operativo.

Para ello es preciso generar un archivo llamado systemd Service File dentro de una ubicación del sistema operativo. Para ejemplo ejecutamos los siguientes comandos -->

Creamos el archivo en el directorio de servicios del sistema de la siguiente forma:

sudo nano /etc/systemd/system/[NombreDelServicio].service

Donde [NombreDelServicio] es el nombre de nuestra instalación de Thuban. Siguiendo nuestro ejemplo sería:

sudo nano /etc/systemd/system/thuban-prueba-8080.service

Esto nos desplegará una pantalla vacía con unos comandos en la parte inferior:

Aquí copiar y pegar lo siguiente:

[Unit]
Description=[Descripción]
After=syslog.target network.target

[Service]
User=[UsuarioTomcat]
Group=[GrupoTomcat]
Type=forking
Environment=JAVA_HOME=[Directorio de Instalación de Java]
Environment=CATALINA_PID=[PID del Tomcat a instalar]
Environment=CATALINA_HOME=[Directorio Raíz de Tomcat]
Environment=CATALINA_BASE=[Directorio Base del Tomcat]
ExecStart=[Script de inicio del Tomcat]
ExecStop=[Script de detención del Tomcat]
Restart=on-failure

[Install]
WantedBy=multi-user.target

Aquí debemos completar una serie de información propia de nuestra instalación del Tomcat. Serían los siguiente:

• [Descripción] → Descripción de nuestro servicio. Para poder identificarlo.

• [UsuarioTomcat] → El usuario que ejecutará el tomcat que creamos en el Paso 3

• [GrupoTomcat] → El grupo de usuario del Tomcat del Paso 3

• [Directorio de Instalación de Java] → El directorio donde está la instalación de Java a utilizar. (Incluida con el paquete de instalación)

• [PID del Tomcat a instalar] → Archivo de control del proceso de tomcat. Indicar la ruta y el nombre que tendrá.

• [Directorio Raíz de Tomcat] → Directorio raíz del servidor de aplicaciones.

• [Directorio Base del Tomcat] → Igual al Directorio Raíz del Tomcat.

• [Script de inicio del Tomcat] → Ruta completa al archivo de startup del tomcat.

• [Script de detención del Tomcat] → Ruta completa al archivo de shutdown del tomcat.

Siguiendo nuestro ejemplo, debería quedar así:

[Unit]
Description=Thuban Prueba 8080
After=syslog.target network.target

[Service]
User=tomcat
Group=tomcat
Type=forking
Environment=JAVA_HOME=/AplicacionesJ2EE/Thuban-Prueba/appserver/java
Environment=CATALINA_PID=/AplicacionesJ2EE/Thuban-Prueba/appserver/server/tomcat.pid
Environment=CATALINA_HOME=/AplicacionesJ2EE/Thuban-Prueba/appserver/server
Environment=CATALINA_BASE=/AplicacionesJ2EE/Thuban-Prueba/appserver/server
ExecStart=/AplicacionesJ2EE/Thuban-Prueba/appserver/server/bin/startup.sh
ExecStop=/AplicacionesJ2EE/Thuban-Prueba/appserver/server/bin/shutdown.sh
Restart=on-failure

[Install]
WantedBy=multi-user.target

Finalmente presionamos ctrl + O para guardar los cambios y ctrl + X para salir del archivo.

Finalmente ejecutamos el siguiente comando para que el sistema reconozco el nuevo servicio:

sudo systemctl daemon-reload

Paso 7

En el archivo .service del Paso 5 también se podrían definir las opciones de Java que requiere Thuban para iniciar. Sin embargo es más prolijo y seguro hacerlo con la creación de un archivo de tipo bash que es invocado automáticamente por el script de ejecución. El mismo viene dentro del paquete de instalación pero en caso de no existir se lo puede crear con cualquier editor de texto y dejarlo en la carpeta “bin” del servidor de aplicación. En nuestro ejemplo sería: /AplicacionesJ2EE/Thuban-Prueba/appserver/server/bin

Abrimos o creamos el archivo setenv.sh, el mismo debe contener la siguiente información:

export CATALINA_OPTS="$CATALINA_OPTS -Dthuban.context=[CarpetaContext]"
export CATALINA_OPTS="$CATALINA_OPTS -Dthuban.security=[CarpetaSecurity]"

Donde se deben reemplazar las variables:

• [CarpetaContext] → Por la ruta a la carpeta Context de Thuban

• [CarpetaSecurity] → Por la ruta a la carpeta Security de Thuban.

Siguiendo nuestro ejemplo, quedaría así:

export CATALINA_OPTS="$CATALINA_OPTS -Dthuban.context=/AplicacionesJ2EE/Thuban-Prueba/config/Context/"
export CATALINA_OPTS="$CATALINA_OPTS -Dthuban.security=/AplicacionesJ2EE/Thuban-Prueba/config/Security/"

Paso 8

Dirigirse a la carpeta Context de Thuban y allí ubicar y abrir, en el editor de texto de preferencia, el archivo “context.properties”. Ej: /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:

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

Donde:

• 192.168.0.20 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.

Paso 9

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

Allí se deben configurar las siguientes propiedades:

• jdbc.username

• jdbc.password

Guardar los cambios y cerrar el archivo.

Ejemplo:

jdbc.username=thuban
jdbc.password=passThuban

Paso 10

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: /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:

<!-- 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:

<!-- 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 11

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

sudo systemctl start [Nombre Servicio]

Que en nuestro ejemplo sería:

sudo systemctl start thuban-prueba-8080

Paso 12

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