[DRBD-user] Public draft of DRBD Users' Guide available, feedback requested

Florian Haas florian.haas at linbit.com
Mon Mar 3 09:30:25 CET 2008

Note: "permalinks" may not be as permanent as we would like,
direct links of old sources may well be a few messages off.


thanks for your feedback. See comments below.

On Tuesday 26 February 2008 13:08:33 Dominik Klein wrote:
> Hi
> > We have just published an initial public draft of the all-new DRBD Users'
> > Guide which will henceforth be available at
> > http://www.drbd.org/users-guide/.
> Very nice work. Thank you very much.

Glad to please you. :-)

> http://www.drbd.org/users-guide/ch-admin.html
> Inconsistent. The data are inconsistent
> s/are/is

Strictly speaking you're wrong, as "data" is a plural word, its singular 
being "datum". :-) But I agree that it's being used as a singular word 
colloquially, hence, I fixed this.

> http://www.drbd.org/users-guide/s-enable-dual-primary.html
> IIRC, become-primary-on-both; was introduces in a recent version. If so,
> one could think of adding the version number as you did in several other
> places.

Correct; fixed.

> http://www.drbd.org/users-guide/s-resizing.html
> "ensure that only one node is in primary state"
> Is this to say that it works in a primary/primary configuration, but
> only if you temporarily put one node to secondary mode? That could be
> made clearer.
> "are shrunk first"
> the "first" should be highlighted imho :)

I rephrased that point to make it clearer.

> list point 7:
> I think theres a \n missing after "/tmp/metadata"

Correct again; fixed.

> http://www.drbd.org/users-guide/s-resolve-split-brain.html
> "At this point, you must manually intervene"
> A link might refer to the section about automatic split-brain recovery.

That is correct too, but it's not there yet because there is, as of now, no 
section on the actual configuration of automatic post-split-brain recovery 
strategies exists. This is on the to-do list.

> http://www.drbd.org/users-guide/ch-heartbeat.html
> "they are be started and stopped by the cluster manager"
> s/be//
> or maybe you meant "are to be"?

I rephrased that to "the cluster manager starts and stops them". :-)

> http://www.drbd.org/users-guide/ch-heartbeat.html
> R1 can only deal with heartbeat and LSB Resources. OCF Resources are for
> R2 only.
> You even say so:
> http://www.drbd.org/users-guide/s-xen-heartbeat.html
> Although - there is a wrapper for R1 that makes it possible to use OCF
> RAs in R1, but I don't know how to use it and wether that should be
> stated in this place.

It makes so little sense to do this that we're taking the liberty not to 
include this. :-)

> http://www.drbd.org/users-guide/s-heartbeat-r1.html
> "Resource group support is limited to two resource groups"
> Thats not true.
> You can have more than two resource groups. It's just that more than 2
> groups are internally treated as one large group per node.

OK, then isn't "limited to two resource groups" a reasonable simplification 
for users?

> http://www.drbd.org/users-guide/s-heartbeat-dopd.html
> This does not mention the difference in configurations with stonith
> enabled. You might at least place a link to the blog here.

I'm not sure I follow you there; please clarify.

> http://www.drbd.org/users-guide/s-xen-internal.html
> Although it *should* be clear, you could state that one needs to copy
> block-drbd to /etc/xen/scripts
> Or is block-drbd a part of xen by now?

It's a part of the DRBD distribution that automatically installs 
into /etc/xen/scripts.

> http://www.drbd.org/users-guide/s-xen-heartbeat.html
> As you earlier described R1 first, you might want to keep doing this.

Low on my priority list, as I believe it makes zero sense to use Xen in 
Heartbeat R1 configurations, for lack of resource monitoring. But I might add 
a note about using the xendomains script as a Heartbeat-managed LSB service.


: Florian G. Haas 
: LINBIT Information Technologies GmbH
: Vivenotgasse 48, A-1120 Vienna, Austria

Please note: when replying, there is no need to CC my 
personal address. Replying to the list is fine. Thank you.

More information about the drbd-user mailing list