Red Hat Bugzilla – Bug 656167
Last modified: 2011-06-22 18:20:49 EDT
Description of problem:
No (sys admin level) documentation for dm-replicator
Version-Release number of selected component (if applicable):
author: Heinz Mauelshagen <firstname.lastname@example.org>
description: device-mapper remote replication target
vermagic: 2.6.32-71.el6.x86_64 SMP mod_unload modversions
Steps to Reproduce:
Documentation explaining how sys admins can use dm-replicator to get replication working between sites and what tools to use should be available.
Kernel doc -- Documentation/device-mapper/replicator.txt could be a good reference even through it don't cover all explanation for every parameter.
Created attachment 462248 [details]
A script for setting up dm-replicator base on LVM
Please check this script for how to setup dm-replicator.
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.
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:
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?
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.
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.
I have sent this note to the lvm-team mailing list:
BZ#656167 is a request to document dm-replicator.
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.
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.
That word "productive" in Comment 10 should be "productize". Still not a great word, but at least one that makes sense in this context.