gitea-pages/admin-guide/puppet/profiles/multipath.rst

profile::multipath

This profile configures multipath.conf.

Parameters

Name	Type	Default
wwid	hash	hiera_hash('multipath::wwid',{})
blacklist_wwid	hash	hiera_hash('multipath::blacklist_wwid',{})
devices	array	hiera_hash('multipath::devices',{})
blacklist_devices	array	hiera_hash('multipath::blacklist_devices',{})
blacklist_devnode	array	hiera_hash('multipath::blacklist_devnode',{})

wwid

A hash containing the allowed multipaths by adding the device alias and its corresponding 'wwid'. In example:

Hiera data:

profile::multipath::wwid:
  'vol1_a': '360080e50004315f40000087e5966df82'
  'vol1_b': '360080e5000431680000007c35966e03e'
  'vol1_c': '360080e50004315f4000008825966e1bf'

will generate the following lines in the '/etc/multipath.conf' file:

multipaths {
    multipath {
        alias vol1_a
            wwid  "360080e50004315f40000087e5966df82"
    }
    multipath {
        alias vol1_b
            wwid  "360080e5000431680000007c35966e03e"
    }
    multipath {
        alias vol1_c
            wwid  "360080e50004315f4000008825966e1bf"
    }
}

blacklist_wwid

An hash containing blacklisted multipaths by adding the device alias and its corresponding wwid. In example:

Hiera data:

profile::multipath::blacklist_wwid:
  'vol1_j': '360080e50004315f40000087e59aaaaaa'

will generate the following lines in the '/etc/multipath.conf' file:

blacklist {
    ...
    multipath {
        alias vol1_j
        wwid  "360080e50004315f40000087e59aaaaaa"
    }
    ...
}

devices

An array containing allowed devices in the multipath.conf configuration. In example:

Hiera data:

profile::multipath::devices:
  - vendor: "Supermicro"
    product: "Supermicro"

will generate the following lines in the '/etc/multipath.conf' file:

devices {
    device {
        vendor "Supermicro"
        product "Supermicro"
    }
}

blacklist_devices

An array containing blacklisted devices in the multipath.conf configuration. In example:

Hiera data:

profile::multipath::blacklist_devices:
    - vendor: "HP"
      product: "HP"
    - vendor: "HP"

will generate the following lines in the '/etc/multipath.conf' file:

blacklist {
    ...
    device {
        vendor "HP"
        product "HP"
    }
    device {
        vendor "HP"
    }
    ...
}

blacklist_devnode

An array containing a list of node devices that will be blacklisted in multipath.conf. By default some 'devnodes' are already included and fixed by default in the template file. These ones are the following:

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

In example, hiera data:

profile::multipath::blacklist_devnode:
  - "sda"
  - "sdb"

will generate the following lines in the '/etc/multipath.conf' file:

blacklist {
    ...
    devnode "sda"
    devnode "sdb"
    ...
}