dgcfgrestore(1M)														  dgcfgrestore(1M)

NAME

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

SYNOPSIS

       /usr/sbin/dgcfgrestore -n dg_name -l

       /usr/sbin/dgcfgrestore -n dg_name [ -o old_dm_name ] dm_name

       /usr/sbin/dgcfgrestore -f dg_conf_path -l

       /usr/sbin/dgcfgrestore -f dg_conf_path [ -o old_dm_name ] dm_name

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 con-
		 figuration 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:

       ##Initialize replaced disk device c0t7d0 for use by VxVM
       # /etc/vx/bin/vxdisketup -i c0t7d0
       ##Create disk group using this disk
       # vxdg init onediskdg disk01=c0t7d0
       ## Restore configuration data
       # dgcfgrestore -n onediskdg c0t7d0
       # vxprint -g onediskdg -ht
       DG NAME	    NCONFIG    NLOG	MINORS	 GROUP-ID
       DM NAME	    DEVICE     TYPE	PRIVLEN  PUBLEN   STATE
       V  NAME	    USETYPE    KSTATE	STATE	 LENGTH   READPOL   PREFPLEX
       PL NAME	    VOLUME     KSTATE	STATE	 LENGTH   LAYOUT    NCOL/WID MODE
       SD NAME	    PLEX       DISK	DISKOFFS LENGTH   [COL/]OFF DEVICE   MODE
       SV NAME	    PLEX       VOLNAME	NVOLLAYR LENGTH   [COL/]OFF AM/NM    MODE

       dg onedisk   default    default	7928000  944849696.3237.veritas9

       dm disk01    c8t0d0     simple	1024	 8885610  -

       v  volume1   fsgen      DISABLED EMPTY	 10240	  SELECT    -
       pl volume1-01 volume1   DISABLED EMPTY	 10240	  CONCAT    -	     RW
       sd disk01-01 volume1-01 disk01	0	 10240	  0	    c8t0d0   ENA

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

       vxvol -g onediskdg start vol01

       Although not recommended, it is possible to initialize disks that do not contain configuration data.  Having redundant copies of configura-
       tion 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.

       ## Initialize replaced disk device c0t4d0 for use by VxVM
       # /etc/vxvm/bin/vxdisksetup -i c0t4d0
       ## Create disk group using this disk
       # vxdg init dgnocfg disk01=c0t4d0
       ## Reinitialize c0t5d0 to match new instance of dgnocfg
       # /etc/vxvm/bin/vxdiskunsetup -C c0t5d0
       # /etc/vxvm/bin/vxdisksetup -i c0t5d0 noconfig
       # vxdg -g dgnocfg adddisk disk02=c0t5d0
       ## Restore configuration data
       #d gcfgrestore -f /tmp/dgnocfg.backup c0t4d0
       # vxprint -g dgnocfg -ht
       DG NAME	     NCONFIG	 NLOG	  MINORS   GROUP-ID
       DM NAME	     DEVICE	 TYPE	  PRIVLEN  PUBLEN   STATE
       V  NAME	     USETYPE	 KSTATE   STATE    LENGTH   READPOL   PREFPLEX
       PL NAME	     VOLUME	 KSTATE   STATE    LENGTH   LAYOUT    NCOL/WID MODE
       SD NAME	     PLEX	 DISK	  DISKOFFS LENGTH   [COL/]OFF DEVICE   MODE
       SV NAME	     PLEX	 VOLNAME  NVOLLAYR LENGTH   [COL/]OFF AM/NM    MODE

       dg dgnocfg    default	 default  5035000  945182942.3700.veritas9

       dm disk01     c0t4d0	 simple   1024	   8885610  -
       dm disk02     c0t5d0	 simple   1024	   8885610  -

       v  mirvol01   fsgen	 DISABLED EMPTY    10240    SELECT    -
       pl mirvol01-01 mirvol01	 DISABLED EMPTY    10240    CONCAT    -        RW
       sd disk01-01  mirvol01-01 disk01   0	   10240    0	      c0t4d0   ENA
       pl mirvol01-02 mirvol01	 DISABLED EMPTY    10240    CONCAT    -        RW
       sd disk02-01  mirvol01-02 disk02   0	   10240    0	      c0t5d0   ENA

       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.

       vxmend -g dgnocfg off mirvol01-01
       vxvol -g dgnocfg start mirvol01
       vxmend -g dgnocfg on mirvol01-01

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

       dgcfgrestore -n twodiskdg -l

       This command displays output such as the following:

       Disk Group Configuration information in "/etc/vxvmconf/twodiskdg.conf"
       DG Name twodiskdg
       ---- Physical disks : 2 ----
	   /dev/rdsk/c0t4d0
	   /dev/rdsk/c0t5d0

       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.

       # Initialize c0t3d0 for use by VxVM
       /etc/vx/bin/vxdisketup -i c0t3d0
       # Create disk group using this disk
       vxdg init onediskdg disk01=c0t3d0
       # Restore configuration data
       dgcfgrestore -n foodg -o c0t3d0 c0t2d0

AUTHOR

       dgcfgrestore was developed by the Hewlett-Packard Company.

SEE ALSO

       dgcfgbackup(1M), vxdg(1M)

VxVM 5.0.31.1							    24 Mar 2008 						  dgcfgrestore(1M)