contrib/lvm2/dist/man/vgrename.8.in

   1 .TH VGRENAME 8 "LVM TOOLS #VERSION#" "Sistina Software UK" \" -*- nroff -*-
   2 .SH NAME
   3 vgrename \- rename a volume group
   4 .SH SYNOPSIS
   5 .B vgrename
   6 [\-A|\-\-autobackup y|n]
   7 [\-d|\-\-debug]
   8 [\-h|\-?|\-\-help]
   9 [\-t|\-\-test]
  10 [\-v|\-\-verbose]
  11 .IR OldVolumeGroup { Path | Name | UUID }
  12 .IR NewVolumeGroup { Path | Name }
  13 .SH DESCRIPTION
  14 vgrename renames an existing (see
  15 .B vgcreate(8)
  16 ) volume group from
  17 .IR OldVolumeGroup { Name | Path | UUID }
  18 to
  19 .IR NewVolumeGroup { Name | Path }.
  20 .SH OPTIONS
  21 See \fBlvm\fP for common options.
  22 .SH Examples
  23 "vgrename /dev/vg02 /dev/my_volume_group" renames existing
  24 volume group "vg02" to "my_volume_group".
  25 .TP
  26 "vgrename vg02 my_volume_group" does the same.
  27 .TP
  28 "vgrename Zvlifi-Ep3t-e0Ng-U42h-o0ye-KHu1-nl7Ns4 VolGroup00_tmp"
  29 changes the name of the Volume Group with UUID
  30 Zvlifi-Ep3t-e0Ng-U42h-o0ye-KHu1-nl7Ns4 to
  31 "VolGroup00_tmp".
  32
  33 All the Volume Groups visible to a system need to have different
  34 names.  Otherwise many LVM2 commands will refuse to run or give
  35 warning messages.
  36
  37 This situation could arise when disks are moved between machines.  If
  38 a disk is connected and it contains a Volume Group with the same name
  39 as the Volume Group containing your root filesystem the machine might
  40 not even boot correctly.  However, the two Volume Groups should have
  41 different UUIDs (unless the disk was cloned) so you can rename
  42 one of the conflicting Volume Groups with
  43 \fBvgrename\fP.
  44 .TP
  45 .SH SEE ALSO
  46 .BR lvm (8),
  47 .BR vgchange (8),
  48 .BR vgcreate (8),
  49 .BR lvrename (8)