...
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
- #Obteniendo el software
- #Iniciar el servidor
- #Crear y activar una aplicación aplicación ejemplo
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 borderStyle solid
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 | ||||
---|---|---|---|---|
| ||||
<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 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 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 borderStyle solid
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:
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.