...
Anchor
This article will show you how to configure Apache Geronimo server to run as a Microsoft Windows service. Currently, there are two options for running the server as a Windows service: using Apache Commons Daemon or using Java Service Wrapper.
Apache Commons Daemon
Software Prerequisites
...
<geronimo_home>\bin\service_pr.bat install
For example:
noformat
This will create a Geronimo service for the server with the name "geronimosrv" with default parameters. You can start/stop the Geronimo service using Windows' Services
tool or by using <geronimo_home>\bin\geronimosrvw.exe
tool.
...
...
By default the Geronimo service is be configured with "manual" startup type. Use Windows' Services
tool or geronimosrvw.exe
command to configure it to "automatic" if needed.
Default admin account "system" with password "manager" is used to shut down the service. Change this setting with the geronimosrvw.exe tool (in the "Shutdown" tab) if the default admin account is changed.
JAVA_OPTS and GERONIMO_OPTS environment variables are NOT read by the service_pr.bat script. If you need to add any options that shall be used to start/stop the service, you can use the geronimosrvw.exe tool to add them to the command line arguments in the "Startup" and/or "Shutdown" tab. You can also use the geronimosrv.exe command to do that.
For more help on how to use the geronimosrv.exe and geronimosrvw.exe command, refer to Apache Commons Daemon manual.
...
To remove the Apache Geronimo service run the following command:
<geronimo_home>\bin\service_pr.bat remove
For example: borderStyle No Format
solid
Java Service Wrapper
A Java Service Wrapper will be required as an additional software to achieve this configuration. Using a service wrapper gives you some additional "control" on the service you are configuring such as the ability to ping the service and take action if the service is down.
...
Create the configuration file as illustrated in the following example and place it in the <geronimo_home>/var/config/wrapper.conf directory to keep all the wrapper files within Geronimo's directory structure.
...
...
where
- replace <geronimo_home> and <java_home> with the appropriate settings for your environment.
...
Next we will create a batch file to run the service from the command line without the need of actually installing the service. This is particularly helpful when testing and debugging the configuration. Create the g_service.bat
batch file in the <geronimo_home>/bin directory and copy the content of the following example.
...
This file is a modified version from the one provided by the wrapper as a sample, it has been edited to specify the location of the wrapper.conf
file relative to Geronimo's var/config directory.
...
You should see a screen similar to the following example, note that part has been truncated for display purposes. borderStyle No Format
solid
Congratulations!!! you have now Geronimo server running as a Windows service.
...
The following two batch files are provided to install and remove Geronimo as a Windows service. Create the files in the <geronimo_home>/bin
directory and copy the content as depicted in the following examples.
...
...
To install Apache Geronimo as a MS Windows service run the following command:
...
You should get a confirmation screen similar to this example. No Format
...
...
To remove the Apache Geronimo service run the following command:
...
You should get a confirmation screen similar to this example. borderStyle No Format
solid