Red Hat Bugzilla – Bug 499682
DM Multipath Documentation Should Include Recommended Configuration Settings
Last modified: 2009-08-19 23:28:07 EDT
User-Agent: Mozilla/5.0 (X11; U; Linux i686; en-US; rv:22.214.171.124) Gecko/2009032713 Fedora/3.0.8-1.fc10 Firefox/3.0.8
The DM Multipath Documentation [Book identifier: DM_Multipath(EN)-5 (2009-01-06T15:35)] should include recommended configuration settings. Currently, we ship a file called multipath.conf.defaults in the documentation that comes with the device-mapper-multipath package. That file lists default settings for various vendors' SAN hardware, with no explanation of where those settings originated. The DM_Multipath book should include these settings, along with an explanation of where these settings came from (directly from the vendor?). Furthermore, if the recommended settings are different for clustered versus non-clustered environments, then the documentation should explicitly state what those differences are.
Adding Ben Marzinski to the CC list for this bug, since I rely on him for pretty much all the multipath information. I have sent Ben a note (6/25/09) asking him to look at this bug and asking him to help me figure out how to respond.
The defaults come from vendors. They are the same for clustered and non-clustered environments, and they aren't just recommendations. They are the compiled in default configuration. That means that unless users want to change them, they don't have to do anything. Multipath will automatically use these configuration values. Also, as new features are added multipath, and new hardware devices are released, these configurations change. Unless we want to update them in the DM_Multipath book every release, it makes more sense to point users to that file, which will have the latest configuration.
As per Ben's commnt in #3, above, I'm closing this bug. I debated whether to categorize this as NOTABUG or WONTFIX, but I went with NOTABUG for now.