Search
The Best Hyperconverged Infrastructure (HCI) for Enterprise ROBO, SMB & Edge
HCI Appliance overview

Updating StarWind x Proxmox SAN Integration Services During a Proxmox VE 8 to 9 Upgrade

  • Guidance
  • March 21, 2026

Introduction

When upgrading from Proxmox VE 8 to Proxmox VE 9, it is essential to ensure that all integration components remain compatible with the new environment. StarWind x Proxmox SAN Integration Services should be updated accordingly to maintain proper functionality and avoid potential issues with storage operations. This article outlines the required steps for updating the integration services during the Proxmox upgrade process.

Prerequisites

This guide is applicable for Proxmox clusters and hosts that have StarWind x Proxmox SAN Integration Services installed: open Storage in the cluster and check in there is a starlvm storage type. 

Before proceeding with the update, it is recommended to make sure that: 

  • Proxmox nodes have access to the Internet to download necessary packets during the upgrade. 
  • Cluster is healthy, e.g. the nodes are green and there are no warning/errors, including with the hardware. 
  • There are no failed services on each Proxmox host. 
  • You have a current backup of your data on VSAN storage and nodes. 
  • Adequate disk space is available on each Proxmox host. 

Upgrade Procedure

The cluster nodes have to be upgraded one by one to maintain storage availability. Please follow the recommended upgrade sequence below: 

  • Stop or migrate virtual machines from the node that is going to be upgraded to Proxmox 9. 
  • Stop the StarWind VSAN CVM running on the node that is going to be upgraded. Reboot the node. 
  • Reboot the Proxmox node after the upgrade is done. 
  • Run the checklist: pve8to9 
  • Ensure that no critical issues are detected. You have to see the warning about StarWind x Proxmox SAN Integration Services (StarLvmPlugin) requiring an update.
  • Update StarWind x Proxmox SAN Integration Services by running the following commands on the Proxmox host: 
curl -fsSL -o install-starwind-proxmox-plugin-pve9.sh http://repo.starwind.com/san-and-nas/scripts/install-starwind-proxmox-plugin-pve9.sh 
bash install-starwind-proxmox-plugin-pve9.sh 

The script downloads the latest version of the StarWind Proxmox plugin and installs StarWind x Proxmox SAN Integration Services version 13, which is compatible with Proxmox VE 9. 

  • Start the StarWind VSAN CVM on the upgraded Proxmox host and wait until synchronization process is completed 
  • Check that all StarWind devices have the Synchronized status on all nodes 
  • Verify that the iSCSI storage is connected from the partner node by executing the following commands: 
pvesm status - checking Proxmox storage state 
iscsiadm -m session - checking active iSCSI sessions   
multipath -ll  - checking multipathing 
  • Start and rebalance the Virtual machines in Proxmox cluster 
  • Repeat the steps above on the remaining StarWind nodes one by one. 

Summary

The upgrade from Proxmox VE 8 to Proxmox VE 9 in a StarWind-integrated environment can be performed safely with minimal downtime (if VMs stopped). Following this procedure ensures a smooth transition to Proxmox VE 9 while maintaining StarWind storage integration. 

Please get in touch with StarWind Support by emailing starwind-support@datacore.com to get help with the StarWind x Proxmox SAN Integration Services update.  

Tags
Hey! Looking for a reliable, high-performance, and cost-effective shared storage solution for your production cluster?
Dmytro Malynka
Dmytro MalynkaStarWind Virtual SAN Product Manager
We’ve got you covered! StarWind Virtual SAN (VSAN) is specifically designed to provide highly-available shared storage for Hyper-V, vSphere, and KVM clusters. With StarWind VSAN, simplicity is key: utilize the local disks of your hypervisor hosts and create shared HA storage for your VMs. Interested in learning more? Book a short StarWind VSAN demo now and see it in action!