{scrollbar}

Este artículo proporciona detalles sobre la instalación de Apache Geronimo. Aquí encontrarás información sobre cuales son los prerrequisitos de software, donde descargar Geronimo y como adaptar la instalación para el uso de puertos distintos a los predefinidos.

En este documento también encontrarás detalles sobre la instalación y configuracion de distintas topologías, cómo la de 2-capas (2-tier) con un servidor Web remoto.

Este artículo esta organizado en las secciones siguientes:

20pxdisc

Software prerrequisito

Apache Geronimo v2.0 se construye con J2SE 1.5, usando Maven 2; puedes obtener las versiones apropiadas para esa JVM, de los sitios siguientes.

J2SE SDK (http://java.sun.com/)
Apache Maven (http://maven.apache.org/)

Descargar Geronimo

El código fuente y binarios de Geronimo v2.0 puede ser encontrado en la siguiente URL
http://geronimo.apache.org/downloads.html

Construyendo desde código fuente

Desde una línea de comandos, descomprime el código fuente (.zip ó tar.gz) y cambia al directorio <geronimo_home>.
Teclea el siguiente comando para construir Apache Geronimo:

mvn install

Pasos detallados y requerimientos para construir a Geronimo desde el código fuente son cubiertos a detalle en la sección Construyendo Apache Geronimo con Maven 2.

Instalando Geronimo desde binarios

Dependiendo de la plataforma en la que planeas instalar y ejecutar Apache Geronimo, descarga la imagen apropiada de instalación. Selecciona el formato de compresión de archivo adecuado para tu sistema operativo (.zip, .tar.gz), con hacer clic directamente a la liga, para después descargarlo y expandir al binario en tu disco duro en un nuevo directorio.

La instalación de apache Geronimo es tan simple como la descompresión de archivos .zip ó .tar. Desde una línea de comandos, ingresa al directorio <geronimo_home>/bin e inicia al servidor mediante el siguiente comando:

geronimo run

Para tu conveniencia, Apache Geronimo proporciona una serie de scripts para administrar al servidor y aplicaciones; visita la sección Herramientas y comandos para mayor detalle.

Cambiando los puertos predefinidos

El puerto HTTP es el estándar de red que el contenedor Web usa. Este número de puerto debe ser usado en cualquier URL HTTP que llama a aplicaciones Web en ejecución sobre Geronimo. Los módulos de configuración del servidor y de inicio en Geronimo son controlados por el archivo config.xml con el listener predefinido configurado en el puerto 8080.

Existen varias razones por la cual se cambian los puertos de red, en gran medida por la ejecución de múltiples instancias de Geronimo. Para configurar al puerto predefinido, edita al archivo <geronimo_home>/var/config/config.xml. El archivo config.xml que corresponde a la distribución Apache Geronimo v2.0 con Tomcat se muestra en el ejemplo siguiente.

xmlsolidconfig.xml

<?xml version="1.0" encoding="UTF-8"?>       <attributes xmlns="http://geronimo.apache.org/xml/ns/attributes-1.1"> <module name="org.apache.geronimo.configs/rmi-naming/2.0-M2/car"> <gbean name="RMIRegistry"> <attribute name="port">1099</attribute> </gbean> <gbean name="NamingProperties"> <attribute name="namingProviderUrl">rmi://0.0.0.0:1099</attribute> </gbean> <gbean name="DownloadedPluginRepos"> <attribute name="repositoryList">http://geronimo.apache.org/plugins/plugin-repository-list-2.0.txt</attribute> <attribute name="userRepositories">[]</attribute> </gbean> </module> <module name="org.apache.geronimo.configs/j2ee-server/2.0-M2/car"/> <module name="org.apache.geronimo.configs/transaction-jta11/2.0-M2/car"/> <module name="org.apache.geronimo.configs/j2ee-security/2.0-M2/car"> <gbean name="JaasLoginServiceRemotingServer"> <attribute name="host">0.0.0.0</attribute> <attribute name="port">4242</attribute> </gbean> <gbean name="JMXService"> <attribute name="protocol">rmi</attribute> <attribute name="host">0.0.0.0</attribute> <attribute name="port">9999</attribute> <attribute name="urlPath">/jndi/rmi://0.0.0.0:1099/JMXConnector</attribute> </gbean> </module> <module name="org.apache.geronimo.configs/axis/2.0-M2/car"/> <module load="false" name="org.apache.geronimo.configs/axis2/2.0-M2/car"/> <module load="false" name="org.apache.geronimo.configs/cxf/2.0-M2/car"/> <module name="org.apache.geronimo.configs/openejb/2.0-M2/car"/> <module load="false" name="org.apache.geronimo.configs/j2ee-corba-yoko/2.0-M2/car"> <gbean name="NameServer"> <attribute name="port">1050</attribute> <attribute name="host">localhost</attribute> </gbean> </module> <module load="false" name="org.apache.geronimo.configs/j2ee-corba-sun/2.0-M2/car"> <gbean name="NameServer"> <attribute name="port">1050</attribute> <attribute name="host">localhost</attribute> </gbean> </module> <module name="org.apache.geronimo.configs/system-database/2.0-M2/car"> <gbean name="DerbyNetwork"> <attribute name="host">0.0.0.0</attribute> <attribute name="port">1527</attribute> </gbean> </module> <module name="org.apache.geronimo.configs/activemq-broker/2.0-M2/car"> <gbean name="ActiveMQ.tcp.default"> <attribute name="host">0.0.0.0</attribute> <attribute name="port">61616</attribute> </gbean> </module> <module name="org.apache.geronimo.configs/activemq/2.0-M2/car"/> <module name="org.apache.geronimo.configs/tomcat6/2.0-M2/car"> <gbean name="TomcatResources"/> <gbean name="TomcatWebConnector"> <attribute name="host">0.0.0.0</attribute> <attribute name="port">8080</attribute> <attribute name="redirectPort">8443</attribute> </gbean> <gbean name="TomcatAJPConnector"> <attribute name="host">0.0.0.0</attribute> <attribute name="port">8009</attribute> <attribute name="redirectPort">8443</attribute> </gbean> <gbean name="TomcatWebSSLConnector"> <attribute name="host">0.0.0.0</attribute> <attribute name="port">8443</attribute> </gbean> <gbean name="org.apache.geronimo.configs/tomcat6/2.0-M2/car?ServiceModule=org.apache.geronimo.configs/tomcat6/2.0-M2/car,j2eeType=GBean,name=TomcatWebContainer"> <attribute name="catalinaHome">var/catalina</attribute> </gbean> </module> <module name="org.apache.geronimo.configs/geronimo-gbean-deployer/2.0-M2/car"/> <module name="org.apache.geronimo.configs/j2ee-deployer/2.0-M2/car"> <gbean name="WebBuilder"> <attribute name="defaultNamespace">http://geronimo.apache.org/xml/ns/j2ee/web/tomcat-1.2</attribute> </gbean> <gbean name="EnvironmentEntryBuilder"> <attribute name="eeNamespaces">http://java.sun.com/xml/ns/j2ee,http://java.sun.com/xml/ns/javaee</attribute> </gbean> </module> <module name="org.apache.geronimo.configs/connector-deployer/2.0-M2/car"> <gbean name="ResourceRefBuilder"> <attribute name="eeNamespaces">http://java.sun.com/xml/ns/j2ee,http://java.sun.com/xml/ns/javaee</attribute> </gbean> <gbean name="AdminObjectRefBuilder"> <attribute name="eeNamespaces">http://java.sun.com/xml/ns/j2ee,http://java.sun.com/xml/ns/javaee</attribute> </gbean> </module> <module name="org.apache.geronimo.configs/persistence-jpa10-deployer/2.0-M2/car"/> <module name="org.apache.geronimo.configs/openejb-deployer/2.0-M2/car"> <gbean name="EJBBuilder"> <reference name="ServiceBuilders"> <pattern> <name>GBeanBuilder</name> </pattern> <pattern> <name>PersistenceUnitBuilder</name> </pattern> </reference> <reference name="WebServiceBuilder"> <pattern> <name>CXFBuilder</name> </pattern> <pattern> <name>Axis2Builder</name> </pattern> <pattern> <name>WebServiceBuilder</name> </pattern> </reference> </gbean> <gbean name="EjbRefBuilder"> <attribute name="eeNamespaces">http://java.sun.com/xml/ns/j2ee,http://java.sun.com/xml/ns/javaee</attribute> </gbean> <gbean name="ClientEjbRefBuilder"> <attribute name="eeNamespaces">http://java.sun.com/xml/ns/j2ee,http://java.sun.com/xml/ns/javaee</attribute> </gbean> </module> <module name="org.apache.geronimo.configs/client-deployer/2.0-M2/car"/> <module name="org.apache.geronimo.configs/cxf-deployer/2.0-M2/car"/> <module name="org.apache.geronimo.configs/axis2-deployer/2.0-M2/car"/> <module name="org.apache.geronimo.configs/axis-deployer/2.0-M2/car"> <gbean name="AxisServiceRefBuilder"> <attribute name="eeNamespaces">http://java.sun.com/xml/ns/j2ee,http://java.sun.com/xml/ns/javaee</attribute> </gbean> </module> <module name="org.apache.geronimo.configs/javamail/2.0-M2/car"> <gbean name="SMTPTransport"> <attribute name="host">localhost</attribute> <attribute name="port">25</attribute> </gbean> </module> <module name="org.apache.geronimo.configs/sharedlib/2.0-M2/car"> <gbean name="SharedLib"> <attribute name="classesDirs">var/shared/classes</attribute> <attribute name="libDirs">var/shared/lib</attribute> </gbean> </module> <module name="org.apache.geronimo.configs/tomcat6-deployer/2.0-M2/car"/> <module name="org.apache.geronimo.configs/welcome-tomcat/2.0-M2/car"/> <module name="org.apache.geronimo.configs/webconsole-tomcat/2.0-M2/car"/> <module load="false" name="org.apache.geronimo.configs/uddi-tomcat/2.0-M2/car"/> <module name="org.apache.geronimo.configs/remote-deploy-tomcat/2.0-M2/car"/> <module name="org.apache.geronimo.configs/hot-deployer/2.0-M2/car"/> <module load="false" name="org.apache.geronimo.configs/ca-helper-tomcat/2.0-M2/car"/> <module name="console.dbpool/LocalDB/1.0/rar"/> <module name="console.dbpool/jdbc%2FTradeDataSource/1.0/rar"/> </attributes>

A continuación hay dos porciones del archivo config.xml, una para Tomcat y otra para Jetty. Estas porciones muestran la sección completa donde los listeners son definidos, sólo hemos reemplazado al estándar 8080 con un puerto arbitrario, 9000 en este caso.

xmlsolidExcerpt from config.xml - Tomcat

<module name="org.apache.geronimo.configs/tomcat6/2.0-M2/car"> <gbean name="TomcatResources"/> <gbean name="TomcatWebConnector"> <attribute name="host">0.0.0.0</attribute> <attribute name="port">9000</attribute> <attribute name="redirectPort">8443</attribute> </gbean> <gbean name="TomcatAJPConnector"> <attribute name="host">0.0.0.0</attribute> <attribute name="port">8009</attribute> <attribute name="redirectPort">8443</attribute> </gbean> <gbean name="TomcatWebSSLConnector"> <attribute name="host">0.0.0.0</attribute> <attribute name="port">8443</attribute> </gbean> <gbean name="org.apache.geronimo.configs/tomcat6/2.0-M2/car?ServiceModule=org.apache.geronimo.configs/tomcat6/2.0-M2/car,j2eeType=GBean,name=TomcatWebContainer"> <attribute name="catalinaHome">var/catalina</attribute> </gbean> </module>

xmlsolidExcerpt from config.xml - Jetty

<module name="org.apache.geronimo.configs/jetty6/2.0-M2/car"> <gbean name="JettyWebConnector"> <attribute name="host">0.0.0.0</attribute> <attribute name="port">9000</attribute> <attribute name="redirectPort">8443</attribute> </gbean> <gbean name="JettySSLConnector"> <attribute name="host">0.0.0.0</attribute> <attribute name="port">8443</attribute> </gbean> </module> <module name="org.apache.geronimo.configs/geronimo-gbean-deployer/2.0-M2/car"/> <module name="org.apache.geronimo.configs/j2ee-deployer/2.0-M2/car"> <gbean name="WebBuilder"> <attribute name="defaultNamespace">http://geronimo.apache.org/xml/ns/j2ee/web/jetty-1.2</attribute> </gbean> <gbean name="EnvironmentEntryBuilder"> <attribute name="eeNamespaces">http://java.sun.com/xml/ns/j2ee,http://java.sun.com/xml/ns/javaee</attribute> </gbean> </module>

Guarda el archivo y reinicia al servidor; con la nueva configuración, apunta tu explorador web hacia el nuevo puerto.

http://localhost:9000/console