You are here: 3 Scheduler Commands > Commands > mdiag

3.9 mdiag

3.9.1 Synopsis

mdiag -a [accountid]

mdiag -b [-l policylevel] [-t partition]

mdiag -c [classid]

mdiag -C [configfile] // diagnose config file syntax

mdiag -e [-w <starttime>|<endtime>|<eventtypes>|<oidlist>|<eidlist>|<objectlist>] --xml

mdiag -f [-o user|group|acct|qos|class] [-v]

mdiag -g [groupid]

mdiag -G [Green]

mdiag -j [jobid] [-t <partition>] [-v] [--blocking]

mdiag -l

mdiag -L [-v] // diagnose usage limits

mdiag -n [-A <creds>] [-t partition] [nodeid] [-v]

mdiag -p [-t partition] [-v] // diagnose job priority

mdiag -q [qosid]

mdiag -r [reservationid] [-v] [-w type=<type>] [--blocking]

mdiag -R [resourcemanagername] [-v]

mdiag -s [standingreservationid] [--blocking]

mdiag -S [-v] // diagnose scheduler

mdiag -t [-v] // diagnose partitions

mdiag -T [triggerid] [-v] [--blocking]

mdiag -u [userid]

mdiag [--format=xml]

3.9.2 Overview

The mdiag command is used to display information about various aspects of the cluster and the results of internal diagnostic tests. In summary, it provides the following:

Some mdiag options gather information from the Moab cache which prevents them from interrupting the scheduler, but the --blocking option can be used to bypass the cache and interrupt the scheduler.

3.9.3 Arguments

Option Description
-a [accountid] Display account information.
-b Display information on jobs blocked by policies, holds, or other factors.

If blocked job diagnostics are specified, the -t option is also available to constrain the report to analysis of particular partition. Also, with blocked job diagnosis, the -l option can be used to specify the analysis policy level.

-c [classid] Display class information.
-C [file] With the vast array of options in the configuration file, the -C option does not validate function, but it does analyze the configuration file for syntax errors including use of invalid parameters, deprecated parameters, and some illegal values. If you start Moab with the -e flag, Moab evaluates the configuration file at startup and quits if an error exists.

mdiag -C does not print out any #INCLUDE lines listed in moab.cfg (and moab.dat), but it does evaluate and print out the lines found in those included files.

-e

Moab will do a query for all events whose eventtime starts at <starttime> and matches the search criteria. This works only when Moab is configured with ODBC MySQL. The syntax is:
mdiag -e[-w <starttime>|<eventtypes>|
<oidlist>|<eidlist>|<objectlist>] --xml

  • starttime default is -
  • eventtypes default is command delimited, the default is all event types (possible values can be found in the EventType table in the Moab database)
  • oidlist is a comma-delimited list of object ids, the default is all objects ids
  • eidlist is a comma-delimited list of specific event ids, the default is all event ids
  • objectlist is a comma-delimited list of object types, the default is all object types (possible values can be found in the ObjectType table in the Moab database)
-f Display fairshare information.
-g [groupid] Display group information.
-G [Green] Display green computing information.
-j [jobid] Display job information.
-l Diagnose license information contained in the moab.lic file.
-L Display limits.
-n [nodeid] Display nodes.

If node diagnostics are specified, the -t option is also available to constrain the report to a particular partition.

-p Display job priority.

If priority diagnostics are specified, the -t option is also available to constrain the report to a particular partition.

-q [qosid] Display qos information.
-r [reservationid] Display reservation information.
-R [rmid] Display resource manager information.
-s [srsv] Display standing reservation information.
-S Display general scheduler information.
-t Display configuration, usage, health, and diagnostic information about partitions maintained by Moab.
-T [triggerid] Display trigger information.
-u [userid] Display user information.
--format=xml Display output in XML format.

3.9.3.A XML Output

Information for most of the options can be reported as XML as well. This is done with the command mdiag -<option> <CLASS_ID> --format=xml. For example, XML-based class information will be written to STDOUT in the following format:

<Data>
  <class <ATTR>="<VAL>" ... >
    <stats <ATTR>="<VAL>" ... >
      <Profile <ATTR>="<VAL>" ... >
      </Profile>
    </stats>
  </class>
<Data>
  ...
</Data>

Of the mdiag options, only -G and -L cannot be reported as XML.

Related Topics 

© 2016 Adaptive Computing