(Click to open topic with navigation)

Installation > Installing TORQUE

Installing TORQUE

These instructions describe how to install and start TORQUE.

Requirements

The following software is required to run TORQUE 4.5.0:

  • Libxml2-devel package (package name may vary)
  • Openssl-devel package (package name may vary)
  • GCC
  • A posix compatible version of make.
  • Tcl/Tk version 8 or higher if you plan to build the GUI portion of TORQUE or use a Tcl based scheduler.
  • If you want to use cpusets, libhwloc 1.1 or later is required (for TORQUE 4.0.0 and later)
Prerequisites
  • TORQUE requires certain ports to be 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 how to configure the ports that TORQUE uses for communication, see Configuring Ports.

    Important: If you intend to use TORQUE 4.5.0 with Moab, you must run Moab version 7.1 or later. TORQUE 4.5.0 will not work with versions earlier than Moab 7.1.

  • Make sure your host (with the correct IP address) is in your /etc/hosts file.
  • The libxml2-devel, openssl-devel, and boost-devel packages must be installed (These packages should already be installed from following the steps in the Installation overview).
    • [root]# yum install openssl-devel libxml2-devel boost-devel

To install TORQUE

  1. Switch the user to root.
    2. [user]$ su -
  2. Download the latest 4.5.0 build from the Adaptive Computing website. It can also be downloaded via command line.
    1. Clone the source from github. If you clone the source from github, the libtool package must be installed.
      2. [root]# yum install libtool
[root]# git clone https://github.com/adaptivecomputing/torque.git -b 4.5.04.5.0
[root]# cd 4.5.0
[root]# ./autogen.sh

      If you are using CentOS 5, 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
[root]# cd /tmp
[root]# git clone https://github.com/adaptivecomputing/torque.git -b 4.5.0 4.5.0
[root]# cd 4.5.0
[root]# ./autogen.sh
    2. Get the tarball source distribution.
      3. [root]# wget http://www.adaptivecomputing.com/download/torque/torque-4.5.0.tar.gz

[root]# tar -xzvf torque-4.5.0.tar.gz
[root]# cd torque-4.5.0/
  3. Run each of the following commands in order.
    4. [root]# ./configure
[root]# make
[root]# make install

    For information on what options are available to customize the ./configure command, see Customizing the install.

  4. Configure the trqauthd daemon to start automatically at system boot.
    5. * If Debian distribution, do the following *
[root]# cp contrib/init.d/debian.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 

* If SLES distribution, do the following *
[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

* 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
  5. 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.

    6. You will also want to scp the init.d scripts to the compute nodes and install them there.

  6. Verify that the /var/spool/torque/server_name file exists and contains the correct name of the server.
    7. [root]# echo <pbs_server's_hostname> > /var/spool/torque/server_name
  7. 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.
    8. [root]# export PATH=/usr/local/bin/:/usr/local/sbin/:$PATH
  8. Initialize serverdb by executing the torque.setup script.
    9. [root]# ./torque.setup root
  9. Add nodes to the /var/spool/torque/server_priv/nodes file. For information on syntax and options for specifying compute nodes, see Managing Nodes.
  10. Configure the MOMs if necessary (See Configuring TORQUE on compute nodes in the TORQUE Administrator Guide.).
  11. Configure pbs_server and pbs_mom to start automatically at system boot, and then start their daemons. 
    12. * If Debian distribution, do the following *
[root]# cp contrib/init.d/debian.pbs_server /etc/init.d/pbs_server
[root]# cp contrib/init.d/debian.pbs_mom /etc/init.d/pbs_mom
[root]# chkconfig --add pbs_server
[root]# chkconfig --add pbs_mom
[root]# service pbs_server restart
[root]# service pbs_mom start

* If SLES distribution, do the following *
[root]# cp contrib/init.d/suse.pbs_server /etc/init.d/pbs_server
[root]# cp contrib/init.d/suse.pbs_mom /etc/init.d/pbs_mom
[root]# chkconfig --add pbs_server
[root]# chkconfig --add pbs_mom
[root]# service pbs_server restart
[root]# service pbs_mom start

* If RHEL distribution, do the following *
[root]# cp contrib/init.d/pbs_server contrib/init.d/pbs_mom /etc/init.d
[root]# chkconfig --add pbs_server
[root]# chkconfig --add pbs_mom
[root]# service pbs_server restart
[root]# service pbs_mom start

Related topics