Moab Workload Manager
Home Up

mdiag

(Moab Diagnostics)

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>]  
mdiag -f [-o user|group|acct|qos|class] [-v]
mdiag -g [groupid]
mdiag -G [Green]
mdiag -j [jobid] [-t <partition>] [-v] [--blocking]
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
-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.)
-e

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

starttime default is -
endtime default is INFINITY
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 power management 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 priority.

Note 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

Home Up