deda80a245
git-svn-id: https://svn.code.sf.net/p/xcat/code/xcat-core/trunk@1980 8638fb3e-16cb-4fca-ae20-7b5d299a9bcd
173 lines
2.8 KiB
Plaintext
173 lines
2.8 KiB
Plaintext
=head1 NAME
|
|
|
|
B<nodels> - lists the nodes, and their attributes, from the xCAT database.
|
|
|
|
|
|
=head1 SYNOPSIS
|
|
|
|
B<nodels> [I<noderange>] [B<-H> | B<--with-fieldname>] [I<table.column> | I<shortname>] [I<...>]
|
|
|
|
B<nodels> [I<noderange>] [B<-H> | B<--with-fieldname>] [I<table>]
|
|
|
|
B<nodels> [B<-?> | B<-h> | B<--help> | B<-v> | B<--version>]
|
|
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
The B<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: I<table.column> . A few shortcut names can
|
|
also be used as aliases to common attributes:
|
|
|
|
=over 15
|
|
|
|
=item B<groups>
|
|
|
|
nodelist.groups
|
|
|
|
=item B<tags>
|
|
|
|
nodelist.groups
|
|
|
|
=item B<mgt>
|
|
|
|
nodehm.mgt
|
|
|
|
=item B<switch>
|
|
|
|
switch.switch
|
|
|
|
=back
|
|
|
|
The B<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.
|
|
|
|
|
|
=head1 OPTIONS
|
|
|
|
=over 10
|
|
|
|
=item B<-v|--version>
|
|
|
|
Command Version.
|
|
|
|
=item B<-H|--with-fieldname>
|
|
|
|
Force display of table name and column name context for each result
|
|
|
|
=item B<-?|-h|--help>
|
|
|
|
Display usage message.
|
|
|
|
=back
|
|
|
|
|
|
=head1 RETURN VALUE
|
|
|
|
=over 3
|
|
|
|
=item 0
|
|
|
|
The command completed successfully.
|
|
|
|
=item 1
|
|
|
|
An error has occurred.
|
|
|
|
=back
|
|
|
|
|
|
=head1 EXAMPLES
|
|
|
|
=over 3
|
|
|
|
=item 1.
|
|
|
|
To list all defined nodes, enter:
|
|
|
|
nodels
|
|
|
|
Output is similar to:
|
|
|
|
node1
|
|
node2
|
|
node3
|
|
|
|
=item 2.
|
|
|
|
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
|
|
|
|
|
|
=item 3.
|
|
|
|
To list nodes in node group ppc, enter:
|
|
|
|
nodels ppc
|
|
|
|
Output is similar to:
|
|
|
|
ppcnode1
|
|
ppcnode2
|
|
ppcnode3
|
|
|
|
=item 4.
|
|
|
|
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
|
|
|
|
=item 5.
|
|
|
|
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
|
|
|
|
=item 6.
|
|
|
|
To list the out-of-band mgt method for blade1:
|
|
|
|
nodels blade1 nodehm.mgt
|
|
|
|
Output is similar to:
|
|
|
|
blade1: nodehm.mgt: blade
|
|
|
|
=back
|
|
|
|
|
|
=head1 FILES
|
|
|
|
/opt/xcat/bin/nodels
|
|
|
|
|
|
=head1 SEE ALSO
|
|
|
|
L<noderange(3)|noderange.3>, L<tabdump(8)|tabdump.8>, L<lsdef(1)|lsdef.1>
|
|
|