xcat-core/xCAT-client/pods/man1/chvm.1.pod

=head1 NAME

B<chvm> - Changes HMC- and IVM-managed partition profiles.

=head1 SYNOPSIS

I<chvm [-h| --help]>

I<chvm [-v| --version]>


I<chvm [-V| --verbose] noderange [-p profile]>


I<chvm [-V| --verbose] noderange attr=val [attr=val...]>


=head1 DESCRIPTION

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.

=head1 OPTIONS


B<-h>          Display usage message.

B<-p profile>  Name of an existing partition profile.

B<attr=val>    Specifies one or more "attribute equals value" pairs, separated by spaces.

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 change the partition profile for lpar4 using the configuration data in the file /tmp/lparfile, enter:

I<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:

I<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:

I<chvm lpar4 max_mem=4096>

Output is similar to:

lpar4: Success

=head1 FILES

/opt/xcat/bin/chvm


=head1 SEE ALSO

L<mkvm(1)|mkvm.1>, L<lsvm(1)|lsvm.1>, L<rmvm(1)|rmvm.1>