mnodectl

(Moab Node Control)

mnodectl -d attr=val nodeexp
mnodectl -m attr=val nodeexp
mnodectl -q [cat|diag] nodeexp

Change specified attributes for a given node expression.

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

Flag	Name	Format	Default	Description	Example
-d	DESTROY	---	N/A	Remove specified node(s) from the scheduler or remove specified node attribute	mnodectl -d > mnodectl -d node001
		message:<INDEX> Where <INDEX> is a message index	---	Remove the message with the given index from the node	mnodectl -d > mnodectl node001 -d message:admin2
-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 > mnodectl node1 -m gevent=cpufail:'cpu02 has failed w/ec:0317' > mnodectl node1 -m gmetric=temp:131.2 > mnodectl node1 -m message='cpufailure:cpu02 has failed w/ec:0317' > mnodectl node1 -m OS=RHAS30 > mnodectl node1 -m power=off > mnodectl node1 -m resource.tape+=2,2 > mnodectl node1 -m state=Drain > mnodectl node1 -m variable=IP=10.10.10.100,Location=R1S2
-q	QUERY	{ cat \| profile }	---	query node categories or node profile information (see ENABLEPROFILING for nodes).	mnodectl -q cat ALL > 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 -v -q profile ...

Name	Format	Default	Description	Example
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 -m 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. NOTE: POWEROFFURL and POWERONURL need to be set in the config file for action to be taken external to the scheduler.	mnodectl -m > 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 -m > 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 -m > mnodectl node1 -m state=Drain
VARIABLE	<name>[=<value>],<name[=<value]]...	---	Set a list of variables for a node	mnodectl -m > mnodectl node1 -m variable=IP=10.10.10.100,Location=R1S2