Drivers and nodes as services

In this section, it is assumed that you have downloaded and installed a JPPF driver distribution or one of the JPPF node distributions. The root installation folder of the driver or node will be desgnated as JPPF_HOME in the next sections.

1 Windows services with Apache's commons-daemon

Using the Apache commons-daemon utilities, it is possible to install a driver or node as a Windows service without any additional download. First a little bit of configuration checking and/or editing is required:

a) edit the file service.bat in the JPPF_HOME\bin\daemon folder in your favorite text editor

b) check the following environmment variables at the start of the file and make sure they match the JVM root location and architecture in your environment:

rem must point to the root installation folder of a JDK or JRE
set JRE_HOME=%JAVA_HOME%
rem JVM azrchitecture, must be one of 32, 64, ia64
set ARCH=64

If you need addtional jar files or class folders for your node or driver, you can either drop them in the JPPF_HOME\lib folder or specifiy them with the ADDITIONAL_CP environment variable, for example:

rem add more jars and class folders to the default classpath
set ADDITIONAL_CP=C:/libs/myJar.jar;C:/MypPoject/classes

When this is done, you are ready to install the JPPF driver or node as a Windows service:

service.bat install

To remove the service, use the following command:

service.bat uninstall

Lastly, the gui.bat script starts a utility which installs itself in the system tray and allows you to monitor, control and configure the service. Launch it with the following command:

gui.bat

2 Windows services with the Java Service Wrapper

JPPF drivers and nodes can be run as Windows Services using the Java Service Wrapper available at Tanuki Software. This is done by following these steps:

• download the Java Service Wrapper for your platform and copy the files wrapper.exe, wrapper.dll and wrapper.jar to the JPPF_HOME directory
• edit the file JPPF_HOME\config\wrapper-driver.conf or JPPF_HOME\config\wrapper-node.conf and check that the setting for the wrapper.java.command property is valid (either the PATH environment must contain a JRE, or the JRE installation directory must be entered here)
• run the InstallService.bat script in the JPPF_HOME\bin\jsw folder to install the JPPF service
• run the UninstallService.bat script in the JPPF_HOME\bin\jsw folder to uninstall the JPPF service

3 Unix daemons with the Java Service Wrapper

JPPF drivers and nodes can be run as Windows Services using the Java Service Wrapper available at Tanuki Software. This is done by following these steps:

• download the Java Service Wrapper for your platform and copy the files wrapper, libwrapper.so and wrapper.jar to the JPPF_HOME directory
• don't forget to set the executable bit for the JPPF_HOME/bin/jsw/JPPFDriver or JPPF_HOME/bin/jsw/JPPFNode and the wrapper scripts/executables
• edit the file JPPF_HOME/config/wrapper-driver.conf or JPPF_HOME/config/wrapper-node.conf and check that the setting for the wrapper.java.command property is valid (either the PATH environment must contain a JRE, or the JRE installation directory must be entered here)
• open a terminal in the JPPF_HOME/bin/jsw directory
• to run the driver or node as a daemon: ./JPPFDriver start or ./JPPFNode start
• to stop the driver or node: ./JPPFDriver stop or ./JPPFNode stop
• to restart the driver or node: ./JPPFDriver restart or ./JPPFNode restart