volclonedg man page on DigitalUNIX

Printed from http://www.polarhome.com/service/man/?qf=volclonedg&af=0&tf=2&of=DigitalUNIX

volclonedg(8)							 volclonedg(8)

NAME
       volclonedg - Creates a copy of an LSM disk group whose underlying disks
       have been cloned via hardware.

SYNOPSIS
       /usr/sbin/volclonedg -c diskgroup  [-n  clonedg_name]  [-d  volsavedir]
       [-r] [-l] clone_disk_name...

OPTIONS
       Specifies  the  name  of	 an  LSM  disk	group  to  clone  (the	parent
       diskgroup).  Specifies a name other than the  default  (parentdg_clone)
       as  the name of the clone disk group. Must be a unique disk group name.
       Specifies the name of the directory containing the appropriate  volsave
       data  that  volclonedg  uses  to	 create	 the LSM configuration for the
       cloned disk group. This option is needed only if you create  the	 clone
       disk  group  on a different system.  Specifies that LSM should not per‐
       form recovery on mirrored volumes in the clone disk group.  Clears  the
       lock  that prevents multiple invocations of volclonedg on the same sys‐
       tem or on multiple nodes in a cluster. In a cluster, after the lock  is
       cleared,	 it  is	 taken	out on behalf of the initiating node. Use this
       option with caution--concurrent volclonedg operations  can  have	 unin‐
       tended results.

OPERANDS
       Specifies the name of the cloned disk(s). Must specify the entire disk,
       not a disk partition.

DESCRIPTION
       The volclonedg command allows you to create a  copy  of	a  disk	 group
       using  disks that have been cloned via hardware. This command is avail‐
       able on both standalone systems and clusters. LSM must be installed and
       running before you can use volclonedg.

       All of the disks in a disk group must be cloned in hardware before run‐
       ning this command. After execution, a new disk group  is	 created  con‐
       taining the same configuration as the parent disk group. The volclonedg
       command uses the volsave and volrestore functionality to save the  con‐
       figuration  of the parent disk group (if necessary) and create the same
       configuration in the clone disk group.

       The volclonedg command attempts to start all volumes in the clone  disk
       group  and  automatically performs background recovery on mirrored vol‐
       umes in the clone disk group by default. If any plexes were detached in
       the parent disk group, they are not used for recovery in the clone disk
       group. Instead, an enabled plex is used to recover the data.

       If you specify no recovery (with the -r option),	 mirrored  volumes  in
       the  clone  disk group are put in the active state immediately, with no
       recovery taking place. In this case, if any plexes were detached in the
       parent  disk  group, they are also detached in the clone disk group, to
       avoid data integrity issues.

       To create a clone disk group on a different system from the parent disk
       group, first run the volsave command on the parent system.  The result‐
       ing  volsave  information  is  saved  in	 a  timestamped	 directory  in
       /usr/var/lsm/db,	 by  default (see volsave(8)).	Copy that directory to
       the target system, and then run the volclonedg command with the -d vol‐
       savedir option on the target system to make sure the proper description
       set is used.  See EXAMPLES.

       If the disk clones exist on the same system  or	cluster	 as  the  disk
       group to clone, you need only run the volclonedg command.

NOTES
       LSM will initially reject disk clones. You must run the volclonedg com‐
       mand to allow LSM to accept these clones and their resulting  LSM  con‐
       figuration.  Before  you	 execute the volclonedg command, the following
       warning may appear when starting LSM or running certain	LSM  commands:
       WARNING: Disk dsk10: Disk rejected as clone.

       To ascertain which disks are LSM disk clones, run the voldisk list com‐
       mand. The output from this command indicates cloned disks with a status
       of online aliased.

       If LSM has not been made aware of the cloned disks and the autoconfigu‐
       ration feature is enabled (this is the default; see  vold(8)  for  more
       information),  run  the	voldctl	 enable command before running voldisk
       list.

       You do not need to run voldctl enable before running volclonedg.

RESTRICTIONS
       You must be the root user to run this command.	You  cannot  create  a
       clone diskgroup that has the name rootdg, even if you move the hardware
       disk clones to another system and run the volclonedg  command  on  that
       system.	There  can be only one rootdg disk group on a system.  The LSM
       disk group to be cloned cannot include nopriv disks.  All the disks  in
       the  parent  disk  group	 must be cloned in hardware before you run the
       volclonedg command.

EXAMPLES
       The following examples create a clone disk group on the same system  as
       the  parent  disk  group:  Display  the	disks  in the disk group to be
       cloned: # voldisk -g dg1 list DEVICE	  TYPE	    DISK	 GROUP
       STATUS  dsk6	     sliced	disk01	      dg1	   online dsk7
       sliced	  disk02	 dg1		online	 dsk8		sliced
       disk03	      dg1	     online   dsk9	     sliced	disk04
       dg1	    online Clone the disks in hardware using  the  appropriate
       hardware	 controller commands. See your hardware documentation for more
       information.  Run the hwmgr command to make the	system	aware  of  the
       cloned disks. See hwmgr(8) for more information.

	      For this example, assume the disk clones are named dsk10, dsk11,
	      dsk12, and dsk13.	 Use the names of the disk clones to clone the
	      disk  group  dg1:	 To  create a clone of disk group dg1 with the
	      default name of dg1_clone, enter:	 #  volclonedg	-c  dg1	 dsk10
	      dsk11  dsk12  dsk13  To  create a clone of disk group dg1 with a
	      different name (for example, temp_dg), enter:  #	volclonedg  -c
	      dg1 -n temp_dg dsk10 dsk11 dsk12 dsk13

       The  following example creates a clone of disk group dg1 on a different
       system from the one hosting the parent disk group: On the  parent  disk
       group   system,	 enter:	  #   volsave	-d   /usr/tmp/volsavedir  Copy
       /usr/tmp/volsavedir from the parent disk group  system  to  the	target
       system.	Ensure that the cloned disks are accessible to the target sys‐
       tem.  On the target system, enter: # volclonedg -d  /usr/tmp/volsavedir
       -c dg1 dsk10 dsk11 dsk12 dsk13

FILES
       Specifies  the  command	path.  Specifies the default directory for the
       information saved by the volsave command.

SEE ALSO
       Commands: voldisk(8), volsave(8), volrestore(8)

       Cluster Administration, Cluster Installation, Logical Storage Manager

								 volclonedg(8)
[top]

List of man pages available for DigitalUNIX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net