3c0dfdbfbf
git-svn-id: https://svn.code.sf.net/p/xcat/code/xcat-core/trunk@786 8638fb3e-16cb-4fca-ae20-7b5d299a9bcd
183 lines
5.5 KiB
Plaintext
183 lines
5.5 KiB
Plaintext
=head1 Name
|
|
|
|
B<nodeset> - set the boot state for a noderange
|
|
|
|
=head1 B<Synopsis>
|
|
|
|
B<nodeset> [I<noderange>] [I<boot>|I<install>|I<state>|I<stat>]
|
|
|
|
B<nodeset> [I<noderange>] [I<stage2>|I<stage3>|I<shell>]
|
|
|
|
B<nodeset> [I<noderange>] [I<clone>|I<cloneserver>|I<image>]
|
|
|
|
|
|
B<nodeset> [I<noderange>] [I<flash>={I<image>}]
|
|
|
|
|
|
B<nodeset> [I<-h>|I<--help>|I<-v>|I<--version>]
|
|
|
|
=head1 B<Description>
|
|
|
|
B<nodeset> sets the next cold or warm boot state for a single or range of
|
|
nodes or groups. This tells xCAT what you want to happen the next time the
|
|
nodes are booted up. See L<noderange(3)>. B<nodeset> accomplishes this by
|
|
changing the network boot files. Each xCAT node always boots from the
|
|
network and downloads a boot file with instructions on what action to
|
|
take next.
|
|
|
|
B<nodeset> only supports PXELINUX, Etherboot, Etherboot/NBGRUB, and ELILO
|
|
as network boot loaders. B<nodeset> calls B<nodeset.pxe>, B<nodeset.eb>, B<node->
|
|
B<set.nbgrub>, and B<nodeset.elilo> to perform the updates.
|
|
|
|
Assume that /tftpboot is the root for tftpd (set in L<site.tab(5)>).
|
|
|
|
B<nodeset.pxe> makes changes to /tftpboot/pxelinux.0/{node hex ip}
|
|
|
|
B<nodeset.eb> makes changes to /etc/dhcpd.conf
|
|
|
|
B<nodeset.nbgrub> makes changes to /tftpboot/grub/{node hostname}.grub
|
|
|
|
B<nodeset.elilo> makes changes to /tftpboot/elilo/{node ip}.conf and
|
|
/tftpboot/elilo/{node hex ip}.conf
|
|
|
|
B<nodeset.elilo> support both formats for xCAT patch elilo 2.5 and xCAT
|
|
patched elilo 3.x.
|
|
|
|
B<nodeset> only sets the next boot state, but does not reboot.
|
|
|
|
B<nodeset> is called by rinstall and winstall and is also called by the
|
|
installation process remotely to set the boot state back to "boot".
|
|
|
|
When B<nodeset> is called to set a node for an installation state, a NODE-
|
|
TYPE-RESOURCE.BOOTTYPE template must exist in /tftpboot/xcat (or the
|
|
appropriate directory as defined in L<site.tab(5)>), where NODETYPE is
|
|
defined per node in L<nodetype.tab(5)>, RESOURCE is defined per node or
|
|
group in L<noderes.tab(5)>, and BOOTTYPE is defined per node in
|
|
L<nodehm.tab(5)>.
|
|
|
|
=head1 B<Options>
|
|
|
|
=over 7
|
|
|
|
=item B<boot>
|
|
|
|
Instruct node to boot local harddisk 0 on next boot.
|
|
|
|
=item B<install>
|
|
|
|
Instruct node to boot from network. This usually involves TFTP
|
|
downloading a kernel, initrd, and kernel options, then booting
|
|
the downloaded images to facilitate automated unattended
|
|
installation.
|
|
|
|
=item B<state>|B<stat>
|
|
|
|
Display the next boot state.
|
|
|
|
=item B<stage2>
|
|
|
|
Instruct node to boot from network image stage2. This involves
|
|
TFTP downloading a special prebuilt kernel, initrd, and kernel
|
|
options used for MAC address collection. For a new node this is
|
|
the default action and cannot be changed until a node entry
|
|
exists in L<dhcpd.conf(5)>. It is not necessary to explicitly set
|
|
stage2, unless it is used for testing and development purposes.
|
|
|
|
=item B<stage3>
|
|
|
|
Instruct node to boot from network image stage3. This involves
|
|
TFTP downloading a special prebuilt kernel, initrd, and kernel
|
|
options used for the automated programming of IBM service pro-
|
|
cessors.
|
|
|
|
=item B<shell>
|
|
|
|
Instruct node to boot from a network maintainance shell image.
|
|
This involves TFTP downloading a special prebuilt kernel, ini-
|
|
trd, and kernel options used for a limited RAMdisk-based main-
|
|
tainance shell. Only available for IA64 systems.
|
|
|
|
=item B<clone>
|
|
|
|
Instruct node to boot from network into clone mode. In clone
|
|
mode the node will poll the management node for nodes in clone-
|
|
server mode, once a clone lock is established the clone node
|
|
clones the cloneserver node. Usually called from L<rclone(1)>.
|
|
|
|
=item B<cloneserver>
|
|
|
|
Instruct node to boot from network into cloneserver mode. In
|
|
cloneserver mode the node will wait for a node to attempt a
|
|
clone lock. Once a clone lock is established the clone node
|
|
clones the cloneserver node. All other requested will be
|
|
refused until node cloning is completed.
|
|
|
|
=item B<image>
|
|
Instruct node to boot from network and run Partition Imager to
|
|
create partition images.
|
|
|
|
=item B<flash>=I<image>
|
|
|
|
Instruct node to boot from network load DOS and flash I<image>.
|
|
Usually called from L<rflash(1)>.
|
|
|
|
=item B<-h>|B<--help>
|
|
|
|
Print help.
|
|
|
|
=item B<-v>|B<--version>
|
|
|
|
Print version.
|
|
|
|
=back
|
|
|
|
|
|
=head1 B<Files>
|
|
|
|
B<nodehm> table -
|
|
xCAT node hardware management file. See L<nodehm(5)> for fur-
|
|
ther details. This is used to determine the network boot type:
|
|
PXE, Etherboot, ELILO, or NA.
|
|
|
|
B<noderes> table -
|
|
xCAT node resources file. See L<noderes(5)> for further
|
|
details. This is used to determine the node's resource group.
|
|
|
|
B<nodetype> table -
|
|
xCAT node installation type file. See L<nodetype(5)> for fur-
|
|
ther details. This is used to determine the node installation
|
|
image type.
|
|
|
|
B<site> table -
|
|
xCAT main configuration file. See L<site(5)> for further
|
|
details. This is used to determine the location of the TFTP
|
|
root directory and the TFTP xCAT subdirectory. /tftpboot and
|
|
/tftpboot/xcat is the default.
|
|
|
|
B</etc/dhcpd.conf> file -
|
|
xCAT dhcpd configuration file. See L<dhcpd.conf(5)> for further
|
|
details. This is used by B<nodeset> to determine if a node will
|
|
only boot stage2 because no statically assigned IP exists for
|
|
that node. Also used by nodeset.eb to set the boot state for
|
|
Etherboot enabled nodes.
|
|
|
|
|
|
=head1 B<Examples>
|
|
|
|
B<nodeset> I<node5> I<install>
|
|
|
|
node5: install compute62-compute
|
|
|
|
Install node5 with the compute62 image using resources from the compute
|
|
resource group.
|
|
|
|
|
|
=head1 B<Author>
|
|
|
|
Egan Ford <egan@us.ibm.com>
|
|
|
|
=head1 B<See> B<Also>
|
|
|
|
L<noderange(3)>, L<nodels(1)>, L<nodestat(1)>, L<rinstall(1)>,
|
|
L<rflash(1)>, L<makedhcp(8)>
|