Apache Geronimo v2.0.1 (August, 2007)
This README serves as five minute overview of Geronimo, but better
documentation can be found here:
Please read the RELEASE NOTES for a complete list of features that are
available in this release, as well as improvements and bug fixes.
If you've downloaded and unpacked a binary distribution of Geronimo,
then you are finished with installation.
If you wish to modify the default ports that Geronimo will use, edit the file
Note for Windows platform:
Windows users keep in mind the directory path length limitation of 255 characters.
Defaulting installation to predefined directories such as "My Documents" or
"Program Files" may cause the installation or the server start up to fail. Try a
<geronimo_home> at a root level instead.
Starting and Stopping
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 5 JDK/JRE prior to executing the command.
To see the available command options type:
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
the following command from <geronimo_home> directory:
java -Djava.endorsed.dirs=lib/endorsed -javaagent:bin/jpa.jar -jar bin/server.jar
Once the server has started, you can access the welcome application by
pointing your browser to:
To access the Geronimo Administration Console point your browser to:
The default user name is "system" and the default password is "manager".
Geronimo comes with deploy scripts and batch files to deploy JEE modules or
applications. You can either use the scripts or simply invoke the executable
jar by running the following command:
<geronimo_home>/bin/java -jar deployer.jar deploy my-web-app.war [deploy plan]
If you use the scripts provided then the command would be as follows:
<geronimo_home>/bin/deploy deploy my-web-app.war [deploy plan]
You will need to use the username "system" and password "manager" unless you
changed the defaults.
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 from within the Geronimo directory <geronimo_home>/bin:
java -jar deployer.jar help [command]
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 you can also graphically deploy applications and resources via
the Geronimo Administration Console available at:
Any problems with this release can be reported to the Geronimo
mailing list or Jira issue tracker.
Mailing list archive:
Mailing list subscription:
Notice Regarding Cryptographic Software
This distribution includes cryptographic software. The country in
which you currently reside may have restrictions on the import,
possession, use, and/or re-export to another country, of
encryption software. BEFORE using any encryption software, please
check your country's laws, regulations and policies concerning the
import, possession, or use, and re-export of encryption software, to
see if this is permitted. See <http://www.wassenaar.org/> for more
The U.S. Government Department of Commerce, Bureau of Industry and
Security (BIS), has classified this software as Export Commodity
Control Number (ECCN) 5D002.C.1, which includes information security
software using or performing cryptographic functions with asymmetric
algorithms. The form and manner of this Apache Software Foundation
distribution makes it eligible for export under the License Exception
ENC Technology Software Unrestricted (TSU) exception (see the BIS
Export Administration Regulations, Section 740.13) for both object
code and source code.
The following provides more details on the included cryptographic
Software related to cryptographic functionality is located in
an artifcact referred to as geronimo-util. The source code for
this functionality can be reviewed at:
The URL above is a reference to the Apache Geronimo Server source
tree for all development (and released) source trees.