Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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

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

Antesala

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

Obteniendo el software

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

Pre-requisitos

Aunque esta forma de instalación instalación es la más rápidamás rápida, requerirás requerirás instalar cierto software previo a la instalación 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

...

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

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

Note

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 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á será hecho referencia como <geronimo_home>.

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

...

Con Apache Geronimo ya instalado, abre una consola de línea línea de comandos y cambia de directorio a <geronimo_home>/bin. En ese directorio encontrarás encontrarás algunos archivos script (.bat y .sh) junto con cinco archivos .jar. Si observas a los últimos últimos cinco archivos mencionados, encontrarásencontrará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 configuración de Geronimo que contiene la aplicación aplicación cliente que desees correr.
El archivo deployer.jar es la aplicación 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 versión previa de Geronimo a la versión versión actual.
El archivo shutdown.jar puede ser invocado de la línea línea de comandos para apagar al servidor.

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

...

Como alternativa, un script esta disponible: startup también iniciará también iniciará al servidor. Una vez que el servidor este iniciado, deberías deberías ver la información información siguiente en la consola de línea línea de comandos.

No Format
bgColor#000000
borderStylesolid
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 aplicación que puedes probar, y lo bueno es, que ya se encuentra activada.

...

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

La siguiente figura ilustra la consola basada en Web.

...

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

Crear y activar una

...

aplicación ejemplo

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

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

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

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

...

Code Block
xml
xml
borderStylesolid
titlePlan de activación activación Geronimo geronimo-web.xml
<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://geronimo.apache.org/xml/ns/j2ee/web-1.1">
	<environment>
		<moduleId>
			<groupId>aplicaciones.ejemplo</groupId>
			<artifactId>ApHolaMundo</artifactId>
			<version>1.1</version>
		</moduleId>		
	</environment>
  	<context-root>/hola</context-root>
</web-app>
Note

Esta versión versión de geronimo-web.xml no funcionará 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.

Code Block
xml
xml
borderStylesolid
titleweb.xml
<?xml version="1.0" encoding="UTF-8"?>

<web-app version="2.4"

   xmlns="http://java.sun.com/xml/ns/j2ee"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
   xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee
   http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">

    <welcome-file-list>
         <welcome-file>HolaMundo.jsp</welcome-file>
    </welcome-file-list>

</web-app>

Empaqueta la

...

aplicación

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

jar -cvf HolaMundo.war *

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

Activar y probar la

...

aplicación

Para activar la aplicación aplicación tienes dos opciones, puedes usar la Consola Geronimo ó ó la línea línea de comandos. Para este ejemplo, usarás 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 navegación de la ocnsola. Esto cargará cargará la ventana Install New Applications (Instalar Aplicaciones Nuevas).

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

*Mediante la línea 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 aplicación ha sido activada exitosamente, deberías deberías ver al siguiente mensaje:

No Format
bgColor#000000
borderStylesolid
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 aplicación al apuntar tu navegador web a la siguiente URL:

http://localhost:8080/hola

Resumen

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