|Home > Documentation > User's guide > Administration > Running Geronimo > Running Multiple Instances of Geronimo|
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.
Each instance gets its own copy of the following at
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!
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 following. All your instance data will be put in
<geronimo_home>/foo. All the directories named below are relative to
foo/var/config/config.substitutions.propertiesand change the portOffset. Try using 10, 20, 30.. etc for various instances.
We will be using
var as a template.
servers/geronimoiand change the portOffset for each instance.
org.apache.geronimo.server.namesystem property to the instance name before you start the server. Use the syntax
-Dorg.apache.geronimo.server.name=foofor an instance named
<geronimo_home>/foo. Add this to your
<geronimo_home>/bin/shutdown --port <port_num>
<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 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.
To use multiple repositories see: