=head1 NAME

B<wwnodes>

=head1 DESCRIPTION

B<wwnodes> is a tool used to help with the normal administration of Warewulf
nodes.

=head1 OPTIONS

=over 4

=item B<--info => node name/designation

Display information and current statistics about the given node. You can
reference the node either by node name or by its designation (node0000).

=item B<--sync/update>

This funcation will synchronize all of the nodes' passwd, hosts, etc... for
each of the nodes. Use this option when adding or removing users from a given
set of nodes.

Modules for what content gets syncronized can be found at
/usr/lib(64)/warewulf/modules/sync_*. 'sync_nodegroup' is a shell script
example of how to do this.

=over 8

=item B<--nonodes>

When used with --sync/update this funcation will generate the sync files, but
not actually do the node update. This is useful if you prefer to do it with a
parallel command like pdsh.

=back

=item B<--add>

When nodes boot for the first time, they will send out a request to the master
node for a new node configuration. Using 'add' wwnodes will scan for these 
requests, and then add the node's mac addresses to the nodes.conf configuration 
file (first/default group), add the pxeboot entries, and trigger that node to 
reboot. When the node reboots.

=item B<--help>

Show the help screen.

=head2 The following are options that can be passed with B<--add>:

=over 8

=item B<--scan>

Continue scanning for new nodes. The default behavior is to scan for a single
new node, and then exit.

Note, this option can not be used if you are going to define custom attributes
on a per node basis (as the options --name, --otherdev, and --otheraddr do).

=item B<--group => groupname

By default adding new nodes puts the new nodes in the top most group in the
configuration file which is the default group. This option adds the node to a
particular group.

=item B<--opts => "key=value,..."

Define optional options for specific nodes. The optional arguments can be
found in the nodes.conf manual.

note: since these arguments are specific for one node, you can not run this
with the --scan argument!

=back

=head1 AUTHOR

B<Warewulf> is written and maintained by Greg M. Kurtzer <gmk@lbl.gov>, and
hosted by Lawrence Berkeley National Labratory (http://www.lbl.gov).

http://warewulf-cluster.org/
