=head1 Name

B<rinstall> - Begin OS provision on a noderange

=head1 B<Synopsis>

B<rinstall> [I<-o>|I<--osver>] [I<-p>|I<--profile>] [I<-a>|I<--arch>] [I<-c>|I<--console>] [I<noderange>]

B<rinstall> [I<-O>|I<--osimage>] [I<-c>|I<--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 [I<-O>|I<--osimage>] is specified or nodetype.provmethod=I<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<--osver>

Specifies which os version to provision.  If unspecified, the current node os setting is used. Will be ignored if [I<-O>|I<--osimage>] is specified or nodetype.provmethod=I<osimage>. 

=item B<-p>|B<--profile>

Specifies what profile should be used of the operating system.  If not specified the current node profile setting is used. Will be ignored if [I<-O>|I<--osimage>] is specified or nodetype.provmethod=I<osimage>.


=item B<-a>|B<--arch>

Specifies what architecture of the OS to provision.  Typically this is unneeded, but if provisioning between x86_64 and x86 frequently, this may be a useful flag. Will be ignored if [I<-O>|I<--osimage>] is specified or nodetype.provmethod=I<osimage>.

=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>

B<rinstall> I<node1-node20>

Provison nodes 1 through 20, using their current configuration.

B<rinstall> I<node1-node20> -o rhels5.1 -p compute

Provision nodes 1 through 20, forcing rhels5.1 and compute profile.

B<rinstall> I<node1-node20> -O rhels6.4-ppc64-netboot-compute

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

B<rinstall>  I<node1> -c

Provisoon node1 and start a console to monitor the process.


=head1 B<See> B<Also>

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