bparchive [-p policy] [-s schedule][-L progress_log [-en]] [-S master_server [,master_server,...]] [-t policy_type] [-w [hh:mm:ss]] [-k "keyword_phrase"] -f listfile | filenames
On UNIX and Linux systems, the directory path to this command is /usr/openv/netbackup/bin/
bparchive processes the files that are listed on the command line or in the file that is specified by the -f listfile option. Any file path that is entered can be a file name or a directory name. If the list of files includes a directory, it archives all files and subdirectories of that directory and starts at the directory itself.
By default, you return to the system prompt after bparchive is successfully submitted. The command works in the background and does not return completion status directly to you. Use the -w option to change bparchive to work in the foreground and to return completion status after a specified time period.
bparchive writes informative and error messages to a progress-log file if the file is created. Create the file before you run the bparchive command and specify it with the -L progress_log option. If bparchive cannot archive any of the requested files or directories, use the progress log to determine the reason for the failure.
If you create a directory with write access, bparchive creates a debug log file in this directory to use for troubleshooting.
On UNIX and Linux systems, the directory is /usr/openv/netbackup/logs/bparchive/
NetBackup sends mail on the archive completion status to mail_address if USEMAIL = mail_address is entered as follows: non-administrator users specify it on the $HOME/bp.conf file; administrators specify it in the /usr/openv/netbackup/bp.conf file. This message is sent when the archive process is complete.
The following restrictions apply to this command:
0 = Standard
4 = Oracle
6 = Informix-On-BAR
7 = Sybase
10 = NetWare
13 = MS-Windows
14 = OS/2
15 = MS-SQL-Server
16 = MS-Exchange-Server
19 = NDMP
The following policy types apply only to NetBackup Enterprise Server:
11 = DataTools-SQL-BackTrack
17 = SAP
18 = DB2
20 = FlashBackup
21 = Split-Mirror
22 = AFS
39 = Enterprise-Vault
On UNIX and Linux systems, the file name must begin with /.
For example: /home/tlc/proglog.
The default is to not use a progress log.
Include the -en option to generate a progress log that is in English. The name of the log contains the string _en. This option is useful to support personnel in a distributed environment where different locales may create logs of various languages.
The required date and time values format in NetBackup commands varies according to your locale. The /user/openv/msg/.conf file (UNIX and Linux) and the install_path\VERITAS\msg\LC.CONF file (Windows) contain information such as the date-time formats for each supported locale. The files contain specific instructions on how to add or modify the list of supported locales and formats.
See the "Specifying the locale of the NetBackup installation" topic in the NetBackup Administrator's Guide, Volume II.
You can optionally specify a wait time in hours, minutes, and seconds. The maximum wait time you can specify is 23:59:59. If the wait time expires before the archive is complete, the command exits with a timeout status. The archive, however, still completes on the server.
If you use -w without specifying the wait time or if you specify a value of 0, NetBackup waits indefinitely for the completion status.
The keyword phrase is a textual description of the archive that is a maximum of 128 characters in length. All printable characters are permitted including space (" ") and period (".").
Enclose the phrase in double quotes ("...") or single quotes (oq...cq).
The default keyword phrase is the null (empty) string.
The required file list format depends on whether the files have spaces, newlines, or returns in the names. To archive the files that do not have spaces or newlines or returns in the names, use th following format:
filepathThe path to the file you want to archive. Some examples on UNIX and Linux systems are:/home, /etc, and /var. Some examples on Windows systems are: c:\Programs and c:\documents\old_memos
To archive the files that have spaces or newlines or returns in the names, use this format:
filepathlen filepathfilepath is the path to the file you want to archive and filepathlen is the number of characters in the file path.
The path to the file you want to archive. Some examples on UNIX and Linux systems are:/home, /etc, and /var. Some examples on Windows systems are: c:\Programs and c:\documents\old_memos
Examples on UNIX and Linux systems are the following:
5 /home 4 /etc 4 /var 19 /home/abc/test file
11 c:\Programs 8 c:\winnt 22 c:\documents\old memos
Example 1 - Archive a single file:
UNIX and Linux systems: bparchive /usr/user1/file1
Example 2 - Archive the files that are listed in a file that is named archive_list:
bparchive -f archive_list
Example 3 - Associate keyword phrase "Archive My Home Directory 02/02/10" to the archive of a directory named kwc and use a progress log that is named arch.log:
UNIX and Linux systems: bparchive -k "Archive My Home Directory 02/02/10" \-L/home/kwc/arch.log /home/kwc