drbdmeta-8.3(8)

1DRBDMETA(8)                  System Administration                 DRBDMETA(8)
2
3
4

NAME

6       drbdmeta - DRBD's meta data management tool
7

SYNOPSIS

9       drbdmeta [--force] [--ignore-sanity-checks] {device} {v06 minor |
10                v07 meta_dev index | v08 meta_dev index} {command}
11                [cmd args...]
12

DESCRIPTION

14       Drbdmeta is used to create, display and modify the contents of DRBD's
15       meta data storage. Usually you do not want to use this command
16       directly, but start it via the frontend drbdadm(8).
17
18       This command only works if the DRBD resource is currently down, or at
19       least detached from its backing storage. The first parameter is the
20       device node associated to the resource. With the second parameter you
21       can select the version of the meta data. Currently all major DRBD
22       releases (0.6, 0.7 and 8) are supported.
23

OPTIONS

25       --force
26
27           All questions that get asked by drbdmeta are treated as if the user
28           answered 'yes'.
29
30       --ignore-sanity-checks
31
32           Some sanity checks cause drbdmeta to terminate. E.g. if a file
33           system image would get destroyed by creating the meta data. By
34           using that option you can force drbdmeta to ignore these checks.
35

COMMANDS

37       create-md --peer-max-bio-size val
38
39           Create-md initializes the meta data storage. This needs to be done
40           before a DRBD resource can be taken online for the first time. In
41           case there is already a meta data signature of an older format in
42           place, drbdmeta will ask you if it should convert the older format
43           to the selected format.
44
45           If you will use the resource before it is connected to its peer for
46           the first time DRBD may perform better if you use the
47           --peer-max-bio-size option. For DRBD versions of the peer use up to
48           these values: <8.3.7 -> 4k, 8.3.8 -> 32k, 8.3.9 -> 128k, 8.4.0 ->
49           1M.
50
51       get-gi
52
53           Get-gi shows a short textual representation of the data generation
54           identifier. In version 0.6 and 0.7 these are generation counters,
55           while in version 8 it is a set of UUIDs.
56
57       show-gi
58
59           Show-gi prints a textual representation of the data generation
60           identifiers including explanatory information.
61
62       dump-md
63
64           Dumps the whole contents of the meta data storage including the
65           stored bit-map and activity-log in a textual representation.
66
67       outdate
68
69           Sets the outdated flag in the meta data. This is used by the peer
70           node when it wants to become primary, but cannot communicate with
71           the DRBD stack on this host.
72
73       dstate
74
75           Prints the state of the data on the backing storage. The output is
76           always followed by '/DUnknown' since drbdmeta only looks at the
77           local meta data.
78
79       check-resize
80
81           Examines the device size of a backing device, and it's last known
82           device size, recorded in a file /var/lib/drbd/drbd-minor-??.lkbd.
83           In case the size of the backing device changed, and the meta data
84           can be found at the old position, it moves the meta data to the
85           right position at the end of the block device.
86

EXPERTS COMMANDS

88       Drbdmeta allows you to modify the meta data as well. This is
89       intentionally omitted for the command's usage output, since you should
90       only use it if you really know what you are doing. By setting the
91       generation identifiers to wrong values, you risk to overwrite your
92       up-to-data data with an older version of your data.
93
94       set-gi gi
95
96           Set-gi allows you to set the generation identifier.  Gi needs to be
97           a generation counter for the 0.6 and 0.7 format, and a UUID set for
98           8.x. Specify it in the same way as get-gi shows it.
99
100       restore-md dump_file
101
102           Reads the dump_file and writes it to the meta data.
103

VERSION

105       This document was revised for version 8.3.2 of the DRBD distribution.
106

AUTHOR

108       Written by Philipp Reisner <philipp.reisner@linbit.com> and Lars
109       Ellenberg <lars.ellenberg@linbit.com>.
110

REPORTING BUGS

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

COPYRIGHT

115       Copyright 2001-2008 LINBIT Information Technologies, Philipp Reisner,
116       Lars Ellenberg. This is free software; see the source for copying
117       conditions. There is NO warranty; not even for MERCHANTABILITY or
118       FITNESS FOR A PARTICULAR PURPOSE.
119