Veritas NetBackup™ Commands Reference Guide
- Introduction
- Appendix A. NetBackup Commands
Name
nbreplicate — initiate replication on a storage device
SYNOPSIS
-backupid backup_id -Bidfile file_name -cn copy_number -rcn replicate_copy_number -slp_name policy_name [-altreadhost hostname] [-priority number] [-v] [-target_sts target_sts] [-target_user target_sts_username] [-target_pwd target_sts_password]
On UNIX systems, the directory path to this command is /usr/openv/netbackup/bin/admincmd/
On Windows systems, the directory path to this command is <install_path>\NetBackup\bin\admincmd\
DESCRIPTION
The nbreplicate command allows a copy of a backup to be replicated to a NetBackup storage device in another domain. To duplicate an image in the same NetBackup domain, please see bpduplicate.
The nbreplicate command creates a copy of a specified backup based on the configuration on the supported replication targets of the storage server. This command is part of the automated Storage Lifecycle Policy (SLP) process of Remote Master Replication operations.
This command is not intended to circumvent normal NBSTSERV processing for Storage Lifecycle Policy controlled images. This command exists to redo previously successful replications. It is distinctly different from bpduplicate.
This command can be run only on the master server.
OPTIONS
- -altreadhost hostname
Specify an alternate host from which to read the media. The default condition is that bpreplicate reads the source media from the host that performed the backup.
- -backupid backup_id
Specifies the backup ID of a single backup to replicate or for which you can change the primary copy.
- -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 are ignored.
Also, file_name is removed during the execution of that command line interface (CLI) because the NetBackup GUIs commonly use this parameter. They expect the command-line interface to remove the temporary file that was used for the -Bidfile option upon completion. Direct command-line interface users can also use the option; however, it removes the file.
- -cn copy_number
Determines the copy number to duplicate. Valid values are 1 through 10. The default is 1.
-primary means to search or duplicate the primary copy.
- -priority number
Sets a backup policy to run at a lesser or a higher priority than disk staging duplication.
- -target_pwd target_sts_password
Specifies the target storage server password if credentials are required to access the device.
- -target_sts target_sts
Specifies the target storage server to receive a copy of the replicated backup.
- -target_user target_sts_username
Specifies the target storage server user name if credentials are required to access the device.
- -rcn replicate_copy_number
Specifies the copy number of the replication copy. The copy number is the operation index value of the storage lifecycle policy replication operation plus 100.
-primary means to search or duplicate the primary copy.
- -slp_name policy_name
Specifies the SLP name of the duplicated file.
- -v
Selects the verbose mode. When you specify the debug logs or progress logs, it includes more information.
EXAMPLE
Re-replicate an image according to the SLP parameters of an image that was previously successfully replicated, but needs to be replicated again due to disaster recovery.
# nbreplicate -backupid bu789 -rcn 102 -cn 1 -priority 0 -slp_name slp1
FILES
UNIX systems:
/usr/openv/netbackup/logs/admin/* /usr/openv/netbackup/db/images/*
Windows systems:
install_path\NetBackup\db\images\* install_path\NetBackup\logs\admin\*
SEE ALSO
See bpduplicate.