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.

The following software is required to run TORQUE 4.2.0 Early Access:

libxml2-devel package (package name may vary)
openssl-devel package (package name may vary)
ANSI C compiler. The native C compiler is recommended if it is ANSI; otherwise, use gcc.
A fully POSIX make. If you are unable to "make" PBS with your make, we suggest using gmake from GNU.
Tcl/Tk version 8 or higher if you plan to build the GUI portion of TORQUE or use a Tcl based scheduler.
If you use cpusets, libhwloc 1.1 or later is required (for TORQUE 4.0.0 and later)

To install TORQUE

Install the gcc, libssl-devel, and libxml2-devel packages to build 4.2.0 Early Access. 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++

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 libxml-devel libopenssl-devel gcc gcc-c++
Verify that the following ports are open for essential communication:
- For client communication to pbs_server, all privileged ports must be open (ports under 1024).
- For pbs_server communication to pbs_mom, the default port is 15003.
- For pbs_mom to pbs_server, the default port is 15001.
For more information on configuring ports, see Configuring Ports.
Download the TORQUE distribution file from http://www.adaptivecomputing.com/support/download-center/torque-download/. You can also download source code using Subversion from the repository at https://github.com/adaptivecomputing/torque/. Use the following command to display all branches:

svn list https://github.com/adaptivecomputing/torque/

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

Extract the packaged file and navigate to the unpackaged directory.

[root]# tar -xzvf torque-4.2.0 Early Access.tar.gz

[root]# cd torque-4.2.0 Early Access/

Do the following to configure the package:

Run ./configure. TORQUE has many options you can specify to configure your installation. For more information, see Customizing the install.
By default, the TORQUE directory is /var/spool/torque. If you want to change the location, use the --with-server-home configuration option.
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.
[root]# ./configure

Run make and make install.

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

[root]# make

[root]# make install

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

Configure the trqauthd daemon to start automatically at system boot (See Configuring trqauthd for client commands).
* If Debian distribution, do the following *
[root]# cp contrib/init.d/debian.trqauthd /etc/init.d/trqauthd

* If SLES distribution, do the following *
[root]# cp contrib/init.d/suse.trqauthd /etc/init.d/trqauthd

* If RHEL distribution, do the following *
[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
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 Specifying compute nodes.
You will also want to scp the init.d scripts to the compute nodes and install them there.
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
After installation, verify that you have the PATH environment variable configured to include /usr/local/bin/ and /usr/local/sbin/ for both the installation user and the root user.

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. This step is not necessary if the shared libraries are in their default locations.

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:

[root]# echo '/usr/local/lib' > /etc/ld.so.conf.d/torque.conf

[root]# 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 in the TORQUE Administrator Guide.).
Configure pbs_server and pbs_mom to start automatically at system boot, then start their daemons. See Enabling TORQUE as a service.

While Adaptive Computing distributes the spec files to create RPMs, it doesn't support RPM installation. 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.