Skip to main content
tiCrypt 2.18.1

Libvirt Storage Pools

info

For backend configuration of Libvirt storage pools, see Backend: Libvirt Configuration.

Prerequisites

User Role:

Sub-admin, Admin, Super-admin

Permission Requirements

  • Virtual Machines
    • View the storage pools of any realm
  • VM Administration
    • Create storage pools (to create a pool)
    • Edit any storage pool (to edit or delete a pool)

Access Libvirt Storage Pools​

  1. Go to the Management icon in the top left taskbar.
  2. Navigate to the Virtual Machines section.
  3. Click Libvirt Storage Pools in the left panel.

View Basic Information of a Libvirt Storage Pool​

  1. Go to the Management icon in the top left taskbar.
  2. Navigate to the Virtual Machines section.
  3. Click Libvirt Storage Pools in the left panel.
  4. Select the storage pool to view.
  5. Click the View button in the top right panel.
  6. Review the Libvirt pool panel.

The panel's Basic info card shows the Type, Explicit quotas (Required or Not required), Location, Backend location ("Not set" when empty), Realm and the ID.

Create a New Libvirt Storage Pool​

  1. Go to the Management icon in the top left taskbar.
  2. Navigate to the Virtual Machines section.
  3. Click Libvirt Storage Pools in the left panel.
  4. Click the Create new storage pool button in the top right panel.
  5. In the Create new Libvirt storage pool pop-up, enter the name, realm, type, location in the VM host filesystem, optional location in the backend filesystem, and whether explicit quotas are required.
  6. Click Create pool.
Result:

The message "Created <name>" appears and the pool is added to the table.

The following table describes the fields of the Create new Libvirt storage pool pop-up.

FieldDescription
NameRequired, up to 80 characters, without spaces or any of / \ | " : * ? < > { }. It must differ from the name of every other pool.
RealmRequired. Only Libvirt realms are shown. Set at creation only.
TypeRequired. Drives, Hardware Setups, Raw Volumes, Images, ISOs or Miscellaneous.
Location in VM host filesystemRequired, up to 256 characters. An absolute, slash-separated path whose folder names use only letters, digits, _ and -; dots are not allowed.
Location in Backend filesystem (Optional)Up to 256 characters, with the same rules as the VM host location.
Explicit quotasNo, this pool does not need a quota: without a quota set, the pool has unrestricted access. Yes, a quota must be set: "If no quota is set, the pool defaults to 0, blocking access until a quota is defined."
caution

A storage pool without explicit quotas places no limit on how much shared storage VMs and drives can consume.

warning

Both the VM host and backend host locations must exist and have write permissions for the tiCrypt user. Otherwise, the storage pools will be unusable.

tip

Use a full (absolute) path for the storage pool location so that both the VM host and backend can access it.

Edit an Existing Libvirt Storage Pool​

  1. Go to the Management icon in the top left taskbar.
  2. Navigate to the Virtual Machines section.
  3. Click Libvirt Storage Pools in the left panel.
  4. Select the storage pool to edit.
  5. Click the Edit button in the top right panel.
  6. In the Update <name> pop-up, edit the name, type, locations, and whether explicit quotas are required. The realm cannot be changed.
  7. Click Update pool.
Result:

The message "Updated <name>" appears. If nothing changed, "No changes made" appears instead.

Copy the Libvirt Storage Pool ID​

  1. Go to the Management icon in the top left taskbar.
  2. Navigate to the Virtual Machines section.
  3. Click Libvirt Storage Pools in the left panel.
  4. Select the storage pool whose ID you want to copy.
  5. Under the ID column, click the Copy button.
  6. Paste the storage pool ID where necessary.
note

The storage pool ID is a unique string of letters and numbers, for example: b354082e-4ae2-4d59-9dde-327824b27018.

Delete a Libvirt Storage Pool​

  1. Go to the Management icon in the top left taskbar.
  2. Navigate to the Virtual Machines section.
  3. Click Libvirt Storage Pools in the left panel.
  4. Select the storage pool to delete.
  5. Click the Delete button in the top right panel.
  6. In the Delete <name>? prompt, click Delete <name>.

Delete works on one pool at a time and needs the Edit any storage pool permission.

Deleting a storage pool loses its volumes

The prompt states: "Deleting a Libvirt pool is irreversible. All the volumes in the pool will be lost if they are not backed up."

Select the Pool Type for a Libvirt Storage Pool​

  1. Go to the Management icon in the top left taskbar.
  2. Navigate to the Virtual Machines section.
  3. Click Libvirt Storage Pools in the left panel.
  4. Select the storage pool whose type you want to edit.
  5. Click the Edit button in the top right panel.
  6. In the pop-up, set the storage pool type to Drives, Hardware Setups, Raw Volumes, Images, ISOs, or Miscellaneous.
  7. Click Update pool.
info

The Type field indicates what a storage pool holds: Drives for drives, Hardware Setups for VM hardware setups, Raw Volumes for raw VM image volumes, Images for VM images, ISOs for ISO images, and Miscellaneous for other volumes.