lvm_import_vdo(8) — Linux manual page


FSADM(8)                                                        FSADM(8)

NAME         top

       lvm_import_vdo — utility to import VDO volumes into a new volume

SYNOPSIS         top

              [options] device

DESCRIPTION         top

       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         top

              Bypass some sanity checks.

              Display the help text.

              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 LV a backend
              device, the name of this LV is used for VDO LV.  In this
              case also the of volume group must stay same.  Automatic
              name may change between releases and currently selects
              "vdolv" as LV name and VG name is selected from sequence
              "vdovg", "vdovg1", ...

              Be more verbose.

              Answer "yes" at any prompts.

              Print verbosely commands without running them.

              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.

              Configuration file for VDO manager. Can be used to specify
              configuration for vdo manager.

DIAGNOSTICS         top

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

EXAMPLES         top

       Convert VDO volume created by vdo manager into logical volume LV1
       with within volume group VG1.

       # lvm_import_vdo --name VG1/LV1 /dev/mapper/vdo-volume


       TMPDIR The temporary directory name for mount points. Defaults to

              The device directory name.  Defaults to "/dev" and must be
              an absolute path.

              Specify uuid prefix for snapshot volume used during vdo

              Allow to overide command called from lvm. Defaults to

              Allow to overide command called from vdo. Defaults to

SEE ALSO         top

       lvm(8), lvm.conf(5),


COLOPHON         top

       This page is part of the lvm2 (Logical Volume Manager 2) project.
       Information about the project can be found at 
       ⟨⟩.  If you have a bug report for
       this manual page, see ⟨⟩.
       This page was obtained from the project's upstream Git repository
       ⟨git://⟩ on 2024-06-14.  (At that
       time, the date of the most recent commit that was found in the
       repository was 2024-06-11.)  If you discover any rendering
       problems in this HTML version of the page, or you believe there
       is a better or more up-to-date source for the page, or you have
       corrections or improvements to the information in this COLOPHON
       (which is not part of the original manual page), send a mail to

Red Hat, Inc      LVM TOOLS 2.03.25(2)-git (2024-05-16)         FSADM(8)