1LVCONVERT(8)                System Manager's Manual               LVCONVERT(8)
2
3
4

NAME

6       lvconvert - convert a logical volume from linear to mirror or snapshot
7

SYNOPSIS

9       lvconvert  -m/--mirrors  Mirrors  [--corelog]  [-R/--regionsize Mirror‐
10       LogRegionSize] [-A/--alloc AllocationPolicy] [-h/-?/--help]  [-v/--ver‐
11       bose] [--version]
12       LogicalVolume[Path] [PhysicalVolume[Path]...]
13
14       lvconvert   -s/--snapshot   [-c/--chunksize  ChunkSize]  [-h/-?/--help]
15       [-v/--verbose] [-Z/--zero y/n] [--version]
16       OriginalLogicalVolume[Path] SnapshotLogicalVolume[Path]
17

DESCRIPTION

19       lvconvert will change a linear logical volume to a mirror logical  vol‐
20       ume  or to a snapshot of linear volume and vice versa.  It is also used
21       to add and remove disk logs from mirror devices.
22

OPTIONS

24       See lvm for common options.
25       Exactly one of --mirrors or --snapshot arguments required.
26
27       -m, --mirrors Mirrors
28              Specifies the degree of the mirror  you  wish  to  create.   For
29              example,  "-m  1" would convert the original logical volume to a
30              mirror volume with 2-sides; that is, a linear  volume  plus  one
31              copy.
32
33       --corelog
34              This optional argument tells lvconvert to switch the mirror from
35              using a disk-based (persistent) log to an  in-memory  log.   You
36              may  only  specify this option when the --mirror argument is the
37              same degree of the mirror you are changing.
38
39       -R, --regionsize MirrorLogRegionSize
40              A mirror is divided into regions of this size (in MB),  and  the
41              mirror  log  uses this granularity to track which regions are in
42              sync.
43
44       -s, --snapshot
45              Create a snapshot from existing  logical  volume  using  another
46              existing logical volume as its origin.
47
48       -c, --chunksize ChunkSize
49              Power of 2 chunk size for the snapshot logical volume between 4k
50              and 512k.
51
52       -Z, --zero y/n
53              Controls zeroing of the first KB of data in  the  snapshot.   If
54              the volume is read-only the snapshot will not be zeroed.
55

Examples

57       "lvconvert -m1 vg00/lvol1"
58       converts  the  linear  logical  volume "vg00/lvol1" to a mirror logical
59       volume.  This command could also be used to convert  a  two-way  mirror
60       with an in-memory log to a two-way mirror with a disk log.
61
62       "lvconvert -m1 --corelog vg00/lvol1"
63       converts  a  two-way mirror with a disk log to a two-way mirror with an
64       in-memory log.
65
66       "lvconvert -m0 vg00/lvol1"
67       converts a mirror logical volume to a linear logical volume.
68
69       "lvconvert -s vg00/lvol1 vg00/lvol2"
70       converts logical volume "vg00/lvol2" to  snapshot  of  original  volume
71       "vg00/lvol1"
72
73

SEE ALSO

75       lvm(8),   vgcreate(8),  lvremove(8),  lvrename(8),  lvextend(8),  lvre‐
76       duce(8), lvdisplay(8), lvscan(8)
77
78
79
80Red Hat, Inc                       LVM TOOLS                      LVCONVERT(8)
Impressum