Multipath

Description

This cookbook provides provides the ability to configure Device Mapper Multipath MPIO for Fibre-Channel and iSCSI storage attached systems.

A generic template, as well as three vendor-specific templates are included within this cookbook. Included vendor-specific templates are for Equallogic iSCSI, EMC Clariion, and Dell Powervault MDxxxx storage arrays.

Requirements

Recommended Cookbooks

iscsi
dbench

Attributes

multipath.conf template

multipath (namespace)
- ["blacklist_regex"]: An array of regular expressions to blacklist. Default '^sd[a]$'
- ["blacklist_wwid"]: An array of World-Wide Identifiers (WWID) to blacklist. Default empty.
- ["aliases"]: A colon separated mapping of WWID to assign a friendly name. Default empty.
- ["storage_type"]: Select a vendor-specific multipath template (equallogic, powervault, clariion, default)

Usage

Set node specific overrides, and add recipe["multipath"] to the run_list

Example multipath node configuration for an EMC Clariion array. The keys, u01 through u03 are "friendly" name aliases for the storage paths.

"normal": {
  "multipath": {
      "storage_type": "clariion",
      "blacklist_regex": [ "^sd[ab]$" ],
      "blacklist_wwid": [
        "3600508e000000000a02ffd9698283e07",
        "3600508e000000000bb2f2d55b328ee05",
        "350060160b9a03c9450060160b9a03c94"
      ],
      "aliases": [
        "u01:36006016005041f00d8f65c69ec56df11",
        "u02:36006016005041f00d9f65c69ec56df11",
        "u03:36006016005041f00daf65c69ec56df11"
      ]
  }
}

multipath::undo recipe

A run-once recipe to undo the default recipe. Inspired by the annoyances cookbook.

License and Author

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

neubauerf/cookbook-multipath