COMO INSTALAR JBoss

Pasos Previos

· Instalación funcional del JDK 1.4.2, según descrito en : Instalación JDK en Plataformas Windows

Descarga (JBoss)

Descargar la versión más reciente de JBoss :

· JBoss 3.2.x [~57 MB]

· Descargar la versión más reciente del árbol 3.2.x

· Descargar la versión JBoss binario para mayor integridad.

· ( Otras alternativas a JBoss binario, son src que incluye el fuente -- mismo que requiere un proceso de compilación local tardado -- y jdk13 que incluye el JDK 1.3 en su estructura )

Instalación

Coloquese en el directorio donde desee realizar la instalación y realice los siguientes pasos:

· Descomprimir el archivo de JBoss a través de WinZip y colocarlo dentro de un directorio temporal/instalación.

· Una vez terminada la instalación se recomienda cambiar el nombre del directorio jboss-3.2.x a simplemente jboss ; quedando instalado en una ruta absoluta como : C:\jboss\.

Configuración (JBoss)

Para efectos del curso, JBoss solo requiere modificaciones mínimas a su configuración las cuales serán detalladas en la parte del curso correspondiente.

En el directorio raíz de JBoss reside un directorio llamado bin que contiene los ejecutables de JBoss, el archivo run.bat es empleado para arrancar el Servidor en versión "default".

Al invocar este comando, JBoss será iniciado con los parámetros y componentes residentes en el directorio $JBOSS_HOME/server/default, donde $JBOSS_HOME es el directorio raíz de instalación.

Configuración (Base de Datos-HSQL/JBoss)

En este curso será empleada la Base de Datos HSQL (Hypersonic) integrada con JBoss, esta Base de Datos puede ser inicializada automáticamente al iniciarse JBoss

Dicha Base de Datos se encuentra equipada con una interfase gráfica que permite observar directamente la información contenida en ella, lo anterior será de utilidad al diseñar EJB's de Entidad ("Entity EJB's"); para accesar esta interfase gráfica se deben realizar los siguientes pasos:

· Debe modificar el archivo de configuración para Hypersonic hsqldb-ds.xml ubicado bajo el directorio $JBOSS_HOME/server/default/deploy, donde $JBOSS_HOME es el directorio raíz de instalación. En él debe permitir el acceso vía TCP a la Base de Datos, mismo que se encuentra desactivado por "default".

· La primer sección que debe modificar en hsqldb-ds.xml se encuentra en el segundo párrafo, debe eliminar el comentario tipo XML (-->) en la parte final de esta sección, para encontrarse de la siguiente manera :

jdbc:hsqldb:hsql://localhost:1701

La otra sección en hsqldb-ds.xml que debe modificar es una de las ultimas secciones en este archivo. Asegúrese que el siguiente MBean se encuentre sin comentario tipo XML (-->) en su parte final, debe encontrarse de la siguiente manera :

name="jboss:service=Hypersonic"> 1701 true default false true

· Una vez realizadas estas modificaciones puede activar el proceso de JBoss, esto permitirá la conexión hacia la Base de Datos.(Vea fase de Pruebas para instrucciones de arranque, antes proseguir con los siguientes pasos )

· Para facilitar la invocación de la interfase gráfica sobre la Base de Datos, se recomienda generar un archivo llamado Hypersonic.bat con la siguiente información :

# Donde C:\jboss representa el directorio raíz de instalación java -cp "%CLASSPATH%;C:\jboss\server\default\lib\hsqldb.jar;." org.hsqldb.util.DatabaseManager

La definición anterior invoca la Clase Java que genera la interfase gráfica de HSQL (Hypersonic), sin embargo, al colocar la definición anterior en un archivo de "Shell" se facilita la creación de la interfase al invocar Hypersonic.bat.

· Al invocar el comando/archivo anterior modifique los parámetros a los siguientes valores:

Type : HSQL Database Engine Server Driver: org.hsqldb.jdbcDriver URL : jdbc:hsqldb:hsql://localhost:1701 (Agregar Puerto) User : sa Password : (En Blanco)

NOTA: Para que la conexión hacia HSQL (Hypersonic) sea exitosa es necesario que el proceso de JBoss este activo, además de realizar las modificaciones pertinentes al archivo hsqldb-ds.xml como fue descrito anteriormente.

· Ahora se debe cargar el Modelo de Datos, a continuación se describe el modelo empleado a lo largo del curso :

CREATE TABLE CUENTAS_BANCARIAS(ID VARCHAR PRIMARY KEY, NOMBRE VARCHAR, APELLIDO VARCHAR, SALDO DOUBLE)

· Para agilizar el proceso de montaje de datos se recomienda colocar la declaración anterior en un archivo llamado datos.sql.

· De la interfase gráfica de HSQL (Hypersonic) seleccione la opción File -> Open Script... y elija el archivo creado anteriormente (datos.sql); una vez ejecutado el comando anterior oprima el icono Execute para cargar la tabla SQL.

· Al terminar las instrucciones anteriores seleccione la opción View -> Refresh Tree ; posteriormente debe aparecer en la ventana izquierda de la interfase gráfica la tabla SQL.

Pruebas

Ejecute el comando run.bat ubicado en el directorio $JBOSS_HOME/bin/, donde $JBOSS_HOME es el directorio raíz de instalación, al invocar el comando anterior deben aparecer instrucciones como las siguientes:

C:\ ./run.bat ========================================================================= JBoss Bootstrap Environment JBOSS_HOME: C:\jboss JAVA: C:\jdk\bin\java JAVA_OPTS: -server -Dprogram.name=run.bat CLASSPATH: C:\jboss\bin\run.jar;C:\jdk\lib\tools.jar ========================================================================= 12:55:10,608 INFO [Server] Starting JBoss (MX MicroKernel)... 12:55:10,610 INFO [Server] Release ID: JBoss [WonderLand] 3.2.7 (build: CVSTag=JBoss_3_2_7 date=200501280217) 12:55:10,610 INFO [Server] Home Dir: C:\jboss 12:55:10,610 INFO [Server] Home URL: file:C:\jboss\ 12:55:10,623 INFO [Server] Library URL: file:C:\jboss\lib\ 12:55:10,625 INFO [Server] Patch URL: null 12:55:10,642 INFO [Server] Server Name: default 12:55:10,642 INFO [Server] Server Home Dir: C:\jboss\server\default 12:55:10,643 INFO [Server] Server Home URL: C:\jboss\server\default\ 12:55:10,643 INFO [Server] Server Data Dir: C:\jboss\server\default\data ........ <> ....... ....... 12:55:31,862 INFO [Http11Protocol] Starting Coyote HTTP/1.1 on http-0.0.0.0-8080 12:55:32,074 INFO [ChannelSocket] JK2: ajp13 listening on /0.0.0.0:8010 12:55:32,192 INFO [JkMain] Jk running ID=1 time=0/149 config=null 12:55:32,216 INFO [Server] JBoss (MX MicroKernel) [3.2.7 (build: CVSTag=JBoss_3_2_7 date=200501280217)] Started in 25s:163ms

Si observa los resultados anteriores sin ningún tipo de error, ha instalado correctamente JBoss, en caso contrario realice los pasos anteriores hasta que esta prueba sea ejecutada correctamente.

Otras Configuraciones

La instalación previa de JBoss se encuentra en su estado "default", puede encontrar mayores detalles acerca de su configuración en la siguiente página:

· http://www.osmosislatina.com/jboss/configuracion.htm .