vgcfgbackup(1m) [hpux man page]
vgcfgbackup(1M) vgcfgbackup(1M) NAME
vgcfgbackup - create or update LVM volume group configuration backup file SYNOPSIS
vg_conf_path] vg_name DESCRIPTION
The command saves the LVM configuration for a volume group in a default or alternate configuration backup file (see the option). By default, runs automatically each time an LVM command changes the LVM configuration. In this case, it always uses the default configura- tion backup file. An existing default configuration backup file is renamed with an extension of Options and Arguments recognizes the following options and arguments: vg_name The path name of a volume group. Save the configuration using an alternate file name specified by vg_conf_path. If is omitted, the default file name is in the form: base_vg_name is the base name of vg_name. For example, if vg_name is specified as base_vg_name is Update the configuration backup file with the latest LVM configuration. Only those physical volumes added since the configuration backup file was last modified need to be online. If is omitted, all physical volumes for vg_name must be online. RETURN VALUE
exits with one of the following values: Successful completion. Failure. Errors occurred when information from the volume group was being accessed. EXTERNAL INFLUENCES
Environment Variables determines the language in which messages are displayed. If is not specified or is null, it defaults to "C" (see lang(5)). If any internationalization variable contains an invalid setting, all internationalization variables default to "C" (see environ(5)). EXAMPLES
Back up LVM configuration information for volume group in the default backup file Update LVM configuration information corresponding to volume group in the default backup file Back up LVM configuration information for volume group in the alternate configuration backup file WARNINGS
It is recommended that any alternate configuration backup file be created in the root file system (as is the case with the default path name). This facilitates easy volume group recovery during maintenance mode, such as after a system crash. AUTHOR
was developed by HP. SEE ALSO
vgcfgrestore(1M). vgcfgbackup(1M)
Check Out this Related 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)