Instalación de un JBOSS AS
Posted on Febrero 2nd, 2009 in J2EE | 3 Comments »
La primera cosa necesaria para la instalación del JBOSS AS es una distribución del mismo. Para todos los ejemplos J2EE que publicaré se ha utilizado la versión JBoss 4.2.0.GA, pero deberian funcionar para las versiones posteriores.
La descarga de JBOSS AS se puede entrontrar a través de GOOGLE o en la página web oficial http://jboss.org/jbossas/downloads/.
Comprovar la versión de la JDK
Para la instalación del servidor de aplicaciones es necesario como mínimo la versión de jdk 1.5. Se puede comprobar la versión instalada con el siguiente comando:
> java -version
Java(TM) 2 Runtime Environment, Standard Edition (build 1.5.0_02-56)
Java HotSpot(TM) Client VM (build 1.5.0_02-36, mixed mode, sharing)
En caso de no disponer de la versión se puede realizar la descarga directamente de la página de sun para la plataforma que mas convenga – http://java.sun.com/javase/downloads/index.jsp
Estructura de directorios
Para todos los ejemplos voy a suponer que el directorio de trabajo es /opt/jboss/*. Por lo tanto una vez descomprimido el servidor de aplicaciones dentro de /opt/jboss queda una estructura de directorios com la siguiente:
En la imagen se muestra que el directorio raiz es jboss-4.0-4, es importante y muy útil crear un alias “jboss” para acceder a cualquier versión que se tenga instalada de esta manera todos los scripts u otras aplicaciones no se verán afectados en el caso de una actualización del servidor de aplicaciones. Por lo tanto, para el ejemplo de la imagen anterior la ruta /opt/jboss/ será un alias a /opt/jboss-4.0-4 o /opt/jboss-XXX/
En la documentación oficial de jboss (http://docs.jboss.org/jbossas/jboss4guide/r5/html/ch01.html) existe una tabla que describe cada directorio. Aquí va un extracto:
The JBoss top-level directory structure
| Directory | Description |
|---|---|
| bin | All the entry point JARs and start scripts included with the JBoss distribution are located in the bin directory. |
| client | The JARs that are required for clients that run outside of JBoss are located in the client directory. |
| server | The JBoss server configuration sets are located under the server directory. The default server configuration set is the server/default set. JBoss ships with minimal, default and all configuration sets. The subdirectories and key configuration files contained default configuration set are discussed in more detail in Section 1.3, “The Default Server Configuration File Set” |
| lib | The lib directory contains startup JARs used by JBoss. Do not place your own libraries in this directory. |
The JBoss server configuration directory structure
| Directory | Description |
|---|---|
| conf | The conf directory contains the jboss-service.xml bootstrap descriptor file for a given server configuration. This defines the core services that are fixed for the lifetime of the server. |
| data | The data directory is available for use by services that want to store content in the file system. |
| deploy | The deploy directory is the default location the hot deployment service looks to for dynamic deployment content. This may be overridden through the URLDeploymentScanner URLs attribute. |
| lib | The lib directory is the default location for static Java libraries that should not be hot deployed. All JARs in this directory are loaded into the shared classpath at startup. |
| log | The log directory is the directory log files are written to. This may be overridden through the conf/log4j.xml configuration file. |
| tmp | The tmp directory is used by JBoss to store temporarily files such as unpacked deployments. |
Por defecto JBOSS AS presenta tres posibles configuraciones (se pueden modificar y crear las que se crean convenientes en función de configuraciones, clusters, etc.):
- minimal
que arranca un microkernel JMX mínimo - default
arranca un servidor de aplicaciones completo pero sin funcionalidades de cluster, webservices, etc - all
como su nombre indica es la configuración completa con servidor de aplicaciones J2EE full, con clustering, webservices, rmi-iiop, etc.
Para los que trabajan en windows y quieren simular un entorno linux os recomiendo la descarga cygwin.
Arrancando y parando el servidor de aplicaciones
Para arrancar el JBOSS con la configuración por defecto (default)
> /opt/jboss/bin/run.sh -c default
Probar en el navegador http://localhost:8080
Para parar una instancia de JBOSS
> /opt/jboss/bin/shutdown.sh -S
Los comandos anteriores nos permiten arrancar y parar el servidor de aplicaciones, pero para poder operar y trabajar correctamente hay que configurar un poco más. En las próximas entregas veremos como arrancar el servidor de aplicaciones sobre una IP, como arrancar todos los servicios a través de la configuración “all”, como preparse para la escalabilidad y clusterización, como instalar el servidor de aplicaciones como un servicio en linux, seguridad, accesos en el puerto 80, etc.
