The Dispatcher can be installed as a network service, which is automatically started at the computer boot time and available to remote users over the network. This configuration is suitable for environments where the nodes are shared by more than one user and jobs are submitted remotely to the Dispatcher.
EnFuzion provides a script for a straightforward network service installation on a Red Hat Linux operating system. The installation must be performed manually on other operating systems. The installation steps on the Red Hat Linux operating system and the manual installation on other systems is described below.
To install EnFuzion as a network service on the root system with Red Hat Linux, perform the following steps:
Install EnFuzion root software on the system as described in the Section called Installing EnFuzion Software on Linux/Unix.
Login to the system under the root account.
Install EnFuzion service by executing the install-service script in the directory with the extracted EnFuzion distribution files.
The script assumes that the EnFuzion root software is installed under the enfuzion user and in the default installation directory. Otherwise, the user, the group, and the installation directory can be specified by executing:
install-service <user> <group> [ <directory> ]For security reasons, it is recommended that the use of the root account is avoided and that the EnFuzion root software is not running under the root account.
The install-service script installs the EnFuzion init script, enables the script execution at the boot time, creates the EnFuzion working directory /var/local/enfuzion and sets the service port to 10102. The default directory can be changed by editing the value of DISPATCHER_WORK_DIR in the /etc/init.d/enfuzion script. The default port can be changed by editing the value of DISPATCHER_PORT in the /etc/init.d/enfuzion script.
To install EnFuzion manually as a network service on the root system, perform the following steps:
Install EnFuzion root software on the system as described in the Section called Installing EnFuzion Software on Linux/Unix.
Login to the system under the account that was used for installation.
Create the Dispatcher working directory under the account that was used to install EnFuzion root software.
Start the Dispatcher in the working directory with command:
enfdispatcher -m -r -d -p 10102
This command starts the service on port 10102. Change the number to provide the EnFuzion service on a different port.
(optional)To start the Dispatcher at the boot time, include its execution in the system init sequence. Details depend on your system. Although the system init sequence is usually performed by the root user account, it is highly discouraged to run EnFuzion service under the root user. To avoid this problem, set EnFuzion executables to run under a non-privileged user account. The recommended options for the Dispatcher are:
enfdispatcher -m -r -d -p 10102
This command starts the service on port 10102. Change the number to provide the EnFuzion service on a different port.
On the Red Hat Linux, the init script is called enfuzion-init-script and located in the config directory of the Linux distribution package. This script can be used as a template for other platforms. Although there is no guarantee, the Red Hat Linux service installation and its script might work on other common Linux distributions.