This article provide details about the Apache Geronimo installation. Here you will find information about what are the prerequisite software, where to download Geronimo from and how to customize the installation to use custom ports other than the defaults.
In this document you will also find details about the installation and configuration of different topologies such as 2-tier with remote Web server.
This article is organized in the following sections:
Prerequisite software
Apache Geronimo v2.1 builds on J2SE 1.5 using Maven 2, get the appropriate JVM versions from the following sites.
- J2SE SDK (http://java.sun.com/)
- Apache Maven (http://maven.apache.org/) only needed if building from source.
Note: Ensure that after installing Java in your system the <java_home>/bin
directory is added to the system PATH and also ensure that both variables JAVA_HOME and JRE_HOME are also defined.
Building from source
From a command line console uncompress the source code (.zip or tar.gz) and change directory <geronimo_home>.
Type the following command to build Apache Geronimo:
mvn install
When you build from the source, by default, you build all the distributions described earlier. Detailed steps and requirements to build Geronimo from the source are covered in depth in the Building Geronimo with Maven section.
Installing Geronimo from binaries
Depending on the platform you plan to install and run Apache Geronimo download the appropriate installation image. Select the appropriate file compression format for your operating system (.zip, .tar.gz) by clicking directly on the link, download it and expand the binary to your hard drive in a new directory.
The installation of Apache Geronimo is as simple as uncompressing the .zip or .tar files. From a command line window change directory to <geronimo_home>/bin and start the server using the following command:
geronimo run
For your convenience, Apache Geronimo provides a series of scripts to manage the server and applications, visit the Tools and commands section for further details.