Part 14 – HVMCLI Command Reference

hvmcli is the command-line interface for managing HPE HVM hypervisor hosts. It provides tools for virtual machine management, networking, storage, hardware inspection, cluster operations, logging, monitoring, and maintenance.

These are all commands that will come as references in this job.

root@hvm-n1:# ip -br a
lo               UNKNOWN        127.0.0.1/8 ::1/128
ens18            UP
ens19            DOWN
ens20            UP
ens21            UP
ens22            UP
ens23            UP
ens1             UP             fe80::be24:11ff:fe2e:69a/64
ens2             UP             fe80::be24:11ff:fe95:cc6f/64
hvmbr0           UP             fe80::2870:cfff:fe4e:fbcd/64
hvmbr1           UP             fe80::2087:4fff:fea6:f7aa/64
hvmbr2.1617      UP             172.16.17.71/24 fe80::18d8:3cff:fe11:d1fd/64
hvmbr3.1618      UP             172.16.18.71/24 fe80::9c7b:68ff:fef3:45c4/64
hvmbr5           UP             fe80::54ae:7aff:feb4:d558/64
hvmup1           UP
hvmup5           UP
ens1.1617@ens1   UP
ens2.1618@ens2   UP
hvmbr0.1611@hvmbr0 UP             172.16.11.71/24 fe80::2870:cfff:fe4e:fbcd/64
hvmbr1.1612@hvmbr1 UP             172.16.12.71/24 fe80::2087:4fff:fea6:f7aa/64
vnet0            UNKNOWN        fe80::fc54:ff:fe3a:bc3f/64
root@hvm-n1:~#
root@hvm-n1:#
oot@hvm-n1:~# sudo ovs-vsctl show
b41fc574-b502-4023-8f3c-751c258e0e7c
    ovs_version: "3.7.1"
root@hvm-n1:~#
root@hvm-n1:~# sudo ovs-vsctl show
b41fc574-b502-4023-8f3c-751c258e0e7c
    ovs_version: "3.7.1"
root@hvm-n1:~# sudo netplan get bridges
hvmbr2.1617:
  addresses:
  - "172.16.17.71/24"
  dhcp4: false
  mtu: 1500
  interfaces:
  - ens1.1617
  parameters:
    forward-delay: "0"
    stp: false
hvmbr3.1618:
  addresses:
  - "172.16.18.71/24"
  dhcp4: false
  mtu: 1500
  interfaces:
  - ens2.1618
  parameters:
    forward-delay: "0"
    stp: false
hvmbr1:
  dhcp4: false
  mtu: 1500
  interfaces:
  - hvmup1
  parameters:
    stp: false
hvmbr5:
  dhcp4: false
  mtu: 1500
  interfaces:
  - hvmup5
  parameters:
    stp: false
hvmbr0:
  dhcp4: false
  mtu: 1500
  interfaces:
  - ens18
  parameters:
    stp: false
root@hvm-n1:~#

Basic Syntax

sudo hvmcli <namespace> <command> [options]

Examples:

sudo hvmcli vm list
sudo hvmcli node list
sudo hvmcli cluster status
root@hvm-n1:~# sudo hvmcli vm list
VM Name  Power State  CPU  Memory     Number Disks
-------  -----------  ---  ---------  ------------
vme-mgr  running      4    16384 MiB  1
root@hvm-n1:~# sudo hvmcli node list
Hostname  Vendor  Model                           Serial         CPUs  CPU Model  CPU MHz   Memory(GB)  OS                  Kernel            Uptime                  NTP Servers  DNS Servers  HTTP Proxy
--------  ------  ------------------------------  -------------  ----  ---------  --------  ----------  ------------------  ----------------  ----------------------  -----------  -----------  ----------
hvm-n1    QEMU    Standard PC (Q35 + ICH9, 2009)  Not Specified  8     x86_64     2095 MHz  30.3 GB     Ubuntu 26.04.1 LTS  7.0.0-31-generic  up 4 hours, 40 minutes  172.16.11.1  172.16.11.5  -
root@hvm-n1:~# sudo hvmcli cluster status
Quorum  Nodes  Name             Stack         State
------  -----  ---------------  ------------  ------
yes     4      37n99h70c3r1tf3  corosync/dlm  active

VM Management

List Virtual Machines

sudo hvmcli vm list

Detailed view:

sudo hvmcli vm list --details

Start a VM

sudo hvmcli vm start --name my-vm

Stop a VM

Graceful shutdown:

sudo hvmcli vm stop --name my-vm

Force power off:

sudo hvmcli vm stop --name my-vm --force

Restart a VM

sudo hvmcli vm restart --name my-vm

Reboot Guest OS

sudo hvmcli vm reboot --name my-vm

Node Management

List Nodes

sudo hvmcli node list

Show Configuration

sudo hvmcli node show-config

Configure Node

sudo hvmcli node configure

Backup Configuration

sudo hvmcli node backup

Restore Configuration

sudo hvmcli node restore

Reboot Node

sudo hvmcli node reboot

Shutdown Node

sudo hvmcli node shutdown

View Node Events

sudo hvmcli node events

Cluster Commands

Show Cluster Status

root@hvm-n1:~# sudo hvmcli cluster status
Quorum  Nodes  Name             Stack         State
------  -----  ---------------  ------------  ------
yes     4      37n99h70c3r1tf3  corosync/dlm  active

List Cluster Nodes

root@hvm-n1:~# sudo hvmcli cluster nodes --list
Node      Status  ID  Votes  Local
--------  ------  --  -----  -----
hvm-n1    online  1   1      yes
hvm-n2    online  2   1      no
hvm-n3    online  3   1      no
hvm-n4-4  online  4   1      no
root@hvm-n1:~#

Network Commands

List Networks

root@hvm-n1:~#
root@hvm-n1:~# sudo hvmcli network list
Name     State   Autostart  Persistent  Type      virtSwitch  Interface  Managed
-------  ------  ---------  ----------  --------  ----------  ---------  -------
hvmnet0  active  yes        yes         standard  vs0         -          no
hvmnet5  active  yes        yes         standard  VM-Network  -          no

Storage Commands

List Storage Resources

root@hvm-n1:~# sudo hvmcli storage list
Name                 Type  State   Autostart
-------------------  ----  ------  ---------
local                ext4  active  yes
morpheus-cloud-init  ext4  active  yes
morpheus-images      ext4  active  yes
shared-ds-01         GFS2  active  yes

iSCSI Information

root@hvm-n1:~# sudo hvmcli storage iscsi --list
SID  Target                     Portal             Iface IP      Interface    State
---  -------------------------  -----------------  ------------  -----------  ---------
1    iqn.2026-10.lab.sitea:vme  172.16.17.19:3260  172.16.17.71  hvmbr2.1617  LOGGED_IN
2    iqn.2026-10.lab.sitea:vme  172.16.18.19:3260  172.16.18.71  hvmbr3.1618  LOGGED_IN

Fibre Channel Information

sudo hvmcli storage fc

Multipath Information

root@hvm-n1:~# sudo hvmcli storage multipath status
Device                             Transport  Vendor   Size  Paths  Active  Failed  State
---------------------------------  ---------  -------  ----  -----  ------  ------  ------
3600140530d15e7c1cd54047bce911360  iscsi      LIO-ORG  200G  2      2       0       active
root@hvm-n1:~#

Rescan Storage

root@hvm-n1:~# sudo hvmcli storage rescan
Rescanning iSCSI sessions...
iSCSI rescan complete (2 session(s)).
No Fibre Channel HBAs detected — skipping FC rescan.
Reloading multipath maps...
Multipath maps reloaded.
iSCSI Sessions Rescanned  SCSI Hosts Scanned  Multipath Reloaded  Errors
------------------------  ------------------  ------------------  ------
2                         0                   yes                 none
No new devices discovered.
root@hvm-n1:~#

Hardware Commands

CPU Information

root@hvm-n1:~# sudo hvmcli hardware cpu list
  Architecture           x86_64
  CPU(s)                 8
  Thread(s) per core     1
  Core(s) per socket     8
  Socket(s)              1
  Model Name             Intel(R) Xeon(R) Silver 4110 CPU @ 2.10GHz
  Vendor ID              GenuineIntel
  Virtualization         VT-x
  Logical CPU Threads    8
  Hyperthreading Active  no
  Physical CPU Cores     8

Memory Information

root@hvm-n1:~# sudo hvmcli hardware memory list
  Physical Memory   30.34 GiB
  Reliable Memory   30.34 GiB
  NUMA Node Count   1
  Total Memory      30.34 GiB
  Used Memory       16.88 GiB
  Available Memory  13.46 GiB
  Free Memory       12.93 GiB
  Swap Total        8.00 GiB
  Swap Free         8.00 GiB
  HugePages Total   0
  HugePages Free    0
  HugePage Size     2.00 MiB
root@hvm-n1:~#

PCI Devices

sudo hvmcli hardware pci list

Boot Volume Details

root@hvm-n1:~# sudo hvmcli hardware bootvolume list
  Root Device             /dev/sda2
  Boot Device Identifier  /dev/sda2
  Boot Device Type        part
  Root Filesystem         ext4
  Root Type               part
  Root Size               250G
  Boot Disk               /dev/sda
  Boot Disk Size          250G
  Boot Disk Model         QEMU HARDDISK
  Boot Disk Serial        drive-scsi0
  Boot Disk Transport     -
  Boot Disk Rotational    no
  Boot Disk Read-Only     no
root@hvm-n1:~#

IPMI/BMC Sensors

sudo hvmcli hardware ipmi

Software Commands

List Installed Packages

oot@hvm-n1:~# sudo hvmcli software list
  QEMU        10.2.1
  Libvirt     12.0.0
  Kernel      7.0.0-31-generic
  hvmcli      1.0.0
root@hvm-n1:~#

Update Software

sudo hvmcli software update

Logs

Node Logs

sudo hvmcli logs node

Cluster Logs

sudo hvmcli logs cluster

Morpheus Agent Logs

sudo hvmcli logs morpheus-agent

Health Monitoring

Run Health Check

Running health checks...
Check                      Type      Status  Details
-------------------------  --------  ------  -------------------------------------------------------------------------
Virtualization service     OS        PASS    Virtualization service is healthy.
VM stopped state           OS        PASS    No virtual machines found in stopped state.
NTP configuration          OS        PASS    NTP is configured and synchronized.
NTP time drift             OS        PASS    NTP drift is within threshold (0.044ms).
Host zombie process        OS        PASS    No zombie process detected.
Kernel errors              OS        PASS    No critical kernel errors in recent dmesg.
Key service status         OS        PASS    All key services are running.
Open file descriptors      OS        PASS    Open file descriptor count is within limits.
Kernel modules             OS        PASS    All required kernel modules are loaded.
Morpheus agent             OS        PASS    Morpheus agent is running.
Cluster status             Cluster   PASS    Cluster is healthy.
Cluster quorum             Cluster   PASS    Cluster quorum is present.
Cluster DC                 Cluster   NA      Not applicable: quorum/DLM clusters have no DC.
Cluster nodes online       Cluster   PASS    All cluster nodes are online.
Cluster failed resources   Cluster   PASS    No failed cluster resource actions detected.
Cluster partition state    Cluster   PASS    Cluster partition state is healthy.
Cluster STONITH            Cluster   PASS    Fencing is DLM-managed and healthy.
Corosync link health       Cluster   PASS    Corosync links are healthy.
Host disk space            Storage   PASS    No partition is above 95% utilization.
iSCSI portal reachability  Storage   PASS    All iSCSI target portals are reachable.
iSCSI MTU consistency      Storage   PASS    All iSCSI portals accept full MTU-size frames without fragmentation.
Multipath path state       Storage   PASS    No multipath path is in failed state.
Host gateway reachability  Network   PASS    Default gateway is reachable.
DNS resolution             Network   PASS    DNS nameservers are reachable.
Network interface errors   Network   PASS    No RX/TX errors detected on any interface.
Uplink member link state   Network   PASS    All uplink member interfaces are up.
Uplink member speed        Network   WARN    Unable to validate speed for: hvmup1(ens20, ens21), hvmup5(ens22, ens23).
Swap usage                 Hardware  PASS    No swap is in use.
Host CPU utilization       Hardware  PASS    Host CPU utilization is within threshold (61.4%).
Host memory utilization    Hardware  PASS    Host memory utilization is within threshold (55.8%).
IO wait                    Hardware  PASS    IO wait is within threshold (0.0%).

Summary: PASS=29 WARN=1 FAIL=0 NA=1

Continuous Health Monitoring

sudo hvmcli health watch

Resource Monitoring

Default Top View

sudo hvmcli top
  Services: ● libvirt  ● OVS  ● Multipath  ● HA
  ────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
top - 17:36:10 up  4:46,  1 user,  load average: 2.23, 1.67, 1.61
Tasks: 245 total,   1 running, 244 sleeping,   0 stopped,   0 zombie
%Cpu(s):  1.1 us,  1.1 sy,  0.0 ni, 96.7 id,  0.0 wa,  0.0 hi,  0.0 si,  1.1 st
MiB Mem :  31066.6 total,  13221.0 free,  17300.5 used,  16758.3 buff/cache
MiB Swap:   8192.0 total,   8192.0 free,      0.0 used.  13766.1 avail Mem

CPU Usage

sudo hvmcli top cpu

Memory Usage

sudo hvmcli top memory

Network Usage

sudo hvmcli top network

Disk Usage

sudo hvmcli top disk

Host Overview

sudo hvmcli top host

Virtual Switch Management

List Virtual Switches

root@hvm-n1:~# sudo hvmcli virtswitch list
virtSwitch Name  Base Type  Bridge Mode   Base Interfaces  Uplink Name  Bridge Name  Libvirt Network Name  Uplink Mode    MTU   Traffic Types   VLAN Networks            Management IP  Management Netmask  Management Gateway  Management VLAN
---------------  ---------  ------------  ---------------  -----------  -----------  --------------------  -------------  ----  --------------  -----------------------  -------------  ------------------  ------------------  ---------------
ISCSI-A          iscsi      linux-bridge  ens1             ens1         hvmbr2       hvmnet2               -              1500  iscsi:1617      ens1.1617 (vlan 1617)                       
ISCSI-B          iscsi      linux-bridge  ens2             ens2         hvmbr3       hvmnet3               -              1500  iscsi:1618      ens2.1618 (vlan 1618)                       
migration        general    linux-bridge  ens20, ens21     hvmup1       hvmbr1       hvmnet1               active-backup  1500  live-migration  hvmup1.1612 (vlan 1612)                     
VM-Network       general    linux-bridge  ens22, ens23     hvmup5       hvmbr5       hvmnet5               active-backup  1500  vm              -                                           
vs0              general    linux-bridge  ens18            ens18        hvmbr0       hvmnet0               -              1500  management, vm  ens18.1611 (vlan 1611)   172.16.11.71   255.255.255.0       172.16.11.1         1611
root@hvm-n1:~#

Create Virtual Switch

sudo hvmcli virtswitch create

Display Status

oot@hvm-n1:~# sudo hvmcli virtswitch status
virtSwitch: ISCSI-A [DEGRADED]
  Uplinks:
    ens1: UP
  Segments:
    iscsi:1617 (ens1.1617): UP

virtSwitch: ISCSI-B [DEGRADED]
  Uplinks:
    ens2: UP
  Segments:
    iscsi:1618 (ens2.1618): UP

virtSwitch: migration [DEGRADED]
  Uplinks:
    ens20: UP
    ens21: UP
    Aggregation: active-backup — active
  Segments:
    live-migration (hvmup1.1612): UNKNOWN

virtSwitch: VM-Network [DEGRADED]
  Uplinks:
    ens22: UP
    ens23: UP
    Aggregation: active-backup — active
  Segments:
    vm (hvmup5): UP

virtSwitch: vs0 [DEGRADED]
  Uplinks:
    ens18: UP
  Segments:
    management (ens18.1611): UNKNOWN — gateway 172.16.11.1 (routable)
    vm (ens18): UP
root@hvm-n1:~#

Delete Virtual Switch

sudo hvmcli virtswitch delete

Version Information

sudo hvmcli version

Help Commands

Show namespace help:

sudo hvmcli vm help
sudo hvmcli storage help
sudo hvmcli cluster help
sudo hvmcli hardware help

Useful Examples

# List all VMs
sudo hvmcli vm list

# Start a VM
sudo hvmcli vm start --name web-server

# Stop a VM forcefully
sudo hvmcli vm stop --name web-server --force

# Check cluster health
sudo hvmcli cluster status

# View CPU information
sudo hvmcli hardware cpu list

# Perform host health check
sudo hvmcli health check

# View real-time resource usage
sudo hvmcli top

(Visited 3 times, 1 visits today)

By Ash Thomas

Ash Thomas is a seasoned IT professional with extensive experience as a technical expert, complemented by a keen interest in blockchain technology.