Commands - mrmctl

Moab Workload Manager^®

mrmctl

(Moab Resource Manager Control)

Synopsis

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

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

-c — Create

Format: queue=<STRING>

Default: ---

Description: Create a queue for the specified RM.

Example:

> mrmctl -c queue=fastQueue base

Moab will create a new queue, fastQueue on the RM base.

Note This functionality is RM dependent.

-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.

-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