148 lines
3.4 KiB
ReStructuredText
148 lines
3.4 KiB
ReStructuredText
``profile::multipath``
|
|
=======================
|
|
|
|
This profile configures :manpage:`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"
|
|
...
|
|
}
|
|
|
|
|