Commands - mnodectl
Home Up Moab Workload Manager®

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
Format: [message:<INDEX>]
Default: N/A
Description:

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.
Example: 
> mnodectl -d node001
node001 is removed from the scheduler. 

> 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,
    RESOURCE,
    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 resource.tape+=2,2 node1 
> mnodectl -m state=Drain node1 
> mnodectl -m variable=IP=10.10.10.100,Location=R1S2 node1 


    

  
  
  
    

       
       
    

  
  
    

      -q — Query
    

    

      Format:
      {cat | diag | profile} 
    

    

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

    

  




Parameters




  
    

      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


      

    

  
  
  
    

       
       
    

  
  
    

      RESOURCE
    

    

      Format:
      <RESID>{+=|-=|=}<AVAL>[,<CVAL>]     Where <RESID> is a generic resource and <AVAL> and < CVAL are numbers 
    

    

      Default:
      --- 
    

    

      Description:
      Increment (+=), decrement (-=) or set (=) a generic resource.  The configured amount of a generic resource can be optionally specified with set. 
    

    

      Example:
      

        
> mnodectl node1 -m resource.matlab+=1,1

      

    

  
  
  
    

       
       
    

  
  
    

      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







   		
     

     

      © 2001-2010 Adaptive Computing Enterprises, Inc.