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 following software is required to run TORQUE 4.2.10:

• 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 your configuration uses cpusets, you must install libhwloc 1.1; the corresponding hwloc-devel package is also required.

To install TORQUE

1. Install the gcc, libssl-devel, and libxml2-devel packages to build 4.2.10. 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 libxml2-devel libopenssl-devel gcc gcc-c++

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

3. 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/torque.git -b 4.2.10     4.2.10

To download a different version, replace each 4.2.10 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.

4. Extract the packaged file and navigate to the unpackaged directory.

[root]# tar -xzvf torque-4.2.10.tar.gz

[root]# cd torque-4.2.10/

5. 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.
2. By default, the TORQUE directory is /var/spool/torque. If you want to change the location, use the --with-server-home configuration option.
3. 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=....

   [root]# ./configure

6. 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. Note that Mac OSX is not officially supported.

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

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

   

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

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

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

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

12. Initialize serverdb by executing the torque.setup script.

    [root]# ./torque.setup root

    

    If you are upgrading from TORQUE 2.5.9, run pbs_server -u before running torque.setup.

    [root]# pbs_server -u

13. Add nodes to the /var/spool/torque/server_priv/nodes file. For information on syntax and options for specifying compute nodes, see Node manager (MOM) configuration.
14. Configure the MOMs if necessary. See Configuring TORQUE on compute nodes..
15. Configure pbs_server and pbs_mom to start automatically at system boot, then start their daemons. See Enabling TORQUE as a service.

Related topics 

• TORQUE installation overview
• Compute nodes

© 2015 Adaptive Computing