Blame view

Documentation/device-mapper/snapshot.txt 6.45 KB
e484585ec   Paolo 'Blaisorblade' Giarrusso   [PATCH] Add dm-sn...
1
2
3
4
5
6
7
8
9
10
  Device-mapper snapshot support
  ==============================
  
  Device-mapper allows you, without massive data copying:
  
  *) To create snapshots of any block device i.e. mountable, saved states of
  the block device which are also writable without interfering with the
  original content;
  *) To create device "forks", i.e. multiple different versions of the
  same data stream.
d698aa450   Mikulas Patocka   dm snapshot: add ...
11
12
  *) To merge a snapshot of a block device back into the snapshot's origin
  device.
e484585ec   Paolo 'Blaisorblade' Giarrusso   [PATCH] Add dm-sn...
13

d698aa450   Mikulas Patocka   dm snapshot: add ...
14
15
16
  In the first two cases, dm copies only the chunks of data that get
  changed and uses a separate copy-on-write (COW) block device for
  storage.
e484585ec   Paolo 'Blaisorblade' Giarrusso   [PATCH] Add dm-sn...
17

d698aa450   Mikulas Patocka   dm snapshot: add ...
18
19
  For snapshot merge the contents of the COW storage are merged back into
  the origin device.
e484585ec   Paolo 'Blaisorblade' Giarrusso   [PATCH] Add dm-sn...
20

d698aa450   Mikulas Patocka   dm snapshot: add ...
21
22
  There are three dm targets available:
  snapshot, snapshot-origin, and snapshot-merge.
e484585ec   Paolo 'Blaisorblade' Giarrusso   [PATCH] Add dm-sn...
23
24
25
26
  
  *) snapshot-origin <origin>
  
  which will normally have one or more snapshots based on it.
e484585ec   Paolo 'Blaisorblade' Giarrusso   [PATCH] Add dm-sn...
27
28
29
30
31
32
  Reads will be mapped directly to the backing device. For each write, the
  original data will be saved in the <COW device> of each snapshot to keep
  its visible content unchanged, at least until the <COW device> fills up.
  
  
  *) snapshot <origin> <COW device> <persistent?> <chunksize>
411f11405   Paolo 'Blaisorblade' Giarrusso   [PATCH] Fix dm-sn...
33
  A snapshot of the <origin> block device is created. Changed chunks of
e484585ec   Paolo 'Blaisorblade' Giarrusso   [PATCH] Add dm-sn...
34
35
36
37
38
39
40
41
42
  <chunksize> sectors will be stored on the <COW device>.  Writes will
  only go to the <COW device>.  Reads will come from the <COW device> or
  from <origin> for unchanged data.  <COW device> will often be
  smaller than the origin and if it fills up the snapshot will become
  useless and be disabled, returning errors.  So it is important to monitor
  the amount of free space and expand the <COW device> before it fills up.
  
  <persistent?> is P (Persistent) or N (Not persistent - will not survive
  after reboot).
411f11405   Paolo 'Blaisorblade' Giarrusso   [PATCH] Fix dm-sn...
43
44
  The difference is that for transient snapshots less metadata must be
  saved on disk - they can be kept in memory by the kernel.
e484585ec   Paolo 'Blaisorblade' Giarrusso   [PATCH] Add dm-sn...
45

d698aa450   Mikulas Patocka   dm snapshot: add ...
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
  * snapshot-merge <origin> <COW device> <persistent> <chunksize>
  
  takes the same table arguments as the snapshot target except it only
  works with persistent snapshots.  This target assumes the role of the
  "snapshot-origin" target and must not be loaded if the "snapshot-origin"
  is still present for <origin>.
  
  Creates a merging snapshot that takes control of the changed chunks
  stored in the <COW device> of an existing snapshot, through a handover
  procedure, and merges these chunks back into the <origin>.  Once merging
  has started (in the background) the <origin> may be opened and the merge
  will continue while I/O is flowing to it.  Changes to the <origin> are
  deferred until the merging snapshot's corresponding chunk(s) have been
  merged.  Once merging has started the snapshot device, associated with
  the "snapshot" target, will return -EIO when accessed.
  
  
  How snapshot is used by LVM2
  ============================
e484585ec   Paolo 'Blaisorblade' Giarrusso   [PATCH] Add dm-sn...
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
  When you create the first LVM2 snapshot of a volume, four dm devices are used:
  
  1) a device containing the original mapping table of the source volume;
  2) a device used as the <COW device>;
  3) a "snapshot" device, combining #1 and #2, which is the visible snapshot
     volume;
  4) the "original" volume (which uses the device number used by the original
     source volume), whose table is replaced by a "snapshot-origin" mapping
     from device #1.
  
  A fixed naming scheme is used, so with the following commands:
  
  lvcreate -L 1G -n base volumeGroup
  lvcreate -L 100M --snapshot -n snap volumeGroup/base
  
  we'll have this situation (with volumes in above order):
  
  # dmsetup table|grep volumeGroup
  
  volumeGroup-base-real: 0 2097152 linear 8:19 384
  volumeGroup-snap-cow: 0 204800 linear 8:19 2097536
  volumeGroup-snap: 0 2097152 snapshot 254:11 254:12 P 16
  volumeGroup-base: 0 2097152 snapshot-origin 254:11
  
  # ls -lL /dev/mapper/volumeGroup-*
  brw-------  1 root root 254, 11 29 ago 18:15 /dev/mapper/volumeGroup-base-real
  brw-------  1 root root 254, 12 29 ago 18:15 /dev/mapper/volumeGroup-snap-cow
  brw-------  1 root root 254, 13 29 ago 18:15 /dev/mapper/volumeGroup-snap
  brw-------  1 root root 254, 10 29 ago 18:14 /dev/mapper/volumeGroup-base
d698aa450   Mikulas Patocka   dm snapshot: add ...
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
  
  How snapshot-merge is used by LVM2
  ==================================
  A merging snapshot assumes the role of the "snapshot-origin" while
  merging.  As such the "snapshot-origin" is replaced with
  "snapshot-merge".  The "-real" device is not changed and the "-cow"
  device is renamed to <origin name>-cow to aid LVM2's cleanup of the
  merging snapshot after it completes.  The "snapshot" that hands over its
  COW device to the "snapshot-merge" is deactivated (unless using lvchange
  --refresh); but if it is left active it will simply return I/O errors.
  
  A snapshot will merge into its origin with the following command:
  
  lvconvert --merge volumeGroup/snap
  
  we'll now have this situation:
  
  # dmsetup table|grep volumeGroup
  
  volumeGroup-base-real: 0 2097152 linear 8:19 384
  volumeGroup-base-cow: 0 204800 linear 8:19 2097536
  volumeGroup-base: 0 2097152 snapshot-merge 254:11 254:12 P 16
  
  # ls -lL /dev/mapper/volumeGroup-*
  brw-------  1 root root 254, 11 29 ago 18:15 /dev/mapper/volumeGroup-base-real
  brw-------  1 root root 254, 12 29 ago 18:16 /dev/mapper/volumeGroup-base-cow
  brw-------  1 root root 254, 10 29 ago 18:16 /dev/mapper/volumeGroup-base
c53a381ef   Mike Snitzer   dm: document when...
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
  
  
  How to determine when a merging is complete
  ===========================================
  The snapshot-merge and snapshot status lines end with:
    <sectors_allocated>/<total_sectors> <metadata_sectors>
  
  Both <sectors_allocated> and <total_sectors> include both data and metadata.
  During merging, the number of sectors allocated gets smaller and
  smaller.  Merging has finished when the number of sectors holding data
  is zero, in other words <sectors_allocated> == <metadata_sectors>.
  
  Here is a practical example (using a hybrid of lvm and dmsetup commands):
  
  # lvs
    LV      VG          Attr   LSize Origin  Snap%  Move Log Copy%  Convert
    base    volumeGroup owi-a- 4.00g
    snap    volumeGroup swi-a- 1.00g base  18.97
  
  # dmsetup status volumeGroup-snap
  0 8388608 snapshot 397896/2097152 1560
                                    ^^^^ metadata sectors
  
  # lvconvert --merge -b volumeGroup/snap
    Merging of volume snap started.
  
  # lvs volumeGroup/snap
    LV      VG          Attr   LSize Origin  Snap%  Move Log Copy%  Convert
    base    volumeGroup Owi-a- 4.00g          17.23
  
  # dmsetup status volumeGroup-base
  0 8388608 snapshot-merge 281688/2097152 1104
  
  # dmsetup status volumeGroup-base
  0 8388608 snapshot-merge 180480/2097152 712
  
  # dmsetup status volumeGroup-base
  0 8388608 snapshot-merge 16/2097152 16
  
  Merging has finished.
  
  # lvs
    LV      VG          Attr   LSize Origin  Snap%  Move Log Copy%  Convert
    base    volumeGroup owi-a- 4.00g