drbdmeta(8) [debian man page]
DRBDMETA(8) System Administration DRBDMETA(8) NAME
drbdmeta - DRBD's meta data management tool . SYNOPSIS
drbdmeta [--force] [--ignore-sanity-checks] {device} {v06 minor | v07 meta_dev index | v08 meta_dev index} {command} [cmd args...] DESCRIPTION
Drbdmeta is used to create, display and modify the contents of DRBD's meta data storage. Usually you do not want to use this command directly, but start it via the frontend drbdadm(8). This command only works if the DRBD resource is currently down, or at least detached from its backing storage. The first parameter is the device node associated to the resource. With the second parameter you can select the version of the meta data. Currently all major DRBD releases (0.6, 0.7 and 8) are supported. OPTIONS
--force All questions that get asked by drbdmeta are treated as if the user answered 'yes'. --ignore-sanity-checks Some sanity checks cause drbdmeta to terminate. E.g. if a file system image would get destroyed by creating the meta data. By using that option you can force drbdmeta to ignore these checks. COMMANDS
create-md Create-md initializes the meta data storage. This needs to be done before a DRBD resource can be taken online for the first time. In case there is already a meta data signature of an older format in place, drbdmeta will ask you if it should convert the older format to the selected format. get-gi Get-gi shows a short textual representation of the data generation identifier. In version 0.6 and 0.7 these are generation counters, while in version 8 it is a set of UUIDs. show-gi Show-gi prints a textual representation of the data generation identifiers including explanatory information. dump-md Dumps the whole contents of the meta data storage including the stored bit-map and activity-log in a textual representation. outdate Sets the outdated flag in the meta data. This is used by the peer node when it wants to become primary, but cannot communicate with the DRBD stack on this host. dstate Prints the state of the data on the backing storage. The output is always followed by '/DUnknown' since drbdmeta only looks at the local meta data. check-resize Examines the device size of a backing device, and it's last known device size, recorded in a file /var/lib/drbd/drbd-minor-??.lkbd. In case the size of the backing device changed, and the meta data can be found at the old position, it moves the meta data to the right position at the end of the block device. EXPERT'S COMMANDS Drbdmeta allows you to modify the meta data as well. This is intentionally omitted for the command's usage output, since you should only use it if you really know what you are doing. By setting the generation identifiers to wrong values, you risk to overwrite your up-to-data data with an older version of your data. set-gi gi Set-gi allows you to set the generation identifier. Gi needs to be a generation counter for the 0.6 and 0.7 format, and a UUID set for 8.x. Specify it in the same way as get-gi shows it. restore-md dump_file Reads the dump_file and writes it to the meta data. VERSION
This document was revised for version 8.3.2 of the DRBD distribution. AUTHOR
Written by Philipp Reisner philipp.reisner@linbit.com and Lars Ellenberg lars.ellenberg@linbit.com. REPORTING BUGS
Report bugs to drbd-user@lists.linbit.com. COPYRIGHT
Copyright 2001-2008 LINBIT Information Technologies, Philipp Reisner, Lars Ellenberg. This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. SEE ALSO
drbdadm(8) DRBD 8.3.2 15 Oct 2008 DRBDMETA(8)
Check Out this Related Man Page
DRBDLINKS(8) System Manager's Manual DRBDLINKS(8) NAME
drbdlinks - manages links into a shared DRBD partition SYNOPSIS
drbdlinks [OPTION]... [start|stop|auto|status|monitor] DESCRIPTION
drbdlinks is a program which manages links into a DRBD partition which is shared among several machines. It is meant to be used in con- junction with the heartbeat system for simplifying management of high availability clusters. A simple configuration file, "/etc/drb- dlinks.conf", specifies the links. This can be used to manage links for "/etc/apache", "/var/lib/pgsql", and other system files and direc- tories that need to appear as if they are local to the system when running applications after a DRBD shared partition has been mounted. A sample configuration file with annotations is included in the drbdlinks distribution. When run with "start" as the mode, drbdlinks will rename the existing files/directories, and then make symbolic links into the DRBD parti- tion. "stop" does the reverse. The "monitor" and "status" modes will check the file-system against the configuration file and will report "running" (monitor mode) or "OK" (status mode) if all links appear to be up. Otherwise they report "down" or "stopped" (respectively). By default, the rename appends .drbdlinks to the name, but this can be overridden in the configuration file. The "list" mode just show the list of links, with each line showing the link, destination, and a 0/1 flag for bindMount status. This may be useful for user scripts without having to parse the configuration. An init script is included which runs "stop" before heartbeat starts, and after heartbeat stops. This is done to try to ensure that when the shared partition isn't mounted, the links are in their normal state. OPTIONS
drbdlinks has several options, using either short or long variants. -h, --help Print a short help message describing the available options and exit. -c, --config-file=CONFIGFILE Specify an alternate config file. The default config file is /etc/drbdlinks.conf. Alternate config files should have a "drb- dlinks-" prefix, e.g. "drbdlinks-httpd.conf". -s, --suffix=SUFFIX Name to append to the local file-system name when the link is in place. The default is "drbdlinks", which would result in a renamed file like "/etc/httpd.drbdlinks". -v, --verbose Increase verbosity level by 1 for every occurrence of this option. EXAMPLES
Here are a few examples of how drbdlinks can be used. The most straight-forward, and default, method for starting drbdlinks: drbdlinks start To use a suffix different from the default when linking to a file or directory, the -s option can be used, specifying the desired string: drbdlinks -s orig start would rename the file-system name to "name.orig". Increase the verbosity to assist in debugging: drbdlinks -v -v start Use an alternate configuration file, possibly from with a DRBD mounted file-system: drbdlinks -c /shared1/drbdlinks-httpd.conf start This would use the specified configuration file, found on our DRBD device mounted on /shared1. This would allow us to easily keep drb- dlinks configurations tied to a specific set of data on a DRBD disk in an active/active sort of HA configuration. SEE ALSO
DRBD(8), drbdadm(8), drbdsetup(8), heartbeat(8). AUTHOR
drbdlinks was written by Sean Reifschneider <jafo@tummy.com>. This manual page was written by Cyril Bouthors <cyril@bouthors.org>, for the Debian project (but may be used by others). Sean Reifschnei- der modified it for status and monitor arguments, and included it in the base drbdlinks release. Mike Loseke <mike@tummy.com> added the sections on options and examples. September 3, 2008 DRBDLINKS(8)