NAME
hpvmstatus – Displays status information about one or more virtual machines.
SYNOPSIS
hpvmstatus [-V|-X|-M] [-v]
hpvmstatus {-P vm-name|-p vm-number} [-D | -L] [-V|-X|-M] [-v]
hpvmstatus -e {-P vm-name|-p vm-number} [-V|-X|-M] [-v]
hpvmstatus -i {-P vm-name|-p vm-number} [-X|-M] [-v]
hpvmstatus -r {-P vm-name|-p vm-number} [-V|-X|-M] [-v]
hpvmstatus -d {-P vm-name|-p vm-number} [-V|-X|-M] [-v] [-D]
hpvmstatus -m [-M|-X]
hpvmstatus -S [-M|-X]
hpvmstatus -s [-M|-X]
hpvmstatus -n [-V|-M]
hpvmstatus -R {-P vm-name|-p vm-number} [-M|-X]
hpvmstatus -C {-P vm-name|-p vm-number} [-V|-X|-M] [-v] [-D]
hpvmstatus -A {-P vm-name|-p vm-number}
DESCRIPTION
The hpvmstatus command displays information about the operational state and virtual hardware configuration of the virtual machines on the VSP.
Information displayed by the hpvmstatus command includes the following:
+ Version of the command (if you specify the -v option).
+ Name of the virtual machine (limited to 20 characters in
summary format).
+ State of the virtual machine. The machine will be in one of
the following states:
+ On: The virtual machine is "powered on." It may be at its
console prompt, or it may have booted its operating system
and be fully functional. This is the normal state of a
running virtual machine.
+ Off: The virtual machine is fully halted.
+ On (RMT): The virtual machine is a Serviceguard-packaged VM
that is running on another member of the cluster. Use the
hpvmstatus -m to get a list of systems in the multi-server
environment, MSE.
+ Off (NR): This designates that the guest is not running and
has been set to prevent starting using the not-runnable,
(NR), attribute.
+ Invalid: The virtual machine configuration file is
corrupted or invalid. The configuration file must be
corrected before this virtual machine can be started.
+ Off (NA): This designates that the guest is defined, but
its configuration is not active (the vPar or VM does not
consume resources and cannot be booted).
+ Running condition of the guest. The machine can be in one of
the following conditions:
+ On (EFI): The virtual machines is running normally in
Extensible Firmware Interface (EFI).
+ On (OS): The virtual machine is powered on and is running
normally in the operating system.
+ On (ATTN): The virtual machine may need attention because
it is not responding to interrupts.
+ On (MGT): This designates that the guest is the target of a
migration between two Integrity VM servers.
+ On (MGS): This designates that the guest is the source of a
migration between two Integrity VM servers.
+ Resources allocated to this virtual machine.
+ Attributes assigned to this virtual machine.
+ Dynamic memory information, if dynamic memory is enabled for
this virtual machine.
The hpvmstatus command displays the active configuration for guests
that are on, including the resource assignments that are currently in
effect. For guests with a status of off, the command displays the
configuration to be used when the guest in next booted.
The hpvmstatus command displays variety of information:
+ To list all the virtual machines that are on the VSP, enter
the hpvmstatus command without any options.
+ To display detailed information about a virtual machine, use
the -P or -p option to specify the virtual machine.
+ To display devices in the same format used on the command
line, use the -d option.
+ To display a virtual machine's log file, for either the VSP or
the specified virtual machine, include the -e option.
+ To display the virtual machine's memory and CPU resource
allocation and entitlement information, use the -r option.
+ To display the mode the scheduler is in, use the -S option.
To obtain a display in machine-readable format, use the -M or -X
option.
Only superusers can execute the hpvmstatus command.
hmvmstatus command output
The default, no options, hpvmstatus command output appears as follows:
# hpvmstatus
[Virtual Machines]
Virtual Machine Name VM # Type OS Type State #VCPUs #Devs #Nets Memory
==================== ===== ==== ======= ========= ====== ===== ===== =======
ux1 1 SH HPUX On (OS) 4 2 1 3 GB
vPar0002 2 VP HPUX Off 3 0 0 2048 MB
guest1 3 SH UNKNOWN Off 1 0 0 2 GB
Options
The following options can be specified only once.
The hpvmstatus command recognizes the following options and arguments:
-v Displays the version number of the hpvmstatus command.
The version number is displayed first, followed by
information specified by other options.
-V Displays detailed information (verbose mode) about the
virtual machines, including the status of migrating
virtual machines. For migrating virtual machines, the
verbose status displays in which stage the migration is
and percent completed for that stage. The verbose
status also displays the source and target VSP aliases
and IP addresses.
The -V, -M, and -X options are mutually exclusive.
-M Displays verbose attribute and resource information in
machine- readable format, including information on
migrating virtual machines.
Individual fields are separated by one of three
delimiters:
+ The colon (:) separates each field and resource
type.
+ The semicolon (;) separates subfields of a resource
type.
+ The comma (,) separates individual items in a list
of similar items.
The -V, -M, and -X options are mutually exclusive.
-X Displays verbose information about attribute and
resource in XML format, including information on
migrating virtual machines.
The -V, -M, and -X options are mutually exclusive.
-P vm-name
Specifies the name of the virtual machine for which
information is to be displayed.
The -P and -p options are mutually exclusive.
-p vm-number
Specifies the number of the virtual machine for which
information is to be displayed. The vm_number is
assigned when a virtual machine is created and is
displayed by the hpvmstatus command.
The -P and -p options are mutually exclusive.
-D Displays resource assignments that takes effect the
next time the virtual machine is started (deferred
mode).
-L Displays the changes from the current configuration.
-e Displays the event log for the VSP or the specified
virtual machine. The event log records all changes to
virtual machine configurations.
-i This option, when used with the -P option, prints
statistics collected by the monitor. Currently, these
include vCPU percentage and durations over the lifetime
of the guest.
-r Displays the resource entitlement information for the
virtual machine or machines. There are two sections,
one for virtual CPU entitlement information and one for
virtual machine memory entitlement. The virtual CPU
section includes the following information:
+ #vCPUs: The number of virtual CPUs in this virtual
machine.
+ Entitlement: The amount of CPU entitlement this
virtual machine can use per virtual CPU. Note that
the displayed value might be slightly different than
what was specified. For example, the value can be
rounded down to the nearest whole percentage of CPU
entitlement. Note also that a vPar is always
assigned 100% entitlement.
+ Maximum: The maximum amount of CPU entitlement this
virtual machine can use. Note that the displayed
value might be slightly different than what was
specified. For example, the value might be rounded
up to the nearest whole percentage of CPU
entitlement. If no maximum is set, the default is
100% or all the CPU cycles. For example, a 1500Mhz
CPU displays 1500Mhz.
+ Percent Usage: The percentage of the VSP physical
CPUs this virtual machine has used during the last
interval period.
+ Cumulative Usage: The number of VSP CPU ticks this
virtual machine has consumed since the virtual
machine was booted.
When you specify a virtual machine, the hpvmstatus
command displays the following information for each
virtual CPU:
+ Cumulative Usage: The number of ticks this virtual
CPU has consumed since the virtual machine was
booted.
+ Guest percent: The CPU percentage that the guest has
consumed.
+ Host percent: The CPU percentage that the VSP uses
on behalf of the guest.
+ Cycles achieved (in MHz).
+ Sampling Interval: The time between samples.
The virtual machine memory section includes the
following information:
+ DynMem Min: The minimum memory that can be
dynamically allocated to this virtual machine with
the dynamic memory allocation capability or
automatic memory reallocation (AMR).
+ Memory Entitle: The value of the desired memory
allocation for the virtual machine. It may be set
manually or automatically (by AMR). : The amount of
memory entitlement this virtual machine is
guaranteed to have allocated to it, provided it has
memory demand. This value is meaningful only if AMR
is enabled for the virtual machine. Otherwise, the
value is ignored.
+ DynMem Max: The maximum memory that can be
dynamically allocated to this virtual machine with
the dynamic memory allocation capability or AMR.
+ DynMem Target: The value of the desired memory
allocation for the virtual machine. It may be set
manually or automatically (by AMR).
+ DynMem Current: The actual, current memory allocated
to the virtual machine.
+ Comfort Min: The memory allocation required to
relieve memory "pressure" in the virtual machine.
+ Total Memory: The absolute maximum amount of memory
this virtual machine may be allocated.
+ Free Memory: Amount of free memory in the virtual
machine (according to the operating system running
there).
+ Available Memory: Amount of memory allocated to the
virtual machine's user processes but not locked.
This memory is available for paging by the virtual
machine's operating system.
+ Memory Pressure: A value between 0 and 100 used as
an indicator of memory deficit and paging. The
higher the number the longer the system has been in
a memory deficit.
+ AMR Chunk: The granularity of memory allocation used
by AMR to increase or decrease that allocated to a
virtual machine.
+ AMR State: Indicator of the AMR state of a given VM.
The following indicators are displayed:
+ If the amr_enable attribute is not set, DISABLED
is displayed.
+ If the VM is not running on the VSP, but the
amr_enable attribute is set, ENABLED is
displayed.
+ If the VM is running and the amr_enable attribute
is set, then one of two states is displayed:
ACTIVE if the VM's memory entitlement is set or
PENDING if the VM's memory entitlement is not
set.
Note: AMR is not operational for a VM until both
its amr_enable and ram_dyn_entltlement
attributes are set.
-d Displays the devices on the specified virtual machine
in the same format used on the command line.
-S Reports the VSP scheduler mode (CAPPED or NORMAL). If
CAPPED, displays information about the controller
process.
-s Displays the current VSP resources.
-n Displays NPIV limits and label information for all NPIV
capable VSP resources.
-R Displays the current vPar and VM resource reservations.
-m Displays information about the multiserver environment,
including the Serviceguard identifier, state, IP
address, and host name. If the VSP is not a
Serviceguard server, the following message is
displayed:
No HPVM multi-server environment configured.
-C Displays the current LDOM (logical domain) assignment
of CPUs and memory. CPU and memory assignments are
always assigned using LORA, thus cell preferences are
no longer displayed.
-A Displays the guest configuration differences between
the next start and the last start guest configurations.
If there are no differences, the following messages is
printed and the next start configuration replaces the
current configuration:
No differences were found. Copy has been removed.
If only the last configuration is present, the
following message is returned:
No next start configuration found.
Last Updated: Aug 16, 2020