Bug 499682 - DM Multipath Documentation Should Include Recommended Configuration Settings
Summary: DM Multipath Documentation Should Include Recommended Configuration Settings
Keywords:
Status: CLOSED NOTABUG
Alias: None
Product: Red Hat Enterprise Linux 5
Classification: Red Hat
Component: Documentation-cluster
Version: 5.3
Hardware: All
OS: Linux
low
medium
Target Milestone: rc
: ---
Assignee: Steven J. Levine
QA Contact: Content Services Development
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2009-05-07 16:29 UTC by Scott Mayhew
Modified: 2009-08-20 03:28 UTC (History)
3 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2009-08-07 18:38:31 UTC
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)

Description Scott Mayhew 2009-05-07 16:29:47 UTC
User-Agent:       Mozilla/5.0 (X11; U; Linux i686; en-US; rv:1.9.0.8) 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. 

Reproducible: Always

Comment 2 Steven J. Levine 2009-06-25 19:23:23 UTC
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.

Comment 3 Ben Marzinski 2009-06-30 21:01:01 UTC
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.

Comment 4 Steven J. Levine 2009-08-07 18:38:31 UTC
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.


Note You need to log in before you can comment on or make changes to this bug.