HP Integrity Virtual Machines Installation, Configuration, and Administration Version A.03.50

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.
When a new device is added to a guest without specifying the bus/target/lun in the resource
parameter, a default order of bus/target/lun allocation is followed. This ordering fills 0-14 targets
on the lowest numbered bus before proceeding to the next higher-numbered bus. This default
ordering is the same for both AVIO and VIO guest adapters.
NOTE: Targets above 14 are supported only on AVIO adapters.
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
217