Bug 656167

Summary: dm-replicator documentation
Product: Red Hat Enterprise Linux 6 Reporter: Colin Coe <colin.coe>
Component: doc-Logical_Volume_ManagerAssignee: Steven J. Levine <slevine>
Status: CLOSED WONTFIX QA Contact: ecs-bugs
Severity: medium Docs Contact:
Priority: low    
Version: 6.1CC: coughlan, fge, jbrassow, jha, mishu, pkennedy, redhat-bugzilla
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: 2011-06-16 22:58:38 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:
Deadline: 2011-06-20   
Attachments:
Description Flags
A script for setting up dm-replicator base on LVM none

Description Colin Coe 2010-11-23 06:41:14 UTC
Description of problem:
No (sys admin level) documentation for dm-replicator

Version-Release number of selected component (if applicable):
modinfo dm-replicator
filename:       /lib/modules/2.6.32-71.el6.x86_64/kernel/drivers/md/dm-replicator.ko
license:        GPL
author:         Heinz Mauelshagen <heinzm>
description:    device-mapper remote replication target
srcversion:     ECA4D2A942A25ED1F29C53F
depends:        dm-mod,dm-registry
vermagic:       2.6.32-71.el6.x86_64 SMP mod_unload modversions

How reproducible:
Always

Steps to Reproduce:
1. 
2.
3.
  
Actual results:
No documentation

Expected results:
Documentation explaining how sys admins can use dm-replicator to get replication working between sites and what tools to use should be available.

Additional info:

Comment 2 Gris Ge 2010-11-23 06:47:08 UTC
Kernel doc -- Documentation/device-mapper/replicator.txt could be a good reference even through it don't cover all explanation for every parameter.

Comment 3 Gris Ge 2010-11-23 06:53:17 UTC
Created attachment 462248 [details]
A script for setting up dm-replicator base on LVM

Please check this script for how to setup dm-replicator.

Comment 4 Steven J. Levine 2011-01-20 18:52:00 UTC
I'm changed the component to LVM, since that's where the device mapper is documented. This doesn't seem to be about DM-Multipath documentation.

Comment 5 Steven J. Levine 2011-01-20 19:00:48 UTC
Jon:

I added you to the CC list and set this to needinfo from you because I don't know what to make of this bug -- it was originally filed as a DM-Multipath documentation bug, but it seems to be more about the device mapper in general, which I document as an appendix in the LVM manual -- and which you helped me put together. That appendix is here:

http://documentation-stage.bne.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/6/html/Logical_Volume_Manager_Administration/device_mapper.html

Now, I'm not even sure what this request is for. Can you provide me with any sort of help in figuring out what it is that I'm specifically being asked to document here? Is this an additional mapping target that I should add to the device mapper appendix?

-Steven

Comment 6 Steven J. Levine 2011-04-11 19:33:05 UTC
I never got an answer to my NEEDINFO here, and this update to the documentation is not going to make the 6.1 release. I'm moving this to 6.2 and will pursue this info. It's a major documentation task and will involve allocation of documentation resources.

Comment 8 Steven J. Levine 2011-06-15 21:01:29 UTC
Jon: This is another ping on this BZ -- I'm still not sure what this bug refers to, or how to plan for addressing it in RHEL 6.2.

Comment 9 Steven J. Levine 2011-06-16 20:41:27 UTC
I have sent this note to the lvm-team mailing list:

BZ#656167 is a request to document dm-replicator.

https://bugzilla.redhat.com/show_bug.cgi?id=656167

I am unfamiliar with this, so I ask these questions of this list:

- Does it make sense to document dm-replicator in the user/admin documentation?  The bug notes that this should be documented for system administrators, but I'm looking for additional input as to whether this is something we should be documenting in the LVM/CLVM manual.

- The bug notes that Heinz Mauelshagen is the author of the dm-replicator component. If we document this, is Heinz still the technical contact I can contact to help me put together the documentation?

Any advice or comments on this would be appreciated. Thanks.

-Steven Levine

Comment 10 Steven J. Levine 2011-06-16 22:58:38 UTC
The LVM team has decided not to productive the dm-replicator at this time. drbd should meet customer needs. If this decision is re-visited, we can open a new bug to add the documentation, but since those are the current plans I am closing this bug as wontfix.

Comment 11 Steven J. Levine 2011-06-16 22:59:36 UTC
That word "productive" in Comment 10 should be "productize". Still not a great word, but at least one that makes sense in this context.