Moab Workload Manager
Home Up

mnodectl

 (Moab Node Control)

Synopsis

mnodectl -d message:<index> nodeexp
mnodectl -m attr=val nodeexp
mnodectl -q [cat|diag|profile|wiki] nodeexp

Overview

Change specified attributes for a given node expression.

Access

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

Format

-d — Destroy
Format: message:<INDEX>
Default: N/A
Description:

With message:<INDEX> argument: Remove the message with the given index from the node.
Example: 
> mnodectl node001 -d message:admin2
The admin2 message on node001 is removed.
   
-m — Modify
Format: <ATTR>=<VAL>

Where <ATTR> is one of the following:
    GEVENT,
    GMETRIC,
    MESSAGE,
    OS,
    POWER,
    STATE,
    VARIABLE
Default: ---
Description: Modify the state or attribute of specified node(s)
Example: 
> mnodectl -m gevent=cpufail:'cpu02 has failed w/ec:0317' node1 
> mnodectl -m gmetric=temp:131.2 node1 
> mnodectl -m message='cpufailure:cpu02 has failed w/ec:0317' node1 
> mnodectl -m OS=RHAS30 node1 
> mnodectl -m power=off node1 
> mnodectl -m state=Drain node1 
> mnodectl -m variable=IP=10.10.10.100,Location=R1S2 node1
   
-q — Query
Format: {cat | diag | profile | wiki}
Default: ---
Description: Query node categories or node profile information (see ENABLEPROFILING for nodes).
Example: 
> mnodectl -q cat ALL
node categorization stats from Mon Jul 10 00:00:00 to Mon Jul 10 15:30:00
Node: moab
 Categories:
                     busy: 96.88%
                     idle: 3.12%
Node: maka
 Categories:
                     busy: 96.88%
                     idle: 3.12%
Node: pau
 Categories:
                     busy: 96.88%
                     idle: 3.12%
Node: maowu
 Categories:
                     busy: 96.88%
                  down-hw: 3.12%
Cluster Summary:
                     busy: 96.88%
                  down-hw: 0.78%
                     idle: 2.34%

> mnodectl -v -q profile
...

> mnodectl -q wiki <nodeName>
Query a node with the output displayed in a WIKI string. The node's name may be replaced with ALL.

Parameters

GEVENT
Format: <EVENT>:<MESSAGE>
Default: ---
Description: Creates a generic event on the node to which Moab may respond. (see Enabling Generic Events)
Example: 
mnodectl -m gevent=powerfail:'power has failed' node1
   
GMETRIC
Format: <ATTR>:<VALUE>
Default: ---
Description: Sets the value for a generic metric on the node. (see Enabling Generic Metrics).
Note When a gmetric set in Moab conflicts with what the resource manager reports, Moab uses the set gmetric until the next time the resource manager reports a different number.
Example: 
mnodectl -m gmetric=temp:120 node1
   
MESSAGE
Format: '<MESSAGE>'
Default: ---
Description: Sets a message to be displayed on the node.
Example: 
mnodectl -m message='powerfailure: power has failed' node1
   
NODEEXP
Format: <STRING>
Where <NODEEXP> is a node name, regex or "ALL"
Default: ---
Description: Identifies one or more nodes.
Example: node1 - applies only to node1
fr10n* - all nodes starting with "fr10n"
ALL - all known nodes
   
OS
Format: <STRING>
Default: ---
Description: Operating System (see Resource Provisioning)
Example: 
mnodectl node1 -m OS=RHELAS30
   
POWER
Format: {off|on}
Default: ---
Description: Set the power state of a node. Action will NOT be taken if the node is already in the specified state.
Example: 
> mnodectl node1 -m power=off
   
STATE
Format: <NODE_STATE>
Where <NODE_STATE> is one of the following:
    Busy,
    Down,
    Drain,
    Drained,
    Flush,
    Idle,
    Running,
    Reserved,
    Unknown
Default: ---
Description: Sets the state of the specified node(s).
Note Not all resource managers support all of these states.
Example: 
> mnodectl node1 -m state=Drain
   
VARIABLE
Format: <name>[=<value>],<name[=<value]]...
Default: ---
Description: Set a list of variables for a node.
Example: 
> mnodectl node1 -m variable=IP=10.10.10.100,Location=R1S2

See Also

Home Up