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.
------------------- PENDIENTE A TRADUCIR ------------------->
Administration Console Security Configuration
---------------------------------------------
The default administration user/password for the Geronimo Administration Console
and command line deployment tool is system/manager. You can change these defaults
directly from the Geronimo Administration Console by accessing Security -> Console
Realm and change the user name and password from the Console Realm Users portlet.
As an alternative, you can make the same changes by editing the
<geronimo_home>/var/security/users.properties and
<geronimo_home>/var/security/groups.properties files.
Deploying Applications
----------------------
Geronimo comes with deploy scripts and batch files to deploy J2EE modules or
applications. You can use the scripts or simply invoke the executable jar by
running the following command (note that you need to start Geronimo first):
<geronimo_home>/bin/java -jar deployer.jar deploy my-web-app.war [deploy plan]
You will need to use the username "system" and password "manager" unless you
customized those as described above. The deployment plan argument is
optional -- you can pack a deployment plan into the application module, provide
it on the command line, or in some cases omit it entirely.
You can also use the "Login" command to avoid entering a user name and password
every time you use the deploy tool
For more information on the commands and options supported by the deploy tool,
run from within the Geronimo directory <geronimo_home>/bin:
java -jar deployer.jar help [command]
You can also graphically deploy applications and resources via the Geronimo
Administration Console available at http://localhost:8080/console/
Other Deployment Options
------------------------
As an alternative to the command-line deployer, you can copy application
modules into the <geronimo_home>/deploy/ directory and the
hot deployer service will deploy them automatically. The command-line deployer
has some advantages, as it will output any
deployment errors to its own console rather than just the server log.
Additionally, Geronimo provides a Maven plugin that can deploy applications to
Geronimo as part of a Maven build.
Configuration
-------------
Most configuration attributes can be updated in the
<geronimo_home>/var/config/config.xml file. The attributes most likely to be
changed are already included in the supplied config.xml file, while others may
need to be added manually.
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 -------------------
Notas de versión previa, de otros Milestones: