vgcfgrestore(8) [redhat man page]

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

NAME

       vgcfgrestore - restore volume group descriptor area

SYNOPSIS

       vgcfgrestore   [-b|--backup_number   VolumeGroupBackupNumber]  [-d|--debug]  [-f|--file	VGConfPath]  [-l[l]|--list  [--list]]  [-h|--help]
       [-i|--ignore_size] [-n|--name VolumeGroupName] [-o|--oldpath OldPhysicalVolumePath] [-t|--test] [-v|--verbose] [PhysicalVolumePath]

DESCRIPTION

       vgcfgrestore allows you to restore the volume group descriptor area from backup files in /etc/lvmconf or from VGConfPath to the given Phys-
       icalVolumePath.	 The  default  backup  file is /etc/lvmconf/VolumeGroupName.conf.  This command DOES NOT restore data contained in logical
       volume(s), only the LVM configuration metadata!

   OPTIONS
       -b, --backup_numberVolumeGroupBackupNumber
	      Restore from the specified backup number. Use together with option -n which gives the name of the volume group. See examples below.

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

       -f, --file VGConfPath
	      Restore from the specified path. Useful for selection of specific backups in the backup history or for copies of VGDA backups.

       -i, --ignore_size
	      Restore though the size of the physical volume doesn't match the one in the backup.

       -l, --list
	      Display volume group information contained in the backup file.  If given twice, the physical and	logical  volume  information  con-
	      tained in the backup file is also shown.

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

       -n, --name VolumeGroupName
	      Do a restore for this volume group name.

       -o, --oldpath OldPhysicalVolumePath
	      If  the  path  to the physical volume has changed between backup time and restore time, this option enables you to choose the corre-
	      sponding physical volume path in the backup file.

       -t, --test
	      Do a test run reading the volume group backup WITHOUT trying to restore it

       -v, --verbose
	      Give verbose runtime information about vgcfgrestore's activities.

       --version
	      Output the version number and exit successfully.

Examples
       To display information like with "vgdisplay vg00" stored in the backup file /etc/lvmconf/vg00.conf:

	    vgcfgrestore -n vg00 -l

       To restore the VGDA of vg00 from the alternative backup file /tmp/vg00-old to physical volume /dev/sdn1:

	    vgcfgrestore -f /tmp/vg00-old -n vg00 /dev/sdn1

       To restore the VGDA of vg00 from the alternative backup file
       /etc/lvmconf/vg00.conf.5.old
       to physical volume
       /dev/sda5 :

	    vgcfgrestore -n vg00 -b 5 /dev/sda5

DIAGNOSTICS

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

       1  no physical volume on command line
       2  invalid physical volume name
       3  volume group is active
       4  error doing restore to physical volume
       5  backup is invalid for this volume group
       6  volume group is inconsistent
       7  physical volume doesn't belong to volume group backup
       8  error reading physical volume
       9  error getting size of physical volume
       10 error writing VGDA to physical volume(s)
       11 error removing special files of volume group
       12 error setting volume group into lvmtab
       13 error doing backup

       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

SEE ALSO

       lvm(8), vgcfgbackup(8), vgcreate(8)

AUTHOR

       Heinz Mauelshagen <Linux-LVM@Sistina.com>

Heinz Mauelshagen						     LVM TOOLS							   VGCFGRESTORE(8)

Check Out this Related Man Page

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

NAME

       vgsplit - split a volume groups

SYNOPSIS

       vgsplit	[-A|--autobackup  {y|n}] [-d|-ebug] [-h|--help] [-l|--list] [-t|--test] [-v|--verbose] [--version] ExistingVolumeGroupName NewVol-
       umeGroupName PhysicalVolumePath [PhysicalVolumePath...]

DESCRIPTION

       vgsplit moves one or more PhysicalVolumePath(s) from ExistingVolumeGroupName into NewVolumeGroupName.  Physical volumes that are split  off
       to  the	new volume group must not contain any partial logical volumes.	Use pvmove(8) to move logical volumes to the desired physical vol-
       umes.

   OPTIONS
       -A, --autobackup {y|n}
	      Controls automatic backup of VG metadata after the merge (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.

       -l, --list
	      Display split volume group names like vgdisplay -v.

       -t, --test
	      Do a test run WITHOUT any real changes.

       -v, --verbose
	      Display verbose runtime information about vgsplit's activities.

       --version
	      Display tool and IOP version and exit successfully.

EXAMPLE

       To separate physical volumes /dev/sdk1 and /dev/sdn1 from the existing volume group databases and put them into new volume group my_vg.

	    vgsplit -v databases my_vg /dev/sdk1 /dev/sdn1

DIAGNOSTICS

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

       1  invalid volume group name
       2  invalid physical volume name
       3  malloc error
       4  error reading VGDA of existing volume group
       5  new volume group already exists
       6  error setting up VGDA for split
       7  logical volume to be split into new volume group must be inactive
       8  logical volume doesn't exist
       9  error removing logical volume from kernel
       10 error reducing VGDA by physical volume in kernel
       11 error writing changed existing VGDA to physical volume(s)
       12 error writing new VGDA to physical volume(s)
       13 error creating device special files for changed existing volume group
       14 error creating device special files for new volume group
       15 error creating new VGDA in kernel
       16 error inserting new volume group name into lvmtab

       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), vgcreate(8), vgextend(8), vgreduce(8), vgmerge(8), pvmove(8)

AUTHOR

       Heinz Mauelshagen <Linux-LVM@Sistina.com>

Heinz Mauelshagen						     LVM TOOLS								VGSPLIT(8)

Linux and UNIX Man Pages

vgcfgrestore(8) [redhat man page]

Check Out this Related Man Page