lvm_import_vdo(8) — Linux manual page

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | DIAGNOSTICS | EXAMPLES | ENVIRONMENT VARIABLES | SEE ALSO | COLOPHON

FSADM(8)                                                        FSADM(8)

NAME         top

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

SYNOPSIS         top

       lvm_import_vdo
              [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

       -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 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", ...

       -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         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

ENVIRONMENT VARIABLES         top

       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 overide command called from lvm. Defaults to
              "lvm".

       VDO_BINARY
              Allow to overide command called from vdo. Defaults to
              "vdo".

SEE ALSO         top

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

       vdo(8),

COLOPHON         top

       This page is part of the lvm2 (Logical Volume Manager 2) project.
       Information about the project can be found at 
       ⟨http://www.sourceware.org/lvm2/⟩.  If you have a bug report for
       this manual page, see ⟨https://github.com/lvmteam/lvm2/issues⟩.
       This page was obtained from the project's upstream Git repository
       ⟨git://sourceware.org/git/lvm2.git⟩ on 2023-12-22.  (At that
       time, the date of the most recent commit that was found in the
       repository was 2023-12-06.)  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
       man-pages@man7.org

Red Hat, Inc      LVM TOOLS 2.03.24(2)-git (2023-11-21)         FSADM(8)