bsradm

SYNOPSIS

drbdadmbsradm [options...] [-- [ backend-options...]] {command} {context...}

DESCRIPTION

The drbdadmbsradm utility is used for managing DRBD bsr based on its configuration files, see drbdbsr.conf(5). It translates high-level commands into one or more lower-level commands for the drbdsetupbsrsetup and drbdmetabsrmeta utilities, which control the kernel module and manipulate the on-disk metadata.Depending on the command, the drbdadmbsradm utility operates on one or more resources, devices, connections, or peer devices. The following command contexts are defined:resource

...

All options following a double-dash are passed through to the lower-level utilities as specified. In addition, drbdadmbsradm understands most of the options of drbdsetupbsrsetup, and will pass them through even without the double-dash.

OPTIONS

-d, --dry-run

Show which commands drbdadmbsradm would execute instead of actually executing them (for example, drbdadm bsradm -d up resource). This can be a useful way to learn how drbdsetupbsrsetup and drbdmetabsrmeta are used.

-c, --config-file file

Use an alternative configuration file. By default, drbdadmbsradm will use the the first of the following files that exists: /etc/drbdbsr-90.conf, /etc/drbdbsr-84.conf, /etc/drbdbsr-83.conf, /etc/drbdbsr-82.conf, /etc/drbdbsr-08.conf, /etc/drbdbsr.conf.

-t, --config-to-test file

Check an additional configuration file. This option is only allowed with the dump and the sh-nop commands.

-s, --drbdsetupbsrsetup file

Specifies the full path to the drbdsetupbsrsetup program. If this option is omitted, drbdadm bsradm will look for it beneath itself first, and then in the PATH.

-m, --drbdmetabsrmeta file

Specifies the full path to the drbdmetabsrmeta program. If this option is omitted, drbdadm bsradm will look for it beneath itself first, and then in the PATH.

...

Perform the command on a stacked resource.

COMMANDS

adjust { resource}

Adjust the configuration of the kernel module so that it matches the configuration files. The result should be the same as when stopping and restarting all resources ( drbdadm bsradm down all followed by drbdadm bsradm up all), but without the interruptions. Note that the adjust command can misinterpret the configuration change in some cases. To be safe, check what the command would do (with the --dry-run option) before running the actual command.

...

Apply the activity log of the specified device. See drbdmetabsrmeta(8) for details.

attach { device}

Attach a lower-level device to an existing replicated device. See drbdsetupbsrsetup(8) for details.

check-resize { device}

Call drbdmeta bsrmeta to eventually move internal meta data. If the backing device was resized, while DRBD bsr was not running, meta data has to be moved to the end of the device, so that the next attach command can succeed.

...