1DRBDMETA(8) System Administration DRBDMETA(8)
2
6 drbdmeta - DRBD's meta data management tool .
7
9 drbdmeta [--force] [--ignore-sanity-checks] {device} {v06 minor |
10 v07 meta_dev index | v08 meta_dev index} {command}
11 [cmd args...]
12
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 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
25 --force
26 All questions that get asked by drbdmeta are treated as if the user
27 answered 'yes'.
28 --ignore-sanity-checks
30 Some sanity checks cause drbdmeta to terminate. E.g. if a file
31 system image would get destroyed by creating the meta data. By
32 using that option you can force drbdmeta to ignore these checks.
33
35 create-md
36 Create-md initializes the meta data storage. This needs to be done
37 before a DRBD resource can be taken online for the first time. In
38 case there is already a meta data signature of an older format in
39 place, drbdmeta will ask you if it should convert the older format
40 to the selected format.
41 get-gi
43 Get-gi shows a short textual representation of the data generation
44 identifier. In version 0.6 and 0.7 these are generation counters,
45 while in version 8 it is a set of UUIDs.
46 show-gi
48 Show-gi prints a textual representation of the data generation
49 identifiers including explanatory information.
50 dump-md
52 Dumps the whole contents of the meta data storage including the
53 stored bit-map and activity-log in a textual representation.
54 outdate
56 Sets the outdated flag in the meta data. This is used by the peer
57 node when it wants to become primary, but cannot communicate with
58 the DRBD stack on this host.
59 dstate
61 Prints the state of the data on the backing storage. The output is
62 always followed by '/DUnknown' since drbdmeta only looks at the
63 local meta data.
64 check-resize
66 Examines the device size of a backing device, and it's last known
67 device size, recorded in a file /var/lib/drbd/drbd-minor-??.lkbd.
68 In case the size of the backing device changed, and the meta data
69 can be found at the old position, it moves the meta data to the
70 right position at the end of the block device.
71
73 Drbdmeta allows you to modify the meta data as well. This is
74 intentionally omitted for the command's usage output, since you should
75 only use it if you really know what you are doing. By setting the
76 generation identifiers to wrong values, you risk to overwrite your
77 up-to-data data with an older version of your data.
78 set-gi gi
80 Set-gi allows you to set the generation identifier. Gi needs to be
81 a generation counter for the 0.6 and 0.7 format, and a UUID set for
82 8.x. Specify it in the same way as get-gi shows it.
83 restore-md dump_file
85 Reads the dump_file and writes it to the meta data.
86
88 This document was revised for version 8.3.2 of the DRBD distribution.
89
91 Written by Philipp Reisner philipp.reisner@linbit.com and Lars
92 Ellenberg lars.ellenberg@linbit.com.
93
95 Report bugs to drbd-user@lists.linbit.com.
96
98 Copyright 2001-2008 LINBIT Information Technologies, Philipp Reisner,
99 Lars Ellenberg. This is free software; see the source for copying
100 conditions. There is NO warranty; not even for MERCHANTABILITY or
101 FITNESS FOR A PARTICULAR PURPOSE.
102
104 drbdadm(8)
105DRBD 8.3.2 15 Oct 2008 DRBDMETA(8)