Instalación JBoss en Plataformas Linux.

Pasos Previos

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

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, se recomienda /usr/local/, realice los siguientes pasos:

Descomprimir el archivo con el siguiente comando : unzip jboss-3.2.x.zip .
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 : /usr/local/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.sh 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 :

 

      <!-- for tcp connection, allowing other processes to use the hsqldb
      database. This requires the org.jboss.jdbc.HypersonicDatabase mbean.-->
      <connection-url>jdbc:hsqldb:hsql://localhost:1701</connection-url>

      <!-- Comentario se cierra con anterioridad no en este punto. 
              Configuración es activada -->

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 :

 
  <!--  En este caso simplemente se eliminó todo el comentario -->
  <!--  Como no existen comentarios la configuracion es activada -->
   <mbean code="org.jboss.jdbc.HypersonicDatabase" 
     name="jboss:service=Hypersonic">
     <attribute name="Port">1701</attribute>
     <attribute name="Silent">true</attribute>
     <attribute name="Database">default</attribute>
     <attribute name="Trace">false</attribute>
     <attribute name="No_system_exit">true</attribute>
   </mbean>

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.sh con la siguiente información :

 
#!/bin/bash
# Donde /usr/local/jboss/ representa el directorio raíz de instalación 
java -cp "$CLASSPATH:/usr/local/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.sh.

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.sh 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:

 

[web@ws_osmosis bin]$ ./run.sh
=========================================================================

  JBoss Bootstrap Environment

  JBOSS_HOME: /usr/local/jboss

  JAVA: /usr/local/jdk/bin/java

  JAVA_OPTS: -server -Dprogram.name=run.sh

  CLASSPATH: /usr/local/jboss/bin/run.jar:/usr/local/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: /usr/local/jboss
12:55:10,610 INFO  [Server] Home URL: file:/usr/local/jboss/
12:55:10,623 INFO  [Server] Library URL: file:/usr/local/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: 
                                   /usr/local/jboss/server/default
12:55:10,643 INFO  [Server] Server Home URL: 
                                   file:/usr/local/jboss/server/default/
12:55:10,643 INFO  [Server] Server Data Dir: 
                                   /usr/local/jboss/server/default/data

........
    < 50-70 lineas >
.......
.......
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 21s:146ms

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