Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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)

Code Block
languagexml
<Server port="8005" shutdown="SHUTDOWN">

Conector http

Code Block
languagexml
<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
languagetext
@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
languagetext
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 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
languagetext
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
languagexml
<!-- 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
languagexml
<!-- 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.

...

Filter by label (Content by label)
showLabelsfalse
cqllabel in ( "how-to" , "thubanweb" ) and space = currentSpace ( ) and title ! ~ "\"Nueva Instalación de Thuban\""

...