Skip to main content

Libvirt Storage Pools

Prerequisites

Access Level:Admin, Super-admin
Permission Requirements
  • . Basic VM Interaction
    • View drives (inconsistent, see notes)
    • View drive keys (necessary to share/attach)
    • View hardware/image setups made available to them
    • View own VM configs and configs shared with them
    • View own VMs and VMs shared with them
    • View storage pools for any Libvirt realm
    • Lookup individual Libvirt storage pools
  • . VM Administration
    • Create Libvirt storage pools
    • Edit Libvirt storage pools
    • Delete Libvirt storage pools
    • View all VM configs in the system
    • Arbitrarily edit any VM config
    • View host machines and hardware information in any Libvirt realm
    • Arbitrarily view logs from any VM

Access Libvirt Storage Pools​

  1. Go to the Management icon in the top left taskbar.
  2. Navigate to the Virtual Machines section.
  3. Click the 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 the 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. In the left panel, view the storage pool name, type, location and realm.

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 the Libvirt Storage Pools in the left panel.
  4. Click the Create new storage pool button in the top right panel.
  5. In the pop-up, enter the storage pool name, realm, type, optional location in VM backend filesystem, and whether or not explicit quotas are required.
  6. Click Create pool.
caution

A storage pool without explicit quotas grants unlimited access to shared storage for its users.

danger

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

Ensure the Libvirt storage pool location is a full path to allow users to write to both the VM host and the backend.

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 the 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 pop-up, edit the storage pool name, type, optional location in VM backend filesystem, and whether or not explicit quotas are required.
  7. Click Update pool.

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 the Libvirt Storage Pools in the left panel.
  4. Select the storage pool to copy ID.
  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 numbers and characters: 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 the 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 pop-up, click Delete.
danger

Deleting a Libvirt storage pool is permanent. All volumes will be lost if 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 the Libvirt Storage Pools in the left panel.
  4. Select the storage pool to edit type.
  5. Click the Edit button in the top right panel.
  6. In the pop-up, edit the storage pool type to Drives, Hardware Setups, Raw Volumes, Images, ISOs, or Miscellaneous.
  7. Click Update pool.
info

The Type in storage pools indicates the purpose the storage pool serves. For example, a storage pool for storing data will be set to Drives, for hardware infrastructure to Hardware Setups, for volume allocation to Volumes, for VM images used by hardware setups to Images, for ISO images to ISOs, and for other purposes to Miscellaneous.