...
...
title | Warning |
---|
...
This article is organized as follows:
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 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!
The Default Instance 'geronimo'
Coming Soon!
The default instance named 'geronimo' will be created and run using the following. It will use <geronimo_home>/geronimo
for instance data.
...
Creating A New Server Instance
...
...
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>
.
mkdir foo
- Copy var to foo.
- Edit
foo/var/config/config.substitutions.properties
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
copyvar
toservers/geronimoi
and change the portOffset for each instance. - To run ith instance set org.apache.geronimo.server.name property to servers/geronimoi.
Running An Instance
- Set the
org.apache.geronimo.server.name
system property to the instance name before you start the server. Use the syntax-Dorg.apache.geronimo.server.name=foo
to name your for an instance namedfoo
located at<geronimo_home>/foo
. Add this to yourGERONIMO_OPTS
environment variableTip title Windows Hintset GERONIMO_OPTS=-Dorg.apache.geronimo.server.name=foo
- Start the server using
startupCode Block <geronimo_home>/bin/startup - To shutdown this instance use the port number of RMI Naming port (default 1099)
Code Block <geronimo_home>/bin/shutdown --port =<port_num> - To deploy applications to this instance use the port number of RMI Nmaing port
Code Block <geronimo_home>/bin/deploy --port <port_num> deploy ......
The administration console 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!
Coming Soon!
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