Skip to content

fasrc/slurm_showq

Repository files navigation

A "showq" style job summary utility for SLURM. Useful for generating a
summary of all running, pending, and blocked jobs.

    Copyright (C) 2013, 2022 Karl Schulz, Paul Edmon

    This program is free software: you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation, either version 3 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program.  If not, see <http://www.gnu.org/licenses/>.


Texas Advanced Computing Center
Originally: November 2012
[email protected]

Modified by Paul Edmon at FAS Harvard Research Computing
[email protected]

-------------------
Build Instructions:
-------------------

The build system uses standard auto-tools and should, in theory, work
with:

$ ./configure
$ make

If successful, the resulting binary is named "showq". You will need
the SLURM development headers installed and if configure cannot find
your SLURM location, try ./configure --with-slurm=<slurm-path>

--------------
General Usage:
--------------

# ./showq --help

Usage: slurm_showq [OPTIONS]

Thus utility summarizes all running, idle, and pending jobs 
along with any upcoming advanced reservations in the SLURM batch system.

OPTIONS:
  --help                  generate help message and exit
  --version               output version information and exit
  --all-reserv            show all advanced reservations
  -l [ --long ]           enable more verbose (long) listing
  -u [ --user ]           display jobs for current user only
  -U <username>           display jobs for username only
  -p, -q partition        display jobs for partition/queue
  -o                      display pending jobs in order of priority
  -s                      display job summary only


---------------
Example Output:
---------------

Generates output of the form shown below.  Place a "showq.conf" config
file in the location where your "showq" binary is located to define
the total number of hosts available (only required if you want to have
a currently active % line of output in showq for SLURM).  

ACTIVE JOBS--------------------
JOBID     JOBNAME    USERNAME      STATE   CORE   REMAINING  STARTTIME
================================================================================
15574     HOMME      hilar         Running 1024    21:34:48  Thu Jan  3 07:49:23
15575     HOMME      hilar         Running 1024    21:35:25  Thu Jan  3 07:50:00
15576     HOMME      hilar         Running 1024    21:38:29  Thu Jan  3 07:53:04
15577     HOMME      hilar         Running 1024    21:39:55  Thu Jan  3 07:54:30
15578     HOMME      hilar         Running 1024    21:41:13  Thu Jan  3 07:55:48
15579     HOMME      hilar         Running 1024    21:42:14  Thu Jan  3 07:56:49
15580     HOMME      hilar         Running 1024    21:44:18  Thu Jan  3 07:58:53
15581     HOMME      hilar         Running 1024    21:45:46  Thu Jan  3 08:00:21
15582     HOMME      hilar         Running 1024    21:46:59  Thu Jan  3 08:01:34
15583     HOMME      hilar         Running 1024    21:47:45  Thu Jan  3 08:02:20
16436     HOMME      hilar         Running 1024    21:52:20  Thu Jan  3 08:06:55
16437     HOMME      hilar         Running 1024    21:53:53  Thu Jan  3 08:08:28
16438     HOMME      hilar         Running 1024    21:54:51  Thu Jan  3 08:09:26
16439     HOMME      hilar         Running 1024    21:55:32  Thu Jan  3 08:10:07
16440     HOMME      hilar         Running 1024    22:02:41  Thu Jan  3 08:17:16
16455     HOMME      hilar         Running 2048     5:50:48  Thu Jan  3 08:05:23
17541     HOMME      hilar         Running 4096     4:13:57  Thu Jan  3 12:28:32
17728     relaxing1  junila        Running 960      4:11:24  Thu Jan  3 12:25:59
17873     iq_ms_0000 zxia          Running 16       1:06:45  Thu Jan  3 13:21:20
17874     iq_ms_0000 zxia          Running 16       1:07:09  Thu Jan  3 13:21:44
17875     iq_ms_0000 zxia          Running 16       1:07:25  Thu Jan  3 13:22:00
17906     bash       bylayera      Running 16       1:52:24  Thu Jan  3 14:06:59
17907     bash       jukalae       Running 128      3:12:04  Thu Jan  3 15:26:39
17908     bash       firal         Running 16       2:02:08  Thu Jan  3 14:16:43
17930     iq_ms_0000 zxia          Running 16       3:08:19  Thu Jan  3 15:22:54
17931     iq_ms_0000 zxia          Running 16       3:08:19  Thu Jan  3 15:22:54
17932     iq_ms_0000 zxia          Running 16       3:10:50  Thu Jan  3 15:25:25
17934     iq_ms_0000 zxia          Running 16       3:12:04  Thu Jan  3 15:26:39
17936     bash       hilar         Running 16       3:12:04  Thu Jan  3 15:26:39
17943     h2mol-slep ikla          Running 32       5:57:06  Thu Jan  3 15:11:41
17945     bash       iolae         Running 16       3:12:37  Thu Jan  3 15:27:12
17949     iq_ms_0000 zxia          Running 16       3:18:21  Thu Jan  3 15:32:56
17950     iq_ms_0000 zxia          Running 16       3:18:21  Thu Jan  3 15:32:56
17951     iq_ms_0000 zxia          Running 16       3:18:51  Thu Jan  3 15:33:26
17952     iq_ms_0000 zxia          Running 16       3:24:51  Thu Jan  3 15:39:26
17953     iq_ms_0000 zxia          Running 16       3:25:21  Thu Jan  3 15:39:56
17956     bash       queaital      Running 368     11:44:46  Thu Jan  3 15:59:21
17960     benchmarks oladiae       Running 16       0:55:51  Thu Jan  3 16:11:26
17961     benchmarks oladiae       Running 16       0:55:51  Thu Jan  3 16:11:26
17962     benchmarks oladiae       Running 16       0:55:51  Thu Jan  3 16:11:26
17963     benchmarks oladiae       Running 16       0:55:51  Thu Jan  3 16:11:26
17964     benchmarks oladiae       Running 16       0:55:51  Thu Jan  3 16:11:26
17965     benchmarks oladiae       Running 16       0:55:51  Thu Jan  3 16:11:26
17966     benchmarks oladiae       Running 16       0:55:51  Thu Jan  3 16:11:26
17967     bash       juazil        Running 32       3:56:44  Thu Jan  3 16:11:19
17968     benchmarks oladiae       Running 16       0:55:52  Thu Jan  3 16:11:27
17969     benchmarks oladiae       Running 16       0:55:52  Thu Jan  3 16:11:27
17970     benchmarks oladiae       Running 16       0:55:52  Thu Jan  3 16:11:27
17971     benchmarks oladiae       Running 16       0:55:52  Thu Jan  3 16:11:27
17972     benchmarks oladiae       Running 16       0:55:52  Thu Jan  3 16:11:27
17973     benchmarks oladiae       Running 16       0:55:52  Thu Jan  3 16:11:27
17974     benchmarks oladiae       Running 16       0:55:52  Thu Jan  3 16:11:27
17975     benchmarks oladiae       Running 16       0:55:52  Thu Jan  3 16:11:27

      53 active jobs : 1470 of 6416 hosts ( 22.91 %)

WAITING JOBS------------------------
JOBID     JOBNAME    USERNAME      STATE   CORE     WCLIMIT  QUEUETIME
================================================================================
14595     pal-14     jailea        Waiting 768     12:00:00  Sun Dec 23 22:45:45
16336     di3        iolae         Waiting 1024    12:00:00  Fri Dec 28 20:51:59
16441     HOMME      hilar         Waiting 1024    30:00:00  Sun Dec 30 18:09:29
16442     HOMME      hilar         Waiting 1024    30:00:00  Sun Dec 30 18:09:31
16443     HOMME      hilar         Waiting 1024    30:00:00  Sun Dec 30 18:09:34
16444     HOMME      hilar         Waiting 1024    30:00:00  Sun Dec 30 18:09:39
16445     HOMME      hilar         Waiting 1024    30:00:00  Sun Dec 30 18:09:43
17369     myMPI      perayy        Waiting 4       24:00:00  Tue Jan  1 18:52:36
17524     xyl.1.0    asreali       Waiting 480     12:00:00  Wed Jan  2 11:24:47
17535     xyl.0.0    asreali       Waiting 480     12:00:00  Wed Jan  2 11:26:51
17542     HOMME      hilar         Waiting 8192     4:00:00  Wed Jan  2 11:32:02
17610     just_hel   iolae         Waiting 1024    12:00:00  Wed Jan  2 23:23:45
17613     nohel      iolae         Waiting 1024    12:00:00  Wed Jan  2 23:26:02
17635     t42r36C    xiaol         Waiting 320     12:00:00  Thu Jan  3 00:51:56
17756     h2mol-real ikla          Waiting 2928    12:00:00  Thu Jan  3 10:38:29
17758     h2mol-real ikla          Waiting 2928    12:00:00  Thu Jan  3 10:40:59
17798     wrf_lrg_10 juazil        Waiting 10240    1:30:00  Thu Jan  3 11:20:22
17862     myMPI      perayy        Waiting 8       24:00:00  Thu Jan  3 13:11:53
17863     myMPI      perayy        Waiting 16      24:00:00  Thu Jan  3 13:12:20
17864     myMPI      perayy        Waiting 32      24:00:00  Thu Jan  3 13:12:42
17865     myMPI      perayy        Waiting 64      24:00:00  Thu Jan  3 13:13:03

BLOCKED JOBS--
JOBID     JOBNAME    USERNAME      STATE   CORE     WCLIMIT  QUEUETIME
================================================================================
14596     pal-15     jailea        Waiting 768     12:00:00  Sun Dec 23 22:45:45
14597     pal-16     jailea        Waiting 768     12:00:00  Sun Dec 23 22:45:45
14598     pal-17     jailea        Waiting 768     12:00:00  Sun Dec 23 22:45:45
14599     pal-18     jailea        Waiting 768     12:00:00  Sun Dec 23 22:45:46
14600     pal-19     jailea        Waiting 768     12:00:00  Sun Dec 23 22:45:46
16337     di3        iolae         Waiting 1024    12:00:00  Fri Dec 28 20:52:26
17525     xyl.1.0    asreali       Waiting 480     12:00:00  Wed Jan  2 11:24:47
17526     xyl.1.0    asreali       Waiting 480     12:00:00  Wed Jan  2 11:24:48
17527     xyl.1.0    asreali       Waiting 480     12:00:00  Wed Jan  2 11:24:48
17528     xyl.1.0    asreali       Waiting 480     12:00:00  Wed Jan  2 11:24:48
17529     xyl.1.0    asreali       Waiting 480     12:00:00  Wed Jan  2 11:24:48
17536     xyl.0.0    asreali       Waiting 480     12:00:00  Wed Jan  2 11:26:51
17537     xyl.0.0    asreali       Waiting 480     12:00:00  Wed Jan  2 11:26:51
17538     xyl.0.0    asreali       Waiting 480     12:00:00  Wed Jan  2 11:26:51
17539     xyl.0.0    asreali       Waiting 480     12:00:00  Wed Jan  2 11:26:51
17611     just_hel   iolae         Waiting 1024    12:00:00  Wed Jan  2 23:24:17
17614     nohel      iolae         Waiting 1024    12:00:00  Wed Jan  2 23:27:21
17636     t42r37C    xiaol         Waiting 320     12:00:00  Thu Jan  3 00:51:57
17637     t42r38C    xiaol         Waiting 320     12:00:00  Thu Jan  3 00:51:57
17638     t42r39C    xiaol         Waiting 320     12:00:00  Thu Jan  3 00:51:57
17639     t42r40C    xiaol         Waiting 320     12:00:00  Thu Jan  3 00:51:58
17640     t42r41C    xiaol         Waiting 320     12:00:00  Thu Jan  3 00:51:58
17641     t42r42C    xiaol         Waiting 320     12:00:00  Thu Jan  3 00:51:58
17642     t42r43C    xiaol         Waiting 320     12:00:00  Thu Jan  3 00:51:58
17643     t42r44C    xiaol         Waiting 320     12:00:00  Thu Jan  3 00:51:59
17644     t42r45C    xiaol         Waiting 320     12:00:00  Thu Jan  3 00:51:59
17645     t42r46C    xiaol         Waiting 320     12:00:00  Thu Jan  3 00:51:59
17646     t42r47C    xiaol         Waiting 320     12:00:00  Thu Jan  3 00:52:00
17647     t42r48C    xiaol         Waiting 320     12:00:00  Thu Jan  3 00:52:00
17648     t42r49C    xiaol         Waiting 320     12:00:00  Thu Jan  3 00:52:00
17649     t42r50C    xiaol         Waiting 320     12:00:00  Thu Jan  3 00:52:01

Total Jobs: 105   Active Jobs: 53    Idle Jobs: 21    Blocked Jobs: 31  

About

A modification to the slurm_showq code written by TACC.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published