hpvmstatus(1M)

NAME

hpvmstatus — Display status information about one or more virtual machines.

SYNOPSIS

hpvmstatus [ -V -X -M ] [-v]

hpvmstatus -D { -P vm-name -p vm-number } [ -V -X -M ] [-v]

hpvmstatus -e { -P vm-name -p vm-number } [ -V -X -M ] [-v]

hpvmstatus -i { -P vm-name -p vm-number } [ -V -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]

hpvmstatus -m [ -M -X ]

hpvmstatus -S [ -M -X ]

hpvmstatus -s [ -M -X ]

hpvmstatus -C { -P vm-name -p vm-number } [ -V -X -M ] [-v] [-D]

DESCRIPTION

The hpvmstatus command displays information about the operational state and virtual hardware configuration of the virtual machines on the VM Host. 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.
- Invalid: The virtual machine configuration file is corrupted or invalid. The configuration file must be corrected before this virtual machine can be started.
Running condition of the guest. The machine can be in one of the following conditions:
- EFI: — The virtual machines is running normally in Extensible Firmware Interface (EFI).
- OS: — The virtual machine is running normally in the operating system.
- ATTN! — The virtual machine may need attention because it is not responding to interrupts.
Resources attached 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 VM Host, enter the hpvmstatus command without the -P, -p, -e, or -r option.
To display detailed information about a virtual machine, use the -P or -p option (without the -e, -r, or -d 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 VM Host or the specified virtual machine, include the -e option.
To display the virtual machine's resource scheduling 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.

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.

The -V, -M, and -X options are mutually exclusive.

-M

Displays verbose attribute and resource information in machine- readable format.

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.

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).

-e

Displays the event log for the VM Host 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 CPU entitlement information for the virtual machines, including:

#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 may be slightly different than what was specified. For example, the value can be rounded down to the nearest whole percentage of CPU entitlement.
Maximum: The maximum amount of CPU entitlement this virtual machine can use. Note that the displayed value may be slightly different than what was specified. For example, the value may 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 VM Host physical CPUs this virtual machine has used during the last interval period.
Cumulative Usage: The number of VM Host 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 VM Host uses on behalf of the guest.
Cycles achieved (in MHz).
Sampling Interval: The time between samples.

-d

Displays the devices on the specified virtual machine in the same format used on the command line.

-S

Reports the VM Host scheduler mode (CAPPED or NORMAL). If CAPPED, displays information about the controller process.

-s

Displays the current VM Host resources.

-m

Displays information about the multiserver environment, including the Serviceguard identifier, state, IP address, and host name. If the VM Host is not a Serviceguard server, the following message is displayed:

No HPVM multi-server environment configured.

-C

Displays the type of memory each guest and VM Host is using: cell local memory, interleaved memory, or none. If no guest name/number is specified, all are printed.

RETURN VALUES

The hpvmstatus command exits with one of the following values:

0: Successful completion.
1: One or more error conditions occurred.

DIAGNOSTICS

The hpvmstatus command displays error messages on stderr for any of the following conditions:

An invalid option is specified.
An invalid value is specified for an option.
The vm-name or vm-number does not exist, cannot be accessed, is not a virtual machine, or is corrupt.
A value was omitted for an argument that requires one, or a value was supplied for an argument that does not take one.
The hpvmstatus command and the Integrity VM software are not at the same version levels.

EXAMPLES

Summarize information about all the virtual machines on the VM Host:

# hpvmstatus
[Virtual Machines]
Virtual Machine Name VM #  OS Type State     #VCPUs #Devs #Nets Memory  Runsysid
==================== ===== ======= ========= ====== ===== ===== ======= ========
config1                  1 HPUX    Off (NR)       1     5     1  512 MB        0
config2                  2 HPUX    Off            1     7     1    1 GB        0
winguest1                5 WINDOWS On (OS)        1     5     1    1 GB        0
winguest2                9 WINDOWS Off            1     3     1    2 GB        0

Display detailed information about a virtual machine named guest1.

# hpvmstatus -P guest1 -V
[Virtual Machine Details]
Virtual Machine Name    : guest1
Virtual Machine UUID    : bf4c3714-df65-11da-bd4e-00306e4a93e6
Virtual Machine ID      : 5
Virtual Machine Label   :
VM's Model Name         : server Integrity Virtual Machine
VM's Serial Number      : VM00619004
VM's Config Version     : 4.0.0
VM's Config Label       : HPVM B.04.00 13h00m11s EST
Operating system        : HPUX
OS Version Number       :
State                   : On (OS)
Start type              : Manual
Console type            : vt100-plus
Guest's hostname	      : 
Guest's IPv4 address    : 106.16.5.24
Guest's IPv6 address    : fe80::ee8d:40ff:fe58:4d28
EFI Location            : /opt/hpvm/guest-images/common/efi
Pattern File location   : /opt/hpvm/guest-images/common/patterns.vmmpat
...

Display the attributes and resources attached to the virtual machine config2:

# hpvmstatus -P config2

[Virtual Machine Details]
Virtual Machine Name VM #  OS Type State
==================== ===== ======= ========
config2                  2 HPUX    On (OS)

[Authorized Administrators]
Oper Groups:
Admin Groups:
Oper Users:
Admin Users:

[Virtual CPU Details]
#vCPUs Entitlement Maximum
====== =========== =======
     1       10.0%  100.0%

[Memory Details]
Total    Reserved
Memory   Memory
=======  ========
[Dynamic Memory Information]
Minimum     Target      Maximum
Memory      Memory      Memory
=========== =========== ===========
  1024 MB     2039 MB      2048 MB

[Storage Interface Details]
Guest                                 Physical
Device  Adaptor    Bus Dev Ftn Tgt Lun Storage   Device
======= ========== === === === === === ========= =========================
disk    scsi         0   1   0   0   0 disk      /dev/rdisk/disk00

[Network Interface Details]
Interface Adaptor    Name/Num   PortNum Bus Dev Ftn Mac Address
========= ========== ========== ======= === === === =================
vswitch   avio_lan   192net     1         0   1   0 de-ad-be-ef-17-67
vswitch	 lan        15net      1         0   2   0 66-c7-a6-2d-d6-01
vswitch   lan        192net     3         0   3   0 be-ef-de-ad-17-67
vswitch   lan        localnet   1         0   4   0 be-ef-17-67-de-ad
[Misc Interface Details]
Guest                                 Physical
Device  Adaptor    Bus Dev Ftn Tgt Lun Storage   Device
======= ========== === === === === === ========= =========================
serial  com1                           tty       console

Display information about a gWLM managed VM Host:

# hpvmstatus -S
HPVM scheduler is running in CAPPED mode.

 Controller process information:
PID=13456,NAME=gWLM,HOST=acms.work.com,URL=http://acms.work.com:280


NONVM group entitlement information:
                           Percent       Cumulative
#VCPUs Entitlement Maximum   Usage            Usage
====== =========== ======= ======= ================
     0      108MHz 1300MHz    1.9%           469302 

Startable virtual machines:
vm1,vm2,vm3,vm4,vm5,vm6

Display the system resources on the VM Host system:

# hpvmstatus -s
                [HPVM Server System Resources]

        Processor speed = 900 Mhz
        Total physical memory = 6132 Mbytes
        Total number of processors = 2
        Available memory = 2557 Mbytes
        Available swap space = 1541 Mbytes
        Maximum vcpus for an HP-UX virtual machine = 2
        Maximum vcpus for a Windows virtual machine = 2
        Maximum vcpus for a Linux virtual machine = 2
        Available entitlement for a 1 way virtual machine = 900 Mhz
        Available entitlement for a 2 way virtual machine = 810 Mhz

Display the Serviceguard server information on the VM Host system:

# hpvmstatus -m
HPVM Multi-server environment
        Server group name       : HPVM-SG-hpvm_sg_1131
        Server group uuid       : 45e2a680-af14-11dc-9e00-00306e4a831c
        This server's identifier: 2

        Server_id               : 2
        Server_state            : 1
        Server_ipaddr           : 10.0.128.116
        Server_hostname         : troop
        Server_uuid             : 12345678-abcd-1234-abcd-123456789012
        Server_physical_uuid    : 58d03f5d-79ed-11d9-b720-17c097e9e0d0

        Server_id               : 1
        Server_state            : 1
        Server_ipaddr           : 10.0.128.159
        Server_hostname         : company
        Server_uuid             : 23456789-abcd-5678-efgh-123456789012
        Server_physical_uuid    : 560ef4fb-7e16-11d7-86df-c7749ef083ae

Display the devices on the specified virtual machine in the same format used on the command line:

# hpvmstatus -P hpvm0014 -d
 [Virtual Machine Devices]
 
 [Storage Interface Details]
 disk:scsi::0,0,1:lv:/dev/vg01/rlv2
 
 [Network Interface Details]
 network:lan:0,1,0x56A3E9D74099:vswitch:myswitch
 
 [Misc Interface Details]
 serial:com1::tty:console

Displays whether the guests are cell local memory, interleaved memory or none. Note that "none" or "cell" only appear in guests that have not been booted yet. Once booted, they must either choose interleaved memory "ilm", or pick a home cell number. The Other column is the sum of all other cell local memory outside the home cell (ideally 0).

#hpvmstatus -C
# hpvmstatus -c
 [Guest Cell Local Memory Usage]
                             Cell        MB        MB          MB
 Virtual Machine Name VM #  Prefer Interleave  Home Cell Other Cell
 ==================== ===== ====== ========== ========== ==========
 lp0                      8      0       2067          0          0
 lp1                      9   cell          0          0          0
 lp2                     11   none          0          0          0

AUTHORS

The hpvmstatus command was developed by the HP.

hpvmstatus(1M)

Technical documentation

» Table of Contents

» Glossary

» Index

NAME

SYNOPSIS

DESCRIPTION

Options

RETURN VALUES

DIAGNOSTICS

EXAMPLES

AUTHORS

SEE ALSO