top

Si estas en apuros para tener a Apache Geronimo arriba y funcional lo más pronto posible, este artículo te proporcionará pasos básicos para su descarga, construcción (en caso de ser necesario) y ejecución de forma rápida. Cabe aclarar que esto no es una guía completa, por lo cual podrías revisar otras ligas en la sección principal de Apache Geronimo v1.1 - Guí­a de Usuario para mayor información.

Todo lo que necesitas son de 5 a 10 minutos y el seguir los pasos básicos siguientes.

• #Antesala
• #Obteniendo el software
• #Iniciar el servidor
• #Crear y activar una aplicación ejemplo

Antesala

Apache Geronimo es un servidor de aplicaciones J2EE certificado que es completamente opensource y bajo Licencia Apache. Geronimo primero pasó la prueba Technology Compatibility Kit (TCK) en 2005 y la versión 1.0 se lanzó en Enero 2006. La comunidad de Geronimo es mantenida por 28 committers de más de 8 compañias; múltiples organizaciones han iniciado la construcción de aplicaciones sobre Geronimo. Geronimo v1.1 es el segundo lanzamiento oficial del servidor de aplicaciones de la Fundación de Software Apache.

Obteniendo el software

En estos momentos tienes una opción para obtener el software. La forma más rápida y sencilla es obtener al binario directamente del sitio de Apache. Ya que este artículo pretende ayudarte a tener a Apache Geronimo arriba y en ejecución de la forma más rápida, sólo se cubrirá la descarga del binario por el momento.

Pre-requisitos

Aunque esta forma de instalación es la más rápida, requerirás instalar cierto software previo a la instalación de Geronimo.

J2SE 1.5

Geronimo actualmente emplea Sun ORB para RMI, por lo cual se requiere emplear SUN JDK. Consulta la siguiente URL para detalles en como descargar e instalar J2SE 1.5:
http://java.sun.com

Descargar binarios

Dependiendo de la plataforma en la cual pretendas instalar y ejecutar Apache Geronimo, requerirás elegir la imagen de instalación apropiada. Abre un explorador Web e ingresa a la siguiente URL; ahí encontrarás los paquetes disponibles para descarga (binarios y código fuente).

http://geronimo.apache.org/downloads.html

Elige al archivo con formato de compresión compatible con tu sistema (zip, tar, gz) con hacer clic directamente en su liga, descargarlo y expandir al binario en tu disco duro en un nuevo directorio. Por ejemplo en z:/geronimo, es importante indicar que dicho directorio, de ahora en adelante será hecho referencia como <geronimo_home>.

La instalación de Apache Geronimo es tan simple como la decompresión de archivos .zip ó .tar. El siguiente paso es iniciar al servidor.

Iniciar al servidor

Con Apache Geronimo ya instalado, abre una consola de línea de comandos y cambia de directorio a <geronimo_home>/bin. En ese directorio encontrarás algunos archivos script (.bat y .sh) junto con cinco archivos .jar. Si observas a los últimos cinco archivos mencionados, encontrarás:

• client.jar
• deployer.jar
• server.jar
• upgrade.jar
• shutdown.jar

Dichos archivos jar pueden ser iniciados mediante java -jar para invocar a la clase principal de <geronimo_home>/bin/<nombre del archivo .jar>.
El archivo client.jar puede ser usado para iniciar la configuración de Geronimo que contiene la aplicación cliente que desees correr.
El archivo deployer.jar es la aplicación Java que administra artefactos J2EE y GBeans que corren en el servidor Geronimo.
El archivo server.jar es usado para iniciar al servidor Geronimo.
El archivo update.jar puede ser usado para actualizar archivos xml de la versión previa de Geronimo a la versión actual.
El archivo shutdown.jar puede ser invocado de la línea de comandos para apagar al servidor.

De forma alternativa, los archivos previos, también pueden ser iniciados mediante sus scripts respectivos.

Para iniciar al servidor, ejecuta el siguiente comando:

java -jar server.jar

Como alternativa, un script esta disponible: startup también iniciará al servidor. Una vez que el servidor este iniciado, deberías ver la información siguiente en la consola de línea de comandos.
#000000solid Booting Geronimo Kernel (in Java 1.5.0_06)... Starting Geronimo Application Server v1.1 [**********************] 100% 45s Startup complete Listening on Ports: 1099 0.0.0.0 RMI Naming 1527 0.0.0.0 Derby Connector 4201 0.0.0.0 ActiveIO Connector EJB 4242 0.0.0.0 Remote Login Listener 8009 0.0.0.0 Jetty Connector AJP13 8080 0.0.0.0 Jetty Connector HTTP 8443 0.0.0.0 Jetty Connector HTTPS 9999 0.0.0.0 JMX Remoting Connector 61616 0.0.0.0 ActiveMQ Message Broker Connector Started Application Modules: EAR: geronimo/webconsole-jetty/1.1/car RAR: geronimo/activemq/1.1/car RAR: geronimo/system-database/1.1/car WAR: geronimo/remote-deploy-jetty/1.1/car WAR: geronimo/welcome-jetty/1.1/car Web Applications: http://localhost:8080/ http://localhost:8080/console http://localhost:8080/console-standard http://localhost:8080/remote-deploy Geronimo Application Server started
Para probar al servidor Apache Geronimo puedes emplear a tu explorador Web apuntando a la URL siguiente para probar la Consola Geronimo. La Consola Geronimo es la primer aplicación que puedes probar, y lo bueno es, que ya se encuentra activada.

http://localhost:8080/console

Al ser desplegada, ingresa system como nombre de usuario y manager como la contraseña.

La siguiente figura ilustra la consola basada en Web.

Al momento ya cuentas con Apache Geronimo activo y en ejecución, y el tiempo invertido ha sido mínimo. La siguiente sección te propondrá una JSP ejemplo muy simple y te mostrará como activar y ejecutar dicha aplicación ejemplo.

Crear y activar una aplicación ejemplo

Una JSP tipo HolaMundo es casi un predeterminado para esas pruebas básicas y todos están familiarizados con ella. Crea un nuevo directorio para guardar a todo archivo relacionado con la aplicación. De ahora en adelante, la referencia a ese directorio será <app_home>.

Crea un archivo de texto plano en el directorio <app_home>, llámalo HolaMundo.jsp y copia el contenido del siguiente ejemplo.

Aunque para dicha aplicación simple no es absolutamente necesario, crearás un plan de activación Geronimo para que obtengas la primer inspección de esos planes de activación. Crea un directorio llamado WEB-INF dentro del directorio <app_home>.

Crea un archivo de texto plano en el directorio <app_home>/WEB-INF llamado geronimo-web.xml y copia el contenido del siguiente ejemplo.

Crea un archivo de texto plano, llamado web.xml, en el directorio <app_home>/WEB-INF y copia el contenido del siguiente ejemplo.

Empaqueta la aplicación

Desde una línea de comandos, cambia de directorio a <app_home> y ejecuta el siguiente comando para empaquetar la aplicación HolaMundo en un solo archivo .war.

jar -cvf HolaMundo.war *

Lo anterior te creará un archivo HolaMundo.war en el directorio <app_home>. El siguiente paso es activar la aplicación.

Activar y probar la aplicación

Para activar la aplicación tienes dos opciones, puedes usar la Consola Geronimo ó la línea de comandos. Para este ejemplo, usarás ambas.

Mediante la consola

Ingresa a la consola Geronimo y da clic en la liga   Deploy New (Activar Nueva) en el folder Applications (Aplicaciones) colocado a mano izquierda del panel de navegación de la ocnsola. Esto cargará la ventana Install New Applications (Instalar Aplicaciones Nuevas).

Después elige y carga al archivo HolaMundo.war en la caja de entrada Archive (Archivo) y da clic en el botón install (instalar) para activar a la aplicación en el servidor. Una vez que la aplicación haya sido activada exitosamente, la pantalla será actualizada con un mensaje de activación exitoso. Antes de hacer clic en el botón de instalar, asegúrate que la opción "Start app after install" (Iniciar aplicación después de instalarla) este habilitada.

Mediante la línea de comandos

Cambia de directorio a <geronimo_home>/bin y ejecuta el siguiente comando:

java -jar deployer.jar --user system --password manager deploy <app_home>/HolaMundo.war

Una vez que la aplicación ha sido activada exitosamente, deberías ver al siguiente mensaje:

#000000solid D:\geronimo-1.1\bin>java -jar deployer.jar --user system --password manager deploy D:\Aplicaciones_geronimo\HolaMundo\HolaMundo.war Deployed aplicaciones.ejemplo/ApHolaMundo/1.1/war @ http://localhost:8080/hola

Prueba la aplicación al apuntar tu navegador web a la siguiente URL:

http://localhost:8080/hola

Resumen

Este artículo te mostró lo simple que es tener arriba y en ejecución a Apache Geronimo. El tiempo global para levantar al servidor debería ser de menos de cinco minutos si cuentas con el prerrequisito (Java 1.5) instalado. Además, este artículo te mostró como crear, activar y probar una JSP ejemplo bastante simple, en menos de cinco minutos.