mrmctl

(Moab Resource Manager Control)

Synopsis


mrmctl -f [fobject] {rmName|am:[amid]}
mrmctl -l [rmid|am:[amid]]
mrmctl -m <attr>=<value> [rmid|am:[amid]] [-w <subobjtype>=<value>]
mrmctl -p {rmid|am:[amid]}
mrmctl -R {am|id}[:rmid]}}

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

-f — Flush Statistics
Format:	[<fobject>] where fobject is optional and one of messages or stats.
Default:	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.
Description:	Clears resource manager statistics. If messages is specified, then reported failures, performance data, and messages will be flushed.
Example:	> mrmctl -f base Moab will clear the statistics for RM `base.`

-l — List
Format:	N/A
Default:	All RMs and AMs (when no RM/AM is specified)
Description:	List Resource and Allocation Manager(s)
Example:	> mrmctl -l Moab will list all resource and allocation managers.

-m — Modify
Format:	N/A
Default:	All RMs and AMs (when no RM/AM is specified).
Description:	Modify Resource and Allocation Manager(s).
Example:	> mrmctl -m state=disabled peer13 > mrmctl -m state=disabled -w queue=batch base Moab will disable the queue `batch` within the resource manager `base`.

-p — Ping
Format:	N/A
Default:	First RM configured.
Description:	Ping Resource Manager.
Example:	> mrmctl -p base Moab will ping RM `base.`

-R — Reload
Format:	{am\|id}[:rmid]}}
Default:	---
Description:	Dynamically reloads server information for the identity manager service if `id` is specified; if `am` is specified, reloads the allocation manager service.
Example:	> mrmctl -R id Reloads the identity manager on demand.

-w — Where
Format:	{starttime=<TIME>}
Default:	now
Description:	Starttime for allocated resources.
Example:	> 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:
# disable active resource manager interface > mrmctl -m state=disabled torque # restore disabled resource manager interface > mrmctl -m state=enabled torque

mrmctl

See Also