(Click to open topic with navigation)

You are here: 2 Installation and Configuration > TORQUE Installation Overview > Installing TORQUE

2.3 Installing TORQUE

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

In this topic:

2.3.1 Requirements

Supported Operating Systems

CentOS 5.9, RHEL 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

If you intend to use TORQUE 5.1.1 with Moab Workload Manager, you must run Moab version 8.1.1 or 8.0.x. TORQUE 5.1.1 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:

2.3.2 Prerequisites

Open Necessary Ports

TORQUE requires certain ports to be open for essential communication:

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

If you have a firewall enabled, do the following:

Verify the hostname

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.

2.3.3 Install Dependencies and Packages

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

    • TORQUE requires Boost version 1.36.0 or greater. The boost-devel package provided with Red Hat 5-based systems is older than this requirement. A new option, --with-boost-path has been added to configure (see 2.13 Customizing the Install 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.

    2.3.4 Install TORQUE

    Do the following:

    1. Switch the user to root.
      2. [user]$ su -
    2. 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:

        # Red Hat-based systems
[root]# yum install git 
 
# SUSE-based systems
[root]# zypper install git
        [root]# git clone https://github.com/adaptivecomputing/torque.git -b 5.1.1 5.1.1 
[root]# cd 5.1.1
[root]# ./autogen.sh
      • Get the tarball source distribution.

        • Red Hat-based systems

          [root]# yum install wget
          [root]# wget http://www.adaptivecomputing.com/download/torque/torque-5.1.1.tar.gz -O torque-5.1.1.tar.gz
          [root]# tar -xzvf torque-5.1.1.tar.gz
          [root]# cd torque-5.1.1/
        • SUSE-based systems
          [root]# zypper install wget
          [root]# wget http://www.adaptivecomputing.com/download/torque/torque-5.1.1.tar.gz -O torque-5.1.1.tar.gz
          [root]# tar -xzvf torque-5.1.1.tar.gz
          [root]# cd torque-5.1.1/
    3. 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 2.13 Customizing the Install.

    4. Configure the trqauthd daemon to start automatically at system boot.
      • Red Hat 6-based systems 
        [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
      • SUSE 11-based systems 
        [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
      • Red Hat 7-based and SUSE 12-based systems 
        [root]# cp contrib/systemd/trqauthd.service /usr/lib/systemd/system/
        [root]# systemctl enable trqauthd.service
        [root]# echo /usr/local/lib > /etc/ld.so.conf.d/torque.conf
        [root]# ldconfig
        [root]# systemctl start trqauthd.service
    5. Verify that the /var/spool/torque/server_name file exists and contains the correct name of the server.
      6. [root]# echo <pbs_server's_hostname> > /var/spool/torque/server_name
    6. 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.
      7. [root]# export PATH=/usr/local/bin/:/usr/local/sbin/:$PATH
    7. Initialize serverdb by executing the torque.setup script.
      8. [root]# ./torque.setup root
    8. Add nodes to the /var/spool/torque/server_priv/nodes file. For information on syntax and options for specifying compute nodes, see 2.7 Specifying Compute Nodes.
    9. Configure the MOMs if necessary. See 2.8 Configuring TORQUE on Compute Nodes.

      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 2.4 Compute Nodes.

    10. On the TORQUE Server, configure pbs_server to start automatically at system boot, and then start the daemon.
      • Red Hat 6-based systems 
        [root]# cp contrib/init.d/pbs_server /etc/init.d
[root]# chkconfig --add pbs_server
[root]# service pbs_server restart
      • SUSE 11-based systems
        [root]# cp contrib/init.d/suse.pbs_server /etc/init.d/pbs_server
[root]# chkconfig --add pbs_server
[root]# service pbs_server restart
      • Red Hat 7-based and SUSE 12-based systems
        [root]# qterm
        [root]# cp contrib/systemd/pbs_server.service /usr/lib/systemd/system/
        [root]# systemctl enable pbs_server.service
        [root]# systemctl start pbs_server.service
    11. Configure pbs_mom to start automatically at system boot on each compute node, and then start the daemon.

      12. 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.

      On the TORQUE MOM, do the following:

      • Red Hat 6-based systems 
        [root]# cp contrib/init.d/pbs_mom /etc/init.d
        [root]# chkconfig --add pbs_mom
        [root]# service pbs_mom start
      • SUSE 11-based systems
        [root]# cp contrib/init.d/suse.pbs_mom /etc/init.d/pbs_mom
        [root]# chkconfig --add pbs_mom
        [root]# service pbs_mom start
      • Red Hat 7-based and SUSE 12-based systems
        [root]# cp contrib/systemd/pbs_mom.service /usr/lib/systemd/system/
        [root]# systemctl enable pbs_mom.service
        [root]# systemctl start pbs_mom.service

    © 2015 Adaptive Computing