TORQUE Resource Manager

TORQUE Administrator's Manual - 1.2 Basic Configuration

1.2 Basic Configuration

  • 1.2.1 Initialize/Configure TORQUE on the Server (pbs_server)
  • 1.2.2 Specify Compute Nodes
  • 1.2.3 Initialize/Configure TORQUE on Each Compute Node
  • 1.2.4 Finalize Configurations

   TORQUE only requires a few steps to get the system initially configured and running.  First, the server needs to know which compute nodes it can trust.  Second, the server should be initialized and configured.  Finally, each of the compute nodes need to know where the pbs_server is located.

1.2.1 Initialize/Configure TORQUE on the Server (pbs_server)

   Once installation on the TORQUE server is complete, configure the pbs_server daemon by executing the command torque.setup <USER> found packaged with the distribution source code, where <USER> is a username that will act as the TORQUE admin. (Click here for instructions to configure manually.) This script will setup a basic batch queue to get you started. If you experience problems, make sure that the most recent TORQUE executables are being executed, or that the executables are in your current PATH.
Proper server configuration can be verified by following the steps listed 1.4 Testing.

1.2.2 Specify Compute Nodes

In order for the pbs_server to communicate with each of the compute nodes, it needs to know which machines to contact.  Each node which is to be a part of the cluster must be specified on a line in the server nodes file.  This file is located at $TORQUECFG/server_priv/nodes.  In most cases, it is sufficient to specify just the node name on a line as in the following example:

server_priv/nodes
node001
node002
node003
node004

   If the compute node has multiple processors, specify the number of processors with np=<#CPUs>.  For example, if node001 has 2 processors and node002 has 4, use the following:

server_priv/nodes
node001 np=2
node002 np=4
...

For a full description of this file, please see Configuring the nodes File or the PBS Administrator Guide.

1.2.3 Initialize/Configure TORQUE on Each Compute Node

   If using TORQUE's self extracting packages, and using default compute node configuration, no additional steps are required and the remainder of this section can be skipped.

  If manual installation is occuring or more advanced compute node configuration is required, begin mom configuration by editing the $(TORQUECFG)/mom_priv/config file on each node.  Recommended settings are as follows:

mom_priv/config
$pbsserver      headnode          # note: hostname running pbs_server
$logevent       255               # bitmap of which events to log

  Since this file is identical for all compute nodes, it can be created on the head node and distributed in parallel to all systems.

1.2.4 Finalize Configurations

   After the serverdb is configured, the server_priv/nodes file is completed, and MOM has a minimal configuration, restart pbs_server:

mom_priv/config
qterm -t quick
pbs_server

  Wait a few seconds, and pbsnodes -a should list all nodes in state free.

See Also