Installing the StorPool Proxmox integration

Install the StorPool storage plugin file

Perform these steps on all the Proxmox VE hosts which will need to access StorPool-backed volumes and snapshots:

  • Make sure the StorPool client (the storpool_block service) is installed on the Proxmox host.
  • Point Apt at the StorPool Debian package repository for the bullseye-backports suite; put the following lines into the /etc/apt/sources.list.d/storpool-backports.sources file:
    Types: deb deb-src
    URIs: https://repo.storpool.com/public/contrib/debian/
    Suites: bullseye-backports
    Components: main
    Signed-By: /usr/share/keyrings/storpool-keyring.gpg
    
  • Install the pve-storpool package:
    apt install pve-storpool
    

Check the status of the StorPool and Proxmox installation

  • Make sure the StorPool client (the storpool_block service) is operational:
    systemctl status storpool_block.service
    
  • Make sure the StorPool configuration includes the API access variables:
    storpool_confshow -e SP_API_HTTP_HOST SP_API_HTTP_PORT SP_AUTH_TOKEN SP_OURID
    
  • Make sure the StorPool cluster sees this client as operational:
    storpool service list
    storpool client status
    
  • Make sure the Proxmox cluster is operational and has a sensible name configured:
    pvesh get /cluster/status
    pvesh get /cluster/status -output-format json | jq -r '.[] | select(.id == "cluster") | .name'
    

Create a StorPool-backed Proxmox VE storage

Note: this part may be partly automated by a command-line helper tool.

  • Choose a StorPool template to use for the storage entry:
    storpool template list
    
  • Create a storage entry, specifying the StorPool template to use and some additional tags to set on each StorPool volume and snapshot, e.g. specifying a QoS tier:
    pvesm add \
      'storpool' \
      'sp-nvme' \
      -shared true \
      -content 'images,iso' \
      -extra-tags 'tier=high' \
      -template 'nvme'
    
  • Make sure Proxmox VE can query the status of the created storage:
    pvesm status