...
Servidor de aplicaciones
Java
Carpertas y archivos de configuración de Thuban
Carpeta Context (dentro están los archivos de configuración propios de Thuban)
Carpeta Security (archivo de accesos de seguridad)
Carpeta vacía para el almacenamiento de las imágenes (Uso opcional)
War de Thuban
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)
Conector http
| ||||||||||||
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.
| |||||||||||||
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:
| ||||||||||||
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:
Una vez modificado el archivo, guardar y cerrarlo. | Ejemplo de configuración para SQL Server:
Donde:
| ||||||||||||
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:
Guardar los cambios y cerrar el archivo. | Ejemplo:
| ||||||||||||
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:
En caso de no estar, agramarlo. Luego configurarlo con el equipo deseado, por ejemplo:
| ||||||||||||
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”
|
| ||||||||||||
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
|
Info |
---|
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 |
Instalación en ambiente Linux
...
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.
Paso 1Descomprimir 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 2Renombrar la carpeta “Thuban-Suite” al nombre deseado. |
| ||||||||||||||||||||||||||||||||
Paso 3Es 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
Donde “tomcat” es el nombre del grupo. Luego creamos el usuario, lo agregamos al grupo y establecemos su “Home”
Al usuario también lo llamamos “tomcat”. De querer llamarlo de otra forma se deben reemplazar la siguiente parte:
Por ejemplo:
| ||||||||||||||||||||||||||||||||
Paso 4Le 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.
Siguiendo nuestro ejemplo quedaría así:
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.
Siguiendo nuestro ejemplo, quedaría así:
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.
Siguiendo nuestro ejemplo, quedaría así:
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:
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 5Dirigirse 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:
Por ejemplo:
Editar los siguientes componentes: Shutdown (Al principio del archivo)
Conector http
| ||||||||||||||||||||||||||||||||
Paso 6Ahora 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:
Donde [NombreDelServicio] es el nombre de nuestra instalación de Thuban. Siguiendo nuestro ejemplo sería:
Esto nos desplegará una pantalla vacía con unos comandos en la parte inferior: Aquí copiar y pegar lo siguiente:
Aquí debemos completar una serie de información propia de nuestra instalación del Tomcat. Serían los siguiente:
Siguiendo nuestro ejemplo, debería quedar así:
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:
| ||||||||||||||||||||||||||||||||
Paso 7En 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:
Donde se deben reemplazar las variables:
Siguiendo nuestro ejemplo, quedaría así:
En este mismo archivo se pueden poner cualquier otra variable que sea necesario pasarle a la JVM de Thuban. Por ejemplo, para bases Oracle, el país e idioma el motor de destino: export CATALINA_OPTS="$CATALINA_OPTS -Duser.language=en" | ||||||||||||||||||||||||||||||||
Paso 8Dirigirse 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:
Una vez modificado el archivo, guardar y cerrarlo. | Ejemplo de configuración para SQL Server:
Donde:
| ||||||||||||||||||||||||||||||||
Paso 9Dirigirse 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:
Guardar los cambios y cerrar el archivo. | Ejemplo:
| ||||||||||||||||||||||||||||||||
Paso 10Opcionalmente 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:
En caso de no estar, agramarlo. Luego configurarlo con el equipo deseado, por ejemplo:
| ||||||||||||||||||||||||||||||||
Paso 11Ahora únicamente resta iniciar el servicio de nuestro Thuban. Para ello ejecutamos el siguiente comando --> |
Que en nuestro ejemplo sería:
| ||||||||||||||||||||||||||||||||
Paso 12Verificamos 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 --> |
|
Para detener el servicio de Thuban, utilizaríamos el siguiente comando:
sudo systemctl stop [NombreDelServicio]
Por ejemplo: sudo systemctl stop thuban-prueba-8080
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-8080
Info |
---|
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 |
Configurar Thuban sobre HTTPS (Apache Tomcat)
...