Quick start - Apache Geronimo for the impatient
This article is organized in the following sections:
If you are in a hurry to have Apache Geronimo up and running right away, this article will provide you with some basic steps for downloading, building (when needed) and run the server in no time.
All you need is 5 to 10 minutes and to follow these basic steps.
| Table of Contents |
|---|
| Table of Contents |
|---|
| indent | 20px |
|---|
style | disc |
|---|
Prerequisite
When working with the Geronimo 2.1 binary downloads, J2SE 1.5 is required.
Apache Geronimo v2.1 provides full support for Sun JDK 5.0+ (J2SE 1.5.0+). Refer to the following URL for details on how to download and install J2SE 1.5: http://java.sun.com
Getting Geronimo
| indent |
|---|
|
Download Geronimo from [Geronimo Downloads|http://geronimo.apache.org/downloads.html]
Geronimo 2.1 is available in three assembly configurations:
{indent:2}
* Framework : Geronimo kernel core functionality
* Minimal : Web Container, Transaction, and Connector capabilities
* Java EE 5 : full Java EE 5 functionality
{indent:1}
Minimal and Java EE 5 assemblies are provided with Jetty or Tomcat Web Containers. You can find more information about the Jetty project [here|http://www.mortbay.org/]. More information on the Tomcat project is available [here|http://tomcat.apache.org/]. Both are excellent Web Containers that are compliant with the Servlet 2.5 and JSP 2.1 specifications. Your choice may be driven by your past experience and particular functionality requirements.
The remainder of these instructions assume you have chosen the Java EE 5 server with Jetty.
|
Installing Geronimo
| indent |
|---|
|
To install Geronimo, simply unzip or untar the downloaded file:
{indent:2}
{{tar zxvf geronimo-jetty6-javaee5-2.1-bin.tar.gz}}
{indent:1}
or
{indent:2}
{{unzip geronimo-jetty6-javaee5-2.1-bin.zip}}
{indent:1}
{note:title=Note for Windows users:}
The maximum path length for a directory path on Windows is 255 characters. Installing Geronimo into a long directory path may cause the installation or server start up to fail. It is recommended that you use a short directory name, such as "c:\g\".
{note}
The following sections describe commands which are relative to the geronimo-jetty6-javaee5-2.1 directory which the preceding installation will create.
|
Starting the Geronimo server
| indent |
|---|
|
You can start the Geronimo server using either of the following commands (there are .bat equivalents to the following *nix commands):
{indent:2}
* {{./bin/gsh geronimo/start-server}}
* {{./bin/geronimo.sh run}}
|
Stopping a Geronimo server
| indent |
|---|
|
You can stop a Geronimo server using any of the following techniques:
{indent:2}
* {{./bin/gsh geronimo/stop-server}}
* {{./bin/geronimo.sh stop}}
Control-c (assuming the process is running in the foreground) or equivalent process management command (e.g kill -2)
the shutdown feature of the Administrative Console.
|
Deploying an application
You can deploy an application archive (.war, .ear, or .jar) to a Geronimo server using any of the following techniques:
...
