Article translated by: Waldo Ramírez Montaño
Artículo original en inglés, donado por: Hernan Cunico

Si estas en apuros para tener activo y funcional a Apache Geronimo, este artículo te proporcionará pasos básicos para su descarga, construcción (building, en caso de que te llegue a ser necesario) y activar al servidor en poco tiempo. Cabe señalar que esto no es una guía completa, así que probablemente te gustaría verificar al resto de ligas en la sección principal de Apache Geronimo v1.0 - Guía de Usuario, para obtener mayor información.

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

Obteniendo el software

En estos momentos tienes dos alternativas principales para obtener el software. Puedes descargar el último milestone más reciente y estable (nombrado como M4, M5...) o bien, obtener la última construcción disponible (en ocasiones, inestable). La manera más rápida y sencilla es obtener el binario directamente del sitio de Apache. Debido a que éste artículo pretende ayudarte a tener Apache Geronimo activo y funcional en el menor tiempo posible, aquí sólo se cubrirá la descarga del binario.

Prerrequisitos

Aunque éste es el camino de instalación más rápido, si necesitarás instalar software adicional antes de instalar Geronimo.

J2SE 1.4.2

Actualmente, Geronimo esta usando ORB de Sun para RMI, por lo cual es necesario usar SUN JDK. El uso de un JDK distinto ó de JDK versión distinta puede provocar errores de compilación. Consulta al siguiente URL para detalles en cómo descargar e instalar J2SE 1.4.2: http://java.sun.com

Apache Geronimo v1.0 no soporta Java 1.5, si empleas esa versión, Geronimo fallará al iniciar.

Descarga de binarios

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

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

Selecciona algún formato de compresión de archivo compatible con tu sistema (zip, tar, gz) y descárgalo al hacerle click directamente a su liga, para después expandir al binario en tu disco duro dentro de un nuevo directorio. Por ejemplo, en z:/geronimo, directorio que de ahora en adelante se le hará referencia como <geronimo_home>.

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

Iniciar el servidor

Con Apache Geronimo ya instalado, abre una consola de comandos e ingresa al directorio <geronimo_home>/bin. En dicho directorio encontrarás algunos archivos script (.bat y .sh) y tres archivos .jar. Si observas a esos tres archivos, encontrarás:

client.jar
deployer.jar
server.jar

Para iniciar al servidor, ejecuta el siguiente comando:

java -jar server.jar

Como alternativa se proporciona un script, el script startup también iniciará al servidor. Una vez que el servidor esté iniciado, deberías ver la siguiente información en la consola de comandos.

Booting Geronimo Kernel (in Java 1.4.2_09)...
Started configuration  1/23   1s geronimo/rmi-naming/1.0/car
Started configuration  2/23   3s geronimo/j2ee-server/1.0/car
Started configuration  3/23   2s geronimo/j2ee-security/1.0/car
Started configuration  4/23   9s geronimo/activemq-broker/1.0/car
Started configuration  5/23   1s geronimo/activemq/1.0/car
Started configuration  6/23   0s geronimo/system-database/1.0/car
Started configuration  7/23   4s geronimo/directory/1.0/car
Started configuration  8/23   0s geronimo/ldap-realm/1.0/car
Started configuration  9/23   2s geronimo/jetty/1.0/car
Started configuration 10/23   0s geronimo/geronimo-gbean-deployer/1.0/car
Started configuration 11/23   2s geronimo/j2ee-deployer/1.0/car
Started configuration 12/23   0s geronimo/jetty-deployer/1.0/car
Started configuration 13/23   1s geronimo/welcome-jetty/1.0/car
Started configuration 14/23   1s geronimo/ldap-demo-jetty/1.0/car
Started configuration 15/23   1s geronimo/servlets-examples-jetty/1.0/car
Started configuration 16/23   2s geronimo/jsp-examples-jetty/1.0/car
Started configuration 17/23   3s geronimo/webconsole-jetty/1.0/car
Started configuration 18/23   1s geronimo/uddi-jetty/1.0/car
Started configuration 19/23   1s geronimo/jmxdebug-jetty/1.0/car
Started configuration 20/23  11s geronimo/daytrader-derby-jetty/1.0/car
Started configuration 21/23   0s geronimo/remote-deploy-jetty/1.0/car
Started configuration 22/23   1s geronimo/hot-deployer/1.0/car
Started configuration 23/23   0s geronimo/j2ee-system/1.0/car
Startup completed in 51 seconds
  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
    8019 127.0.0.1 Jetty Connector AJP13
    8080 0.0.0.0   Jetty Connector HTTP
    8443 0.0.0.0   Jetty Connector HTTPS
   61616 0.0.0.0   ActiveMQ Message Broker Connector

  Started Application Modules:
    WAR: geronimo/welcome-jetty/1.0/car
    WAR: geronimo/servlets-examples-jetty/1.0/car
    EAR: geronimo/daytrader-derby-jetty/1.0/car
    EAR: geronimo/webconsole-jetty/1.0/car
    WAR: geronimo/jmxdebug-jetty/1.0/car
    RAR: geronimo/activemq/1.0/car
    WAR: geronimo/ldap-demo-jetty/1.0/car
    WAR: geronimo/jsp-examples-jetty/1.0/car
    WAR: geronimo/remote-deploy-jetty/1.0/car
    RAR: geronimo/system-database/1.0/car
    EAR: geronimo/uddi-jetty/1.0/car

  Web Applications:
    http://localhost:8080/
    http://localhost:8080/console
    http://localhost:8080/console-standard
    http://localhost:8080/daytrader
    http://localhost:8080/debug-tool
    http://localhost:8080/jsp-examples
    http://localhost:8080/juddi
    http://localhost:8080/ldap-demo
    http://localhost:8080/remote-deploy
    http://localhost:8080/servlets-examples

Geronimo Application Server started

Para probar al servidor Apache Geronimo, puedes apuntar tu explorador Web a la siguiente URL para probar la Consola Geronimo. La Consola Geronimo es la primer aplicación que puedes probar, y lo bueno es que, ya se encuentra activa (deployed).

http://localhost:8080/console

Para ingresar, emplea system como user name y manager como password.

La siguiente figura ilustra la Consola Web.

En este punto, ya tienes Apache Geronimo arriba y corriendo, y el tiempo invertido ha sido mínimo. La siguiente sección propondrá un ejemplo JSP muy básico y te mostrará como activar (deploy) y ejecutar dicha aplicación ejemplo.

Crear y activar una aplicación ejemplo

Un JSP estilo HolaMundo es casi un predeterminado para estas pruebas básicas, y prácticamente todos ya están familiarizados con ello. Crea un nuevo directorio para guardar todo archivo relacionado a la aplicación. De ahora en adelante, se hará referencia a dicho directorio como <app_home>.

Crea un archivo de texto plano dentro del directorio <app_home>, llamándolo HolaMundo.jsp, y copia el contenido del siguiente ejemplo.

HolaMundo.jsp

<html>
  <head>
    <jsp:useBean id="tiempo" class="java.util.Date"/>
    <title>
      JSP HolaMundo Básico
    </title>
  </head>
  <body bgcolor="#909DB8">
    <h1>
      <font face="tahoma" color="white">
        ¡Hola mundo desde GERONIMO!
      </font>
    </h1>
    <font face="tahoma" color="white">en ${tiempo}</font>
  </body>
</html>

Aunque para dicha aplicación ejemplo no es necesario, crearás un plan de activación (deployment plan) Geronimo para que obtengas la primer perspectiva de sus planes de activación. Crea un directorio llamado WEB-INF dentro del directorio <app_home>.

Crea un archivo de texto plano dentro del directorio <app_home>/WEB-INF, llamándolo geronimo-web.xml, y copia el contenido del ejemplo siguiente.

Plan de activación Geronimo geronimo-web.xml

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

web.xml

Empaca la aplicación

Desde una ventana consola de comandos, ingresa al directorio <app_home> y ejecuta al siguiente comando para empacar la aplicación HolaMundo en un solo archivo .war.

jar -cvf HolaMundo.war *

El comando anterior creará un archivo HolaMundo.war dentro del directorio <app_home>. El siguiente paso es activar (deploy) esa aplicación.

Activar y probar la aplicación

Para activar la aplicación tienes dos opciones, puedes emplear la Consola Geronimo ó la línea de comandos. Para este ejemplo, usuarás la opción de línea de comandos. Ingresa al directorio <geronimo_home>/bin y ejecuta al siguiente comando:

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

Cuando la aplicación ya haya sido activada exitosamente, deberías observar al mensaje siguiente:

 
E:\geronimo\bin>java -jar deployer.jar --user system --password manager deploy E:\HolaMundo\HolaMundo.war
    Deployed HolaMundo @ http://localhost:8080/hola

Prueba la aplicación mediante un explorador Web, apuntando a la siguiente URL:

http://localhost:8080/hola

Resumen

Este artículo te mostró lo simple que es el tener a Apache Geronimo activo y en ejecución. El tiempo global para lograr que el servidor se encuentre en ejecución debería ser de menos de cinco minutos siempre y cuando ya tengas el prerrequisito (Java 1.4.2) instalado. Además, este artículo te mostró como crear, activar y probar un JSP muy simple en menos de cinco minutos.