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|acct|qos|class] [-v]
mdiag -g [groupid]
mdiag -G [Green]
mdiag -j [jobid] [-t <partition>] [-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] [-w type=<type>]
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
display account information
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.

display class information
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.)
display fairshare information
display group information
display power management information
display job information
display limits
display rack/frame information
display nodes.

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

organize information by specified object type
display job priority.

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

display qos information
display reservation information
display resource manager information
display standing reservation information
display general scheduler information
display trigger information
display user information
display advanced system information
display output in XML format

See Also