From Gentoo Wiki
Jump to: navigation, search
This article is a stub. You can help Gentoo Wiki by expanding it.


DRBD (or Distributed Replicated Block Device) is a network block device that provides reliability when storing data across multiple network nodes.

From the kernel documentation:

DRBD is a shared-nothing, synchronously replicated block device. It is designed to serve as a building block for high availability clusters and in this context, is a "drop-in" replacement for shared storage. Simplistically, you could see it as a network RAID 1.


Kernel configurationEnable CONFIG_BLK_DEV_DRBD in your kernel

Device Drivers --->  Block devices --->
<*>   DRBD Distributed Replicated Block Device support

This is a deprecated template. Help us update this template!

Use Flags

USE flag (what is that?) Default Recommended Description
udev No Enable virtual/udev integration (device discovery, power and storage device support, etc)
bash-completion No Enable bash-completion support
heartbeat No Enable Heartbeat integration
pacemaker No Enable Pacemaker integration
xen No Enable Xen integration


Install sys-cluster/drbd:

root #emerge --ask sys-cluster/drbd

This package installs the userland utilities to interact with, and control DRBD.

aka 'drbdsetup' and 'drbdadm'

Drbd's documentation repository

To use drbd's pdfs you must register and login.

drbd's pdf documentation repository

drbd's management gui

Drbd has a utility to easily setup a cluster in 10 minutes. drbd's management gui


"ERROR: unknown cs for drbd0 : BrokenPipe, Update/DUnknown"

This error means connection state has a problem, link needs fixing, or drbd version updating. Upstream states "we had some issues with discarding the first successful connection and getting in a connect/brokenpipe loop."

Run this command to extract useful information.

root #cat /proc/drbd

External resources