HP Integrity Virtual Machines 4.2: 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] [-r amount]
[ -e percent[:max_percent] | -E cycles[:max_cycles] ]
[-g -group]... [-g [+]group[: {admin | oper}]]...
[-u -user]... [-u [+]user:[ {admin | oper}]]...
[-a rsrc] [-m rsrc] [-d rsrc] [ -i SG | -i SG-pkgname | -i GWLM | -i SG-pkgname
, GWLM | -i NONE ] [{-j 0 | 1 }]
[[-x name=value [:name=value]]]
hpvmmodify -A { -P vm-name | -p vm-number } [-F] [-l vm-label] [-B start-attr]
[ -e percent[:max_percent] | -E cycles[:max_cycles] ] [ [-a rsrc]... [-m rsrc]...
[-d rsrc]... ]
[[-x name=value [:name=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.
When changing from -E cycles to -e percent on a guest that previously had a maximum configured,
if you do not specify a new maximum, then the default maximum value is chosen. This same
action occurs when changing from -e percent to -E cycles.
Virtual machine modification is designed for flexibility and assumes that all existing virtual
machines are not necessarily running at the same time or on the current VM Host. Therefore,
the hpvmmodify command allows virtual machines to be modified in such a way that they
cannot boot on the current system. A guest configuration receives a warning at modification and
an error at start time, for any issues that might 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.
NOTE: Modifications are not allowed during online VM migration.
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 higher than 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.
269