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-jbossbeans.xml colocando el atributo callByValue e isolated a true
<bean name="JBossAppParsingDeployer" class="org.jboss.deployment.JBossAppParsingDeployer"> ... <property name="callByValue">true</property> ... <bean name="EARClassLoaderDeployer" class="org.jboss.deployment.EarClassLoaderDeployer"> ... <property name="isolated">true</property> ...

4.2- Editar JBOSS_HOME/server/default/deployers/ejb-deployer-jbossbeans.xml colocando el atributo callByValue a true

... <!-- The ejb timer service --> <property name="timerServiceName" >jboss.ejb:service =EJBTimerService</property> <!-- A flag indicating if the ejb components should have in VM call optimization disabled. --> <property name="callByValue">true</property> <!-- Specify an unauthenticated identity --> ...

4.3- Editar el archivo

JBOSS_HOME/server/default/deploy/messaging/messaging-jboss-beans.xml

Para asignar una contrasea al servicio de mensajeria:

...

</property> <property name="suckerPassword">UnaContrasea</property> <property name="securityDomain">messaging</property> ...

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