Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Quick start - Apache Geronimo for the impatient

Getting Geronimo

indent
1
1

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
1
1

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 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\".

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
1
1

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
1
1

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 <process-number>)
* the shutdown feature of the Administrative Console.

Deploying an application

indent
1
1

You can deploy an application archive (.war, .ear, or .jar) to a Geronimo server using any of the following techniques:

indent
2
2
  • ./bin/gsh deploy/deploy <path-to-application-archive>
  • ./bin/deploy.sh deploy <path-to-applicaton-archive>
  • cp <path-to-application-archive> deploy/
  • using the deploy capabilities in the Administrative Console
    indent
    1
    1
  • the software
  • Start the server
  • Create and deploy a sample application