arif/xcat-core
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

update the mkvm manpage for Direct FSP Management

Browse Source 
git-svn-id: https://svn.code.sf.net/p/xcat/code/xcat-core/trunk@9089 8638fb3e-16cb-4fca-ae20-7b5d299a9bcd
This commit is contained in:
jjhua 2011-03-18 08:01:06 +00:00
parent 4d6e0092de
commit e902c9749e
1 changed files with 78 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

80
xCAT-client/pods/man1/mkvm.1.pod
View File

@ -10,7 +10,7 @@ I<mkvm [-h| --help]>
I<mkvm [-v| --version]>
=head2 For PPC:
=head2 For PPC (with HMC):
I<mkvm [-V| --verbose] noderange -i id -l singlenode>
@ -18,6 +18,10 @@ I<mkvm [-V| --verbose] noderange -c destcec -p profile>
I<mkvm [-V| --verbose] noderange --full>
=head2 For PPC (using Direct FSP Management):
I<mkvm noderange -i id -m memory_interleaving -r partition_rule>
=head2 For KVM:
I<mkvm noderange -m|--master mastername -s|--size disksize -f|--force>
@ -26,6 +30,8 @@ I<mkvm noderange -m|--master mastername -s|--size disksize -f|--force>
=head2 For PPC:
For PPC (with HMC) specific:
The first form of mkvm command creates new partition(s) with the same profile/resources as the partition specified by I<singlenode>. The -i and I<noderange> specify the starting numeric partition number and the noderange for the newly created partitions, respectively. The LHEA port numbers and the HCA index numbers will be automatically increased if they are defined in the source partition.
The second form of this command duplicates all the partitions from the source specified by I<profile> to the destination specified by I<destcec>. The source and destination CECs can be managed by different HMCs.
@ -34,6 +40,10 @@ Please make sure the nodes in the I<noderange> is defined in the I<nodelist> tab
Please note that the mkvm command currently only supports creating standard LPARs, not virtual LPARs working with VIOS server.
For PPC (without HMC, using Direct FSP Management) specific:
This feature is only for P7 IH. mkvm is designed to set the Octant configure value to split the CPU and memory for partitions, and set Octant Memory interleaving value. The mkvm will only set the pending attributes value. After mkvm, the CEC needs to be rebooted manually for the pending values to be enabled. Before reboot the cec, the administrator can use mkvm to change the partition plan. If the the partition needs I/O slots, the administrator should use chvm to assign the I/O slots.
=head2 For KVM:
mkvm ....
@ -45,11 +55,24 @@ B<-h|--help> Display usage message.
B<-c> The cec (fsp) name for the destination.
B<-i> Starting numeric id of the newly created partitions.
B<-i> Starting numeric id of the newly created partitions. For P7 IH using Direct FSP Management, the id value only could be 1, 5, 9, 13, 17, 21, 25 and 29.
B<-m> memory interleaving. The value only could be interleaved or non-interleaved. non-interleaved mode means the memory cannot be shared across the processors in an octant. interleaved means the memory can be shared.
B<-r> partition rule.
If all the octants configuration value are same in one CEC, it will be " -r 0-7:value" .
If the octants use the different configuration value in one cec, it will be "-r 0:value1,1:value2,...7:value7", or "-r 0:value1,1-7:value2" and so on.
The octants configuration value for one Octant could be 1, 2, 3, 4, 5 . The meanings of the octants configuration value are as following:
1 - 1 partition with all cpus and memory of the octant
2 - 2 partitions with a 50/50 split of cpus and memory
3 - 3 partitions with a 25/25/50 split of cpus and memory
4 - 4 partitions with a 25/25/25/25 split of cpus and memory
5 - 2 partitions with a 25/75 split of cpus and memory
B<-l> The partition name of the source.
B<-p> The file that contains the profiles for the source partitions.
B<--full> Request to create a new full system partition for each CEC.
B<-v|--version> Command Version.
@ -134,6 +157,59 @@ lpar5: Success
lpar6: Success
5. For P7 IH, to create a new partition lpar1 on the first octant of the cec, lpar1 will use all the cpu and memory of the octant 0, enter:
I<mkdef -t node -o lpar1 mgt=fsp groups=all parent=cec01 nodetype=lpar hcp=cec01>
then:
I<mkvm lpar1 -i 1 -m non-interleaved -r 0:1>
Output is similar to:
par1: Success
cec1: Please reboot the CEC cec1 firstly, and then use chvm to assign the I/O slots to the LPARs
6. For P7 Ih, to create new partitions lpar1-lpar8 on the whole cec, each LPAR will use all the cpu and memory of each octant, enter:
I<mkdef -t node -o lpar1-lpar8 nodetype=lpar mgt=fsp groups=all parent=cec01 hcp=cec01>
then:
I<mkvm lpar1-lpar8 -i 1 -m non-interleaved -r 0-7:1>
Output is similar to:
lpar1: Success
lpar2: Success
lpar3: Success
lpar4: Success
lpar5: Success
lpar6: Success
lpar7: Success
lpar8: Success
cec1: Please reboot the CEC cec1 firstly, and then use chvm to assign the I/O slots to the LPARs
7. For P7 IH, to create new partitions lpar1-lpar9, the lpar1 will use 25% CPU and 25% memory of the first octant, and lpar2 will use the left CPU and memory of the first octant. lpar3-lpar9 will use all the cpu and memory of each octant, enter:
I<mkdef -t node -o lpar1-lpar9 mgt=fsp groups=all parent=cec1 nodetype=lpar hcp=cec1>
then:
I<mkvm lpar1-lpar9 -i 1 -m non-interleaved -r 0:5,1-7:1>
Output is similar to:
lpar1: Success
lpar2: Success
lpar3: Success
lpar4: Success
lpar5: Success
lpar6: Success
lpar7: Success
lpar8: Success
lpar9: Success
cec1: Please reboot the CEC cec1 firstly, and then use chvm to assign the I/O slots to the LPARs
=head1 FILES