LVRENAME(8)

NAME
lvrename - rename a logical volume

SYNOPSIS
lvrename [-A/--autobackup y/n] [-d/--debug] [-h/-?/--help] [-v/--verbose]

OldLogicalVolumePath NewLogicalVolumePath /

VolumeGroupName OldLogicalVolumeName NewLogicalVolumeName

DESCRIPTION
lvrename renames an existing ( see lvcreate(8) ) and inactive ( see lvchange(8) ) logical volume. The logical volume must be inactive to avoid a name change conflict for running applications using it.

  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 information about lvrename's activities.

Examples
"lvchange -a n /dev/vg02/lvol1" to deactivate the logical volume. "lvrename /dev/vg02/lvol1 /dev/vg02/testit" to rename logical volume "lvol1" in volume group "vg02" to "testit". "lvchange -a y /dev/vg02/testit" to activate it again. An alternate syntax to rename this logical volume is "lvrename vg02 lvol1 testit".

DIAGNOSTICS
lvrename returns an exit state 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
8  logical volume to be renamed must be inactive
9  error reading volume group
10 error getting index of old logical volume
11 error removing old logical volume from 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
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.

See also
lvm(8), lvchange(8), vgcreate(8), vgrename(8)

AUTHOR
Heinz Mauelshagen <linux-lvm@ez-darmstadt.telekom.de>