MANUAL BASICO DE JBOSS

El objetivo de este manual es explicar breve y básicamente la estructura de este servidor de aplicaciones.

Hay que aclarar que esta descripción es igual para Linux que para Windows.

El Jboss escucha por defecto en el puerto 8080.

El servidor de aplicaciones Jboss es libre y puede descargarse de la pagina oficial de la comunidad

http://www.jboss.org/community

Una vez descargado y descomprimido o instalado, analizaremos los directorios mas importantes.

Bajo la carpeta principal JBOSSX.X.X, se crearan los siguientes directorios

• BIN

• CLIENT

• LIB

• LICENSES

• SCRIPT

• SERVER

Los que mas usaremos serán BIN y SERVER. En ellos se alojarán los archivos ejecutables y nuestras aplicaciones, respectivamente.

EL DIRECTORIO BIN

Aquí se encuentran los ejecutables y los ficheros de configuración de la aplicación.

Los más importantes son:

• JBOSS_INIT_REDHAT y JBOSS_INIT_SUSE: son scripts muy básicos para convertir nuestro Jboss en un daemon (servicio). Estos ficheros son exclusivos de Linux y sirven (como su nombre indica) para distros RedHat o Suse respectivamente.

• RUN.BAT: Es el ejecutable por excelencia. Sirve para levantar nuestro Jboss en Windows.

Este fichero se puede editar (como todos los punto BAT) para modificar la ubicación de nuestra maquina JAVA por ejemplo. Otra linea para modificar muy importante es la siguiente:

set JAVA_OPTS=%JAVA_OPTS% -Xms128m -Xmx512m -server -XX +UseConcMarkSweepGC -Dsun.rmi.dgc.client.gcInterval=3600000 -Dsun.rmi.dgc.server.gcInterval=3600000

En esta linea, podemos configurar cuanta memoria reservaremos para el servidor. -Xms indicara el valor mínimo. -Xmx, el máximo.

• RUN.SH: es el ejecutable por excelencia, pero de los sistemas Linux. Sirve para levantar nuestro Jboss. A diferencia de Windows, en este archivo no se puede modificar la cantidad reservada de memoria para la aplicación. Este archivo apunta a otro para coger la configuración. Este archivo se llama RUN.CONF

• RUN.CONF: este archivo contiene las opciones de las que leerá el RUN.SH para arrancar Jboss. Es exclusivo de Linux.

• RUN.JAR: es el ejecutable para Java.

• SHUTDOWN.BAT: Sirve para detener nuestro servidor Jboss en Windows.

• SHUTDOWN.SH: Sirve para detener nuestro servidor Jboss en Linux.

Si no hay errores, al ejecutar RUN.BAT (Windows) o RUN.SH (Linux) podremos acceder al Jboss, poniendo en un navegador la dirección IP donde esta instalado el servidor con el puerto 8080.

Por ejemplo http://localhost:8080. Si todo es correcto aparecerá la siguiente pantalla:

EL DIRECTORIO SERVER

Para empezar nos encontraremos con 3 carpetas (MINIMAL, ALL, DEFAULT) cada carpeta cargara mas o menos servicios al ejecutar el Jboss. Cuanto mas servicios por defecto mas memoria consumirá nuestro servidor de aplicaciones.

La parte que explicaremos es la de DEFAULT, aunque también es valida para las otras 2 opciones.

Dentro de la carpeta DEFAULT, encontraremos los siguientes directorios:

• CONF

• DEPLOY: Este directorio es el mas importante, ya que ahí se alojara nuestra aplicación. Esta puede ser un archivo .WAR, .SAR, etc. El Jboss cargará todas las aplicaciones que copiemos aquí.

• LIB: las librerías del Jboss.

• LOG: aquí se encuentran dos archivos.

1. BOOT.LOG: Es un archivo de texto plano, donde registra todas las incidencias producidas al inicio del Jboss.

2. SERVER.LOG: Es un archivo de texto plano, donde registra todas las incidencias producidas por el servidor de aplicaciones, incluido los errores producidos por nuestra aplicación. Este fichero “rota” diariamente generando ficheros con el siguiente formato server.log.2009-x-x con los logs de días anteriores. Hay que controlar estos archivos, ya que suelen ser muy pesados y si no los borramos pueden saturar en pocos días nuestro disco duro.

• TMP: archivos temporales.

• WORK: mas archivos temporales.

~ por chavodie en 23/07/2009.