# lvm_import_vdo

## NAME



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


## SYNOPSIS



           **lvm_import_vdo**[_options_] _device_
    


## DESCRIPTION



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


## OPTIONS



           **-f** |**--force**
                  Bypass some sanity checks.
    
           **-h** |**--help**
                  Display the help text.
    
           **-n** |**--name**
                  Specifies the name of converted VDO LV. When the name is
                  not specified, some automatic name is selected. In case the
                  converted VDO volume is already using an LV as a backend
                  device, the name of this LV is used for VDO LV.  In this
                  case also the name of the volume group must stay the same.
                  Automatic name may change between releases and currently
                  selects "vdolv" as LV name and VG name is selected from
                  sequence "vdovg", "vdovg1", ...
    
           **-v** |**--verbose**
                  Be more verbose.
    
           **-y** |**--yes**
                  Answer "yes" at any prompts.
    
           **--dry-run**
                  Print verbosely commands without running them.
    
           **--no-snapshot**
                  With this option conversion tool will not use snapshot (COW
                  storage) for conversion in your $TMPDIR filesystem and it
                  will directly manipulate with VDO device in-place.
                  Warning: the snapshot usage makes the whole conversion
                  transactional and the snapshot can be just simply merged
                  once the whole conversion has successfully proceeded. In
                  the case of error the snapshot is just removed.  Without
                  the use of snapshot there is higher risk of problems with
                  recoverability in case some unexpected error occurs.
    
           **--vdo-config**
                  Configuration file for VDO manager.  Can be used to specify
                  configuration for vdo manager.
    


## DIAGNOSTICS



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


## EXAMPLES



           Convert VDO volume created by vdo manager into logical volume LV1
           within volume group VG1.
    
           # **lvm_import_vdo --name VG1/LV1 /dev/mapper/vdo-volume**
    


## ENVIRONMENT VARIABLES



           **TMPDIR** The temporary directory name for mount points. Defaults to
                  "_/tmp_ ".
    
           **DM_DEV_DIR**
                  The device directory name.  Defaults to "_/dev_ " and must be
                  an absolute path.
    
           **DM_UUID_PREFIX**
                  Specify uuid prefix for snapshot volume used during vdo
                  conversion.
    
           **LVM_BINARY**
                  Allow to override command called from lvm. Defaults to
                  "_lvm_ ".
    
           **VDO_BINARY**
                  Allow to override command called from vdo. Defaults to
                  "_vdo_ ".
    


* * *