Commands - mnodectl

mnodectl

(Moab Node Control)

Synopsis

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

Overview

Change specified attributes for a given node expression.

Access

By default, this command can be run by any Moab Administrator.

Format

-d — Destroy
[message:<INDEX>]
N/A

With no arguments: Removes specified node(s) from the scheduler or remove specified node attribute.

With message:<INDEX> argument: Remove the message with the given index from the node.

> mnodectl -d node001
node001 is removed from the scheduler.

> mnodectl node001 -d message:admin2
The admin2 message on node001 is removed.
   
-m — Modify
<ATTR>=<VAL>

Where <ATTR> is one of the following:
    GEVENT,
    GMETRIC,
    MESSAGE,
    OS,
    POWER,
    RESOURCE,
    STATE,
    VARIABLE
---
Modify the state or attribute of specified node(s)
> 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 resource.tape+=2,2 node1 
> mnodectl -m state=Drain node1 
> mnodectl -m variable=IP=10.10.10.100,Location=R1S2 node1 
   
-q — Query
{cat | diag | profile}
---
Query node categories or node profile information (see ENABLEPROFILING for nodes).
> 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
...

Parameters

NODEEXP
<STRING>
Where <NODEEXP> is a node name, regex or "ALL"
---
Identifies one or more nodes.
node1 - applies only to node1
fr10n* - all nodes starting with "fr10n"
ALL - all known nodes
   
OS
<STRING>
---
Operating System (see Resource Provisioning)
mnodectl node1 -m OS=RHELAS30
   
POWER
{off|on}
---
Set the power state of a node. Action will NOT be taken if the node is already in the specified state.
> mnodectl node1 -m power=off
   
RESOURCE
<RESID>{+=|-=|=}<AVAL>[,<CVAL>] Where <RESID> is a generic resource and <AVAL> and < CVAL are numbers
---
Increment (+=), decrement (-=) or set (=) a generic resource.  The configured amount of a generic resource can be optionally specified with set.
> mnodectl node1 -m resource.matlab+=1,1
   
STATE
<NODE_STATE>
Where <NODE_STATE> is one of the following:
    Busy,
    Down,
    Drain,
    Drained,
    Flush,
    Idle,
    Running,
    Reserved,
    Unknown
---
Sets the state of the specified node(s).

Note Not all resource managers support all of these states.

> mnodectl node1 -m state=Drain 
   
VARIABLE
<name>[=<value>],<name[=<value]]...
---
Set a list of variables for a node.
> mnodectl node1 -m variable=IP=10.10.10.100,Location=R1S2
      

See Also


Home Up