Commands - mrmctl
Moab Workload Manager®

mrmctl

(Moab Resource Manager Control)

Synopsis

mrmctl -c queue=queuename {rmid|am[:amid]}
mrmctl -f [fobject] {rmid|am:[amid]}
mrmctl -l [rmid|am:[amid]]
mrmctl -m [rmid|am:[amid]]
mrmctl -m <attr>=<value> [rmid|am:[amid]] [-w <subobjtype>=<value%gt;]
mrmctl -p {rmid|am:[amid]}

mrmctl -x [<duration>|<nodeid>] [rmid|am:[amid] [-w {starttime}]

Overview

mrmctl allows an admin to query, list, modify, and ping the resource managers and allocation managers in Moab. mrmctl also allows for a queue (often referred to as a class) to be created for a resource manager.

Access

By default, this command can be run by level 1 and level 2 Moab administrators (see ADMINCFG).

Format

Flag Name Format Default Description Example
-c Create queue=<STRING> --- Create a queue for the specified RM
mrmctl -c
> mrmctl -c queue=fastQueue base

Moab will create a new queue, fastQueue on the RM base
-f Flush Statistics [<fobject>] where fobject is optional and one of messages or stats if no fobject is specified, then reported failures and performance data will be flushed.  If no resource manager id is specified, the first resource manager will be flushed. Clears resource manager statistics.  If messages is specified, then reported failures, performance data, and messages will be flushed.
mrmctl -f
> mrmctl -f base

Moab will clear the statistics for RM base
-l List N/A All RMs and AMs (when no RM/AM is specified) List Resource and Allocation Manager(s)
mrmctl -l
> mrmctl -l

Moab will list all resource and allocation managers
-m Modify N/A All RMs and AMs (when no RM/AM is specified) Modify Resource and Allocation Manager(s)
mrmctl -m
> mrmctl -m state=disabled peer13
mrmctl -m
> mrmctl -m state=disabled -w queue=batch base

Moab will disable the queue batch within the resource manager base
-p Ping N/A First RM configured Ping Resource Manager
mrmctl -p
> mrmctl -p base

Moab will ping RM base
-w Where {starttime=<TIME>} now starttime for allocated resources
mrmctl -w
> mrmctl -x 2 -w starttime=+4:00:00

Moab will allocate 2 more resources in 4 hours.

NOTE: Resource manager interfaces can be enabled/disabled using the modify operation to change the resource manager state as in the following example:

RM enable/disable
# disable active resource manager interface

> mrmctl -m state=disabled torque

# restore disabled resource manager interface

> mrmctl -m state=enabled torque

See Also