v3.2.0 — Multipath

truenas-proxmox v3.2.0 — Multipath

Introduces the truenas-proxmox-multipath optional add-on package: active-active iSCSI multipath via dm-multipath. The base truenas-proxmox package is unchanged — multipath is opt-in via a separate plugin (TrueNASMultipath.pm) in the multipath apt component.

Requires PVE 9.x. PVE 8 support was dropped in v3.1.0.

---

What's new

Issue	Change
#256	Multipath plugin — truenas-proxmox-multipath package, truenas-multipath storage type
#278	Multipath UI panel — truenas-multipath appears in Datacenter → Storage → Add
#279	postinst fix — strips pre-existing unmanaged devices {} block before injecting managed stanza (prevents multipathd duplicate-keyword warning)

---

Compatibility

Component	Supported versions
Proxmox VE	9.x (tested: 9.2.3)
TrueNAS CORE	13.x (tested: 13.0-U6) — FreeBSD, ALUA
TrueNAS SCALE	24.10 Electric Eel, 25.04 (tested)

Path mode: Active-active (multibus + service-time 0) — both iSCSI paths carry I/O simultaneously. Failover and path recovery tested on CORE and SCALE 25.04.

---

TrueNAS CORE vs SCALE multipath differences

	TrueNAS CORE (FreeBSD)	TrueNAS SCALE (Linux)
iSCSI target	ctld	Linux LIO
ALUA	Yes (hwhandler='1 alua', prio=50)	No (hwhandler='0', prio=1)
Portal config	0.0.0.0 (all interfaces)	Per-IP listen addresses required
Failover time	~2s	<0.1s

SCALE 25.04 note: PUT /api/v2.0/iscsi/portal/id/<n> rejects the port field. Omit it when adding listen addresses: {"listen": [{"ip": "..."}, {"ip": "..."}]}. See #280.

---

Installation

Add the multipath component to your existing apt sources line:

deb [signed-by=/etc/apt/keyrings/truenas-proxmox.gpg] https://thegrandwazoo.github.io/freenas-proxmox v3 main multipath

Then install:

apt update && apt install truenas-proxmox-multipath

Add a storage in PVE (Datacenter → Storage → Add → TrueNAS Multipath) with truenas_portals set to both iSCSI portal IPs, e.g. 192.168.1.10,10.10.10.10.

Full setup guide: see README.