Daemons & Job Life Cycle

Grid Engine 6.1 Quick Reference

Target ACT Cmd. Switch

scheduler show qconf -sss

This tri-fold brochure was created for
terminate qconf -ks BioTeam customers by reformatting the
information contained in Dan Templetonʼs
Scheduler modify qconf -msconf
config “SGE_Cheat_Sheet.pdf.” Feel free to copy,
show qconf -ssconf publish and redistribute. Suggestions for

Share Add node qconf -astnode path

Tree
Format: /<path>=<shares> path is
Xpath-style with “/” as root node
Additional Resources
Graphic Source: Daniel Templeton
create qconf -astree
Delete 1. Jobs are submitted from submit hosts or via
qconf -dstree http://gridengine.sunsource.net
DRMAA API
Show qconf -sstree
2. User identity, current working directory, paths
Mail Lists Howtos Manpages
and environment values captured if available
submit create qconf -as name 3. Qmaster host receives job request, places entry
host Admin & Blog Wiki
delete in spool database and notifies the scheduler User
qconf -ds name
Guides
show qconf -ss 4. Scheduler attempts to place job in best possible
Create qconf -auser
job slot. If the job can be placed during the
User current scheduling interval, the chosen queue
Delete qconf -duser name instance name is returned to the qmaster
modify qconf -muser name daemon. If job can not be placed it remains on
Show qconf -usq name the pending task list.
list qconf -suserl 5. Qmaster host receives queue instance name
from the scheduler and dispatches job to the
Create qconf -au user_name execution daemon running on the remote host.
User
List list_name
6. The remote Execution daemon spawns a
Note: If user list does not exist shepherd process to manage the job. The
it will be created automatically
shepherd performs a setuid operation to
delete qconf -dul list_name effectively “become” the job submitter
Delete qconf -du user_name
User list_name
7. Shepherd sets up job, including paths, cwd and
environment variables recorded at submission
Modify qconf -mu list_name time. The shepherd starts the job, monitors
show qconf -su list_name resource usage data and exit status. Shepherd
list qconf -sul also performs post-job cleanup tasks.
See “User List” 8. Exit status & accounting data are passed back
user set
to execution daemon which then passes the info
back to the Qmaster.
 Target ACT Cmd. Switch Target ACT Cmd. Switch Target ACT Cmd. Switch

ACL See “User List” Global Exec See “exec host config” Parallel Create qconf -ap name
host Config Environment
Admin Create qconf -ah name Delete qconf -dp name
Host Global Host see “host config” (“PE”)
Delete qconf -dh name config Modify qconf -mp name
List qconf -sh Host Create qconf -aconf name Show qconf -sp name
config
Advance Create qrsub (see manpage) Delete qconf -dconf name List qconf -spl
Reservation
Delete qrdel res_id modify qconf -mconf [name] Project create qconf -aprj name
Show qrstat -ar ar_id show qconf -sconf [name] delete qconf -dprj name
List qrstat list qconf -sconfl modify qconf -mprj name
Note: The “global” host configuration can not be show qconf -sprj name
Calendar create qconf -acal name deleted. If [name] not provided, SGE assumes
“global”.
list qconf -sprjl
Delete qconf -dcal name Stop / qconf -km
modify qconf -mcal name qmaster Terminate
Host Create qconf -ahgrp @name
show Group
qconf -scal name Delete qconf -dhgrp @name clear qmod -cq name | ‘*’
queue error
list qconf -scall Modify qconf -mhrgp @name
Create qconf -aq name
Checkpoint Create qconf -ackpt name Show
environment qconf -shgrp @name
delete qconf -dq name
Delete qconf -dckpt name List qconf -shgrpl
modify qconf -mq name
modify qconf -mckpt name Job alter (see manpage)
qalter
resume qmod -usq name
Show qconf -sckpt name clear qmod -cj jobID
error show qconf -sq [name]
List qconf -sckptl
hold qalter -hold_jid jobID -sq used without [name] prints default template
Complex Create qconf -mc
Entry hold qhold jobID list qstat -f | -u ‘*’
delete qconf -mc
release qrls -h n jobID List qselect
modify qconf -mc
reschedule List
show qmod -rj jobID qconf -sql
qconf -sc
Show qstat -j jobID Suspend qmod -sq name
consumable See “complex Entry” Note: In most cases, job name and wildcard (ʻ*ʼ) See “Complex Entry”
patterns can be used in place of jobID
resource
Department See “User List”
Event show qconf -secl list qstat Create qconf -arqs [name]
Client List resource
submit qrsh (see manpage) Quota delete qconf -drqs name
Exec Host Stop qconf -ke name submit (see manpage) Set
qsub modify qconf -mrqs name
If name is “all”,all exec hosts will be killed suspend qmod -sj jobID show qconf -srqs [name]
Exec Host Create qconf -ae [config] terminate
Config qdel jobID list Sets qconf -srqsl
Name config with “-ae” to import as template create qconf -am name Show qquota
Delete qconf -de name|global manager /
Operator Delete qconf -dm name
modify qconf -me name|global list qconf -sm
Show Document version 3.0 (A4 Format)
qconf -se name|global
Note: substitute “-ao, -do and -so” for operator Continued on reverse ...
list qconf -sel specific create/delete/list actions.