HomeDocumentation > Apache Geronimo v1.1 - Guí­a de Usuario > Inicio express - Apache Geronimo para el impaciente

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

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

Apache Geronimo v1.1 esta certificado con J2EE 1.4 pero trabaja con 1.5 siempre y cuando no se use CORBA ó daytrader.

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.

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.

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

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.

Plan de activación Geronimo geronimo-web.xml
Esta versión de geronimo-web.xml no funcionará en Geronimo V1.0

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

web.xml

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:

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.