external/gpl2/lvm2/dist/man/vgrename.8

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