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



  • 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.
    
    SEE ALSO
    On the VM Host:
    
    hpvm(5), hpvmclone(1M), hpvmcollect(1M), hpvmconsole(1M), hpvmcreate(1M), 
    hpvmdevmgmt(1M), hpvmdevtranslate(1M), hpvmhostrdev(1M), hpvminfo(1M), 
    hpvmmigrate(1M), hpvmmodify(1M), hpvmnet(1M), hpvmpubapi(3), hpvmremove(1M), 
    hpvmresources(5), hpvmsar(1M), hpvmstart(1M), hpvmstop(1M), hpvmupgrade(1M), 
    p2vassist(1M)
    
    On the Integrity VM guest:
    
    hpvmcollect(1M), hpvminfo(1M), hpvmmgmt(1M), hpvmpubapi(3)
    

Log in to reply
 

© Lightnetics 2024