=head1 Name

B<winstall> - Begin OS provision on a noderange

=head1 B<Synopsis>

B<winstall> I<noderange> [B<boot> | B<shell> | B<runcmd=bmcsetup>] [B<runimage=>I<task>] [B<-V>|B<--verbose>]

B<winstall> I<noderange> [B<osimage>=I<imagename> | I<imagename>] [B<--ignorekernelchk>] [B<-u>|B<--uefimode>] [B<-V>|B<--verbose>]

B<winstall> [B<-h>|B<--help>|B<-v>|B<--version>]

=head1 B<Description>

B<winstall> is a convenience command to begin OS provision on a noderange.

If B<osimage>=I<imagename> | I<imagename> is specified or nodetype.provmethod=B<osimage> is set, provision the noderange with the osimage specified/configured.

It  will then run B<wcons> on the noderange.

=head1 B<Options>

=over 7

=item B<boot>

Instruct network boot loader to be skipped, generally meaning boot to hard disk

=item I<imagename> | B<osimage=>I<imagename>

Prepare server for installing a node using the specified os image. The os image is defined in the I<osimage> table and I<linuximage> table. If the I<imagename> is omitted, the os image name will be obtained from I<nodetype.provmethod> for the node.

=item B<--ignorekernelchk>

Skip the kernel version checking when injecting drivers from osimage.driverupdatesrc. That means all drivers from osimage.driverupdatesrc will be injected to initrd for the specific target kernel.

=item B<runimage=>I<task>

If you would like to run a task after deployment, you can define that task with this attribute.

=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 the node to boot to the xCAT genesis 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>

Display usage message.

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

Display version.

=item B<-u>|B<--uefimode>

For BMC-based servers, to specify the next boot mode to be "UEFI Mode".

=item B<-V>|B<--verbose>

Verbose output.

=back


=head1 B<Examples>

=over 2

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

 winstall node1-node20

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

 winstall node1-node20 osimage=rhels6.4-ppc64-netboot-compute

=back

=head1 B<See> B<Also>

L<noderange(3)|noderange.3>, L<rinstall(8)|rinstall.8>, L<wcons(1)|wcons.1>
