Bug 499682

Summary: DM Multipath Documentation Should Include Recommended Configuration Settings
Product: Red Hat Enterprise Linux 5 Reporter: Scott Mayhew <smayhew>
Component: Documentation-clusterAssignee: Steven J. Levine <slevine>
Status: CLOSED NOTABUG QA Contact: Content Services Development <ecs-dev-list>
Severity: medium Docs Contact:
Priority: low    
Version: 5.3CC: bmarzins, cluster-maint, pkennedy
Target Milestone: rcKeywords: Documentation
Target Release: ---   
Hardware: All   
OS: Linux   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2009-08-07 18:38:31 UTC Type: ---
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:

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.