drbdadm - Administration tool for DRBD

drbdadm [ -d ] [ -c file ] [ -s cmd ] command [ all | resource ... ]

Drbdadm is the high level tool of the DRBD program suite. Drbdadm is to drbdsetup what ifup/ifdown is to ifconfig. Drbdadm reads its configuration file and performs the specified commands by calling the drbdsetup program.

-d, --dry-run

Just prints the calls of drbdsetup to stdout, but does not run the commands.

-c, --config-file file

Specifies the configuration file drbdadm will use. If this parameter is not specified, drbdadm will look for /etc/drbd-07.conf and /etc/drbd.conf.

-s, --drbdsetup file

Specifies the full path to the drbdsetup program. If this option is omitted, drbdadm will look for /sbin/drbdsetup and ./drbdsetup.

attach

Attaches a local backing block device to the DRBD resource's device. In file system language this would be the mount operation.

detach

Removes the backing storage device from a DRBD resources's device.

connect

Sets up the network configuration of the resource's device. If the peer device is already configured, the two DRBD devices will connect.

disconnect

Removes the network configuration from the resource. The device will go into StandAllone state.

syncer

Loads the resynchronization parameters into the device.

up

Is a shortcut for attach and connect.

down

Is a shortcut for disconnect and detach.

primary

Switch the resource's device into primary state. You need to do this before you may mount a filesystem onto the device.

secondary

Brings the device back into secondary state. This is needed since in a connected DRBD device pair there might only be one of the two peers in primary state.

invalidate

This forces DRBD to consider the data on the local backing storage device as out-of-sync. Therefor DRBD will copy each and every block over from its peer, to bring the local storage device back in sync.

invalidate_remote

This command is similar to the invalidate command, but the backing storage of the peer is invalidated and hence rewritten with the data of the local node.

resize

DRBD will reexamine all sizing constraints, and re-size the resource's device accordingly. E.g. in case you increased the size of your backing storage devices (on both nodes of course), then DRBD will adopt to the new size after you called this command on _both_ nodes.

adjust

Synchronizes the configuration of device with your configuration file. You should always examine the output of the dry-run mode before actually executing this command.

wait_connect

Waits until the device is connected to its peer device.

state

Shows the current states of the devices (local/peer). E.g. primary/secondary

cstate

Shows the current connection status of the devices.

dump

Just parse the configuration file and dump it to stdout. Might be used to check the configuration file for syntactical correctness.

This document is correct for version 0.7.15 of the DRBD distribution.

Written by Philipp Reisner <philipp.reisner@linbit.com>.

Report bugs to <drbd-user@lists.linbit.com>.

Copyright (c) 2004-2005 Philipp Reisner. This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

drbd.conf(5), drbd(8), drbddisk(8) drbdsetup(8) DRBD Homepage <URL:http://www.drbd.org/>