xcat-core/xCAT-client/pods/man1/rnetboot.1.pod
yinle f593cd8d3d minor fix
git-svn-id: https://svn.code.sf.net/p/xcat/code/xcat-core/trunk@11774 8638fb3e-16cb-4fca-ae20-7b5d299a9bcd
2012-03-07 01:28:09 +00:00

86 lines
2.3 KiB
Plaintext

=head1 NAME
B<rnetboot> - Cause the range of nodes to boot to network.
=head1 SYNOPSIS
B<rnetboot> [B<-V>|B<--verbose>] [B<-s> I<boot_device_order>] [B<-F>] [B<-f>] I<noderange> [B<-m> I<table.column>==I<expectedstatus> [B<-m> I<table.col-umn>=~I<expectedstatus>]] [B<-t> I<timeout>] [B<-r> I<retrycount>]
B<rnetboot> [B<-h>|B<--help>] [B<-v>|B<--version>]
B<rnetboot> noderange [B<ipl=> I<address>]
=head1 DESCRIPTION
The rnetboot command will do what is necessary to make each type of node in the given noderange
boot from the network. This is usually used to boot the nodes stateless or to network install
system p nodes.
=head1 OPTIONS
B<-s>
Set the boot device order. Accepted boot devices are hd and net.
B<-F>
Force reboot the system no matter what state the node is. By default, rnetboot will not reboot the node if node is in 'boot' state.
B<-f>
Force immediate shutdown of the partition.
B<-m>
Use one or multiple -m flags to specify the node attributes and the expected status for the node installation monitoring and automatic retry mechanism. The operators ==, !=, =~ and !~ are valid. This flag must be used with -t flag.
Note: if the "val" fields includes spaces or any other characters that will be parsed by shell, the "attr<oper-ator>val" needs to be quoted. If the operator is "!~", the "attr<operator>val" needs to be quoted using single quote.
B<-r>
specify the number of retries that the monitoring process will perform before declare the failure. The default value is 3. Setting the retrycount to 0 means only monitoring the os installation progress and will not re-initiate the installation if the node status has not been changed to the expected value after timeout. This flag must be used with -m flag.
B<-t>
Specify the the timeout, in minutes, to wait for the expectedstatus specified by -m flag. This is a required flag if the -m flag is specified.
B<-V>
Verbose output.
B<-h>
Display usage message.
B<-v>
Command Version.
=head1 RETURN VALUE
0 The command completed successfully.
1 An error has occurred.
=head1 EXAMPLES
rnetboot 1,3
rnetboot 14-56,70-203
rnetboot 1,3,14-56,70-203
rnetboot all,-129-256
rnetboot all -s hd,net
rnetboot all ipl=00c
=head1 SEE ALSO
L<nodeset(8)|nodeset.8>