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 BioTeam
terminate qconf -ks customers by reformatting the information contained
in Dan Templetonʼs “SGE_Cheat_Sheet.pdf.” Feel
Scheduler modify qconf -msconf
config free to copy, publish and redistribute. Suggestions for
show qconf -ssconf improvements should be sent to chris@bioteam.net

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 -dq 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.
 Alphabetical Reference by Target

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
list qconf -sprjl
Delete “global”.
qconf -dcal name
Stop / qconf -km
modify qconf -mcal name qmaster Terminate
Host Create qconf -ahgrp @name
show qconf -scal name Group
Delete qconf -dhgrp @name clear qmod -cq name | ‘*’
queue error
list qconf -scall Modify qconf -mhrgp @name Create
Checkpoint Create qconf -aq name
qconf -ackpt name Show qconf -shgrp @name
environment delete
Delete qconf -dq name
qconf -dckpt name List qconf -shgrpl modify qconf -mq name
modify qconf -mckpt name Job alter (see manpage)
qalter resume
Show qmod -usq name
qconf -sckpt name clear qmod -cj jobID
error show qconf -sq [name]
List qconf -sckptl
Complex Create hold qalter -hold_jid jobID -sq used without [name] prints default template
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”
resource
Department See “User List” patterns can be used in place of jobID
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 (see manpage) Set
submit 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]
Config terminate qdel jobID list Sets qconf -srqsl
Name config with “-ae” to import as template
create qconf -am name Show
manager / qquota
Delete qconf -de name|global
Operator Delete qconf -dm name
modify qconf -me name|global list qconf -sm
Show qconf -se name|global Document version 3.0 (US Format)
Note: substitute “-ao, -do and -so” for operator
list qconf -sel specific create/delete/list actions.
Continued on reverse ...