Drivers and nodes as services

1 JPPF Driver

First you will need to obtain the driver package from the JPPF download page : JPPF-x.y.z-driver.zip.

Unzip the file JPPF-x.y.z-driver.zip in a location where you intend to run the JPPF server from.

This zip file contains all the binaries for running the server only.

To run the driver: go to the JPPF-x.y.z-driver folder and type “ant run”.

1.1 JPPF Driver as a Windows Service

A JPPF driver can be run as Windows Service using the Java Service Wrapper available at Tanuki Software.

The JPPF-x.y.z-driver.zip distribution and above are prepared for this installation.

To install:

• download the Java Service Wrapper for your platform and copy the files wrapper.exe, wrapper.dll and wrapper.jar to the JPPF driver install directory
• edit config/wrapper-driver.conf file, check that the setting for wrapper.java.command is valid (either the PATH environment must contain a Java 5 JRE, or the installation directory must be entered here)
• run the InstallDriverService.bat file to install the JPPF node service
• run the UninstallDriverService.bat file to uninstall the JPPF node service

1.2 JPPF Driver as a Linux/Unix daemon

The JPPF driver can be run as a Linux/Unix daemon using the Java Service Wrapper available at Tanuki Software.

The JPPF-x.y.z-driver.zip distribution and above are prepared for this installation.

To install:

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

2 JPPF Node

First you will need to obtain the node package from the JPPF download page : JPPF-x.y.z-node.zip.

Unzip the file JPPF-x.y.z-node.zip in a location where you intend to run a JPPF node on.

This zip file contains all the binaries for running a node only.

To run the node: go to the JPPF-x.y.z-node folder and type “ant run”.

2.1 JPPF Node as a Windows Service

The JPPF node can be run as Windows Service using the Java Service Wrapper available at http://wrapper.tanukisoftware.org/. The JPPF-x.y.z-node.zip distribution and above are prepared for this installation.

To install:

• download the Java Service Wrapper for your platform and copy the files wrapper.exe, wrapper.dll and wrapper.jar to the JPPF node install directory
• edit config/wrapper-node.conf file, check that the setting for wrapper.java.command is valid (either the PATH environment must contain a Java 5 JRE, or the installation directory must be entered here)
• run the InstallNodeService.bat file to install the JPPF node service
• run the UninstallNodeService.bat file to uninstall the JPPF node service

2.2 JPPF Node as a Linux/Unix daemon

The JPPF node can be run as a Linux/Unix daemon using the Java Service Wrapper available at Tanuki Software.

The JPPF-x.y.z-node.zip distribution and above are prepared for this installation.

To install:

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

2.3 JPPF Node in “Idle Host” mode

A node can be configured to run only when its host is considered idle, i.e. when no keyboard or mouse activity has occurred for a specified time. This requires additional libraries that must be downloaded separately due to licensing compatibility concerns, and used to compile and build a node add-on. Fortunately, we have automated the download and build process, to lae it as easy as possible.

To install and configure a node in idle mode:

• download the JPPF samples pack
• unzip the JPPF-x.y.z-samples-pack.zip anywhere on your file system
• open a command prompt or shell console in JPPF-x.y.z-samples-pack/IdleSystem
• run the build script: “ant jar”, or simply “ant”. This will download 2 jar files “jna.jar” and “platform.jar” and create a third one “IdleSystem.jar”, into the IdleSystem/lib directory.
• when this is done, copy the 3 jar files IdleSystem/lib into your node's library directory “JPPF-x.y.z-node/lib”
• to configure the node to run in idle mode, open the file “JPPF-x.y.z-node/config/jppf-node.properties” in a text editor and create or edit the following properties:
  • jppf.idle.mode.enabled = true to enable the idle mode
  • jppf.idle.timeout = 6000 to configure the time of keyboard and mouse inactivity before considering the node idle, expressed in milliseconds
  • jppf.idle.poll.interval = 1000 to configure how often the node will check for inactivity, in milliseconds
  • jppf.idle.detector.factory = org.jppf.example.idlesystem.IdleTimeDetectorFactoryImpl please do not change this!
• when this is all done, you can start the node and it will only run when the system has been idle for the configured time, and will stop as soon as any keyboard or mouse input occurs