iSCSI Multipath

This page was deprecated on 18 August 2025. Refer to the SANsymphony WebHelp for the latest and updated documentation.

Installing Multipath Tools

The default installation does not include the 'multipath-tools' package. Use the following commands to install the package:

apt-get update

apt-get install multipath-tools

For more information, see iSCSI Multipath.

Creating a Multipath.conf File

After installing the package, create the following multipath configuration file: /etc/multipath.conf.

Refer to the DataCore Linux Host Configuration Guide for the relevant settings and the adjustments for the PVE in the Wiki iSCSI Multipath.

Copy

    defaults {
        user_friendly_names     yes
        polling_interval           60
        find_multipaths          "smart"
        }

    blacklist {
        devnode "^(ram|raw|loop|fd|md|dm-|sr|scd|st)[0-9]*"
               devnode "^hd[a-z]"
        }

    devices {
            device {
                    vendor                  "DataCore"
                    product                 "Virtual Disk"
                    path_checker         tur
                    prio                         alua
                    failback                   10
                    no_path_retry         fail
                    dev_loss_tmo         60
                    fast_io_fail_tmo      5
                    rr_min_io_rq            100
                    path_grouping_policy    group_by_prio
               }
    }

Restarting the Service

Restart the multipath service using the following command to reload the configuration:

systemctl restart multipath-tools

For more information, see the Wiki ISCSI Multipath.