Lines Matching +full:cache +full:- +full:block +full:- +full:size
1 .. SPDX-License-Identifier: GPL-2.0-only
3 dm-vdo
6 The dm-vdo (virtual data optimizer) device mapper target provides
7 block-level deduplication, compression, and thin provisioning. As a device
20 https://github.com/dm-vdo/vdo/
25 enter or come up in read-only mode. Because read-only mode is indicative of
26 data-loss, a positive action must be taken to bring vdo out of read-only
28 prepare a read-only vdo to exit read-only mode. After running this tool,
34 inspect a vdo target's on-disk metadata. Fortunately, these tools are
35 rarely needed except by dm-vdo developers.
46 https://github.com/dm-vdo/vdoestimator/
52 ----------
56 <offset> <logical device size> vdo V4 <storage device>
57 <storage device size> <minimum I/O size> <block map cache size>
58 <block map era length> [optional arguments]
67 logical device size:
68 The size of the device which the vdo volume will service,
69 in sectors. Must match the current logical size of the vdo
75 storage device size:
76 The size of the device holding the vdo volume, as a number
77 of 4096-byte blocks. Must match the current size of the vdo
80 minimum I/O size:
81 The minimum I/O size for this vdo volume to accept, in
85 block map cache size:
86 The size of the block map cache, as a number of 4096-byte
88 If the logical thread count is non-zero, the cache size
91 block map era length:
92 The speed with which the block map cache writes out
93 modified block map pages. A smaller era length is likely to
95 increased block map writes during normal operation. The
100 --------------------
110 values are non-zero, all of them must be non-zero.
131 The number of threads used to do CPU-intensive work, such
146 underlying storage device. At format time, a slab size for
154 The maximum size of discard bio accepted, in 4096-byte
156 into 4096-byte blocks, and processed up to 2048 at a time.
158 automatically split to a larger size, up to <maxDiscard>
159 4096-byte blocks in a single bio, and are limited to 1500
174 -------------------
176 A modified table may be loaded into a running, non-suspended vdo volume.
178 modifiable parameters are <logical device size>, <physical device size>,
181 If the logical device size or physical device size are changed, upon
184 size may not exceed 4 PB. The physical device size must increase by at
185 least 32832 4096-byte blocks if at all, and must not exceed the size of the
187 slab size is chosen: the physical device size may never increase above the
188 size which provides 8192 slabs, and each increase must be large enough to
193 Start a previously-formatted vdo volume with 1 GB logical space and 1 GB
194 physical space, storing to /dev/dm-1 which has more than 1 GB of space.
198 dmsetup create vdo0 --table \
199 "0 2097152 vdo V4 /dev/dm-1 262144 4096 32768 16380"
201 Grow the logical size to 4 GB.
205 dmsetup reload vdo0 --table \
206 "0 8388608 vdo V4 /dev/dm-1 262144 4096 32768 16380"
209 Grow the physical size to 2 GB.
213 dmsetup reload vdo0 --table \
214 "0 8388608 vdo V4 /dev/dm-1 524288 4096 32768 16380"
217 Grow the physical size by 1 GB more and increase max discard sectors.
221 dmsetup reload vdo0 --table \
222 "0 10485760 vdo V4 /dev/dm-1 786432 4096 32768 16380 maxDiscard 8"
236 dmsetup create vdo1 --table \
237 "0 10485760 vdo V4 /dev/dm-1 786432 512 65550 5000 hash 1 logical 3 physical 2"
240 --------
245 dmsetup message <target-name> 0 <message-name> <message-parameters>
267 vdo: Most of the structures managing on-disk data
273 dump-on-shutdown:
278 ------
292 'read-only' (an error has occurred that forces the vdo
297 values may be 'recovering' or '-' which indicates not
324 - 1.15 MB of RAM for each 1 MB of configured block map cache size. The
325 block map cache requires a minimum of 150 MB.
326 - 1.6 MB of RAM for each 1 TB of logical space.
327 - 268 MB of RAM for each 1 TB of physical storage managed by the volume.
330 size of the deduplication window. For dense indexes, the index requires 1
342 Run-time Usage
345 When using dm-vdo, it is important to be aware of the ways in which its
348 - There is no guarantee that over-writes of existing blocks will succeed.
349 Because the underlying storage may be multiply referenced, over-writing
350 an existing block generally requires a vdo to have a free block
353 - When blocks are no longer in use, sending a discard request for those
357 duplicate blocks, no discard request for any given logical block is
360 - Assuming the underlying storage properly implements flush requests, vdo
364 - Each write to a vdo target entails a significant amount of processing.
380 The most important value to adjust is the block map cache size. In order to
382 the block map which holds the relevant mapping. These mappings are cached.
383 Performance will suffer when the working set does not fit in the cache. By
384 default, a vdo allocates 128 MB of metadata cache in RAM to support
389 thread controls a disjoint section of the block map, so additional logical
404 bios have CPU-heavy callbacks.
411 threads are comparison of 4096-byte data blocks. In most cases, a single