Ficha Tcnica 0001

Configuracin JBoss 5.0.1GA

Autor: Miguel Angel Alejo Macias

Fecha de Elaboracin: 23 Abril 2009

Introduccin:

JBoss : Es un servidor de aplicaicones J2EE de codigo abierto implementado en java

puro. Soporta las tecnologas de J2EE incluyendo Web Services. Jboss 5 es distribuido

con la versin de jbossws-native-3.0.5.GA, con lo cual no es necesario una instalacin

extra para el modulo de web services.

1.- Obtener la version de Jboss 5.0.1.GA de http://www.jboss.org/jbossas/downloads/

2.- Descomprimir el archivo descargado (jboss-5.0.1.GA-jdk6.zip) en la ruta deseada

por ejemplo:

C:\jboss-5.0.1.GA

3.- Colocar la variable de entorno JBOSS_HOME con la ruta en donde se encuentra la

carpeta raiz de Jboss. En el ejemplo es:

JBOSS_HOME = C:\jboss-5.0.1.GA

Si aun no se tiene la variable de entorno JAVA_HOME ser necesario agregarla:

JAVA_HOME = Ruta al jdk disponible

4.- Configurar el Class-Loader:

4.1- Editar JBOSS_HOME/server/default/deployers/ear-deployer-jboss-

beans.xml colocando el atributo callByValue e isolated a true

...

true

...

...

true

...

4.2- Editar JBOSS_HOME/server/default/deployers/ejb-deployer-jboss-

beans.xml colocando el atributo callByValue a true

...

jboss.ejb:service

=EJBTimerService

true

...

4.3- Editar el archivo JBOSS_HOME/server/default/deploy/messaging/messaging-jboss-beans.xml

Para asignar una contrasea al servicio de mensajeria:

...

UnaContrasea

messaging

...

Si no se coloca esta contrasea Jboss manda un WARNING en la consola a la

hora de ejecutarse.

5.- Ejecucin de Jboss (forma bsica)

5.1 Asegurarse que las variables de entorno JBOSS_HOME y JAVA_HOME estan asignadas de forma correcta.

5.2 Colocarse en JBOSS_HOME/bin y ejecutar el siguiente comando:

JBOSS_HOME\bin\run.bat

de esta forma se inicia el servidor JBoss en su forma mas simple.

5.2 Para comprobar que el servidor se ha levantado y esta disponible se debe abrir una ventana del navegador de internet y acceder a la siguiente URL:

http://localhost:8080/ http://127.0.0.1:8080/

6.- Ejecucin de Jboss en modo depuracin

6.1 Es posible iniciar el servidor jboss en modo de depuracin cuando se desea encontrar errores de desarrollo (en codigo) para ello se deben pasar los

parametros adecuados:

6.1.1. Colocar la variable de entorno JAVA_OPTS:

JAVA_OPTS=-Xrunjdwp:transport=dt_socket,address=8787,server=y,suspend=n

De esta forma se le indica a Jboss que debe iniciarse en modo de

depuracin con la forma de transporte dt_socket y escuchando por el

puerto 8787.

6.2 Ejecutar jboss:

JBOSS_HOME\bin\run.bat

Si la configuracin es correcta se ve una linea al iniciar la consola de jboss de la

siguietne forma:

Listening for transport dt_socket at address: 8787

7.- Ejecucin de Jboss asociandole una ip disponible en red.

7.1 Por cuestiones de seguridad al inicial jboss no es posible ver el servidor desde otra maquina en la red ya que solo se inicia en localhost. Para permitir

que otras computadoras puedan ver el servidor es necesario asociarle una ip.

Para ello:

7.1.1. Colocarse en el direcotrio JBOSS_HOME/bin y ejecutar el siguiente comando:

(run.bat -b [ip])

run.bat -b 148.204.14.252

Verificar que el servidor esta disponible con la ip especificada. Abrir un navegador de

internet y colocar la URL:

http://148.204.14.252:8080/

8.- Ejecucin de jboss con varias instancias

8.1 El servidor jboss puede tener varias instancias. La distribucin de jboss 5 tiene una instancia precargada la cual es default. Para ejecutar otra instancia

dentro del mismo servidor es necesario indicarle el nombre de la instancia

por medio de un parametro:

JBOSS_HOME/bin/run.bat -c [NOMBRE_INSTANCIA]

JBOSS_HOME/bin/run.bat -c default

8.2 Si el servidor tiene varias instancias y se desea levantar todas es posiblre realizarlo con el siguiente comando:

JBOSS_HOME/bin/run.bat -c all

9.- Detener Jboss

9.1 Si se ha iniciado jboss en una consola basta con presionar las teclas Ctrl c para detener el servidor.

Ctrl - C

9.2 Si se desea utilizar el comando se debe ejecutar:

JBOSS_HOME/bin/shutdown -S

(la S mayscula)

9.3 Si se desea detener una instancia asociada a una ip del servidor se debe ejecutar:

JBOSS_HOME/bin/shutdown -s 192.168.0.100:1099 -S

10.- Jboss native: jbossws-native-3.0.5.GA

10.1 Para ver el modulo de servicios web es necesario iniciar el servidor jboss: JBOSS_HOME/bin/run

10.2 Abrir un navegador de internet e introducir la siguietne URL: http://localhost:8080/jbossws/

10.3 Esta pantalla muestra la versin de native actualmente instalada y permite ver los web services disponibles dando click en view a list of deployed services