``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"
      ...
  }


