qtools
qtools
offers the shortcuts for some common procedures when working with the Open Grid Scheduler.
Installation
Install qtools
using gem
:
$ gem install qtools
Usage
qqsub
to submit a script or a compiled executableqclean
to remove.e[0-9]*
and.o[0-9]*
files in the current directoryqwatch
to see the running jobs for the current userqcount
to see the number of running jobs for the current userqnode
to list the free nodesqundo
to stop the last submitted job for the current userqless
to read the last error log.e[0-9]*
in the current folder
qqsub
Usage:
$ qqsub 'python3 my_script.py -i input.txt -v' -n my_name -m 8gb
The command above will create a shell script file with the corresponding content and submit a job which will feature the name my_name
and require 8gb
of memory.
Available parameters:
-n
,--name
- job title-m
,--memory
- memory (e.g.,80gb
)-q
,--queue
- queue title-t
,--time
- job time limit in hours (default is24
)-c
,--cpu
- number of CPUs
qwatch
qwatch
is equivalent to running watch -n1 -d "qstat -u $USER"
. Use -n
(--nodes
) flag to show information on nodes too (qstat -n1 -u $USER
)
qclean
qclean
will run rm *.[eo][0-9]*
in the current directory (if such files exist).
qcount
Use qcount
to count the number of jobs for the $USER
. Running qcount -a
will output the number of jobs for all the users.
qnode
Run qnode
to print the list of free nodes sorted by their LOAD
. Use qnode -m
to sort the list of free nodes by memory available and qnode -c
to sort the list by the number of free cores.
qundo
qundo
will try to run qdel
for the last job submitted (for the current user).
qless
Run qless
to read the last default error log .e[0-9]*
in the current folder. Use -o
flag to read the last default output file.
Contributing
Bug reports and pull requests are welcome on GitHub.
License
The gem is available as open source under the terms of the MIT License.