Installing TORQUE

1.0 Installation and configuration > 1.1 TORQUE installation overview > Installing TORQUE

1.1.2 Installing TORQUE

Build the distribution on the machine that will act as the TORQUE server - the machine which monitors and controls all compute nodes by running the pbs_server daemon.

The built distribution package works only on compute nodes of a similar architecture. Nodes with different architecture must have the installation package built on them individually.

To install TORQUE

Install the gcc, libssl-devel, and libxml2-devel packages to build 4.1.7. The package names may vary. Use these commands to install the packages on the following operating systems:

RHEL, CentOS, and Scientific Linux:
```
[root]# yum update
[root]# yum install libxml2-devel openssl-devel gcc gcc-c++
```
If you are installing under EL5, run the following instead:
```
[root]# yum update
```
```
[root]# yum install krb5-workstation
[root]# yum install libxml2-devel openssl-devel gcc gcc-c++
```
SLES (You must have a licensed installation of SuSE and have installed the SuSE Linux Enterprise Software Development Kit and added the ISO to the repository):
```
[root]# zypper update
[root]# zypper install libxml2-devel libopenssl-devel gcc gcc-c++
```
TORQUE is now hosted at https://github.com under the adaptivecomputing organization. To download source, you will need to use the git utility. For example:

[root]# git clone https://github.com/adaptivecomputing.com/torque.git -b 4.1.7   4.1.7

To download a different version, replace each 4.1.7 with the desired version. After downloading a copy of the repository, you can list the current branches by typing git branch -a from within the directory of the branch you cloned.

If you're checking source out from git, read the README.building-40 file in the repository.

Extract the packaged file and navigate to the unpackaged directory.

> tar -xzvf torque-4.1.7.tar.gz

> cd torque-4.1.7/

Do the following to configure the package:
1. Run ./configure. TORQUE has many options you can specify to configure your installation. For more information, see Customizing the install.
  By default, make install installs all files in /usr/local/bin, /usr/local/lib, /usr/local/sbin, /usr/local/include, and /usr/local/man . You can specify an installation prefix other than /usr/local by using --prefix as an argument to ./configure. Note that TORQUE cannot be installed into a directory path that contains a space.
  If you decide to use --prefix to specify a custom directory and that directory does not already exist, you must create it before running ./configure --prefix=....
Run make and make install.

TORQUE must be installed by a root user. If running sudo fails, switch to root with su -.

> make

> sudo make install

OSX 10.4 users need to change #define __TDARWIN in src/include/pbs_config.h to #define __TDARWIN_8.

The TORQUE initialization scripts now installed in your /init.d directory are provided as a courtesy and may be modified at your discretion to work on your system.

After installation, verify that you have the PATH environment variable configured to include /usr/local/bin/ and /usr/local/sbin/.

By default, make install creates a directory at /var/spool/torque. This directory is referred to as TORQUE_HOME. TORQUE_HOME has several sub-directories, including server_priv/, server_logs/, mom_priv/, mom_logs/, and other directories used in the configuration and running of TORQUE.

Verify you have environment variables configured so your system can find the shared libraries and binary files for TORQUE.

To set the library path, add the directory where the TORQUE libraries are installed. For example, if your TORQUE libraries are installed in /usr/local/lib (if you changed the default library path at configure time, use that path instead.), execute the following:

> echo '/usr/local/lib' > /etc/ld.so.conf.d/torque.conf

> ldconfig

Initialize serverdb by executing the torque.setup script.
[root]# ./torque.setup root
Add nodes to the /var/spool/torque/server_priv/nodes file. As an example, the install server was automatically added to the nodes file as a compute node. For information on syntax and options for specifying compute nodes, see Node manager (MOM) configuration.
Configure the MOMs if necessary. See Configuring TORQUE on compute nodes.
Configure pbs_server and pbs_mom to start automatically at system boot, then start their daemons. See Enabling TORQUE as a service.
If you are upgrading TORQUE from version 2.5.9, start pbs_server with -u the first time after upgrading.
[root]# pbs_server -u

While Adaptive Computing distributes the RPM files as part of the build, it does not support those files. Not every Linux distribution uses RPM. Adaptive Computing provides a single solution using make and make install that works across all Linux distributions and most UNIX systems. We recognize the RPM format provides many advantages for deployment but it is up to the individual site to repackage the TORQUE installation to match their individual needs.