Note: This bug is displayed in read-only format because
the product is no longer active in Red Hat Bugzilla.
RHEL Engineering is moving the tracking of its product development work on RHEL 6 through RHEL 9 to Red Hat Jira (issues.redhat.com). If you're a Red Hat customer, please continue to file support cases via the Red Hat customer portal. If you're not, please head to the "RHEL project" in Red Hat Jira and file new tickets here. Individual Bugzilla bugs in the statuses "NEW", "ASSIGNED", and "POST" are being migrated throughout September 2023. Bugs of Red Hat partners with an assigned Engineering Partner Manager (EPM) are migrated in late September as per pre-agreed dates. Bugs against components "kernel", "kernel-rt", and "kpatch" are only migrated if still in "NEW" or "ASSIGNED". If you cannot log in to RH Jira, please consult article #7032570. That failing, please send an e-mail to the RH Jira admins at rh-issues@redhat.com to troubleshoot your issue as a user management inquiry. The email creates a ServiceNow ticket with Red Hat. Individual Bugzilla bugs that are migrated will be moved to status "CLOSED", resolution "MIGRATED", and set with "MigratedToJIRA" in "Keywords". The link to the successor Jira issue will be found under "Links", have a little "two-footprint" icon next to it, and direct you to the "RHEL project" in Red Hat Jira (issue links are of type "https://issues.redhat.com/browse/RHEL-XXXX", where "X" is a digit). This same link will be available in a blue banner at the top of the page informing you that that bug has been migrated.
Description of problem:
"lvconvert“ man page needs correction in examples provided :
In the "OPTIONS“ section the entry for "-m, --mirrors Mirrors“ says:
The default mirroring segment type is "raid1". If the legacy "mirror"
segment type is desired, the --type argument must be used to
explicitly select the desired type.
The "Examples“ section contains many examples that contradict this,
for example the first two:
1. Converts the linear logical volume "vg00/lvol1" to a two-way mirror
logical volume:
lvconvert -m1 vg00/lvol1
This should probably be:
lvconvert --type mirror -m1 vg00/lvol1
2. Converts the linear logical volume "vg00/lvol1" to a two-way RAID1
logical volume:
lvconvert --type raid1 -m1 vg00/lvol1
This should probably be:
lvconvert -m1 vg00/lvol1
Version-Release number of selected component (if applicable):
Red Hat Enterprise Linux
How reproducible:
Always
Steps to Reproduce:
1. go through man page of lvconvert
Actual results:
Default mirroring segment type is raid but examples provided shows different.
Expected results:
Correct examples as above.
Additional info:
This documentation man page change needs correction in RHEL6 as well.
What is used by default depends on the options given to "configure" before compiling sources. In RHEL6, this is "configure ----with-default-mirror-segtype=mirror --with-default-raid10-segtype=mirror" while in RHEL7 the "raidN" types are used instead.
So any man page should be written in a way that it's clear which type is used at the moment - it should simply reference the global/mirror_segtype_default and global/raid10_segtype_default settings and not name any concrete type unless --type mirror/raidN is specified (there is also global/sparse_segtype_default setting which is similar).
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://rhn.redhat.com/errata/RHBA-2016-1445.html
Description of problem: "lvconvert“ man page needs correction in examples provided : In the "OPTIONS“ section the entry for "-m, --mirrors Mirrors“ says: The default mirroring segment type is "raid1". If the legacy "mirror" segment type is desired, the --type argument must be used to explicitly select the desired type. The "Examples“ section contains many examples that contradict this, for example the first two: 1. Converts the linear logical volume "vg00/lvol1" to a two-way mirror logical volume: lvconvert -m1 vg00/lvol1 This should probably be: lvconvert --type mirror -m1 vg00/lvol1 2. Converts the linear logical volume "vg00/lvol1" to a two-way RAID1 logical volume: lvconvert --type raid1 -m1 vg00/lvol1 This should probably be: lvconvert -m1 vg00/lvol1 Version-Release number of selected component (if applicable): Red Hat Enterprise Linux How reproducible: Always Steps to Reproduce: 1. go through man page of lvconvert Actual results: Default mirroring segment type is raid but examples provided shows different. Expected results: Correct examples as above. Additional info: This documentation man page change needs correction in RHEL6 as well.