xcat-core/xCAT-client-2.0/pods/man1/nodels.1.pod
jbjohnso b5f9d956f4 -Migrate kernel, initrd, kcmdline to new bootparams table from noderes
-Migrate serialport to nodehm from noderes


git-svn-id: https://svn.code.sf.net/p/xcat/code/xcat-core/trunk@1205 8638fb3e-16cb-4fca-ae20-7b5d299a9bcd
2008-04-25 15:36:56 +00:00

165 lines
2.6 KiB
Plaintext

=head1 NAME
B<nodels> - lists the nodes in the noderange.
=head1 SYNOPSIS
B<nodels> [I<noderange>] [I<table.column> | I<shortname>] [I<...>]
B<nodels> [I<noderange>] [I<table>]
B<nodels> {B<-v> | B<--version>}
B<nodels> [B<-?> | B<-h> | B<--help>]
=head1 DESCRIPTION
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: I<table.column> . A few shortcut names can
also be used as aliases to common attributes:
=over 10
=item I<groups>
nodelist.groups
=item I<tags>
nodelist.groups
=item I<mgt>
nodehm.mgt
=item I<switch>
switch.switch
=back
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, like was 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 single regular expression row.
=head1 OPTIONS
=over 10
=item B<-v|--version>
Command Version.
=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 2
=item *
To list all defined nodes, enter:
B<nodels>
Output is similar to:
node1
node2
node3
=item *
To list all defined attributes in a table for a node or noderange, enter:
B<nodels> I<rra001a> I<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 *
To list nodes in node group ppc, enter:
B<nodels> I<ppc>
Output is similar to:
ppcnode1
ppcnode2
ppcnode3
=item *
To list the groups each node is part of:
B<nodels> I<all> I<groups>
Output is similar to:
node1: groups: all
node2: groups: all,storage
node3: groups: all,blade
=item *
To list the groups each node is part of:
B<nodels> I<all> I<nodehm.power>
Output is similar to:
node1: nodehm.power: blade
node2: nodehm.power: ipmi
node3: nodehm.power: ipmi
=item *
To list the out-of-band mgt method for blade1:
B<nodels> I<blade1> I<nodehm.mgt>
Output is similar to:
blade1: nodehm.mgt: blade
=back
=head1 FILES
/opt/xcat/bin/nodels
=head1 SEE ALSO
noderange(5)