From 0d4e736b6d71708b28a925f55fa3b4b4052566df Mon Sep 17 00:00:00 2001 From: lissav Date: Tue, 24 Jun 2014 12:17:54 -0400 Subject: [PATCH] defect 4164 --- xCAT-client/pods/man8/rinstall.8.pod | 32 +++++++++++++++--------- xCAT-client/pods/man8/winstall.8.pod | 37 ++++++++++++++++++---------- 2 files changed, 45 insertions(+), 24 deletions(-) diff --git a/xCAT-client/pods/man8/rinstall.8.pod b/xCAT-client/pods/man8/rinstall.8.pod index 1988ace26..1923a8f9f 100644 --- a/xCAT-client/pods/man8/rinstall.8.pod +++ b/xCAT-client/pods/man8/rinstall.8.pod @@ -4,32 +4,42 @@ B - Begin OS provision on a noderange =head1 B -B [I<-o>|I<--osver>] [I<-p>|I<--profile>] [I<-a>|I<--arch>] [I<-O>|I<--osimage>] [I<-c>|I<--console>] [I] +B [I<-o>|I<--osver>] [I<-p>|I<--profile>] [I<-a>|I<--arch>] [I<-c>|I<--console>] [I] + +B [I<-O>|I<--osimage>] [I<-c>|I<--console>] [I] =head1 B -B is a convience command that will change tables as requested for operating system version, profile, and architecture, call B to modify the network boot configuration, call B 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), and B to begin a boot cycle. +B is a convenience command that will change tables as requested for operating system version, profile, and architecture, call B to modify the network boot configuration, call B 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), and B to begin a boot cycle. If [I<-O>|I<--osimage>] is specified or nodetype.provmethod=I is set, provision the noderange with the osimage specified/configured, ignore the table change options if specified. -If -c is specified, it will then become the text console of the node. If wanting consoles on multiple nodes with a similar command, see L. +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. =head1 B =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 table values are used. Will be ignored if [I<-O>|I<--osimage>] is specified or nodetype.provmethod=I. +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. =item B<-p>|B<--profile> -Specifies what profile should be used of the operating system. If not specified the tables are used as is. Will be ignored if [I<-O>|I<--osimage>] is specified or nodetype.provmethod=I. +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. =item B<-a>|B<--arch> -Specifies what architecture of the OS to provision. Typically this is unneeded, but if provisioning betweer 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. +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. =item B<-O>|B<--osimage> @@ -37,7 +47,7 @@ Specifies the osimage to provision. =item B<-c>|B<--console> -Requests that rinstall become rcons once the provision commences. This will only work if there is only one node in the noderange. See L for consoles on multiple systems. +Requests that rinstall runs rcons once the provision starts. This will only work if there is only one node in the noderange. See L for starting nsoles on multiple nodes. =back @@ -46,17 +56,17 @@ Requests that rinstall become rcons once the provision commences. This will onl B I -Provison nodes 1 through 20, using configuration as is from tables. +Provison nodes 1 through 20, using their current configuration. -B -o rhels5.1 -p compute I +B I -o rhels5.1 -p compute Provision nodes 1 through 20, forcing rhels5.1 and compute profile. -B -O rhels6.4-ppc64-netboot-compute I +B I -O rhels6.4-ppc64-netboot-compute Provision nodes 1 through 20 with the osimage rhels6.4-ppc64-netboot-compute. -B -c I +B I -c Provisoon node1 and start a console to monitor the process. diff --git a/xCAT-client/pods/man8/winstall.8.pod b/xCAT-client/pods/man8/winstall.8.pod index 464b22de2..303256b18 100644 --- a/xCAT-client/pods/man8/winstall.8.pod +++ b/xCAT-client/pods/man8/winstall.8.pod @@ -1,53 +1,64 @@ =head1 Name -B - Begin OS provision on a noderange and display in wcons +B - Begin OS provision on a noderange =head1 B -B [I<-o>|I<--osver>] [I<-p>|I<--profile>] [I<-a>|I<--arch>] [I<-O>|I<--osimage>] [I] +B [I<-o>|I<--osver>] [I<-p>|I<--profile>] [I<-a>|I<--arch>] [I] + +B [I<-O>|I<--osimage>] [I] =head1 B -B is a convience command that will change tables as requested for operating system version, profile, and architecture, call nodeset to modify the network boot configuration, and rpower to begin a boot cycle. +B is a convenience tool that will change attributes as requested for operating system version, profile, and architecture, call B to modify the network boot configuration, call B 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), and B to begin a boot cycle. -If [I<-O>|I<--osimage>] is specified or nodetype.provmethod=I is set, provision the noderange with the osimage specified/configured, ignore the table change options if specified +If [I<-O>|I<--osimage>] is specified or nodetype.provmethod=I is set, provision the noderange with the osimage specified/configured, ignore the table change options if specified. -It will then commence a wcons command to the noderange for monitoring. +It will then run wcons on the nodes. =head1 B =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 table values are used. Will be ignored if [I<-O>|I<--osimage>] is specified or nodetype.provmethod=I. +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. =item B<-p>|B<--profile> -Specifies what profile should be used of the operating system. If not specified the tables are used as is. Will be ignored if [I<-O>|I<--osimage>] is specified or nodetype.provmethod=I. +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. =item B<-a>|B<--arch> -Specifies what architecture of the OS to provision. Typically this is unneeded, but if provisioning betweer 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. +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. =item B<-O>|B<--osimage> -Specifies the osimage to provision. +Specifies the osimage to provision. =back =head1 B -B I +B I -Provison nodes 1 through 20, using configuration as is from tables. +Provison nodes 1 through 20, using their current configuration. -B -o rhels5.1 -p compute I +B I -o rhels5.1 -p compute Provision nodes 1 through 20, forcing rhels5.1 and compute profile. -B -O rhels6.4-ppc64-netboot-compute I +B I -O rhels6.4-ppc64-netboot-compute Provision nodes 1 through 20 with the osimage rhels6.4-ppc64-netboot-compute.