Libvirt Volumes
Prerequisites
User Role:
Sub-admin, Admin, Super-admin
Permission Requirements
- VM Administration
- View raw volumes (VM image files)
- Upload raw volumes (VM image files) (to create a raw volume)
View the Capacity, Allocation, and Realm of Libvirt Volumes
- Go to the Management icon in the top left taskbar.
- Navigate to the Virtual Machines section.
- Click the Libvirt Volumes in the left panel.
- View the realm, pool, volume, VM image, capacity, and allocation in the list.
The following table describes the columns of the Libvirt Volumes table.
| Column | Content |
|---|---|
| Realm | The realm of the storage pool that holds the volume. |
| Pool | The storage pool that holds the volume. |
| Volume | The file name of the volume. |
| VM Image | The VM image registered on the volume, with a link to its panel. Empty when no VM image uses the volume. |
| Capacity | The size of the volume. |
| Allocated | The space the volume uses on disk. |
Rows of volumes that no VM image uses yet are green: these volumes are available to register as a VM image. View appears only for a row linked to a VM image, and opens that VM image's panel.
Create a Raw Volume
A raw volume is a blank disk file in a Libvirt storage pool. Creating one is the first step in building a VM image inside tiCrypt: you then register it as a VM image, attach it to a service VM, and boot the service VM from an ISO to install the operating system. For the full procedure, see Windows Images.
Location: Management > Virtual Machines > Libvirt Volumes
- Click the Create raw volume button in the top right panel.
- In the Create raw image pop-up, select the Realm.
- Enter the Name.
.qcow2is added automatically. - Enter the Size. The unit defaults to GB.
- Click Create.
The message "Created raw image <file>" appears, and the new volume is added to the table as a green row, ready to register as a VM image.
The following table describes the fields of the Create raw image pop-up.
| Field | Description |
|---|---|
| Realm | Required. Only Libvirt realms are shown. |
| Name | Required, up to 120 characters, without any of / \ | " : * ? < > { }. It must differ from the other raw images in the realm. |
| Size | Required. At least 1 byte, and a whole number of bytes. |
Refresh Libvirt Volumes Data
bulk-action
- Go to the Management icon in the top left taskbar.
- Navigate to the Virtual Machines section.
- Click the Libvirt Volumes in the left panel.
- Click the Refresh button in the top right panel.
Export Libvirt Volumes Data in CSV Format
bulk-action
- Go to the Management icon in the top left taskbar.
- Navigate to the Virtual Machines section.
- Click the Libvirt Volumes in the left panel.
- Select the Libvirt volumes to export in CSV format.
- Click the Export CSV button in the top right panel.
- Select Selected items.
- In the local window, click Save.
View Libvirt Volumes Data in JSON Format for Export
bulk-action
- Go to the Management icon in the top left taskbar.
- Navigate to the Virtual Machines section.
- Click the Libvirt Volumes in the left panel.
- Select the Libvirt volumes you want to export in JSON format.
- Click the Export JSON button in the top right panel.
- Select View selected items.
- In the pop-up, click the Expand all fields button in the top left panel.
- View the selected Libvirt volumes by id, realmName, pool, volume, capacity, and allocation.
- Once done, click Copy to copy the JSON data or click Download to download the JSON data.
- In the local window, click Save.
- Once done, click Close.
Export Libvirt Volumes Data in JSON Format
bulk-action
- Go to the Management icon in the top left taskbar.
- Navigate to the Virtual Machines section.
- Click the Libvirt Volumes in the left panel.
- Select the Libvirt volumes you want to export in JSON format.
- Click the Export JSON button in the top right panel.
- Select Export selected items.
- In the local window, click Save.
Click View selected items before exporting to view the Libvirt volumes data as a table in JSON format.