lvm_import_vdo(8)

1FSADM(8)                                                              FSADM(8)
2
3
4

NAME

6       lvm_import_vdo — utility to import VDO volumes into a new volume group.
7

SYNOPSIS

9       lvm_import_vdo
10                 [options] device
11

DESCRIPTION

13       lvm_import_vdo utility imports VDO volumes created and managed by
14       vdo(8) manager into lvm2(8) managed VDO LV. This is realized by moving
15       VDO superblock by 2MiB and creating lvm2 metadata at the front of this
16       device. The operation is not reversible, thus after conversion to lvm2
17       the access to VDO data is only possible with lvm2(8) commands, vdo(8)
18       manager no longer control such volume.
19

OPTIONS

21       -f|--force
22              Bypass some sanity checks.
23
24       -h|--help
25              Display the help text.
26
27       -n|--name
28              Specifies the name of converted VDO LV. When the name is not
29              specified, some automatic name is selected. In case the con‐
30              verted VDO volume is already using LV a backend device, the name
31              of this LV is used for VDO LV.  In this case also the of volume
32              group must stay same.  Automatic name may change between re‐
33              leases and currently selects "vdolv" as LV name and VG name is
34              selected from sequence "vdovg", "vdovg1", ...
35
36       -v|--verbose
37              Be more verbose.
38
39       -y|--yes
40              Answer "yes" at any prompts.
41
42       --dry-run
43              Print verbosely commands without running them.
44
45       --no-snapshot
46              With this option conversion tool will not use snapshot (COW
47              storage) for conversion in your $TMPDIR filesystem and it will
48              directly manipulate with VDO device in-place.  Warning: the
49              snapshot usage makes the whole conversion transactional and the
50              snapshot can be just simply merged once the whole conversion has
51              successfully proceeded. In the case of error the snapshot is
52              just removed.  Without the use of snapshot there is higher risk
53              of problems with recoverability in case some unexpected error
54              occurs.
55
56       --vdo-config
57              Configuration file for VDO manager. Can be used to specify con‐
58              figuration for vdo manager.
59

DIAGNOSTICS

61       On successful completion, the status code is 0.  A status code of 1 is
62       used for failure.
63

EXAMPLES

65       Convert VDO volume created by vdo manager into logical volume LV1 with
66       within volume group VG1.
67
68       # lvm_import_vdo --name VG1/LV1 /dev/mapper/vdo-volume
69

ENVIRONMENT VARIABLES

71       TMPDIR The temporary directory name for mount points. Defaults to
72              "/tmp".
73
74       DM_DEV_DIR
75              The device directory name.  Defaults to "/dev" and must be an
76              absolute path.
77
78       DM_UUID_PREFIX
79              Specify uuid prefix for snapshot volume used during vdo conver‐
80              sion.
81
82       LVM_BINARY
83              Allow to overide command called from lvm. Defaults to "lvm".
84
85       VDO_BINARY
86              Allow to overide command called from vdo. Defaults to "vdo".
87