=head1 Name

B<rinstall> - Begin OS provision on a noderange

=head1 B<Synopsis>

B<rinstall> [B<-O>|B<--osimage>] [B<-c>|B<--console>] [I<noderange>]

=head1 B<Description>

B<rinstall> is a convenience command that will change tables as requested for operating system version, profile, and architecture, call B<nodeset> to modify the network boot configuration, call B<rsetboot> net to set the next boot over network (only support nodes with "nodetype.mgt=ipmi", for other nodes, make sure the correct boot order has been set before B<rinstall>), and B<rpower> to begin a boot cycle.

If [B<-O>|B<--osimage>] is specified or nodetype.provmethod=B<osimage> is set, provision the noderange with the osimage specified/configured, ignore the table change options if specified.

If -c is specified, it will then run rcons on the node. This is allowed only if one node in the noderange.   If need consoles on multiple nodes , see L<winstall(8)|winstall.8>.

=head1 B<Options>

=over 7

=item B<-h>|B<--help>

Display usage message. 

=item B<-v>|B<--version>

Display version. 

=item B<-O>|B<--osimage>

Specifies the osimage to provision. 

=item B<-c>|B<--console>

Requests that rinstall runs rcons once the provision starts.  This will only work if there is only one node in the noderange. See L<winstall(8)|winstall.8> for starting nsoles on multiple nodes.

=back


=head1 B<Examples>

=over 2

=item 1.
Provision nodes 1 through 20, using their current configuration.

 rinstall node1-node20

=item 2.
Provision nodes 1 through 20 with the osimage rhels6.4-ppc64-netboot-compute.

 rinstall node1-node20 -O rhels6.4-ppc64-netboot-compute

=item 3.
Provision node1 and start a console to monitor the process.

 rinstall node1 -c

=back 

=head1 B<See> B<Also>

L<noderange(3)|noderange.3>, L<winstall(8)|winstall.8>, L<rcons(1)|rcons.1>