SANsymphony Storage Plugin (v1.1.0) for Proxmox

Explore this Page

Overview

The SANsymphony Storage Plugin for Proxmox enables Proxmox Virtual Environment (VE) to use shared iSCSI and NVMe/TCP storage managed by DataCore SANsymphony .

For additional background and advanced storage configuration, refer to the official DataCore SANsymphony Help documentation.

The SANsymphony Storage Plugin for Proxmox provides the following capabilities for managing shared storage in Proxmox environments:

  • Integrated Storage Management Interfaces: Enables storage provisioning and management through the Proxmox VE web interface (UI), the Proxmox VE command-line interface (CLI), and the interactive ssy-plugin wrapper tool.
  • Automated Storage Configuration: Automatically configures udev rules, iSCSI and NVMe/TCP settings, SCSI disk timeouts, and multipath settings to ensure reliable and optimized storage connectivity.
  • Multipath Support: Supports multiple iSCSI and NVMe/TCP sessions simultaneously, providing path redundancy and improved availability.
  • Seamless Shared Storage Provisioning: Enables consistent provisioning and access to shared SANsymphony virtual disks across all nodes in a Proxmox cluster.
  • Thin Provisioned Disk: Achieve thin provisioning on top of standard Proxmox LVM storage by using SANsymphony virtual disks as the underlying storage for your LVM volumes.
  • Dynamic Raw Device Mapping (RDM): Supports dynamic provisioning and management of SANsymphony virtual disks using Raw Device Mapping.
  • Logical Volume Manager (LVM): Provides full support for LVM volumes layered on top of SANsymphony virtual disks.
  • High Availability and Live Migration Support: Leverages shared storage to fully support Proxmox HA environments, including:
    • Live migration of running virtual machines with zero downtime.
    • Automatic HA failover, allowing VMs to restart on healthy nodes.
    • Consistent data access across nodes using shared LVM.

This guide provides step-by-step instructions to help you install, configure, and use the SANsymphony Storage Plugin for Proxmox in Proxmox VE.

The SANsymphony Storage Plugin for Proxmox 1.1.0 has been validated and tested with Proxmox VE versions 8.x and 9.2. If you upgrade or install Proxmox VE to a version higher than 9.2, you may see the following warning message: "PVE::Storage::Custom::SANsymphonyPlugin is implementing an older storage API; an upgrade is recommended". This warning is informational and does not typically impact the functionality of the plugin.

Prerequisites

Before using the plugin, ensure the following:

  • Ensure that a virtual disk template is available or create one for use with the plugin.
  • If you are installing the plugin using the .deb package, install the required packages listed below.
  • Required Packages
    • Run the following commands:
      Copy
      Commands 
      apt update 
      apt install jq
  • For iSCSI Connectivity
    • If you are using iSCSI, install the following packages:
      Copy
      Commands 
      apt install open-iscsi 
      apt install multipath-tools
  • For NVMe/TCP Connectivity
    • If you are using NVMe/TCP, install the following package and load the NVMe/TCP kernel module:
      Copy
      Commands 
      apt install nvme-cli 
      modprobe nvme-tcp

Learn More