drbdadm [-d] [-c{file}] [-s{cmd}] [-m{cmd}] {
command
} [ all |
resource
... ]
Drbdadm is the high level tool of the DRBD program suite. Drbdadm is to drbdsetup and drbdmeta what ifup/ifdown is to ifconfig. Drbdadm reads its configuration file and performs the specified commands by calling the drbdsetup and/or the drbdmeta program.
-d, --dry-runJust prints the calls of drbdsetup to stdout, but does not run the commands.
-c, --config-filefile Specifies the configuration file drbdadm will use. If this parameter
is not specified, drbdadm will look for /etc/drbd-08.conf and
/etc/drbd.conf.
-s, --drbdsetupfile Specifies the full path to the drbdsetup program. If this option is
omitted, drbdadm will look for /sbin/drbdsetup and ./drbdsetup.
-m, --drbdmetafile Specifies the full path to the drbdmeta program. If this option is
omitted, drbdadm will look for /sbin/drbdmeta and
./drbdsetup.
Attaches a local backing block device to the DRBD resource's device.
Removes the backing storage device from a DRBD resource's device.
Sets up the network configuration of the resource's device. If the peer device is already configured, the two DRBD devices will connect.
Removes the network configuration from the resource. The device will then go into StandAlone state.
Switch the resource's device into primary state. You need to do this before any access to the device, such as creating or mounting a file system.
Brings the device back into secondary role. This is needed since in a connected DRBD device pair, only one of the two peers may have primary role (except if allow-two-primaries is explicitly set in the configuration file).
Forces DRBD to consider the data on the local backing storage device as out-of-sync. Therefore DRBD will copy each and every block over from its peer, to bring the local storage device back in sync.
This command is similar to the invalidate command, however, the peer's backing storage is invalidated and hence rewritten with the data of the local node.
Causes DRBD to re-examine all sizing constraints, and resize the resource's device accordingly. For example 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 one of your nodes. Since new storage space must be synchronised this command only works if there is at least one primary node present.
Initializes the meta data storage. This needs to be done before a DRBD resource can be taken online for the first time.
Shows a short textual representation of the data generation identifiers.
Prints a textual representation of the data generation identifiers including explanatory information.
Dumps the whole contents of the meta data storage, including the stored bit-map and activity-log, in a textual representation.
Synchronizes the configuration of the device with your configuration file. You should always examine the output of the dry-run mode before actually executing this command.
Shows the current states of the devices (local/peer). E.g. Primary/Secondary
Shows the current status of all devices defined in the current config file, in xml-like format. Example output:
<drbd-status version="8.2.6" api="88">
<resources config_file="/etc/drbd-82.conf">
<resource minor="0" name="s0" cs="SyncTarget" st1="Secondary" st2="Secondary"
ds1="Inconsistent" ds2="UpToDate" resynced_precent ="5.9" />
<resource minor="1" name="s1" cs="WFConnection" st1="Secondary"
st2="Unknown" ds1="Inconsistent" ds2="Outdated" />
<resource minor="3" name="dummy" cs="Unconfigured" />
<!-- resource minor="4" name="scratch" not available or not yet created -->
</resources>
</drbd-status>
Just parse the configuration file and dump it to stdout. May be used to check the configuration file for syntactical correctness.
Used to mark the node's data as outdated. Usually used by the peer's outdate-peer handler.
Starts online verify. During online verify, data on
both nodes is compared for inconsistency. See
/proc/drbd for online verify progress. If out-of-sync
blocks are found, they are not resynchronized
automatically. To do that, disconnect and
connect the resource when verification has completed.
See also the notes on data integrity on the drbd.conf manpage.
Temporarily suspend an ongoing resynchronization by setting the local pause flag. Resync only progresses if neither the local nor the remote pause flag is set. It might be desirable to postpone DRBD's resynchronization until after any resynchronization of the backing storage's RAID setup.
Generates a new currend UUID and rotates all other UUID values. This works on disconnected devices only, the device might be in primary or secondary role.
This can be used to shorten the initial resync of a cluster where the second node is added after the first node is gone into production, by means of disk shipping. See the drbdsetup manpage for a more details.
Show the current state of the backing storage devices. (local/peer)
Shows all commands undocumented on purpose.
Written by Philipp Reisner <philipp.reisner@linbit.com>
and Lars Ellenberg <lars.ellenberg@linbit.com>