Shell Commands › Volume Management › copy (Volume Management)--Copy a Volume

copy (Volume Management)--Copy a Volume

Copy a volume.

Syntax

volume copy <src>[%<spar>] <dst>[%<dpar>] [comment=<val> | --stripcomment] [mirrored=<val>] [size=<val>] [fs_options=<val>] [--use-filer] [--fscpy [--prefill]] [ -n ] [--overwrite [--force]]  

Options

<src>

Name of the existing volume to copy. May specify any volume

<spar>

Specifies the partition/logical volume to copy from (for example, '%parN[.parN]'). By default, a block level copy is done, leaving any additional space on the destination partition unused. If --fscpy is used, a filesystem level copy is done, in this case the filesystem will be created with the full size of the destination partition/volume and the fs_options property will be honored when creating the fs. If the source volume has no partition table, this property should not be specified to copy of the whole volume.

<dst>

Name of the new copied volume. Must specify an application user or singleton class volume or global volume

<dpar>

Specifies the partition/logical volume to copy to (for example, '%parN[.parN]'). To copy the source to the whole destination volume (instead of a partition), this property should be left blank.

comment=<val>

Comment that is to be set for the destination volume

--stripcomment

Set the comment for the destination volume to empty.

mirrored=<val>

Set to 1 for mirrored volume.

size=<val>

Specify size for new volume. If not specified, the destination volume is created with the same size as the source volume. Units may be specified(for example, 128M[B], 2G[B]). If units are not specified, it is assumed that the size is in MB.

fs_options=<val>

File system-specific options. Only valid if --fscpy argument is specified.

--use-filer

If the copy operation can be done as a block level copy and this option is specified, do the block level copy in the filer instead of on the controller. This can be used for partitioned or unpartitioned volumes.

--fscpy

Perform filesystem level copy when copying the volume. If this option is not specified, block-level copy is performed.

--prefill

Allocate ALL blocks for new volume. This option is only valid if --fscpy is specified; otherwise it is ignored.

--overwrite

Overwrite destination volume if it exists

--force

Do not prompt for confirmation of overwrite

-n

Skip verification that volume reference is in the class descriptor if destination volume is an application singleton class volume.

Notes:

• When the ctl_blk_cpy parameter in applogic.conf file is set to 0, block level copies are performed using a Linux Filer. When either it is not present, or it is set to 1, the block level copy operations are performed using Controller. Default is 1.
• Only grid maintainers may copy a volume to a global read-only volume (that is, _GLOBAL_RO:<volume>) When copying partitions as opposed to whole volumes, only one partition/lvm logical volume can be copied at a time.
• Size cannot be used if any of the src or dst is used, or the source volume is partitioned (use vol resize instead)
• No changes are done to the partitioning table of the destination volume.
• If %<dpar> is specified and %<spar> is omitted, the source volume must be an unpartitioned volume
• The value specified for the fs_options parameter is filesystem specific.
• The following are the options available for each supported filesystem:

  ext2 | ext3 | swap | reiserfs

  <any option> - Any option understood by mkfs.<filesystem>. The options will be passed directly to the mkfs tool for the chosen filesystem.

  ext3-snapshot

  vol_group_name - String specifying the name of the LVM volume group to create on the volume. If not specified, a volume group name is randomly generated.

  data_percentage - Percentage of the volume that is used to store data, remaining portion of the volume is for snapshots. If not specified, 80% of the volume is used for data.

  <any option> - Any option understood by mkfs.ext3. The options will be passed directly to the mkfs tool and will be used for the data volume.

  zfs

  pool_name - The name of the pool - defaults to volume name if this is not set.

  mountpoint - Mount path of the pool root (or "legacy" or "none", that is, mountpoint=legacy). Defaults to /pool_name.

  autoreplace - On/off - Controls automatic device replacement. Defaults to off.

  delegation - On/off - Controls whether a non-privileged user is granted access based on the dataset permissions defined on the dataset. -Defaults to on.

  failmode - Wait/continue/panic. Defaults to wait.

  version - 1-10 - Defaults to 10 (current).

  ntfs, ntfs03, ntfs08

  volume_label - The volume label for the dst volume. If empty, the vol_name property value is used instead.

  active - Create the new partition as active (bootable). Valid values are yes and no. If omitted, the default value of no is used during format while the value defaults to the src volume type during fscopy

Examples

volume copy my-app:data my-app:data2

Copy application user volume. The volume may be partitioned or unpartitioned.

volume copy my-app:data my-app:data2 --fscpy

Copy application user volume using filesystem level copy. (The operation will fail if any of the partitions are not supported by the Filer.)

volume copy /system:MYSQL5.boot my-app:DBASE.boot -n

Copy global catalog class volume.

volume copy my-app:DBASE.boot my-app2:DBASE.boot

Copy application singleton class volume.

volume copy my-app:data1%par3.par1 my-app:data2%par3.par1

Copy logical partition 1 of extended partition 3 of a volume to logical partition 1 of extended partition 3 of another volume. Volume data2 must exist and have a partitioning table that has extended partition 3 with logical partition 1 in it that is large enough to fit the source partition.

volume copy my-app:data1%par3.par1.home my-app:data2

Copy lvm logical volume "home" (on the first logical partition of extended partition 3) to a separate unpartitioned volume. If the destination volume exists, --overwrite can be used to replace it.

volume copy my-app:data1 my-app:data2%par2 --fscpy

Copy an unpartitioned volume as partition 2 on the destination volume, doing filesystem copy and using all of the space on the destination partition.