Bug 1585824

Summary:	Add --allow description to mpathconf man page
Product:	Red Hat Enterprise Linux 7	Reporter:	John Pittman <jpittman>
Component:	device-mapper-multipath	Assignee:	LVM and device-mapper development team <lvm-team>
Status:	CLOSED ERRATA	QA Contact:	Lin Li <lilin>
Severity:	low	Docs Contact:
Priority:	low
Version:	7.5	CC:	agk, bmarzins, heinzm, lilin, msnitzer, prajnoha, rhandlin
Target Milestone:	rc
Target Release:	---
Hardware:	All
OS:	Linux
Whiteboard:
Fixed In Version:	device-mapper-multipath-0.4.9-114.el7	Doc Type:	No Doc Update
Doc Text:	undefined	Story Points:	---
Clone Of:		Environment:
Last Closed:	2018-10-30 11:27:28 UTC	Type:	Bug
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:

Description John Pittman 2018-06-04 20:30:24 UTC

Description of problem:

The --allow option is present in the 'mpathconf --help' menu, but there is no description in the man page.

Version-Release number of selected component (if applicable):

device-mapper-multipath-0.4.9-119.el7.x86_64

Steps to Reproduce:

Run 'man mpathconf' and check for --allow option

Actual results:

No explanation

Expected results:

Explanation of option in the man page, including the expected way to specify more than one wwid to allow (this is what I was looking for in the man page).

Comment 2 Ben Marzinski 2018-06-22 16:21:15 UTC

The man page has been updated to describe --allow as well as --outfile

Comment 4 Lin Li 2018-07-26 17:04:08 UTC

Verified on device-mapper-multipath-0.4.9-121.el7
[root@storageqe-06 ~]# rpm -qa | grep multipath
device-mapper-multipath-libs-0.4.9-121.el7.x86_64
device-mapper-multipath-0.4.9-121.el7.x86_64

Run 'man mpathconf' and check for --allow option
       --allow <device>
              Modifies  the  /etc/multipath/conf  blacklist  to
              blacklist  all wwids and the blacklist_exceptions
              to whitelist <device>. <device>  can  be  in  the
              form  of  MAJOR:MINOR,  a  wwid, or the name of a
              device-mapper device, either a multipath  device,
              or  any  device  on stacked on top of one or more
              multipath devices. This command can be used  mul‐
              tiple  times  to  allow  multiple devices.  NOTE:
              This action will create a configuration file that
              mpathconf  will not be able to revert back to its
              previous state. Because  of  this,  --outfile  is
              required when using --allow.
       --outfile <filename>
              Write the resulting multipath configuration to <filename>
              instead of /etc/multipath.conf.


Test result: The man page has been updated to describe --allow as well as --outfile

Comment 6 errata-xmlrpc 2018-10-30 11:27:28 UTC

Since the problem described in this bug report should be
resolved in a recent advisory, it has been closed with a
resolution of ERRATA.

For information on the advisory, and where to find the updated
files, follow the link below.

If the solution does not work for you, open a new bug report.

https://access.redhat.com/errata/RHBA-2018:3236