/usr/openv/netbackup/bin/bparchive [-p policy] [-s schedule][-L progress_log
[-en]] [-S master_server[,master_server,...]] [-t policy_type] [-w
[hh:mm:ss]] [-help] [-k "keyword_phrase"] -f listfile | filenames
bparchive processes files listed on the command line or in the file specified
with the -f listfile option. Any file path entered can be a file or directory
name. If the list of files includes a directory, bparchive archives all files
and subdirectories of that directory starting at the directory itself.
By default, you are returned to the system prompt after bparchive is success-
fully submitted. The command works in the background and does not return comple-
tion status directly to you. Use the -w option to change this behavior so
bparchive works in the foreground and returns completion status after a speci-
fied time period.
bparchive writes informative and error messages to a progress-log file if the
file is created. Create the file prior to running 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 /usr/openv/netbackup/logs/bparchive/ directory with public-write
access, bparchive creates a debug log file in this directory to use for trou-
In addition, if a nonroot user specifies USEMAIL = mail_address in their
$HOME/bp.conf file or a root user specifies it in the /usr/openv/net-
backup/bp.conf file, NetBackup sends mail on the archive completion status to
mail_address. This message is sent when the archive process is complete.
The following restrictions apply to this command:
· To archive a file with the bparchive command, you must be either root or
the owner and a member of the primary group (as owner) to delete the
file. Also, the file must not be read-only. Otherwise, NetBackup saves
the files but cannot reset their access time (utime) and does not delete
them from the disk.
· If you specify a UNIX file that is a link, bparchive archives only the
link itself, not the file to which it links.
· bparchive does not archive the "." or ".." directory entries, and also
does not archive disk-image backups.
-p policy Names the policy to use for the user archive. If it is not specified,
the NetBackup server uses the first policy it finds that includes the
client and a user archive schedule.
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
Note: 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
-L progress_log [-en]
Specifies the name of an existing file in which to write progress
information. 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 log in English. The name of the
log will contain the string _en. This option is useful to support per-
sonnel assisting in a distributed environment where differing locales
may create logs of various languages.
Causes NetBackup to wait for a completion status from the server
before returning you to the system prompt.
The date and time format depend on the user's locale. See NOTES.
specifying the keyword phrase with the -k option on the bprestore com-
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 (`...') to avoid conflict
with the UNIX shell.
The default keyword phrase is the null (empty) string.
Specifies a file (listfile) containing a list of files to be archived
and can be used instead of the filenames option. In listfile, place
each file path on a separate line.
The format required for the file list depends on whether the files
have spaces or newlines in the names.
To archive files that do not have spaces or newlines in the names, use
Where filepath is the path to the file you are archiving. For example:
To archive files that have spaces or newlines in the names, use this
Where filepath is the path to the file you are archiving and
filepathlen is the number of characters in the file path.
19 /home/abc/test file
filenames Names one or more files to be archived and can be used instead of the
Notice the hours:minutes:seconds requirements. These are for a locale setting of
C and can be different for other locales.
For more information on locale, see the locale(1) man page for your system.
To archive a single file, enter:
To archive files listed in a file named archive_list, enter:
bparchive -f archive_list
To associate the keyword phrase "Archive My Home Directory 02/02/02" to the
archive of the directory /home/kwc and use a progress log named
/home/kwc/arch.log enter the following (the backslash continues the command as
if it were on one line):
bparchive -k "Archive My Home Directory 02/02/02" \-L /home/kwc/arch.log
bp(1), bpbackup(1), bplist(1), bprestore(1)
Copyright (c) 2002-2005 VERITAS Software Corporation. All rights reserved.
18 Mar 2005 bparchive(1)