Departamento de Ingeniera de Sistemas y Computacin ISIS 2304 Sistemas Transaccionales

Gua de instalacin y de uso de JBoss

I- Objetivo
Instalar JBoss y configurarlo para utilizarlo desde eclipse (versin 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 conexin a la base de datos oracle. Utilice el comando sqlplus nomUsuario@stringConexion/password. Esos valores fueron enviados previamente con la informacin de las cuentas. Instalar el servidor JBoss 1. Descargar el instalador JBoss 4.0.5. La direccin 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 instalacin 4. Haga Clic en Siguiente (Welcome) 5. Haga Clic en Siguiente (Release notes) 6. Aceptar trminos 7. Seleccionar ruta instalacin (en el directorio c:\temp cree una nueva carpeta Jboss). A esta direccin debe apuntar la variable de entorno JBOSS_HOME (configrela 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, asgnele 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 opcin 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 informacin. Modifquelo 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/c2501XX@chie.uniandes.edu.co: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 librera para Oracle que puede bajar de la seccin herramientas y ambiente de la pgina del curso a. Descargue el archivo classes12.zip de la pgina del curso y descomprmalo 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 sern desplegados en el contenedor 5. Vaya a la carpeta bin y haga doble clic en el archivo run.bat o crralo desde eclipse a. Vaya a la ventana de JBoss Server view b. Haga clic derecho sobre el servidor JBoss que configur c. De la opcin de start 6. Se debe lanzar una ventana de comando con la ejecucin 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 ejecucin 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)