Skip to content

README.md

Latest commit

 

History

History
137 lines (110 loc) · 4.78 KB

README.md

File metadata and controls

137 lines (110 loc) · 4.78 KB

multipath-conf-generator

** A web-based tool to generate formatted multipath.conf stanzas from multipath -ll output.**
This project helps Linux system administrators working with SAN storage and multipath setups to easily extract and format WWID and alias information.

📦 Features

  • Paste multipath -ll output
  • Auto-extract WWID, alias, and size
  • Format as valid multipath.conf entries
  • Fully client-side — no data leaves your browser

Getting Started

1. Clone the repository

git clone https://github.com/safesploitOrg/multipath-config-generator.git
cd multipath-config-generator
chronme index.html

Example /etc/multipath.conf

This file defines how Linux handles multipath devices. It includes:

  • multipaths: Specific multipath maps (aliases to WWIDs)
  • devices: Rules for matching SAN hardware
  • defaults: System-wide fallback settings

Multipaths

multipaths {

    multipath {
        alias   mpatha
        wwid    360060160e7d0490097a8ea67adc99518
    }
}
Option Purpose
alias Human-readable name assigned to the multipath map
wwid Worldwide identifier of the LUN/device
mode Optional; can control access mode (e.g., 0600)
uid Optional; sets user ID for the device
gid Optional; sets group ID for the device
path_grouping_policy Can override global/default setting
path_selector Can override global/default setting
path_checker Can override global/default setting
prio Can override global/default setting
no_path_retry Can override global/default setting

Devices

devices {
    device {
        vendor "DGC"
        product "VRAID"
        path_grouping_policy "group_by_prio"
        getuid_callout "/lib/udev/scsi_id --whitelisted --device=/dev/%n"
        path_selector "service-time 0"
        path_checker "tur"
        hardware_handler "1 alua"
        prio "alua"
        failback "immediate"
        rr_weight "uniform"
        no_path_retry 60
    }
}
Option Purpose
vendor, product Matches your SAN device
path_grouping_policy Groups paths by ALUA priority
getuid_callout Gets unique WWID per LUN
path_selector Uses service-time for I/O scheduling
path_checker Uses tur (Test Unit Ready) to check path health
hardware_handler Enables ALUA for failover control
prio Uses ALUA priority to rank paths
failback Immediately fail back to preferred path
rr_weight Round robin weight for path usage
no_path_retry Retry for 60 seconds if paths are lost

Defaults

defaults {
    user_friendly_names no
    find_multipaths yes
    polling_interval 10
    selector "service-time 0"
    path_checker tur
    rr_min_io 100
    failback immediate
    no_path_retry 60
    max_fds 8192
    mode 0644
    uid 0
    gid 0
}
Option Purpose
user_friendly_names Use alias or mpathX naming. Set to no to prefer WWIDs or aliases.
find_multipaths If yes, only create device if multiple paths are detected.
polling_interval Time in seconds between path checks.
selector Path selection algorithm. service-time is commonly used.
path_checker Path health checker. tur (Test Unit Ready) is suitable for ALUA.
rr_min_io Number of I/O requests before switching paths in round-robin mode.
failback When a better path returns, fail back to it (immediate, manual).
no_path_retry Retry count or mode (fail, queue, N times) on path failure.
max_fds Max number of file descriptors multipathd can open.
mode Permissions on multipath devices (e.g., 0644).
uid Owner user ID for device files. Usually 0 (root).
gid Owner group ID for device files. Usually 0 (root).