9b8843b122
git-svn-id: https://svn.code.sf.net/p/xcat/code/xcat-core/trunk@4540 8638fb3e-16cb-4fca-ae20-7b5d299a9bcd
109 lines
4.1 KiB
Plaintext
109 lines
4.1 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<stat>|I<iscsiboot>|I<netboot>|I<runcmd=bmcsetup>|I<osimage=<imagename>>]
|
|
|
|
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)|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> will maniputale the boot configuration files of yaboot and pxelinux.0.
|
|
|
|
Assume that /tftpboot is the root for tftpd (set in B<site(5)>).
|
|
|
|
B<nodeset> for pxe makes changes to /tftpboot/pxelinux.cfg/{node hex ip}
|
|
|
|
B<nodeset> for yaboot makes changes to /tftpboot/etc/{node hex ip}
|
|
|
|
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".
|
|
|
|
User can supply their own scripts to be run on the mn or on the service node (if their is hierarchy) for a node during the nodeset command. Such scripts are called B<prescripts>. They should be copied to /install/prescripts dirctory. A table called I<prescripts> is used to specify the scripts and their associated actions. The scripts to be run at the beginning of the nodeset command are stored in the 'begin' column of I<prescripts> table. The scripts to be run at the end of the noodeset command are stored in the 'end' column of I<prescripts> table. Please run 'tabdump prescripts -d' command for details. The following two environment variables will be passed to each script: NODES contains all the names of the nodes that need to run the script for and ACTION contains the current nodeset action.
|
|
|
|
=head1 B<Options>
|
|
|
|
=over 7
|
|
|
|
=item B<boot>
|
|
|
|
Instruct network boot loader to be skipped, generally meaning boot to hard disk
|
|
|
|
=item B<install>
|
|
|
|
Prepare server for installing a node according to the table configuration. This will
|
|
typically mean an unattended install file is created (i.e. kickstart or autoyast),
|
|
install resources will be verified in tftp and the bulk transfer method (http, ftp, or nfs for example), and the boot loader configuration file will be written.
|
|
|
|
=item B<osimage=<imagename>>
|
|
|
|
Prepare server for installing a node using the sepcified os image. The os image is defined in the I<osimage> table and I<linuximage> table.
|
|
|
|
=item B<stat>
|
|
|
|
Display the current boot loader config file description for the nodes requested
|
|
|
|
=item B<runcmd=bmcsetup>
|
|
|
|
This instructs the node to boot to the xCAT nbfs environment and proceed to configure BMC
|
|
for basic remote access. This causes the IP, netmask, gateway, username, and password to be programmed according to the configuration table.
|
|
|
|
=item B<shell>
|
|
|
|
This instructs tho node to boot to the xCAT nbfs environment, and present a shell prompt on console.
|
|
The node will also be able to be sshed into and have utilities such as wget, tftp, scp, nfs, and cifs. It will have storage drivers available for many common systems.
|
|
|
|
=item B<-h>|B<--help>
|
|
|
|
Print help.
|
|
|
|
=item B<-v>|B<--version>
|
|
|
|
Print version.
|
|
|
|
=back
|
|
|
|
|
|
=head1 B<Files>
|
|
|
|
B<noderes> table -
|
|
xCAT node resources file. See B<noderes(5)> for further
|
|
details.
|
|
|
|
B<nodetype> table -
|
|
xCAT node installation type file. See B<nodetype(5)> for fur-
|
|
ther details. This is used to determine the node installation
|
|
image type.
|
|
|
|
B<site> table -
|
|
xCAT main configuration file. See B<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.
|
|
|
|
=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<See> B<Also>
|
|
|
|
L<noderange(3)|noderange.3>, L<nodels(1)|nodels.1>, L<nodestat(1)|nodestat.1>, L<rinstall(8)|rinstall.8>,
|
|
L<makedhcp(8)|makedhcp.8>
|