f484ba625b
git-svn-id: https://svn.code.sf.net/p/xcat/code/xcat-core/trunk@9205 8638fb3e-16cb-4fca-ae20-7b5d299a9bcd
166 lines
4.6 KiB
Plaintext
166 lines
4.6 KiB
Plaintext
=head1 NAME
|
|
|
|
B<chvm> - Changes HMC- and IVM-managed partition profiles. For P7 IH, chvm only could be used to change the I/O slots assignment to LPARs.
|
|
|
|
=head1 SYNOPSIS
|
|
|
|
B<chvm> [B<-h>| B<--help>]
|
|
|
|
B<chvm> [B<-v>| B<--version>]
|
|
|
|
=head2 PPC (with HMC) specific:
|
|
|
|
B<chvm> [B<-V>| B<--verbose>] I<noderange> [B<-p> I<profile>]
|
|
|
|
B<chvm> [B<-V>| B<--verbose>] I<noderange> B<attr>=I<val> [B<attr>=I<val>...]
|
|
|
|
=head2 PPC (using Direct FSP Management) specific:
|
|
|
|
B<chvm> I<noderange> [B<-p> I<profile>]
|
|
|
|
=head2 VMware specific:
|
|
|
|
B<chvm> I<noderange> [B<-a> I<size>] [B<-d> I<disk>] [B<-p> I<disk>] [B<--resize> B<disk>=I<size>] [B<--cpus> I<count>] [B<--mem> I<memory>]
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
=head2 PPC (with HMC) specific:
|
|
|
|
The chvm command modifies the partition profile for the partitions specified in noderange. A partitions current profile can be read using lsvm, modified, and piped into the chvm command, or changed with the -p flag.
|
|
|
|
This command also supports to change specific partition attributes by specifying one or more "attribute equals value" pairs in command line directly, without whole partition profile.
|
|
|
|
=head2 PPC (using Direct FSP Management) specific:
|
|
|
|
chvm is designed to assign the I/O slots to the new LPAR. Both the current IO owning lpar and the new IO owning lpar must be powered off before an IO assignment. Otherwise, if the I/O slot is belonged to an Lpar and the LPAR is power on, the command will return an error when trying to assign that slot to a different lpar.
|
|
|
|
The administrator should use lsvm to get the profile content, and then edit the content, and add the node name with ":" manually before the I/O which will be assigned to the node. And then the profile can be piped into the chvm command, or changed with the -p flag.
|
|
|
|
=head2 VMware specific:
|
|
|
|
The chvm command modifes the vm specified in noderange. Calling with deregister or purge options at the same time as the resize option is not recommended.
|
|
|
|
=head1 OPTIONS
|
|
|
|
=head2 Common:
|
|
|
|
B<-h>
|
|
|
|
Display usage message.
|
|
|
|
B<-v>
|
|
|
|
Command Version.
|
|
|
|
=head2 PPC specific:
|
|
|
|
B<-p> I<profile>
|
|
|
|
Name of an existing partition profile.
|
|
|
|
B<attr>=I<val>
|
|
|
|
Specifies one or more "attribute equals value" pairs, separated by spaces.
|
|
|
|
B<-V>
|
|
|
|
Verbose output.
|
|
|
|
=head2 VMware specific:
|
|
|
|
B<-a> I<size>
|
|
|
|
Add a new Hard disk with size defaulting to GB. Multiple can be added with comma separated values.
|
|
|
|
B<--cpus> I<count>
|
|
|
|
Set the number of CPUs.
|
|
|
|
B<-d> I<disk>
|
|
|
|
Deregister the Hard disk but leave the backing files. Multiple can be done with comma separated values. The disks are specified by SCSI id. Size defaults to GB.
|
|
|
|
B<--mem> I<memory>
|
|
|
|
Set the memory, defaults to MB.
|
|
|
|
B<-p> I<disk>
|
|
|
|
Purge the Hard disk. Deregisters and deletes the files. Multiple can be done with comma separated values. The disks are specified by SCSI id. Size defaults to GB.
|
|
|
|
B<--resize> B<disk>=I<size>
|
|
|
|
Change the size of the Hard disk. The disk can never be set to less than it's current size. Multiple disks can be resized to I<size> by using comma separated values on the left side of B<=>. The disks are specified by SCSI id. Size defaults to GB.
|
|
|
|
=head1 RETURN VALUE
|
|
|
|
0 The command completed successfully.
|
|
|
|
1 An error has occurred.
|
|
|
|
=head1 EXAMPLES
|
|
|
|
=head2 PPC (with HMC) specific:
|
|
|
|
1. To change the partition profile for lpar4 using the configuration data in the file /tmp/lparfile, enter:
|
|
|
|
cat /tmp/lparfile | chvm lpar4
|
|
|
|
Output is similar to:
|
|
|
|
lpar4: Success
|
|
|
|
2. To change the partition profile for lpar4 to the existing profile 'prof1', enter:
|
|
|
|
chvm lpar4 -p prof1
|
|
|
|
Output is similar to:
|
|
|
|
lpar4: Success
|
|
|
|
3. To change partition attributes for lpar4 by specifying attribute value pairs in command line, enter:
|
|
|
|
chvm lpar4 max_mem=4096
|
|
|
|
Output is similar to:
|
|
|
|
lpar4: Success
|
|
|
|
=head2 PPC (using Direct FSP Management) specific:
|
|
|
|
1.To change the I/O slot profile for lpar4 using the configuration data in the file /tmp/lparfile, the I/O slots information is similar to:
|
|
|
|
4: 514/U78A9.001.0123456-P1-C17/0x21010202/2/1
|
|
4: 513/U78A9.001.0123456-P1-C15/0x21010201/2/1
|
|
4: 512/U78A9.001.0123456-P1-C16/0x21010200/2/1
|
|
|
|
then run the command:
|
|
|
|
cat /tmp/lparfile | chvm lpar4
|
|
|
|
2. To change the I/O slot profile for lpar1-lpar8 using the configuration data in the file /tmp/lparfile. Users can use the output of lsvm.and remove the cec information, and modify the lpar id before each I/O, and run the command as following:
|
|
|
|
chvm lpar1-lpar8 -p /tmp/lparfile
|
|
|
|
=head2 VMware specific:
|
|
|
|
chvm vm1 -a 8,16 --mem 512 --cpus 2
|
|
|
|
Output is similar to:
|
|
|
|
vm1: node successfully changed
|
|
|
|
|
|
=head1 FILES
|
|
|
|
/opt/xcat/bin/chvm
|
|
|
|
|
|
=head1 SEE ALSO
|
|
|
|
L<mkvm(1)|mkvm.1>, L<lsvm(1)|lsvm.1>, L<rmvm(1)|rmvm.1>
|
|
|
|
|
|
|
|
|