xcat-core/xCAT-client-2.0/pods/man1/mkvm.1.pod

74 lines
1.5 KiB
Plaintext

=head1 NAME
B<mkvm> - Creates HMC- and IVM-managed partitions.
=head1 SYNOPSIS
I<mkvm [-h| --help]>
I<mkvm [-v| --version]>
I<mkvm [-V| --verbose] singlenode -i id -n name>
I<mkvm [-V| --verbose] src_cec -c dest_cec>
=head1 DESCRIPTION
The mkvm command creates a new partition with the same profile/resources as the partition specified by singlenode. The -i and -n flags specify the numeric partition number and name of the newly created partition, respectively. The second form of this command duplicates all the partitions associated with src_cec to dest_cec. Note that src_dest and dest_cec must be associated with the same HMC. Newly created partitions are automatically added to the xCAT database.
=head1 OPTIONS
B<-h> Display usage message.
B<-c> Copy partitions from src_cec to dest_cec on single HMC
B<-i> New partition numeric id
B<-n> New partition name
B<-v> Command Version.
B<-V> Verbose output.
=head1 RETURN VALUE
0 The command completed successfully.
1 An error has occurred.
=head1 EXAMPLES
1. To create a new partition lpar5 based on the profile/resources of lpar4, enter:
I<mkvm lpar4 -i 5 -n lpar5>
Output is similar to:
lpar5: Success
2. To duplicate all the partitions associated with cec01 on cec02, enter:
I<mkvm cec01 -c cec02>
Output is similar to:
cec01: Success
=head1 FILES
/opt/xcat/bin/mkvm
=head1 NOTES
This command is part of the xCAT software product.