HP Integrity Virtual Machines Installation, Configuration, and Administration

hpvmmodify(1M)
NAME
hpvmmodify -- Rename a virtual machine or modify the attributes of a virtual machine.
SYNOPSIS
hpvmmodify { -P vm-name | -p vm-number } [ -F | -s ] [-N new-vm-name] [-l vm-label]
[-B start-attr] [-O os-type:version] [-c number-vcpus] [ -e percent | -E cycles
] [-r amount] [-g -group] [-g [+]group[: { admin | oper }]] [-u -user] [-u [+]user[:
{ admin | oper }]] [-a rsrc] [-m rsrc] [-d rsrc] [-i { SG | SG-pkgname | GWLM |
NONE }] [-j { 0 | 1 }] [-R amount] [-x keyword=value]
hpvmmodify -A { -P vm-name | -p vm-number } [-F] [-l vm-label] [-B start-attr] [
-e percent | -E cycles [-a rsrc] [-m rsrc] [-d rsrc] ] [-x keyword=value]
DESCRIPTION
The hpvmmodify command modifies the attributes and resources of the specified virtual machine.
All attributes and resources can be changed statically, so that changes take effect when the virtual
machine is next restarted.
Some attributes and resources can also be changed dynamically. Dynamic changes take effect
immediately and remain in effect when the virtual machine is next started, unless you explicitly
specify otherwise with the -A option.
Only specified attributes or resources are changed. All others retain their original values.
Virtual machine modification is designed for flexibility, and assumes that all existing virtual
machines will not necessarily be running at the same time or on the current VM Host. Therefore,
the hpvmmodify command will allow virtual machines to be modified in such a way that they
cannot boot on the current system. A guest configuration will receive a warning at modification,
and an error at start time, for any issues that would prevent it from starting on the current VM
Host. To verify a particular configuration for the current VM Host without actually modifying
the guest, use the -s option.
Only a superuser can execute the hpvmmodify command.
Options
The hpvmmodify command recognizes the following command-line options and arguments.
-P vm-name
Specifies the name of the virtual machine to be modified.
You must specify either the -P or the -p option.
-p vm-number
Specifies the number of the virtual machine to be modified. The vm-number is displayed by
the hpvmstatus command.
You must specify either the -P or the -p option.
-A
Specifies that the addition, modification, or deletion of resources is done to an active virtual
machine's configuration file. These modifications will be effective until the virtual machine
is rebooted. Not all modifications can be done to an active virtual machine; in this case, an
error message indicates the changes that require the virtual machine to be rebooted.
-e percent
Specifies the percentage of CPU resources to which each of the guest's virtual CPUs is entitled.
During peak system CPU load, the entitlement is the guaranteed minimum allocation of CPU
resources for this virtual machine.
199