This chapter explains how to install and operate EnFuzion software on Linux/Unix computers. The EnFuzion software consists of the EnFuzion root components, the EnFuzion node components and the EnFuzion submit components. These components must be installed on computers that will act as EnFuzion roots, EnFuzion nodes or EnFuzion submit hosts, respectively. The chapter covers EnFuzion software installation, EnFuzion license installation, enabling Linux/Unix node computers for EnFuzion use, installation of EnFuzion as a service, network installation, installation in a mixed Linux/Unix and Windows NT/2000/XP environment, removal of EnFuzion software and Linux/Unix specific issues of EnFuzion operation.
EnFuzion software must be installed on each Linux/Unix computer that will be used as an EnFuzion root, an EnFuzion node or an EnFuzion submit host. The simplest method for installing EnFuzion on Linux/Unix is to execute an installation script from the distribution package. Separate scripts are provided for EnFuzion root installation, for EnFuzion node installation and for EnFuzion submit installation.
The following sections provide details about EnFuzion root, node and submit installation.
To install EnFuzion software on a root host, perform the following steps:
Obtain the EnFuzion distribution package for your Linux/Unix system. Packages are available from the Axceleon Web site.
Login to the system under the account that will be used to execute EnFuzion root programs. EnFuzion processes on the root system will be executing under this account and the use of a dedicated account for this purpose is encouraged. It is recommended that a new account, called enfuzion is created and used to install the EnFuzion software. Since this account name is used by default if EnFuzion is installed as a network service, it simplifies later installation steps.
Root user privileges are not required at this step of EnFuzion root installation. Root privileges will be required later, if EnFuzion is installed as a service. However, if the installation of the EnFuzion root software is performed by the root user, then installation directories on EnFuzion root will be different to provide a system wide access to EnFuzion binaries.
Unpack the package to a temporary directory, using the tar and gunzip utilities on your system. The distribution package and the extraction directories can be deleted after the installation, since they are not required for EnFuzion operation.
Install EnFuzion root components by executing the install-root script in the directory with the extracted EnFuzion distribution files. If the installation is performed by a regular user, the EnFuzion root components are installed to the directory $HOME/enfuzion. If the installation is performed by the root user, the components are installed to the directory /usr/local/enfuzion. The default installation directory can be changed by providing the target directory as an optional argument to install-root.
Add the path for EnFuzion executables to the PATH environment variable. This step allows you to execute EnFuzion binaries from a command line, without specifying the entire path. If EnFuzion was installed by a regular, non-root user, the default path for executables is $HOME/enfuzion/bin. If EnFuzion was installed by a root user, the default executable path is /usr/local/enfuzion/bin.
(optional) EnFuzion can be installed to provide a service on the network. Details are described in the Section called Installing EnFuzion as a Network Service.
To install EnFuzion software on a node host, perform the following steps on each node system:
Obtain the EnFuzion distribution package for your Linux/Unix system. Packages are available from the Axceleon Web site.
Login to the system under the account that will be used to execute EnFuzion programs. On EnFuzion node systems, it is recommended that a new account is created and used to install the EnFuzion software. The proposed name and a group for the account are enfuzion. EnFuzion processes on the node system will be executing under this account and the use of a dedicated account for this purpose is encouraged.
Unpack the package to a temporary directory, using the tar and gunzip utilities on your system. The distribution package and the extraction directories can be deleted after the installation, since they are not required for EnFuzion operation.
Install EnFuzion node components by executing the install-node script in the directory with the extracted EnFuzion distribution files. If several EnFuzion nodes share home directories with NFS or a similar file sharing method, then the EnFuzion node software needs to be installed only on one node.
If the installation is performed by a regular user, the EnFuzion node components are installed to the directory $HOME/enfuzion. If the installation is performed by the root user, the components are installed to the directory /usr/local/enfuzion, If the EnFuzion node software is installed under the root account, it is strongly recommended for security reasons that it is not operated under the root account, since user jobs will gain root privileges on the system.
To install EnFuzion software on a submit host, perform the following steps on each system:
Obtain the EnFuzion distribution package for your Linux/Unix system. Packages are available from the Axceleon Web site.
Login to the system under the account that will be used to execute EnFuzion programs. EnFuzion software must be installed under all user accounts that will be used to submit jobs. Alternatively, the software can be installed to a common directory that is accessible to all users. There is no need to create any new EnFuzion specific accounts on submit systems.
Unpack the package to a temporary directory, using the tar and gunzip utilities on your system. The distribution package and the extraction directories can be deleted after the installation, since they are not required for EnFuzion operation.
Install EnFuzion submit software by executing the install-submit script in the directory with the extracted EnFuzion distribution files. If the installation is performed by a regular user, the EnFuzion submit components are installed to the directory $HOME/enfuzion. If the installation is performed by the root user, the components are installed to the directory /usr/local/enfuzion. The default installation directory can be changed by providing the target directory as an optional argument to install-submit.
Add the path for EnFuzion executables to the PATH environment variable for each user. This step allows you to execute EnFuzion binaries from a command line, without specifying the entire path. If EnFuzion was installed by a regular, non-root user, the default path for executables is $HOME/enfuzion/bin. If EnFuzion was installed by a root user, the default executable path is /usr/local/enfuzion/bin.
If EnFuzion is already installed on the system, you can simply repeat the installation process. The new installation will overwrite the existing installation, except the configuration files. If a configuration file already exists, it will be unchanged. The new installed configuration file will be copied to the target directory with the .new suffix added to its name.
Make sure that you upgrade EnFuzion root, node, and submit software at the same time, using the same EnFuzion release.
If several EnFuzion nodes share home directories with NFS or a similar file sharing method, then the EnFuzion node software can be installed only on one node. It is strongly recommended that EnFuzion node software is not installed or operated under the root user. For an automated installation of EnFuzion across multiple computers, refer to the Section called Network Installation on Linux/Unix below.
If you experience any problems during installation, you can send e-mail to support@axceleon.com and report the problems. Please include the following information:
output from the failed installation process
the contents of the install-*.log files, which provide a log of installation events.