Guía de instalación y de uso de JBoss

Departamento de Ingeniería de Sistemas y Computación
ISIS 2304 – Sistemas Transaccionales
Guía de instalación y de uso de JBoss
I- Objetivo
Instalar JBoss y configurarlo para utilizarlo desde eclipse (versión 3.1.2) con JBoss
IDE
II- Pasos
Verificar las cuentas de usuario y de la base de datos
Use SSH para entrar a chie y verificar su conexión a la base de datos oracle.
Utilice el comando sqlplus nomUsuario@stringConexion/password. Esos valores
fueron enviados previamente con la información de las cuentas.
Instalar el servidor JBoss
1. Descargar el instalador JBoss 4.0.5. La dirección web donde se encuentra es
http://labs.jboss.com/portal/jbossas/download/index.html.
2. Para ejecutar el instalador utilice el comando java –jar nombreArchivoJar
3. Seleccionar el idioma de instalación
4. Haga Clic en Siguiente (Welcome)
5. Haga Clic en Siguiente (Release notes)
6. Aceptar términos
7. Seleccionar ruta instalación (en el directorio c:\temp cree una nueva carpeta
Jboss). A esta dirección debe apuntar la variable de entorno JBOSS_HOME
(configúrela en inicio->miPC->clic derecho->propiedades->tab Opciones
Avanzadas->clic variables de entorno). Este paso es opcional y no se puede
realizar en las salas de sistemas.
8. Selecionar ejb3-clustered
9. Haga Clic en Siguiente (packs to install)
10. Haga Clic en Siguiente (Standard-advanced option)
11. Haga Clic en Siguiente (Installation)
Configurar Eclipse-Jboss IDE
1.
2.
3.
4.
5.
Vaya a window->show view->other
Seleccione Server->JBoss Server View y haga clic en OK
Sobre la vista de JBoss Server View haga clic derecho y seleccione new->Server
Seleccione JBossInc->JBoss AS 4.0 y haga clic en next
De un nombre al servidor, asígnele como home directory el directorio donde
instaló el Jboss y en el JRE escoja jre1.5.0_xx
Crear directorios en el proyecto a desarrollar
1. Cree los directorios bin y dist sino existen en el proyecto. Haga clic derecho
sobre el proyecto y de la opción New-> Folder
2. El directorio bin contendrá los archivos .class del proyecto y el directorio dist
será utilizado para ubicar el archivo de packaging generado en un paso posterior
Configurar el datasource para la base de datos
1. Cree una carpeta conf dentro del proyecto
2. Cree el archivo oracle-ds.xml con la siguiente información. Modifíquelo para
que quede con los datos de su cuenta de la base de datos
<datasources>
<local-tx-datasource>
<jndi-name>OracleDS</jndi-name>
<connectionurl>jdbc:oracle:thin:s2501aXX/[email protected]:1522:chie10
</connection-url>
<use-java-context>false</use-java-context>
<driver-class>oracle.jdbc.driver.OracleDriver</driver-class>
<user-name></user-name>
<password></password>
<exception-sorter-classname>org.jboss.resource.adapter.jdbc.vendor.OracleExceptionSorter</exc
eption-sorter-class-name>
</local-tx-datasource>
</datasources>
Configurar y Correr el servidor Jboss
1. Vaya a la carpeta donde instaló el Jboss
2. Revise la carpeta server\default
3. Copie a la carpeta server\default\lib la librería para Oracle que puede bajar de la
sección herramientas y ambiente de la página del curso
a. Descargue el archivo classes12.zip de la página del curso y
descomprímalo para obtener el driver (classes12.jar)
b. Copie el driver de la base de datos Oracle (classes12.jar) en el directorio
JBoss_HOME\server\default\lib
4. Revise la carpeta server\default\deploy donde deben quedar todos los archivos
que serán desplegados en el contenedor
5. Vaya a la carpeta bin y haga doble clic en el archivo run.bat o córralo desde
eclipse
a. Vaya a la ventana de JBoss Server view
b. Haga clic derecho sobre el servidor JBoss que configuró
c. De la opción de start
6. Se debe lanzar una ventana de comando con la ejecución del servidor, espere
hasta ver un mensaje similar a:
16:02:12,734 INFO
[Server] JBoss (MX MicroKernel) [4.0.5.GA (build:
CVSTag=Branch_4_0 date=200610162339)] Started in 1m:36s:63ms
Hacer deploy del datasource y de los entities
1. No detenga la ejecución del servidor JBoss
2. Copie a la carpeta server\default\deploy el archivo oracle-ds.xml
3. Revise los mensajes en la consola (en particular que no haya mensajes de error)
4. Copie a la carpeta server\default\deploy los archivos que quiere desplegar en el
contenedor
5. Revise los mensajes en la consola (en particular que no haya mensajes de error)