ICC Home Privacy and Legal Notice LC User Documents Banner

UCRL-WEB-201386

SLURM Reference Manual


SMAP (Show Job Geometry)

ROLE.
On BlueGene/L only, the SMAP utilty reveals not only which nodes are allocated to currently running jobs but also the geometric arrangement of those nodes (and hence, the way that BG/L jobs fit among one another topographically). On BG/L, SMAP thus supplements SINFO and SQUEUE as a visually enhanced way to monitor job interactions and to plan spatially for new node allocations.

PREREQUISITES.
(1) SMAP runs only on LC's BlueGene/L (BG/L) machine.
(2) SMAP takes over the terminal window in which it runs. So executing it as a controllee of XTERM, in a separate window dedicated to its output, is a good strategy (see below).
(3) SMAP needs a window wider than 80 characters to display its character-based "map" of job/node allocations effectively. Requesting a 100-character-wide window with XTERM's -geometry option is a good strategy (see below).

EXECUTION.
Because of its prerequisites (above), a typical appropriate SMAP run could begin with an execute line such as this

xterm -geometry 100x30 -e /usr/bin/smap -Dj >& /dev/null &

to show the arrangement of jobs currently running (-Dj) on BG/L.

TYPICAL OUTPUT.
SMAP's character-based map of job/node allocations typically looks like this (some blank columns have been trimmed to fit this manual):


   a a a a b b d d ID JOBID PARTITION USER   NAME ST TIME NODES NODELIST
  a a a a b b d d  a  12345 batch     joseph tst1 R  43:12   64 bgl[000x333]
 a a a a b b c c   b  12346 debug     chris  sim3 R  12:34   16 bgl[420x533]
a a a a b b c c    c  12350 debug     danny  job3 R   0:12    8 bgl[622x733]
                   d  12356 debug     dan    colu R  18:05   16 bgl[600x731]
   a a a a b b d d e  12378 debug     joseph asx4 R   0:34    4 bgl[612x713]
  a a a a b b d d
 a a a a b b c c
a a a a b b c c

   a a a a . . d d
  a a a a . . d d
 a a a a . . e e        Y
a a a a . . e e         |
                        |
   a a a a . . d d      0----X
  a a a a . . d d      /
 a a a a . . . .      /
a a a a . . . #      Z

Note here that:
(1) As the legend indicates, the origin (node 000) lies at the REAR (upper, not lower) left corner of the bottom "plane" (4-line group, and each such 4-line group shows another Y-dimension plane above it).
(2) Unassigned (idle) BG/L base partitions ("nodes" to SLURM) are shown as a period(.) in the map.
(3) Down/drained base partitions (unavailable for use) are shown as a pound sign(#). In this example, only BGL703 is down.


Navigation Links: [ Document List ] [ HPC Home ] [ Previous ] [ Next ]