Notas de Versión -- Apache Geronimo -- 2.0.1
URLs de Geronimo
-------------
Página Hogar: http://geronimo.apache.org/
Descargas: http://geronimo.apache.org/downloads.html
Documentación: http://geronimo.apache.org/documentation.html
Listas de Correo: http://geronimo.apache.org/mailing.html
Código Fuente: http://geronimo.apache.org/svn.html
Seguimiento de Bug: http://issues.apache.org/jira/browse/GERONIMO
Wiki: http://cwiki.apache.org/geronimo
Nota
----
¿Porqué existe 2.0.1 cuando nunca vi a 2.0?
Durante el lanzamiento de Geronimo 2.0 descubrimos un detalle relacionado con
seguridad, que exponía a un servidor en ejecución a usuarios no autorizados,
permitiendoles el ejecutar una activación (deploy) remota. El problema fue
descubierto durante el proceso de lanzamiento con lo cual el proyecto decidió
no continuar con el lanzamiento. Dado que el avance del lanzamiento había sido
suficiente, no fue apropiado el reusar el número de versión 2.0 a pesar de que
no se completó "oficialmente" ese lanzamiento.
Por esa razón 2.0.1 es el primer número del lanzamiento de la versión 2.0.
Información Actualizada
-----------------------
Por favor vea http://cwiki.apache.org/GMOxDOC20/release-notes-201txt.html para la
información más reciente de este lanzamiento.
Requisitos del Sistema
----------------------
Necesita una plataforma que soporte a Sun JDK 5.0+ (J2SE 1.5.0+). Otras MVs Java
deberían funcionar también.
La mayoría de pruebas han sido hechas en Linux, Mac OS X, y Windows.
Cambios Significativos en el Lanzamiento 2.0
--------------------------------------------
- Implementa la especificación Java Enterprise Edition 5.0 (Java EE 5)
- JAX-WS Web Services
- Dos máquinas JAX-WS integradas: Apache Axis2 y Apache CXF
- Los usuarios pueden configurar qué máquina JAX-WS usar.
Estado de la Certificación
--------------------------
Apache Geronimo v2.0 ha pasado el Java Enterprise Edition 5.0
Certification Test Suite al 100%. Consulte "Distribuciones"
para mayor detalle.
Distribuciones
--------------
Apache Geronimo v2.0 esta disponible en cinco distribuciones, tal que pueda
elegir la que mejor se acople a su ambiente.
Las distribuciones disponibles son las siguientes:
Distribuciones Certificadas:
- Apache Geronimo con Tomcat web container, AXIS2 para Web Services y OpenJPA
para persistencia.
- Apache Geronimo con Jetty web container, CXF para Web Services y OpenJPA
para persistencia.
Distribuciones No-Certificadas:
- Little-G con Tomcat web container, configuración mínima.
- Little-G con Jetty web container, configuración mínima.
- Micro-G, framework extendible de Geronimo reducido (stripped down).
Nota: Distribuciones No-Certificadas no contienen a todo el conjunto JavaEE5 y por
ello no se pueden certificar. Distribuciones Certificadas pueden ser reconfiguradas
por el usuario (por ejemplo, Tomcat web container con CXF para Web Services).
Características soportadas
--------------------------
Todos los elementos del modelo de programación de la Especificación Java EE 5.0
están disponibles. Algunos elementos no relacionados con la especificación como
clustering aún se encuentran en desarrollo.
Instalando e Iniciando Geronimo
-------------------------------
Para instalar, simplemente expande al archivo .zip (Windows) ó tar.gz (Unix)
que contiene a Geronimo.
Si deseas modificar los puertos predefinidos que usará Geronimo, edita al archivo
<geronimo_home>/var/config/config-substitutions.properties
Geronimo viene con archivos batch y script para controlar el inicio y fin de las
funciones del servidor. Para consultar ejemplos de uso, simplemente teclea al
comando apropiado para tu plataforma: geronimo.bat ó geronimo.sh . Es necesario el
establecer JAVA_HOME a la copia de tu JDK/JRE 5 de Sun antes de ejecutar el comando.
El siguiente es un ejemplo que establece a JAVA_HOME:
export JAVA_HOME=<JDK/JRE_home>
Para observar las opciones disponibles del comando, teclea:
<geronimo_home>/bin/geronimo.sh
ó
<geronimo_home>\bin\geronimo.bat
El comando desplegará el texto de ayuda indicándote el como iniciar y detener
al servidor Geronimo.
Si prefieres el iniciar al servidor sin un archivo script, puedes simplemente
teclear al siguiente comando desde el directorio <geronimo_home>:
java -Djava.endorsed.dirs=lib/endorsed -javaagent:bin/jpa.jar -jar bin/server.jar
Una vez iniciado el servidor, puedes tener acceso a la Consola de Administración de
Geronimo, en http://localhost:8080/console/ . El nombre de usuario predeterminado
es "system" y la contraseña predeterminada es "manager".
Nota para plataformas Windows:
Usuarios Windows, favor de recordar la limitante de longitud de path a 255 caracteres.
La instalación usual a directorios predefinidos como "Mis Documentos" ó "Archivos de
Programas" pueden causar que la instalación ó inicio de servidor falle. En su lugar,
intenta un <geronimo_home> a nivel raíz.
Configuración de Seguridad para la Consola de Administración
------------------------------------------------------------
El usuario y contraseña de administración predeterminados para la Consola de
Administración de Geronimo, así como de la herramienta deploy de línea de comandos
es system/manager. Puedes cambiar esos valores directamente de la Consola de
Administración de Geronimo mediante el acceso a Security -> Console Realm y
cambiando el nombre de usuario y contraseña desde el portlet Console Realm Users.
Como alternativa, puedes hacer los mismos cambios mediante la edición de los archivos
<geronimo_home>/var/security/users.properties
y
<geronimo_home>/var/security/groups.properties
Activando (Deploying) Aplicaciones
----------------------------------
Geronimo viene con scripts de activación y archivos batch para activar módulos
J2EE ó aplicaciones. Puedes usar los scripts ó simplemente invocar al jar ejecutable
mediante el siguiente comando (nota que primero requieres iniciar Geronimo):
<geronimo_home>/bin/java -jar deployer.jar deploy mi-web-app.war [plan de activación]
Necesitarás usar al usuario "system" y contraseña "manager" a menos los hayas
alterado como se decribió previamente. El argumento "plan de activación" (deployment
plan) es opcional -- puedes empacarlo en el módulo de la aplicación, proporcionarlo en
la línea de comandos, ó en algunos casos omitirlo completamente.
También puedes usar al comando "Login" para evitar el proporcionar un nombre de usuario
y contraseña cada vez que emplees la herramienta de activación.
Para mayor información en los comandos y opciones soportadas por la herramienta de
activación, ejecuta desde el directorio Geronimo <geronimo_home>/bin:
java -jar deployer.jar help [comando]
También puedes activar gráficamente aplicaciones y recursos mediante la Consola de
Administración de Geronimo disponible en http://localhost:8080/console/
Otras Opciones de Activación
----------------------------
Como alternativa a la activación de línea-de-comandos, puedes copiar los módulos de
aplicación en el directorio <geronimo_home>/deploy/ y el servicio de activación
en vivo (hot deployer service) le activará automáticamente. El activador de línea-
de-comandos tiene algunas ventajas, como el mostrar cualquier error de activación
a su propia consola, en lugar de sólo la bitácora del servidor.
Además, Geronimo proporciona un plugin Maven que puede activar aplicaciones en
Geronimo como parte de una construcción Maven.
Configuración
-------------
La mayoría de atriburos de configuración pueden ser actualizados en el archivo
<geronimo_home>/var/config/config.xml. Los atributos que suelen ser cambiados
ya son incluidos en el archivo config.xml, mientras otros podría ser necesario
el agregarlos manualmente.
------------------- PENDIENTE A TRADUCIR ------------------->
Known Issues and Limitations
----------------------------
- If Geronimo is configured with CXF as its JAX-WS engine, some Web Services
might not work correctly on non-Sun JDKs. That is because CXF uses Glassfish
SAAJ implementation which has dependencies on Sun proprietary classes
available only on Sun JDKs.
To workaround this issue and if Sun JDK is not available on your platform
configure Geronimo to use Axis2 as its JAX-WS engine.
Release Notes - Geronimo - Version 2.0
** Sub-task
* [GERONIMO-3040] - Implement process to ensure all annotations are discovered and processed
** Bug
* [GERONIMO-807] - Better handling for system log viewer portlet render requests
* [GERONIMO-1786] - JMS Listeners for protocols activeio, peer and openwire fail to start
* [GERONIMO-2286] - app client plan still uses Strings for dependency Module IDs
* [GERONIMO-2534] - Security realms portlet should validate the realm-name for duplicate name
* [GERONIMO-2699] - Module was not a war
* [GERONIMO-2771] - GlassFish specs are being included in 2.0-M2 builds
* [GERONIMO-2878] - JVM stats exposed through JMX are incorrect and missing init/max heap size
* [GERONIMO-2885] - JSF is leaking application ClassLoaders
* [GERONIMO-2950] - Build test failure in geronimo-naming
* [GERONIMO-3196] - ConcurrentModificationException in ?wsdl processing
* [GERONIMO-3270] - Avoid CMP foreign key violations
* [GERONIMO-3305] - Out Of Memory Error when Running DayTrader in WebServices Mode
* [GERONIMO-3322] - web apps with login config still object to server-side attribute.
* [GERONIMO-3332] - POJO Web-services under Geronimo fail with arrays as method call arguments
* [GERONIMO-3337] - Deploy of servlet-examples-tomcat-2.0-SNAPSHOT.car fails due to existing config.ser
* [GERONIMO-3341] - Slim down geronimo by removing unneeded jars from apps and repository
* [GERONIMO-3343] - Out Of Memory Error when deploying and undeploying applications
* [GERONIMO-3346] - Unable to render Plugins portlet in Jetty
* [GERONIMO-3349] - broken link in console when on the Apache HTTP page
* [GERONIMO-3350] - Console needs to administer all the web connectors. Needs WebManager change.
* [GERONIMO-3355] - unnecessary warning message when trying to create a new group in console realms
* [GERONIMO-3357] - <run-as> role is ignored in web.xml
* [GERONIMO-3358] - LocalAttributeManager needs write permissions even if readOnly is true
* [GERONIMO-3361] - Tomcat is using the wrong classloader to create LoginContext/LoginModules
* [GERONIMO-3362] - Enable Tomcat context level cluster
* [GERONIMO-3365] - config.xml condition vs. load attribute issues
* [GERONIMO-3366] - Dependency needed in openejb config to start OpenEjbSystem before the EntityManagerRegistry
* [GERONIMO-3368] - Axis2ClientConfigurationFactory not always being used in certain platforms
* [GERONIMO-3369] - MultiParentClassLoader does not check for hidden resources in recursiveFind()
* [GERONIMO-3370] - Create local build of OpenJPA in our local repo
* [GERONIMO-3375] - Upgrade to released xmlbeans-maven-plugin
* [GERONIMO-3387] - Unable to deploy an ear file (that contains a war file) if web.xml isn't supplied in the war file.
* [GERONIMO-3411] - Injection target entries are not added to existing env-entry entries.
** Improvement
* [GERONIMO-1874] - synthetic ears should allow use of modules outside the g repository
* [GERONIMO-2438] - adding CRAM-MD5 and DIGEST-MD5 authentication to POP3
* [GERONIMO-2498] - Geronimo should use the full javamail uber jar instead of just the spec jar + provider jar.
* [GERONIMO-2607] - GoperationInfo should include the return type for the operation
* [GERONIMO-2944] - Replace ancient ActiveIO usage in geronimo-security module
* [GERONIMO-3059] - CLIs refactoring - options and arguments parsing should be done prior the boot of a Kernel to provide a quicker feedback to users if they are invalid
* [GERONIMO-3194] - Upgrading documentation for deployment plan-geronimo-application.xml
* [GERONIMO-3344] - Split out non-kernel-dependent transaction and connector classes for use by openejb, jencks, etc etc.
* [GERONIMO-3352] - Upgrade to Jetty 6.1.5 (just released) for Geronimo 2.0
** New Feature
* [GERONIMO-1638] - Multiple servers sharing the same repo and config store
** Task
* [GERONIMO-2581] - Update Version Numbers of Dependent Projects for Geronimo Version 2.0
* [GERONIMO-2700] - JSR-88 1.2 Tasklist (JEE5 Deployment)
* [GERONIMO-3353] - Adjust server log4j files to use a default logging level of error instead of info before releasing.
* [GERONIMO-3364] - Finalize License/Notice files for 2.0 release
* [GERONIMO-3371] - Create local build of Axis2 in our local repo
<------------------- PENDIENTE A TRADUCIR -------------------
| 