Instalacrión de JBoss

Instalación de JBoss.

Fecha de creación: 16.09.2001

Revisión 1.0 (16.09.2001)

Enrique Ibáñez Alemany
enricia AT latinmail DOT com

Copyright (c) 2002, Enrique Ibáñez Alemany. Este documento puede ser distribuido solo bajo los términos y condiciones de la licencia de Documentación de javaHispano v1.0 o posterior (la última versión se encuentra en /licencias/).

Introducción

Este artículo tiene como motivo mostrar la instalación y ejecución del servidor J2EE JBoss. Ante todo hay que aclarar que el JBoss esencialmente es un servidor EJB, por eso su nombre inicial EJBoss a los inicios del proyecto, pero por la beneficiosa aportación de mucha gente se ha convertido en un servidor J2EE.

JBoss es completamente una aplicación Java, por eso es necesario que el JDK 1.3 o superior este instalado y también es conveniente que el subdirectorio '/bin' del JDK este en el PATH para que los ejecutables esten disponibles desde cualquier directorio sin necesidad de incluir la ruta completa. Es conveniente siempre que nosotros queramos iniciar el JBoss con los scripts de arranque que vienen en la distribución. Yo personalmente siempre los utilizo.

En este artículo se explica la instalación de la versión 2.4.0 del JBoss. Esta versión es la última, pero al menos (por conocimiento propio) este artículo seria perfectamente válido desde la versión 2.1 .

Ahora debemos procedecer a la descarga del JBoss. La distribución se presenta en un archivo comprimido '.zip' . En versiones anteriores también se podia encontrar en ficheros comprimidos con la extensión '.tar.gz' y 'tar.bz2'. En estas diferentes presentaciones solo cambia el sistema de compresión pues el contenido es el mismo.

Siempre podemos conseguir la última versión de JBoss desde su página en spurceforge [1], pero podemos ir también al sitio Web del JBoss [2], aqui podemos encontrar las versiones predecesoras en la sección DOWLOAD/Binary.

Nos daremos cuenta de que tenemos diferentes descargas, una de ellas es el JBoss solo ( entonces no es un J2EE ) , y otras dos, cada una de ellas con un servidor JSP/Servlets diferente; Tomcat y Jetty ( asi si que es un J2EE ). En estas descargas además del JBoss se incluye embemido el Tomcat o el Jetty , gestionando completamente el funcionamiento de estos productos(Tomcat/Jetty) el JBoss. Estas dos alternativas son válidas siempre que el servidor EJB (JBoss) y el servidor de JSP/Servlets (Tomcat o Jetty) esten en la misma máquina, pero si necesitamos que cada uno de ellos este en una máquina tendremos la necesidad de instalarlos por separado. También es posible instalar separados cada producto en la misma máquina y hacerlos colaborar. En fin hay varias posibilidades pero esto no es materia de este artículo, ya lo veremos en los próximos.

Volviendo a la descarga, como se ha dicho y según la versión que presentamos en este artículo elegiremos uno de los siguientes archivos:

• JBoss-2.4.0.zip
• JBoss-2.4.0_Tomcat-3.2.3.zip
• Boss-2.4.0_Tomcat-3.2.3.zip

Posibilidades de descarga.

Una vez descargado lo tenemos que descomprimir con nuestra herramienta favorita, ya sea 'gunzip' en sistemas Linux o 'WinZip' en sistemas Windows. Hay que prestar especial atención para conservar la estructura de directorios. El resultado es un directorio con el nombre del archivo sin la extensión del formato de compresión, en nuestro caso sin el '.zip'. Dentro de este directorio encontramos si hemos elegido solo el JBoss, pues la estructura de directorios del mismo y si el que hemos elegido es por ejemplo el que está acompañado con el Tomcat encontraremos un directorio '/jboss' y '/tomcat'.

Si hemos llegado aqui sin ningún problema, la parte de la instalación ya esta finalizada.

Siempre teniendo claro que nuestro JDK esta perfectamente instalado vamos a proceder a ejecutar el JBoss y por supuesto también el Tomcat o Jetty si hemos elegido alguna de estas alternativas. Para esto usaremos los scripts que vienen en la distribución, asi que nuestro PATH tiene que apuntar al directorio '/bin' del JDK. Como se comentó anteriormente existe la posibilidad de iniciar el JBoss sin necesidad de usar los scripts de arranque, esto es simplemente hacer lo que en el script se hace en varias líneas hacerlo solo en una, pero nosotros vamos a usar la forma más comun y sencilla. Para que hacerlo complicado si no es necesario ;-).

Ahora tenemos que situarnos en el subdirectorio '/bin' de la distribución del JBoss. En nuestro caso si hemos optado por instalar solo el JBoss en 'JBoss-2.4.0/bin' si por el contrario hemos elegido una de las distribuciones con el Tomcat o el Jetty será en 'JBoss-2.4.0/jboss/bin'.

Primero vamos a chequear que nuestra instalación del JDK es correcta. Asi que escribimos:

java -version

El resultado tiene que ser un mensaje que nos informe de la versión del Java instalado en nuestro sistema. Como se comentó al inicio del artículo esta debe ser 1.3 o superior.

Llegado aqui solo nos queda iniciar el servidor JBoss. Escribimos... en windows...

...solo el JBoss

run.bat

El JBoss y (Tomcat/Jetty)run_with_tomcat.bat
---o---
run_with_jetty.bat

... y en Linux ...solo el JBoss

run.sh

El JBoss y (Tomcat/Jetty)run_with_tomcat.sn
---o---
run_with_jetty.sh

El JBoss mientras arranca informa por consola de los servicios que está iniciando. A continuación se muestra un pequeño extracto de la salida por consola al final del arranque:

...
[MailService] Mail Service 'Mail' bound
[MailService] Started
[Service Control] Started 28 services
[Default] JBoss 2.4.0 Started in 0m:21s

Esta salida por consola corresponde a la versión 2.4.0 del JBoss con el Tomcat. Cuando se ejecuta el JBoss únicamente en la misma versión se inician 27 servicios asi que no hay que hacer mucho caso al número de servicios de las diferentes versiones.

Si se produce algún error nos daremos cuenta pues se lanza una excepción y se muestra por consola la traza. De todas formas si vemos que el JBoss continua hasta mostrar el mensaje de que se ha arrancado en x segundos, es que se ha iniciado satisfactoriamente. Esto suele pasar cuando nos descargamos una versión con un servidor JSP/Servlet y arrancamos solo el JBoss. En este caso se lanzará una excepción pues en estas distribuciones se incluye en el directorio 'JBoss-2.4.0/jboss/deploy' una aplicación ('.ear') que tiene parte Web y como no dispone de un servidor JSP/Servlet no puede desplegar la parte web. Con mover este archivo a otro directorio.(Mejor que sea fuera de la distribución del JBoss) ya funcionará.

Conclusión

Aunque el artículo es un poco extenso, simplemente la instalación del JBoss se reduce a dos pasos, descargar y descomprimir. Y la ejecución a una sola, llamar al script apropiado. En próximos capítulos veremos como desplegar EJB's y nos adentraremos más en la configuración de este fenomenal servidor J2EE.

Recursos

[1] JBoss en sourceforge,
http://sourceforge.net/projects/jboss/

[2] Web de JBoss,
http://www.jboss.org

Acerca del autor

Enrique Ibáñez Alemany
Enrique Ibáñez Alemany (Enric) es desarrollador Java en Valencia(España).
Dejo de tener tiempo libre cuando apareció ella, la fallera de su vida.