Name
bpdgclone — create or remove clones of Volume Manager (VxVM) volumes
SYNOPSIS
[-c] -g disk_group -n volume [-d primary_disk,secondary_disk:primary_disk_2,secondary_disk_2: primary_disk_n,secondary_disk_n] [-f output_location] [-v] [-h]
The directory path to this command is /usr/openv/netbackup/bin/
DESCRIPTION
This command operates only on UNIX systems.
bpdgclone creates temporary disk groups or clones of disks that contain the mirror image of the volume for the backups that use array-specific snapshot methods. In array-specific snapshot methods (EMC TimeFinder, Hitachi ShadowImage, HP BusinessCopy) client data is configured over a Volume Manager volume. To avoid a name conflict in the Volume Manager, bpdgclone names the temporary disk group as client_name_diskgroup_name_clone. When the backup completes, NetBackup removes the disk group clone.
During normal operation, NetBackup calls the bpdgclone command as needed. No administrator use of this command is required. If a system failure prevents NetBackup from removing the clone, use the bpdgclone command with the -c option to remove it. Then synchronize the mirror disk again with the primary disk.
Note:
If the backup completes, but the clone is not removed, subsequent backups of the client's data fail. To remove a clone, see Examples.
OPTIONS
- -g
Specifies the name of the target disk group.
- -n
Specifies the name of the target volume.
- -d
Lists the primary disks and the secondary disks. The list consists of disk pairs (primary,secondary), where the primary is separated from the secondary by a comma. If there is more than one primary disk in the target volume, colons (:) separate the additional device pairs.
- -c
Deletes the cloned disk group and volume. Note that the primary disks and the secondary disks must be resynchronized after the clone is deleted.
- -h
Prints the command usage.
- -v
Sets the verbose mode.
- -f
Specifies an output file. This file contains a list of pathnames of the primary disks over which the target volume is configured. Use this option to discover the primary disks that make up the target volume.
NOTES
The following are considerations to note when you use the bpdgclone command:
Do not remove a clone while the snapshot backup that uses that clone is still in progress. With no system failures, NetBackup removes the clone when the backup completes.
If you use the bpdgclone command to remove a left over disk clone, you must synchronize the mirror disk again with the primary disk.
Before NetBackup executes bpdgclone to create the clone, NetBackup splits the secondary disk from the primary disk.
EXAMPLES
The following example removes a clone.
/usr/openv/netbackup/bin/bpdgclone -g wil_test -n vol01 -c
where wil_test is the name of the disk group after which the clone was named. The actual clone is named clone_wil_test_clone.
For detailed assistance, see "Troubleshooting" in the NetBackup Snapshot Client Administrator's Guide.