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

update usage and man page for mkvm

Browse Source 
git-svn-id: https://svn.code.sf.net/p/xcat/code/xcat-core/trunk@3104 8638fb3e-16cb-4fca-ae20-7b5d299a9bcd
This commit is contained in:
linggao 2009-04-06 18:52:35 +00:00
parent eb8a69896f
commit a5f448d4fb
2 changed files with 60 additions and 17 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

11
perl-xCAT/xCAT/Usage.pm
View File

@ -102,9 +102,14 @@ my %usage = (
PPC specific:
getmacs <noderange> [-f][-d][-S server -G gateway -C client]",
"mkvm" =>
"Usage: mkvm singlenode -i id -n noderange [-V|--verbose]
mkvm srccec -c destcec [-V|--verbose]
mkvm [-h|--help|-v|--version]",
"Usage:
Common:
mkvm [-h|--help|-v|--version]
For PPC:
mkvm noderange -i id -l singlenode [-V|--verbose]
mkvm noderange -c destcec -p profile [-V|--verbose]
For KVM
mkvm noderange -m|--master mastername -s|--size disksize -f|--force",
"lsvm" =>
"Usage:
Common:

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

@ -4,33 +4,52 @@ B<mkvm> - Creates HMC- and IVM-managed partitions.
=head1 SYNOPSIS
=head2 Common:
I<mkvm [-h| --help]>
I<mkvm [-v| --version]>
I<mkvm [-V| --verbose] singlenode -i id -n noderange>
=head2 For PPC:
I<mkvm [-V| --verbose] srccec -c destcec>
I<mkvm [-V| --verbose] noderange -i id -l singlenode>
I<mkvm [-V| --verbose] noderange -c destcec -p profile>
=head2 For KVM:
I<mkvm noderange -m|--master mastername -s|--size disksize -f|--force>
=head1 DESCRIPTION
The mkvm command creates new partition(s) with the same profile/resources as the partition specified by singlenode. The -i and -n flags specify the starting numeric partition number and the noderange for the newly created partitions, respectively. The second form of this command duplicates all the partitions associated with srccec to destcec. Note that srcdest and destcec must be associated with the same HMC. Newly created partitions are automatically added to the xCAT database.
=head2 For PPC:
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.
Please make sure the nodes in the I<noderange> is defined in the I<nodelist> table and the I<mgt> is set to 'hmc' in the I<nodehm> table before running this command.
=head2 For KVM:
mkvm ....
=head1 OPTIONS
B<-h> Display usage message.
B<-h|--help> Display usage message.
B<-c> Copy partitions from srccec to destcec on single HMC.
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.
B<-n> New partition name.
B<-l> The partition name of the source.
B<-v> Command Version.
B<-p> The file that contains the profiles for the source partitions.
B<-V> Verbose output.
B<-v|--version> Command Version.
B<-V|--verbose> Verbose output.
=head1 RETURN VALUE
@ -43,7 +62,11 @@ B<-V> Verbose output.
1. To create a new partition lpar5 based on the profile/resources of lpar4, enter:
I<mkvm lpar4 -i 5 -n lpar5>
I<mkdef -t node -o lpar5 mgt=hmc groups=all>
then:
I<mkvm lpar5 -i 5 l lpar4>
Output is similar to:
@ -52,7 +75,11 @@ lpar5: Success
2. To create new partitions lpar5-lpar8 based on the profile/resources of lpar4, enter:
I<mkvm lpar4 -i 5 -n lpar5-lpar8>
I<mkdef -t node -o lpar5-lpar8 mgt=hmc groups=all>
then:
I<mkvm lpar5-lpar8 -i 5 lpar4>
Output is similar to:
@ -65,13 +92,24 @@ lpar7: Success
lpar8: Success
3. To duplicate all the partitions associated with cec01 on cec02, enter:
3. To duplicate all the partitions associated with cec01 on cec02, first save the lpars from cec01 to a file:
I<mkvm cec01 -c cec02>
I<lsvm lpar01-lpar04> > I</tmp/myprofile>
then create lpars on cec02:
I<mkvm lpar05-lpar08 -c cec02 -p /tmp/myprofile>
Output is similar to:
cec01: Success
lpar5: Success
lpar6: Success
lpar7: Success
lpar8: Success
=head1 FILES