Netbackup: bpduplicate man page

Netbackup: bpduplicate man page

bpduplicate(1M)NAMEbpduplicate - 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]DESCRIPTIONThe 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 destination_storage_unit_label Specifies the destination storage unit. This parameter is required to 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. 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.

-st sched_type 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) NOT_ARCHIVE (all backups except user archive)

-sl sched_label Search for backups to duplicate that were created by the specified schedule. The default is all schedules.

-L output_file Specifies the name of a file in which to write progress information. The default is to not use a progress file.

-dp destination_pool_name 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 deadlock, specify a different volume pool than where the original media ID resides. The default pool name is NB_duplicates.

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

-class name Search for backups to duplicate in the specified class. The default is all classes.

-s mm/dd/yy [hh[:mm[:ss]]] 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.

-e mm/dd/yy [hh[:mm[:ss]]] 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.

-ct class_type 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 Sybase

-hoursago hours Specifies number of hours prior to the current time to search for backups. Do not use with the -s option.

-cn copy_number Determines the copy number to duplicate. Valid values are 1 or 2. The default is 1.

-M master_server 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. If the command is executed on a slave server, then the master for that slave is the default.

-backupid backup_id Specifies the backup ID of a single backup to duplicate or for which to change the primary copy.

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

-mpx 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: 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. For more information on multiplexing, see the NetBackup System Administratorrs Guide - UNIX.

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

EXAMPLESExample 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/98Example 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 1Example 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.lsFILES/usr/openv/netbackup/logs/admin/* /usr/openv/netbackup/db/images/* SEE ALSONetBackup System Administrators Guide - UNIX