Release Notes -- Apache Geronimo -- Version 1.1
Geronimo URLs
-------------
Home Page: http://geronimo.apache.org/
Downloads: http://geronimo.apache.org/downloads.html
Documentation: http://geronimo.apache.org/documentation.html
Mailing Lists: http://geronimo.apache.org/mailing.html
Source Code: http://geronimo.apache.org/svn.html
Bug Tracking: http://issues.apache.org/jira/browse/GERONIMO
Wiki: http://wiki.apache.org/geronimo
System Requirements
-------------------
You need a platform that supports the Sun JDK 1.4.2. CORBA support requires a
Sun Java 1.4.2 VM (specifically 1.4.2_08 or a higher 1.4.2_* release).
Most testing has been done on Linux, Mac OS X, and Windows.
Installing & Starting Geronimo
------------------------------
To install, simply unpack the .zip (Windows) or tar.gz (Unix) file containing
Geronimo.
If you wish to modify the default ports that Geronimo will use, edit the file
<geronimo_home>/var/config/config.xml
Geronimo comes with batch and script files to control server start and stop
functions. To see usage examples simply type geronimo.bat or geronimo.sh
command as appropriate for your platform. It is necessary to set JAVA_HOME to
the copy of your Sun 1.4.2 JDK/JRE prior to executing the command.
Here is an example to set JAVA_HOME:
export JAVA_HOME=<JDK/JRE_home>
To see the available command options type:
<geronimo_home>/bin/geronimo.sh
or
<geronimo_home>/bin/geronimo.bat
The command will display help text instructing you as to how to start and stop
the Geronimo server.
If you prefer to start the server without a script file you can simply type:
java -jar <geronimo_home>/bin/server.jar
Once the server has started, you can access the Geronimo Administration Console
at http://localhost:8080/console/ . The default user name is "system" and the
default password is "manager".
Administration Console Security Configuration
---------------------------------------------
The default administration user/password for the Geronimo Administration Console
and deployment tool is system/manager. To change this edit 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 during the install process. 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.
For more information on the commands and options supported by the deploy tool,
run:
<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.
Future Road Map at a Glance
---------------------------
http://issues.apache.org/jira/browse/GERONIMO?
report=com.atlassian.jira.plugin.system.project:roadmap-panel
(the above URL must be all on one line)
Significant Changes Since the 1.0 Release
----------------------------------------
* Deployment plans have been updated, ConfigId has been replaced by a more
complete ModuleId structure. Previous releases of Geronimo will require
modifications, refer to the Geronimo documentation for further details.
* Tools and commands have been also updated to reflect the ConfigID -> ModuleId
change as well as geronimo-config-1.1.xsd -> geronimo-module-1.1.xsd schemas.
* More functionality has been included in the Administrative Console
(http://localhost:8080/console/). Memory utilization graphics, more Thread
Pools, remote HTTPd configuration wizard and plugins are some of these new
features.
* All the applications (except for those deployed via Hot Deployment) are
stored in the <geronimo_home>/repository directory. Previous config-store has
been removed.
* Enhanced SMTP support.
* Keystore configuration.
* Little-G, a minimal, small footprint, Tomcat and Jetty configurations are
available.
Choice of Web container
-----------------------
Two versions of the Geronimo binary are available for download. There is a
version for the Jetty Web container and a version for the Tomcat Web
container. Both distributions are fully supported by the Geronimo team.
Please download the binary appropriate for your environment.
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.
Overall Project Status
----------------------
Apache Geronimo v1.1 introduces several structural changes improving
scalability, portability and overall organization as well as including new
features and functionality. This release continues the J2EE certification path
led the previous version of Geronimo providing a fully compliant and usable
J2EE container suitable for everything from development to Enterprise
deployments.
The next version of Geronimo is focused on several areas, including:
* Continue to enhance the performance and usability of the server.
* Improve cross-platform compatibility.
* Improve integration with third-party development tools and server products.
* Enhance configuration, administration and management tools.
* Improve clustering support for web containers and EJBs.
User feedback is critical for future released to be successful! The Geronimo
team is anxious to gather feedback to ensure we are meeting the needs and
expectations of the user community.
For more information on specific bugs or features, or to help with testing
efforts, please visit JIRA, our bug/issue tracking system, at
http://issues.apache.org/jira/browse/GERONIMO
Certification Status
--------------------
Geronimo 1.1 has passed the J2EE(tm) certification test suite and it is
officially J2EE certified.
Specific Issues, Features and Improvements fixed in Version 1.1
---------------------------------------------------------------
|