Bug 723727

Summary: correction to storage admin guide
Product: Red Hat Enterprise Linux 6 Reporter: ranjith ruban <rruban>
Component: doc-Storage_Admin_GuideAssignee: Jacquelynn East <jeast>
Status: CLOSED CURRENTRELEASE QA Contact: ecs-bugs
Severity: low Docs Contact:
Priority: medium    
Version: 6.0CC: jskeoch, rlandman, rpiddapa
Target Milestone: rcKeywords: Documentation
Target Release: 6.3   
Hardware: x86_64   
OS: Linux   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2011-12-07 02:23:41 UTC Type: ---
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:

Description ranjith ruban 2011-07-20 22:13:58 UTC
Description of problem:

There is no /var/lib/multipath/bindings file in rhel6 . It have been changed to /etc/multipath/bindings

The below in the doc at page 139

----------
When the user_friendly_names feature (of device-mapper-multipath) is used, the WWID is mapped to a name of the form /dev/mapper/mpathn. By default, this mapping is maintained in the file /var/lib/multipath/bindings. These mpathn names are persistent as long as that file is maintained.
Warning
The multipath bindings file (by default, /var/lib/multipath/bindings) must be available at boot time. If /var is a separate file system from /, then you must change the default location of the file. For more information, refer to http://kbase.redhat.com/faq/docs/DOC-17650. 
----------

should be changed to below 

When the user_friendly_names feature (of device-mapper-multipath) is used, the WWID is mapped to a name of the form /dev/mapper/mpathn. By default, this mapping is maintained in the file /etc/multipath/bindings. These mpathn names are persistent as long as that file is maintained.


Additional info:

http://docs.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/6/html/Storage_Administration_Guide/persistent_naming.html#persistent_naming-wwid

Comment 2 John Skeoch 2011-07-31 23:45:24 UTC
Checked text in:

Red_Hat_Enterprise_Linux-Storage_Administration_Guide-6-web-en-US-0-51.el5

http://documentation-stage.bne.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/6/html/Storage_Administration_Guide/persistent_naming.html#persistent_naming-wwid

---

The text has been changed however the default path appears contradictory in the Warning admonition, should this be changed also?

-

Warning

The multipath bindings file (by default, /var/lib/multipath/bindings) must be available at boot time. If /var is a separate file system from /, then you must change the default location of the file. For more information, refer to http://kbase.redhat.com/faq/docs/DOC-17650.