Paso 1Descomprimir 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 2Renombrar la carpeta Thuban-Suite al nombre deseado. Por ej: Thuban-Prueba | 
|
Paso 3Dirigirse 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 |
---|
| <Server port="8005" shutdown="SHUTDOWN"> |
Conector http Code Block |
---|
| <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 4Dirigirse 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 5Dentro 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: Una vez modificados estos valores guardar los cambios y cerrar el archivo. | Ejemplo del archivo completo: Code Block |
---|
| @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 6Dirigirse 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 |
---|
| 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. |
|
Paso 7Dirigirse 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 |
---|
| jdbc.username=thuban
jdbc.password=passThuban |
|
Paso 8Opcionalmente 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 |
---|
| <!-- 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 |
---|
| <!-- 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 9Abrir 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 10Dirigirse 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. |
|