Manual setup of initial server configuration
On a new installation of TORQUE, the server database must be initialized using the command pbs_server -t create. This command creates a file in $TORQUEHOME/server_priv named serverdb which contains the server configuration information.
The following output from qmgr shows the base configuration created by the command pbs_server -t create:
qmgr -c 'p s'
#
Set server attributes.
#
set server acl_hosts = kmn
set server log_events = 511
set server mail_from = adm
set server node_check_rate = 150
set server tcp_timeout = 6
This is a bare minimum configuration and it is not very useful. By using qmgr, the server configuration can be modified to set up TORQUE to do useful work. The following qmgr commands will create a queue and enable the server to accept and run jobs. These commands must be executed by root.
pbs_server -t create
qmgr -c "set server scheduling=true"
qmgr -c "create queue batch queue_type=execution"
qmgr -c "set queue batch started=true"
qmgr -c "set queue batch enabled=true"
qmgr -c "set queue batch resources_default.nodes=1"
qmgr -c "set queue batch resources_default.walltime=3600"
qmgr -c "set server default_queue=batch"
When TORQUE reports a new queue to Moab a class of the same name is automatically applied to all nodes.
In this example, the configuration database is initialized and the scheduling interface is activated (using 'scheduling=true'). This option allows the scheduler to receive job and node events which allow it to be more responsive (See scheduling for more information). The next command creates a queue and specifies the queue type. Within PBS, the queue must be declared an 'execution queue in order for it to run jobs. Additional configuration (i.e., setting the queue to started and enabled) allows the queue to accept job submissions, and launch queued jobs.
The next two lines are optional, setting default node and walltime attributes for a submitted job. These defaults will be picked up by a job if values are not explicitly set by the submitting user. The final line, default_queue=batch, is also a convenience line and indicates that a job should be placed in the batch queue unless explicitly assigned to another queue.
Additional information on configuration can be found in the admin manual and in the qmgr main page.
Related topics