Commands - mdiag
Moab Workload Manager®

mdiag

(Moab Diagnostics)

Synopsis

mdiag -a [accountid]
mdiag -b [-l policylevel] [-t partition]
mdiag -c [classid]
mdiag -C [configfile]  // diagnose config file syntax
mdiag -f [-o user|group|account|qos|class] [-v]
mdiag -g [groupid]
mdiag -j [jobid] [-v]
mdiag -L [-v]  // diagnose usage limits
mdiag -m [rackid]
mdiag -n [-A <creds>] [-t partition] [nodeid] [-v]
mdiag -p [-t partition] [-v] // diagnose job priority
mdiag -q [qosid]
mdiag -r [reservationid] [-v]
mdiag -R [resourcemanagername] [-v]
mdiag -s [standingreservationid]
mdiag -S [-v] // diagnose scheduler
mdiag -t [-v] // diagnose partitions
mdiag -T [triggerid] [-v]
mdiag -u [userid]
mdiag -x
mdiag [--format=xml]

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:

  • current object health and state information
  • current object configuration (resources, policies, attributes, etc)
  • current and historical performance/utilization information
  • reports on recent failure
  • object messages

Arguments

Argument Description
-a [accountid] display account information
-b display information on jobs blocked by policies, holds, or other factors.  NOTE: 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] analyze configuration file for errors including use of invalid parameters, deprecated parameters, and illegal values. (If you start Moab with the -e flag, Moab evaluates the configuration file at startup and quits if an error exists.)
-f display fairshare information
-g [groupid] display group information
-j [jobid] display job information
-L display limits
-m rackid display rack/frame information
-n [nodeid] display nodes.  NOTE: if node diagnostics are specified, the '-t' option is also available to constrain the report to a particular partition.
-o <OTYPE>[:<OID>] organize information by specified object type
-p display job priorityNOTE: 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 [triggerid] display trigger information
-u [userid] display user information
-x display advanced system information
--format=xml display output in XML format

See Also