Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migration of unmigrated content due to installation of a new plugin

...

Anchortoptopexcerpt

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
borderStylesolid D:\geronimo-tomcat6-javaee5-2.2\bin>service_pr.bat install The service "geronimosrv" has been installed.

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:
No FormatborderStyle
solid D:\geronimo-tomcat6-javaee5-2.2\bin>service_pr.bat remove The service 'geronimosrv' has been removed.

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.
No FormatborderStyle
solid {D:\geronimo-tomcat6-javaee5-2.2\bin>g_service.bat wrapper | --> Wrapper Started as Console wrapper | Launching a JVM... jvm 1 | Wrapper (Version 3.2.3) http://wrapper.tanukisoftware.org jvm 1 | Copyright 1999-2006 Tanuki Software, Inc. All Rights Reserved. jvm 1 | jvm 1 | Booting Geronimo Kernel (in Java 1.5.0_06)... jvm 1 | Starting Geronimo Application Server v2.2 jvm 1 | jvm 1 | jvm 1 | [* ] 0% 0s Loading jvm 1 | [*- ] 0% 0s Loading org.apache.ge... jvm 1 | [*> ] 6% 0s Loading | [* ] 0% 0s Loading jvm 1 | [*- ] 0% 0s Loading org.apache.ge... jvm 1 | [*> ] 6% 0s Loading org.apache.ge... ... jvm 1 | [*********************************] 100% 19s Startup complete jvm 1 | Listening on Ports: jvm 1 | 1050 127.0.0.1 CORBA Naming Service jvm 1 | 1099 0.0.0.0 RMI Naming jvm 1 | 1527 0.0.0.0 Derby Connector jvm 1 | 2001 127.0.0.1 OpenEJB ORB Adapter jvm 1 | 4201 0.0.0.0 org.apache.geronimo.openejb.EjbDaemonGBean jvm 1 | 4242 0.0.0.0 Remote Login Listener jvm 1 | 6882 127.0.0.1 OpenEJB ORB Adapter jvm 1 | 8009 0.0.0.0 Tomcat Connector AJP jvm 1 | 8080 0.0.0.0 Tomcat Connector HTTP jvm 1 | 8443 0.0.0.0 Tomcat Connector HTTPS jvm 1 | 9999 0.0.0.0 JMX Remoting Connector jvm 1 | 61613 0.0.0.0 ActiveMQ Transport Connector jvm 1 | 61616 0.0.0.0 ActiveMQ Transport Connector jvm 1 | jvm 1 | Started Application Modules: jvm 1 | EAR: org.apache.geronimo.configs/webconsole-tomcat/2.2/car jvm 1 | RAR: org.apache.geronimo.configs/activemq-ra/2.2/car jvm 1 | RAR: org.apache.geronimo.configs/system-database/2.2/car jvm 1 | WAR: org.apache.geronimo.configs/dojo-tomcat/2.2/car jvm 1 | WAR: org.apache.geronimo.configs/remote-deploy-tomcat/2.2/car jvm 1 | WAR: org.apache.geronimo.configs/welcome-tomcat/2.2/car jvm 1 | jvm 1 | Web Applications: jvm 1 | http://localhost:8080/ jvm 1 | http://localhost:8080/console jvm 1 | 1 | http://localhost:8080/console-standard jvm 1 | http://localhost:8080/dojo jvm 1 | http://localhost:8080/remote-deploy jvm 1 | jvm 1 | Geronimo Application Server started

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.
noformat
borderStylesolid D:\geronimo-tomcat6-javaee5-2.2\bin>Install_Geronimo_NT.bat wrapper | Apache Geronimo v2.2 Server installed.

...

To remove the Apache Geronimo service run the following command:

...

You should get a confirmation screen similar to this example.
No FormatborderStyle
solid D:\geronimo-tomcat6-javaee5-2.2\bin>Uninstall_Geronimo_NT.bat wrapper | Apache Geronimo v2.2 Server removed.