vxconfigrestore(1M) vxconfigrestore(1M)
NAME
vxconfigrestore - restore disk group configuration
SYNOPSIS
/etc/vx/bin/vxconfigrestore [-c | -d | -n | -p] [-l directory] {dgname | dgid}
DESCRIPTION
The vxconfigrestore utility is used to restore a disk group's configuration information if this has been lost or become corrupted. The
disk group whose configuration is to be restore is specified either by name or by ID.
Any disks whose private region headers have become corrupted are reinstalled when the disk group configuration is restored. If you choose
not to reinstall the VxVM headers for these disks, it may not be possible to restore the disk group.
The disk group configuration backup files may have been automatically created by the vxconfigbackupd daemon, or manually by running the
vxconfigbackup command.
Restoration of a disk group configuration has two stages: precommit and commit. The precommit stage allows you to temporarily load the con-
figuration that is to be restored, and examine it using the vxprint utility. At this stage, the disk group configuration is read-only. No
permanent changes are written to disk until you choose to commit them. If desired, you can abandon the restore operation at the precommit
stage.
OPTIONS
-c (Commit) Permanently commits changes to the disks. The restoration must be at the precommit stage for this command to succeed.
Volumes are synchronized in the background. For large volume configurations, it may take some time to perform the synchroniza-
tion. You can use the vxtask -l list command to monitor the progress of this operation.
-d (Decommit) Abandons the restore operation at the precommit stage.
-n (Precommit: no installation of VxVM disk header) Loads the disk group configuration at the precommit stage. This option speci-
fies that disks whose private region headers have become corrupted are not to be reinstalled.
-l directory
Specifies a directory other than the default (/etc/vx/cbr/bk) where the backup configuration files are located.
-p (Precommit: load) Loads the disk group configuration at the precommit stage. This option specifies that disks whose private
region headers have become corrupted are to be reinstalled. The vxprint command can be used to examine the disk group configura-
tion.
Note: The volumes have not yet been synchronized at this stage.
This is the default operation if no option is specified.
EXAMPLES
Load the configuration of the mydg disk group from the default directory, and reinstall disks that have corrupted VxVM disk headers:
vxconfigrestore -p mydg
Load the configuration of the mydg1 disk group from the backup files in the directory /dgbackup/mydg1 without reinstalling any disks that
have corrupted private region disk headers:
vxconfigrestore -n -l /dgbackup/mydg1 mydg1
Abandon the restoration of the mydg2 disk group at the precommit stage:
vxconfigrestore -d -l /dgbackup/mydg2 mydg2
Commit the restoration of the configuration of the mydg disk group from the backup files in the directory /dgbackup/mydg:
vxconfigrestore -c -l /dgbackup/mydg mydg
FILES
/etc/vx/cbr/bk/dgname.dgid/dgid.dginfo
Default location of backup file for disk group information.
/etc/vx/cbr/bk/dgname.dgid/dgid.diskinfo
Default location of backup file for disk attributes.
/etc/vx/cbr/bk/dgname.dgid/dgid.binconfig
Default location of backup file for binary configuration copy.
/etc/vx/cbr/bk/dgname.dgid/dgid.cfgrec
Default location of backup file for configuration records in vxprint -m format.
NOTES
A disk group must be restored on the same physical disks as are defined in the configuration backup files.
The disk group configuration backup and restore utilities do not save any data in the public region. This includes file system or other
application data that is configured within VxVM objects.
A shared disk group in a cluster is restored as a private disk group. After the commit phase has completed, you can deport the private
disk group and re-import it as a shared disk group.
SEE ALSO
vxconfigbackup(1M), vxconfigbackupd(1M)
VxVM 5.0.31.1 24 Mar 2008 vxconfigrestore(1M)