lvrename

LVRENAME(8)                                                        LVRENAME(8)



NAME
       lvrename - rename a logical volume

SYNOPSIS
       lvrename  [-A|--autobackup  {y|n}]  [-d|--debug] [-h|--help] [-v|--ver-
       bose] [--version]

       {OldLogicalVolumePath NewLogicalVolume{Path|Name} |

       VolumeGroupName OldLogicalVolumeName NewLogicalVolumeName}

DESCRIPTION
       lvrename  renames  an  existing  logical  volume  from   OldLogicalVol-
       ume{Name|Path} to NewLogicalVolume{Name|Path}.

   OPTIONS
       -A, --autobackup {y|n}
              Controls  automatic  backup of VG metadata after the change (see
              vgcfgbackup(8)).  Default is yes.

       -d, --debug
              Enables additional debugging output (if compiled with DEBUG).

       -h, --help
              Print a usage message on standard output and exit  successfully.

       -v, --verbose
              Gives verbose progress messages.

EXAMPLE
       To rename lvold in volume group vg02 to lvnew:

            lvrename /dev/vg02/lvold /dev/vg02/lvnew

       An alternate syntax to rename this logical volume is

            lvrename vg02 lvold lvnew


DIAGNOSTICS
       lvrename returns an exit code of 0 for success or > 0 for error:

       1  invalid logical volume name
       2  error checking existence of volume group
       3  volume group inactive
       4  new logical volume special file already exists
       5  old logical volume doesn't exist
       6  volume group names are different
       7  new logical volume already exist
       9  error reading volume group
       10 error getting index of old logical volume
       11 error renaming logical volume in kernel
       12 error creating new logical volume in kernel
       13 error writing VGDA to physical volume(s)
       14 error creating device special for new logical volume
       15 invalid volume group name

       95 driver/module not in kernel
       96 invalid I/O protocol version
       97 error locking logical volume manager
       98 invalid lvmtab (run vgscan(8))
       99 invalid command line

ENVIRONMENT VARIABLES
       LVM_AUTOBACKUP
              If  this variable is set to "no" then the automatic backup of VG
              metadata is turned off.

       LVM_VG_MAX_BACKUPS
              This variable determins the backup history depth  of  kept  VGDA
              copy  files in /etc/lvmconf.  It can be set to a positive number
              between 0 and 999.  The higher this number is the more steps are
              you  able  to  backup  with vgcfgrestore(8) from the changes you
              make to your volume groups.

       LVM_VG_NAME
              The default Volume Group Name  to  use.  Setting  this  variable
              enables  you  to  enter just the Logical Volume Name rather than
              its complete path.

SEE ALSO
       lvm(8), lvchange(8), vgcreate(8), vgrename(8)

AUTHOR
       Heinz Mauelshagen <Linux-LVM@Sistina.com>



Heinz Mauelshagen                  LVM TOOLS                       LVRENAME(8)