dgcfgrestore

NAME

dgcfgrestore - display or restore VxVM disk group configuration from backup file

SYNOPSIS

DESCRIPTION

The dgcfgrestore command may be used to restore configuration data to the only disk in a single-disk disk group, or to a disk in a multi-disk disk group in which all other disks do not have a configuration data copy.

dgcfgrestore is designed not to work if the disk being restored belongs to a multi-disk disk group and at least one of the other disks in the group is online and contains configuration data. In such cases, adding the new disk to the disk group causes the configuration data to be copied to the new disk.

dgcfgrestore fails if the disk group to which the disk is being restored does not exist.

The dgcfgrestore command restores the VxVM configuration data from a default (-n option) or alternate (-f option) configuration backup file to the physical disk named by dm_name.

If the -l option is specified, dgcfgrestore displays the configuration data on the standard output.

The -o option allows the configuration stored for one disk device, old_dm_name, to be copied to another disk device, dm_name.

OPTIONS AND ARGUMENTS

dm_name

Specified the basename of a disk device (such as c0t4d0).

If the -o option is not specified, dm_name must specify the basename of a disk device whose configuration is stored in the configuration backup file.

-f dg_conf_path

Obtains configuration information from the alternate configuration backup file specied by dg_conf_path.

-l

Lists configuration information saved in the specified configuration backup file.

-n dg_name

Obtains configuration information from the default configuration backup file, /etc/vxvmconf/dg_name.conf, where dg_name is the name of the disk group.

-o old_dm_name

Restores the configuration information saved for disk device, old_dm_name to disk device, dm_name.

old_dm_name must be the basename of a disk device whose VxVM configuration is stored in the configuration backup file.

dm_name must be the basename of a disk device that has already been initialized to the disk group to which the disk being restored belonged. Note: Its configuration need not be stored in the configuration backup file.

EXIT CODES

dgcfgrestore exits with a zero status on successful completion. An non-zero exit status indicates that errors occurred during the restore operation.

"EXAMPLES"

Restore the VxVM configuration information for the VxVM disk disk01 on the replacement disk device c0t7d0 that was part of the single-disk disk group onediskdg using the default configuration file /etc/vxvmconf/dg00.conf:

It is now necessary to start the volumes. For a simple volume (neither RAID-5 nor mirrored), simply start the volume:

Although not recommended, it is possible to initialize disks that do not contain configuration data. Having redundant copies of configuration data on disks in a disk group avoids the need for the following procedure.

The next example shows how restore the VxVM configuration information for the VxVM disk, disk01 on the replacement disk device, c0t4d0. This was the only disk with configuration data in the two-disk disk group, dgnocfg. The other disk in the disk group, disk02 on c0t5d0, does not contain configuration data. The example uses the alternate configuration file /tmp/dgnocfg.backup.

For a mirrored volume, we want to use the good plex on the disk that was not replaced (disk02) to resynchronize the other one. To do so, we take the replaced plex offline, start the volume and place the remaining plex online.

The next example lists backup information saved in default configuration file /etc/vxvmconf/dgnocfg.conf:

This command displays output such as the following:

The final example restores the VxVM configuration information for the VxVM disk, disk01 for failed disk device c0t2d0, which was part of a single-disk disk group, foodg, to disk, c0t3d0. The default configuration file, /etc/vxvmconf/foodg.conf is used.

AUTHOR

dgcfgrestore was developed by the Hewlett-Packard Company.

SEE ALSO

dgcfgbackup (1M), vxdg (1M)