nodels - lists the nodes, and their attributes, from the xCAT database.
nodels [noderange] [-b | --blame] [-H | --with-fieldname] [-S] [table.column | shortname] [...]
nodels [noderange] [-H | --with-fieldname] [table]
nodels [-? | -h | --help | -v | --version]
The nodels command lists the nodes specified in the node range. If no noderange is provided, then all nodes are listed.
Additional attributes of the nodes will also be displayed if the table names and attribute names are specified after the noderange in the form: table.column . A few shortcut names can also be used as aliases to common attributes:
nodelist.groups
nodelist.groups
nodehm.mgt
nodels can also select based on table value criteria. The following operators are available:
Select nodes where the table.column value is exactly a certain value.
Select nodes where the table.column value is not a given specific value.
Select nodes where the table.column value matches a given regular expression.
Select nodes where the table.column value does not match a given regular expression.
The nodels command with a specific node and one or more table.attribute parameters is a good substitute for grep'ing through the tab files, as was typically done in xCAT 1.x. This is because nodels will translate any regular expression rows in the tables into their meaning for the specified node. The tab* commands will not do this, instead they will just display the regular expression row verbatim.
Command Version.
Force display of table name and column name context for each result
For values inherited from groups, display which groups provided the inheritence
List all the hidden nodes (FSP/BPA nodes) with other ones.
Display usage message.
0 The command completed successfully.
1 An error has occurred.
To list all defined nodes, enter:
nodels
Output is similar to:
node1
node2
node3
To list all defined attributes in a table for a node or noderange, enter:
nodels rra001a noderes
Output is similar to:
rra001a: noderes.primarynic: eth0
rra001a: noderes.xcatmaster: rra000
rra001a: noderes.installnic: eth0
rra001a: noderes.netboot: pxe
rra001a: noderes.servicenode: rra000
rra001a: noderes.node: rra001a
To list nodes in node group ppc, enter:
nodels ppc
Output is similar to:
ppcnode1
ppcnode2
ppcnode3
To list the groups each node is part of:
nodels all groups
Output is similar to:
node1: groups: all
node2: groups: all,storage
node3: groups: all,blade
To list the groups each node is part of:
nodels all nodehm.power
Output is similar to:
node1: nodehm.power: blade
node2: nodehm.power: ipmi
node3: nodehm.power: ipmi
To list the out-of-band mgt method for blade1:
nodels blade1 nodehm.mgt
Output is similar to:
blade1: blade
Listing blades managed through an AMM named 'amm1'
nodels all mp.mpa==amm1
Output is similar to:
blade1
blade10
blade11
blade12
blade13
blade2
blade3
blade4
blade5
blade6
blade7
blade8
blade9
Listing the switch.switch value for nodes in the second rack:
nodels all nodepos.rack==2 switch.switch
Output is similar to:
n41: switch.switch: switch2
n42: switch.switch: switch2
n43: switch.switch: switch2
n44: switch.switch: switch2
n45: switch.switch: switch2
n46: switch.switch: switch2
n47: switch.switch: switch2
n55: switch.switch: switch2
n56: switch.switch: switch2
n57: switch.switch: switch2
n58: switch.switch: switch2
n59: switch.switch: switch2
n60: switch.switch: switch2
Listing the blade slot number for anything managed through a device with a name beginning with amm:
nodels all mp.mpa=~/^amm.*/ mp.id
Output looks like:
blade1: mp.id: 1
blade10: mp.id: 10
blade11: mp.id: 11
blade12: mp.id: 12
blade13: mp.id: 13
blade2: mp.id: 2
blade3: mp.id: 3
blade4: mp.id: 4
blade5: mp.id: 5
blade6: mp.id: 6
blade7: mp.id: 7
blade8: mp.id: 8
blade9: mp.id: 9
To list the hidden nodes that can't be seen with other flags. The hidden nodes are FSP/BPAs.
lsdef -S
/opt/xcat/bin/nodels