|
|
| Home > Apache Geronimo v1.1 > Documentation > 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.
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.
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.
Aunque esta forma de instalación es la más rápida, requerirás instalar cierto software previo a la instalación de Geronimo.
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 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.
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:
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.
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.
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.
<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.
<?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>
| 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.
<?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>
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.
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:
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.