How to manage disks in Hyperion via CLI

Written By Christian Castagna (Administrator)

Updated at July 23rd, 2025

→ Applies to: Hyperion 9.x and above

 

Step 1. Connect to Hyperion appliance via SSH as admin

ssh admin@<your_ip_address_or_hostname>

 

Step 2. Become Super User

sudo su

 

List disks on a virtual machine


List the disks for a specific virtual machine (replace <vm_name> with the name of the virtual machine)

virsh domblklist <vm_name>

EXAMPLE OUTPUT

Target     Source
-----------------------------------------------
vda        /var/lib/libvirt/images/myvm.img

 

Attach a disk to a virtual machine

Attach a disk to a specific virtual machine (replace <vm_name>, <source_file>, <target_device> and <bus_type> with the correct information)

virsh attach-disk <vm_name> <source_file> <target_device> --targetbus <bus_type> --persistent
  • <vm_name>: the name of the virtual machine;
  • <source_file>: the full path to the disk image file you want to attach;
  • <target_device>: the Linux device name to assign (e.g., vdb, vdc);
    • the first disk attached to a VM is usually vda (typically the system disk). Use vdb for the second disk, vdc for the third, and so on;
  • <bus_type>: specifies the type of disk bus to use:
    • Use sata if the guest OS tools are not installed;
    • Use scsi if the guest OS tools are installed and the VM has been rebooted;


EXAMPLE

virsh attach-disk VM1 /flash/syn-volumes/d1eff186-bd5c-4dc4-910c-de0013b529d8/Server3_1.img vdb --targetbus scsi --persistent

 

Remove a disk from a virtual machine

Remove a disk from a specific virtual machine ((replace <vm_name> and <target_device> with the correct information)

virsh detach-disk <vm-name> <target-device> --persistent
  • <vm_name>: the name of the virtual machine;
  • <target_device>: the Linux device name assigned (e.g., vdb, vdc);
  • --persistent: ensures the disk remains detached after the VM is restarted.


EXAMPLE

virsh detach-disk VM1 vdb --persistent