unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (HP-UX-11.11)
Page:
Section:
Apropos / Subsearch:
optional field



 dgcfgrestore(1M)		  VxVM 3.5		    dgcfgrestore(1M)
				 1 Jun 2002



 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 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.



				    - 1 -	  Formatted:  August 2, 2006






 dgcfgrestore(1M)		  VxVM 3.5		    dgcfgrestore(1M)
				 1 Jun 2002



      -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





				    - 2 -	  Formatted:  August 2, 2006






 dgcfgrestore(1M)		  VxVM 3.5		    dgcfgrestore(1M)
				 1 Jun 2002



      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
      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.

      ## 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



				    - 3 -	  Formatted:  August 2, 2006






 dgcfgrestore(1M)		  VxVM 3.5		    dgcfgrestore(1M)
				 1 Jun 2002



      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)














				    - 4 -	  Formatted:  August 2, 2006