table of contents
PEGASUS-STATUS(1) | Pegasus Manual | PEGASUS-STATUS(1) |
NAME¶
pegasus-status - Pegasus workflow- and run-time status
SYNOPSIS¶
pegasus-status [-h|--help]
[-V|--version] [-v|--verbose] [-d|--debug]
[-w|--watch [s]]
[-L|--[no]legend] [-c|--[no]color] [-U|--[no]utf8]
[-Q|--[no]queue] [-i|--[no]idle] [--[no]held]
[--[no]heavy] [-S|--[no]success]
[-j|--jobtype jt] [-s|--site sid]
[-u|--user name]
{ [-l|--long] | [-r|--rows] }
[rundir]
DESCRIPTION¶
pegasus-status shows the current state of the Condor Q and a workflow, depending on settings. If no valid run directory could be determined, including the current directory, pegasus-status will show all jobs of the current user and no workflows. If a run directory was specified, or the current directory is a valid run directory, status about the workflow will also be shown.
Many options will modify the behavior of this program, not withstanding a proper UTF-8 capable terminal, watch mode, the presence of jobs in the queue, progress in the workflow directory, etc.
OPTIONS¶
-h, --help
-V, --version
-w [sec], --watch [sec]
We strongly recommend to set this interval not too low, as frequent polling will degrade the scheduler performance and increase the host load. In watch mode, the terminal size is the limiting factor, and parts of the output may be truncated to fit it onto the given terminal.
Watch mode is disabled by default. The sec argument defaults to 60 seconds.
-L, --legend, --nolegend
By default, legends are turned off to save terminal real estate.
-c, --color, --nocolor
By default, colors are turned off, as they will not display well on a terminal with black background.
-U, --utf8, --noutf8
The defaults for this setting depend on the LANG environment variable. If the variable contains a value ending in something indicating UTF-8 capabilities, the option is turned on by default. It is off otherwise.
-Q, --queue, --noqueue
By default, Condor Q will be parsed for jobs of the current user. If a workflow run directory is specified, it will furthermore be limited to jobs only belonging to the workflow.
-v, --verbose
Additionally, the signals SIGUSR1 and SIGUSR2 will increase and decrease the expert level respectively during run-time.
By default, the simplest queue view is enabled.
-d, --debug
By default, debug mode is off.
-u name, --user name
By default, the current user is assumed.
-i, --idle, --noidle
By default, idle jobs are shown.
--held, --noheld
By default, the reason is shown.
--heavy, --noheavy
By default, heavy lines connect the jobs to workflows.
-j jt, --jobtype jt
By default, all Pegasus jobtypes are shown.
-s site, --site site
By default, all sites are shown.
-l, --long
This option is mutually exclusive with the --rows option. If both are specified, the --long option takes precedence.
By default, only DAG totals (sums) are shown.
-r, --rows, --norows
This option is mutually exclusive with the --long option. If both are specified, the --long option takes precedence.
By default, the summary is shown in columns.
-S, --success, --nosuccess
By default, all DAGs are shown.
rundir
By default, the rundir is assumed to be the current directory. If the current directory is not a valid rundir, no DAG statistics will be shown.
RETURN VALUE¶
pegasus-status will typically return success in regular mode, and the termination signal in watch mode. Abnormal behavior will result in a non-zero exit code.
EXAMPLE¶
pegasus-status
pegasus-status -l rundir
pegasus-status -j help
pegasus-status -vvw 300 -Ll
RESTRICTIONS¶
Currently only supports a single (optional) run directory. If you want to watch multiple run directories, I suggest to open multiple terminals and watch them separately. If that is not an option, or deemed too expensive, you can ask pegasus-support at isi dot edu to extend the program.
SEE ALSO¶
condor_q(1), pegasus-statistics(1)
AUTHORS¶
Jens-S. Vöckler <voeckler at isi dot edu>
Gaurang Mehta <gmehta at isi dot edu>
Pegasus Team http://pegasus.isi.edu/
11/09/2018 | Pegasus 4.4.0 |