|
|
| Home > Apache Geronimo v1.0 > Documentación > Apache Geronimo v1.0 - GuÃa de Usuario > GuÃa rápida - Apache Geronimo para el impaciente |
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.
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.
Aunque éste es el camino de instalación más rápido, si necesitarás instalar software adicional antes de instalar Geronimo.
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. |
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.
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:
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).
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.
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.
<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.
<?xml version="1.0"?> <web-app xmlns="http://geronimo.apache.org/xml/ns/web" xmlns:naming="http://geronimo.apache.org/xml/ns/naming" configId="HolaMundo"> <context-root>/hola</context-root> </web-app>
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-app version="2.4" xmlns="http://java.sun.com/xml/ns/j2ee"> <welcome-file-list> <welcome-file>HolaMundo.jsp</welcome-file> </welcome-file-list> </web-app>
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.
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:
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.