Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

lvrename(8) [redhat man page]

LVRENAME(8)						      System Manager's Manual						       LVRENAME(8)

NAME

       lvrename - rename a logical volume

SYNOPSIS

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

       {OldLogicalVolumePath NewLogicalVolume{Path|Name} |

       VolumeGroupName OldLogicalVolumeName NewLogicalVolumeName}

DESCRIPTION

       lvrename renames an existing logical volume from OldLogicalVolume{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 com-
	      plete path.

SEE ALSO

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

AUTHOR

       Heinz Mauelshagen <Linux-LVM@Sistina.com>

Heinz Mauelshagen						     LVM TOOLS							       LVRENAME(8)

Check Out this Related Man Page

VGREDUCE(8)						      System Manager's Manual						       VGREDUCE(8)

NAME

       vgreduce - reduce a volume group

SYNOPSIS

       vgreduce [-a|--all] [-A|--autobackup{y|n}] [-d|--debug] [-h|--help] [-v|--verbose] VolumeGroupName [PhysicalVolumePath...]

DESCRIPTION

       vgreduce allows you to remove one or more unused physical volumes from a volume group.

   OPTIONS
       -a, --all
	      Removes all empty physical volumes if none are given on command line.

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

DIAGNOSTICS

       vgreduce returns an exit code of 0 for success and > 0 for error:

       1  neither volume group name nor physical volume path(s) on command line
       2  invalid volume group name
       3  error checking existence of volume group
       4  volume group must be active
       5  error reading VGDA
       6  volume group is not reducable (see vgchange(8))
       7  no physical volume path(s) on command line
       8  realloc error
       9  malloc error
       10 no empty physical volume to reduce volume group by
       11 error setting up VGDA for reduce
       12 error reducing VGDA in kernel
       13 error writing VGDA to physical volume(s)

       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  determines  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 changes you can restore using vgcfgrestore(8).

See also
       lvm(8), vgextend(8)

AUTHOR

       Heinz Mauelshagen <Linux-LVM@Sistina.com>

Heinz Mauelshagen						     LVM TOOLS							       VGREDUCE(8)
Man Page