HP Integrity Virtual Machines 4.2: Installation, Configuration, and Administration

hpvmcreate(1M)
NAME
hpvmcreate -- Create a new Integrity VM virtual machine.
SYNOPSIS
hpvmcreate -P vm-name [ -F | -s ] [-l vm-label] [-B start-attr] [-O os-type
[:version]] [-c number-vcpus ] [ -e percent[:max_percent] | -E
cycles[:max_cycles] ] [-r amount] [-g [+] group [: {admin |oper}]] [-u [+] user[:
{admin |oper}]] [-a rsrc]... [[ -i SG | -i SG-pkgname | -i GWLM | -i SG-pkgname,
GWLM | -i NONE ]] [-j { 0 | 1 }] [[-x name=value [:name=value]]]
DESCRIPTION
The hpvmcreate command creates a new virtual machine (a guest) and assigns the specified
attributes and resources to it. This command creates an association between the virtual devices
seen by the guest and the physical devices managed by the VM Host.
Only superusers can execute the hpvmcreate command.
Virtual machine creation is designed for flexibility and assumes that not all created virtual
machines are necessarily running at the same time or on the current VM Host. Therefore, the
hpvmcreate command allows the creation of virtual machines that cannot boot on the current
system. A guest configuration receives a warning at creation 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 creating the guest, use the -s option.
Options
-P vm-name
Specifies the name of the virtual machine. This name must
be unique on the VM Host. This virtual machine name is
used in other Integrity VM commands to specify which
virtual machine the command affects. If you plan to allow
remote access to the virtual machine's console, the virtual
machine name must be a legal UNIX account name.
The name can consist of up to 256 alphanumeric characters
including A-Z, a-z, 0-9, the dash (-), the underscore (_),
and the period (.). The virtual machine name cannot start
with a dash (-). The -P option is required.
-e percent[:max_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.
The percent can be set to an integral value between 0 and
100. If the value specified is less than 5, then the virtual
machine is allocated the minimum percentage of 5%. The
default entitlement is 10%.
The maximum entitlement may not exceed 100 percent,
and may not be less than the minimum. Each group has a
default maximum setting of 100 percent. You can view the
current settings by using the hpvmstatus -r command.
In addition to the guest calculation, Integrity VM reserves
processing power for essential system functions like
logging, networking, and file system daemons.
The -e and -E options are mutually exclusive.
235