Running Multiple Instances of Geronimo has been edited by Joseph Leong (Feb 25, 2008).

(View changes)


It is possible to run multiple instances of geronimo on the same machine. Currently multiple instances of geronimo share the following directories in <geronimo_home>, the directory where you installed Geronimo.

  • bin
  • lib
  • schema
  • repository

Each instance gets its own copy of the following at <geronimo_home>/<instance_name>

  • var
  • deploy (hot deployment)

bin, lib and schema are read-only, and thus may be shared between instances. The repository is shared, i.e. an application deployed in one instance will show up in the list of deployed modules, but not running, in all the other instances!

Creating A New Server Instance

Be Careful

Start with a fresh image of geronimo. Do not use an image that has been used to run the default instance.

To create an instance named foo do the follwing. All your instance data will be put in <geronimo_home>/foo. All the directories named below are relative to <geronimo_home>.

  1. mkdir foo
  2. Copy var to foo.
  3. Edit foo/var/config/ and change the portOffset. Try using 10, 20, 30.. etc for various instances.

An Example

We will be using var as a template.

  • To create all the instances under a directory named servers copy var to servers/geronimoi and change the portOffset for each instance.
  • To run ith instance set property to servers/geronimoi.

Running An Instance

  1. Set the system property to the instance name before you start the server. Use the syntax for an instance named foo located at <geronimo_home>/foo. Add this to your GERONIMO_OPTS environment variable
    Windows Hint
  2. Start the server using startup
  3. To shutdown[] this instance use the port number of RMI Naming port (default 1099)
    <geronimo_home>/bin/shutdown --port <port_num>
  4. To []deploy applications to this instance use the port number of RMI Nmaing port
    <geronimo_home>/bin/deploy --port <port_num> deploy ......

The Geronimo Administration Console can also be used for all these operations. Connect to an instance by using the right HTTP port (default 8080)

The Default Instance

The default instance is nameless, i.e. it is run from <geronimo_home>/var. It can be deleted!

The default instance named 'geronimo' will be created and run using the following. It will use <geronimo_home>/geronimo for instance data.


Other Useful Enhancements

To use multiple repositories see:
Multiple Repositories

Powered by Atlassian Confluence (Version: 2.2.9 Build:#527 Sep 07, 2006) - Bug/feature request

Unsubscribe or edit your notifications preferences