TORQUE Resource Manager > Installation and Configuration > TORQUE Installation Overview > Installing TORQUE

Installing TORQUE

This topic contains instructions on how to install and start TORQUE.

In this topic:

Requirements
Prerequisites
Dependencies and Packages Installation
Installing TORQUE

Requirements

Supported Operating Systems

CentOS 6.x
Red Hat 6.x
Scientific Linux 6.x
SUSE Linux Enterprise Server 11

CentOS 5.9, Red Hat 5.9 and Scientific Linux 5.9 are supported, largely to continue support for clusters where the compute nodes operating systems cannot be upgraded. We recommend that the TORQUE head node run on the supported operating systems listed above.

Software Requirements

libxml2-devel package (package name may vary)
openssl-devel package (package name may vary)
Tcl/Tk version 8 or later if you plan to build the GUI portion of TORQUE or use a Tcl based scheduler
If you use cpusets, libhwloc 1.2 is required for TORQUE 5.1.0 or 5.0.x; 1.1 is required for TORQUE 4.2.9

If you intend to use TORQUE 5.1.0 with Moab Workload Manager, you must run Moab version 8.1.0 or 8.0.x. TORQUE 5.1.0 will not work with versions earlier than Moab 8.0.

If you build TORQUE from source (i.e. clone from github), the following additional software is required:

gcc
gcc-c++
A posix compatible version of make
libtool 1.5.22
boost-devel 1.36.0

Prerequisites

If using a firewall, open necessary ports.

TORQUE requires certain ports to be open for essential communication:

For client and pbs_mom communication to pbs_server, the default port is 15001.
For pbs_server communication to pbs_mom, the default port is 15002.
For pbs_mom communication to pbs_mom, the default port is 15003.

To open ports in your firewall:

Red Hat-based distributions using iptables:

[root]# iptables-save > /tmp/iptables.mod
[root]# vi /tmp/iptables.mod

# Add the following lines immediately *before* the line matching
# "-A INPUT -j REJECT --reject-with icmp-host-prohibited"
										
# Needed on the TORQUE server for client and MOM communication
 -A INPUT -p tcp --dport 15001 -j ACCEPT
										
# Needed on the TORQUE MOM for server and MOM communication
-A INPUT -p tcp --dport 15002 -j ACCEPT
-A INPUT -p tcp --dport 15003 -j ACCEPT

[root]# iptables-restore < /tmp/iptables.mod
[root]# service iptables save

SuSE-based distributions using SuSEfirewall2:

[root]# vi /etc/sysconfig/SuSEfirewall2

# Add the following ports to the FW_SERVICES_EXT_TCP parameter as required

# Needed on the TORQUE server for client and MOM communication
FW_SERVICES_EXT_TCP="15001"

# Needed on the TORQUE MOM for server and MOM communication
FW_SERVICES_EXT_TCP="15002 15003"

[root]# service SuSEfirewall2_setup restart

For more information on how to configure the ports that TORQUE uses for communication, see Configuring Ports.

Make sure your host (with the correct IP address) is in your /etc/hosts file. To verify that the hostname resolves correctly, make sure that hostname and hostname -f report the correct name for the host.

Dependencies and Packages Installation

Install the libxml2-devel, openssl-devel, and boost-devel packages.

RHEL 6.x, CentOS 6.x, and Scientific Linux 6.x:

[root]# yum install libtool openssl-devel libxml2-devel boost-devel gcc gcc-c++

SLES:

[root]# zypper install libopenssl-devel libtool libxml2-devel boost-devel gcc gcc-c++ make gmake

RHEL 5, CentOS 5, and Scientific Linux 5:

[root]# yum install openssl-devel libtool-devel libxml2-devel gcc gcc-c++ wget

Use these instructions for installing libtool:

[root]# cd /tmp
[root]# wget http://ftpmirror.gnu.org/libtool/libtool-2.4.2.tar.gz
[root]# tar -xzvf libtool-2.4.2.tar.gz 
[root]# cd libtool-2.4.2
[root]# ./configure --prefix=/usr
[root]# make
[root]# make install

TORQUE requires Boost version 1.36.0 or greater. The boost-devel package provided with RHEL 5, CentOS 5, and Scientific Linux 5 is older than this requirement. A new option, --with-boost-path has been added to configure (see Customizing the Install in the TORQUE Administrator Guide for more information). This allows you to point TORQUE to a specific version of boost during make. One way to compile TORQUE without installing Boost is to simply download the Boost version you plan to use from: http://www.boost.org/users/history/. Next, untar Boost—you do not need to build it or install it. When you run TORQUE configure, use the --with-boost-path option pointed to the extracted Boost directory.

Installing TORQUE

Switch the user to root.

[user]$ su -

Download the latest 5.1 build from the Adaptive Computing website. It can also be downloaded via command line (github method or the tarball distribution).

Clone the source from github.

If git is not installed:

# RHEL, CentOS, Scientific Linux:
[root]# yum install git 
 
# SLES:
[root]# zipper install git

[root]# git clone https://github.com/adaptivecomputing/torque.git -b <version> <version> 
[root]# cd <version>
[root]# ./autogen.sh

Get the tarball source distribution.

[root]# yum install wget
[root]# wget http://www.adaptivecomputing.com/download/torque/torque-<version>.tar.gz -O torque-<version>.tar.gz

[root]# tar -xzvf torque-<version>.tar.gz 
[root]# cd torque-<version>/

Run each of the following commands in order.
```
[root]# ./configure
[root]# make
[root]# make install
```
For information on what options are available to customize the ./configure command, see Customizing the Install.
Configure the trqauthd daemon to start automatically at system boot.

# RHEL, CentOS, Scientific Linux:
[root]# cp contrib/init.d/trqauthd /etc/init.d/
[root]# chkconfig --add trqauthd
[root]# echo /usr/local/lib > /etc/ld.so.conf.d/torque.conf
[root]# ldconfig
[root]# service trqauthd start

# SLES:
[root]# cp contrib/init.d/suse.trqauthd /etc/init.d/trqauthd
[root]# chkconfig --add trqauthd
[root]# echo /usr/local/lib > /etc/ld.so.conf.d/torque.conf
[root]# ldconfig
[root]# service trqauthd start

Verify that the /var/spool/torque/server_name file exists and contains the correct name of the server.

[root]# echo <pbs_server's_hostname> > /var/spool/torque/server_name

By default, TORQUE installs all binary files to /usr/local/bin and /usr/local/sbin. Make sure the path environment variable includes these directories for both the installation user and the root user.

[root]# export PATH=/usr/local/bin/:/usr/local/sbin/:$PATH

Initialize serverdb by executing the torque.setup script.

[root]# ./torque.setup root

Add nodes to the /var/spool/torque/server_priv/nodes file. For information on syntax and options for specifying compute nodes, see Specifying Compute Nodes.
Configure the MOMs if necessary (see Configuring TORQUE on Compute Nodes in the TORQUE Administrator Guide).
The make packages command can be used to create self-extracting packages that can be copied and executed on your nodes. For information on creating packages and deploying them, see Compute Nodes.

Configure pbs_server to start automatically at system boot, and then start the daemon.

TORQUE Server on RHEL, CentOS, and Scientific Linux:

[root]# cp contrib/init.d/pbs_server /etc/init.d
[root]# chkconfig --add pbs_server
[root]# service pbs_server restart

TORQUE Server on SLES:

[root]# cp contrib/init.d/suse.pbs_server /etc/init.d/pbs_server
[root]# chkconfig --add pbs_server
[root]# service pbs_server restart

Configure pbs_mom to start automatically at system boot on each compute node, and then start the daemon.
There are several methods to get the following inti.d scripts on to each node. The following instructions assume the entire contents of contrib/init.d in the TORQUE git repository or source tarball are copied(scp)/cloned to the compute node.
These options can be added to the self-extracting packages.
- TORQUE MOM on RHEL, CentOS, and Scientific Linux:
```
[root]# cp contrib/init.d/pbs_mom /etc/init.d
[root]# chkconfig --add pbs_mom
[root]# service pbs_mom start
```
- TORQUE MOM on SLES:
```
[root]# cp contrib/init.d/suse.pbs_mom /etc/init.d/pbs_mom
[root]# chkconfig --add pbs_mom
[root]# service pbs_mom start
```