Netbackup: bpduplicate man page

bpduplicate(1M)
NAME
bpduplicate - create a copy of backups created by Netbackup.
SYNOPSIS
/usr/openv/netbackup/bin/admincmd/bpduplicate [-dstunit
destination_storage_unit_label] [-p | -pb | -PM | -PD] [-Bidfile
file_name] [-v] [-client name] [-st sched_type] [-sl sched_label]
[-L output_file] [-dp destination_pool_name] [-shost source_host]
[-class name] [-s mm/dd/yy hh:mm:ss] [-e mm/dd/yy hh:mm:ss]
[-ct class_type] [-hoursago hours] [-cn copy_number] [-M
master_server] [-backupid backup_id] [-id media_id] [-mpx]

/usr/openv/netbackup/bin/admincmd/bpduplicate -npc
new_primary_copy -backupid backup_id [-client name]
DESCRIPTION
The bpduplicate command allows a copy of a backup to be created. The bpduplicate command can also
change the primary copy in order to enable restoring from a duplicated backup. The primary copy is used
to satisfy restore requests and is initially the original copy.
Multiplexed duplications can be created by using the -mpx option. Refer to the discussion of the -mpx
option for more information.
The duplicated backup has a separate expiration date from the original. Initially, the expiration date of the
copy is set to the expiration date of the original. You can change the expiration date of the copy or the
original by using the bpexpdate(1M) command.
Only two copies of a backup are allowed: the original copy and the duplicated copy.
For more information on duplicating backups, see the NetBackup System Administratorrs Guide - UNIX.
OPTIONS

-dstunit
Specifies the destination storage unit. This parameter is required to
destination_storage_unit_label duplicate backups. Do not specify this option to preview backups to be
duplicated (-p, -pb, -PM, or -PD options) or to change the primary copy (npc option). This option does not have a default.
-Bidfile file_name
file_name specifies a file that contains a list of backup IDs to be
duplicated. List one backup ID per line in the file. If this parameter is
specified, other selection criteria is ignored.
-p
Previews backups to be duplicated according the option settings, but
does not perform the duplication. Displays the media IDs, server name,
backups that are not candidates for duplication (and why), and
information about the backups to be duplicated.
-pb
Previews the duplication but does not perform the duplication. Similar to
the -p option, but does not display information about the backups.
-PM
Displays information on the backups to be duplicated according to the
option settings, but does not perform the duplication. This format first
displays the backup IDs that cannot be duplicated and why (for example,
because the backup already has two copies). It then displays the
following information about the backup: date and time of the backup,
class, schedule, backup ID, host, and media ID or path.
-PD
Same as the -PM option, except the backups are sorted and displayed
by date and time (newest to oldest).
-v
Selects verbose mode. When specified, the debug and progress logs
include more information.
-client name
Specifies the name of the client that produced the originals and is used
as search criteria for backups to duplicate. The default is all clients.

-st sched_type

When specified with the -npc option in order to change the primary copy,
this indicates that NetBackup will first search for the backup ID belonging
to the specified client. This is useful if the client name has changed.
Search for backups to duplicate that were created by the specified
schedule type. The default is any schedule type.
Valid values are:
FULL (full backup)
INCR (differential-incremental backup)
CINC (cumulative-incremental backup)
UBAK (user backup)
UARC (user archive)

-sl sched_label
-L output_file
-dp destination_pool_name

NOT_ARCHIVE (all backups except user archive)

Search for backups to duplicate that were created by the specified
schedule. The default is all schedules.
Specifies the name of a file in which to write progress information. The
default is to not use a progress file.
Specifies the volume pool for the duplicates. Netbackup does not verify
that the media ID selected for the duplicate copy is not the same media
ID where the original resides. Therefore, to avoid the possibility of a

-shost source_host
-class name
-s mm/dd/yy [hh[:mm[:ss]]]

-e mm/dd/yy [hh[:mm[:ss]]]

-ct class_type

deadlock, specify a different volume pool than where the original media
ID resides. The default pool name is NB_duplicates.
Specifies that only the backups created on the specified backup server
are considered for duplication. The default is to consider all backups
regardless of the backup server.
Search for backups to duplicate in the specified class. The default is all
classes.
Specifies the start of the range of dates and times that include all
backups to duplicate. The -e option specifies the end of the range. The
date and time format depend on the useres locale. For more information,
see locale(1). Default is 24 hours prior to the current date and time.
Specifies the end of the range of dates and times that include all
backups to duplicate. The -s option specifies the start of the range. The
date and time format depend on the useres locale. For more information,
see locale(1). Default is the current date and time.
Search for backups created by the specified class type. The default is
any class type.
Valid values are:
AFS
Apollo-wbak
Auspex-FastBackup
DataTools-SQL-BackTrack
DB2
FlashBackup
Informix-On-BAR
NDMP
Oracle
Macintosh
MS-Exchange-Server
MS-Windows
MS-Windows-NT
MS-SQL-Server
Netware

OS/2
SAP
Split-Mirror
Standard

-hoursago hours
-cn copy_number
-M master_server

Sybase
Specifies number of hours prior to the current time to search for
backups. Do not use with the -s option.
Determines the copy number to duplicate. Valid values are 1 or 2. The
default is 1.
Specifies the master server that manages the media database that has
the media ID. If this option is not specified, the default is one of the
following:
If the command is executed on a master server, then that server is the
default.

-backupid backup_id
-id media_id

-mpx

If the command is executed on a slave server, then the master for that
slave is the default.
Specifies the backup ID of a single backup to duplicate or for which to
change the primary copy.
Search the image database for backups to duplicate that are on this
media ID. If the original is fragmented between different media IDs,
NetBackup duplicates only the fragments that exist on the specified
media ID.
Specifies that when duplicating multiplexed backups, NetBackup will
create multiplexed backups on the destination media. This reduces the
time to duplicate multiplexed backups.
Multiplexed duplication is not supported for:
o
o
o
o

Non-multiplexed backups
Backups from disk type storage units
Backups to disk type storage units
Auspex-FastBackup, FlashBackup, or NDMP backups

If backups in the above categories are encountered during duplication,

NetBackup duplicates them first and uses non-multiplexed duplication.
Then, the multiplexed backups are duplicated by using multiplexed
duplication.
If all the backups in a multiplexed group are not duplicated, the
duplicated multiplexed group will have a different layout of fragments. (A
multiplexed group is a set of backups that were multiplexed together
during a single multiplexing session.)
If this option is not specified, all backups are duplicated using non-

multiplexed duplication.

-npc new_primary_copy

For more information on multiplexing, see the NetBackup System

Administratorrs Guide - UNIX.
Allows the primary copy to be changed. The value can be 1 or 2. The
-backupid option must be specified with this option.

EXAMPLES
Example 1
The following command (all on one line) lists backups with a copy number of 1, that were backed up by
the class named stdclass, and created between July 1, 1998, and August 1, 1998.
bpduplicate -PM -cn 1 -class stdclass -s 07/01/98 -e 08/01/98
Example 2
The following command (all on one line) duplicates copy 1 of the backups listed in file /tmp/bidfile. The
destination storage unit is unit1 and the destination pool is dup_pool. Progress information is written to
/tmp/bpdup.ls.
bpduplicate -dstunit unit1 -Bidfile /tmp/bidfile -L /tmp/bpdup.ls -dp dup_pool -cn 1
Example 3
The following command (all on one line) is the same as the prior example, except multiplexed backups
are duplicated using multiplexed duplication.
bpduplicate -dstunit unit1 -Bidfile /tmp/bidfile -mpx -L /tmp/bpdup.ls
FILES
/usr/openv/netbackup/logs/admin/*
/usr/openv/netbackup/db/images/*
SEE ALSO
NetBackup System Administrators Guide - UNIX