f828f75
This README describes how to get the most basic working
f828f75
torque service on a single host.
f828f75
f828f75
To setup a basic single-node localhost-only batch system, install the
f828f75
torque-server, torque-mom, and torque-scheduler packages, and do something like
f828f75
this:
f828f75
95be658
0) If torque is built with munge support then this 
95be658
   must be enabled first on all nodes. The munge
95be658
   package should allready be installed.
95be658
95be658
   Create a munge key with 
95be658
95be658
   /usr/sbin/create-munge-key
95be658
95be658
   Copy resulting key /etc/munge/munge.key to 
95be658
   all torque nodes in your cluster including
95be658
   pbs_server, pbs_mom and client (qstat,qsub) nodes.
f828f75
f828f75
1) Get your full hostname with
f828f75
f828f75
# /bin/hostname --long
f828f75
f828f75
e.g myhost.example.org
f828f75
f828f75
2) Edit /etc/torque/server_name 
f828f75
to contain the single line
f828f75
f828f75
myhost.example.org
f828f75
f828f75
3) Edit /etc/torque/mom/config 
f828f75
to contain the single line
f828f75
f828f75
$pbsserver myhost.example.org
f828f75
f828f75
4) Create a torque serverdb file.
f828f75
# /usr/sbin/pbs_server -D -t create
f828f75
f828f75
Warning this will remove any existing serverdb 
f828f75
file located at /var/lib/torque/server_priv/serverdb
f828f75
f828f75
You will have to Ctrl^C the pbs_server command, it will
f828f75
only take a moment to create this file.
f828f75
f828f75
5) Start the pbs_server and configure it.
f828f75
service pbs_server start
f828f75
# qmgr -c "s s scheduling=true"
f828f75
# qmgr -c "c q batch queue_type=execution"
f828f75
# qmgr -c "s q batch started=true"
f828f75
# qmgr -c "s q batch enabled=true"
f828f75
# qmgr -c "s q batch resources_default.nodes=1"
f828f75
# qmgr -c "s q batch resources_default.walltime=3600"
f828f75
# qmgr -c "s s default_queue=batch"
f828f75
f828f75
6) Add one batch worker to your pbs_server.
f828f75
f828f75
# qmgr -c "c n myhost.example.org"
f828f75
f828f75
7) Start the pbs_mom and pbs_sched deamons.
f828f75
f828f75
# service pbs_mom start
f828f75
# service pbs_sched start
f828f75
f828f75
8) Use chkconfig to start the services at boot time.
f828f75
f828f75
# /sbin/chkconfig pbs_mom on
f828f75
# /sbin/chkconfig pbs_server on
f828f75
# /sbin/chkconfig pbs_sched on
95be658
# /sbin/chkconfig munge on
f828f75
f828f75
9) Submit a test job.
f828f75
As a user not as root run the following
f828f75
f828f75
$ qsub <
f828f75
hostname 
f828f75
echo "Hi I am a batch job running in torque"
f828f75
EOF
f828f75
95be658
10 ) Monitor the state of that job with qstat.
f828f75
95be658
In case of problems first of all look in /var/log/torque
f828f75
f828f75
f828f75