SYNOPSIS
/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
DESCRIPTION
bparchive processes files listed on the command line or in the file
that is specified with 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, bparchive archives all files and subdirectories
of that directory. It starts at the directory itself.
By default, you return to the system prompt after bparchive is success-
fully 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 /usr/openv/netbackup/logs/bparchive/ directory with
public-write access, bparchive creates a debug log file in this direc-
tory to use for troubleshooting.
In addition, NetBackup sends mail on the archive completion status to
mail_address if USEMAIL = mail_address . It is entered as follows: non-
root users specify it on their $HOME/bp.conf file; root users 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:
· To archive a file with bparchive , you must be the root or the
owner and a member of the primary group (as owner) to delete.
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. It
also does not archive disk-image backups.
OPTIONS
-p policy Names the policy to use for the user archive. If it is not
specified, the NetBackup server uses the first policy it
Specifies one of the following numbers that corresponds to
the policy type. The default for Windows clients is 13. For
Netware clients the default is 10. The default for all others
is 0:
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 Note that 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 not to use a progress log.
Include the -en option to generate a log in English. The name
of the log contains the string _en. This option is useful to
support personnel in a distributed environment where differ-
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.
-help Prints a command line usage message when -help is the only
option on the command line.
-k keyword_phrase
Specifies a keyword phrase that NetBackup associates with
the image created by this archive operation. You then can
restore the image by specifying the keyword phrase with the
-k option on the bprestore command.
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.
-f listfile
Specifies a file (listfile) that contains 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 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:
filepath
Where filepath is the path to the file you want to archive.
For example:
/home
/etc
/var
To archive the files that have spaces or newlines or returns
in the names, use this format:
filepathlen filepath
instead of the -f option.
Any files that you specify must be listed at the end, after
all other options.
NOTES
The required date and time values format in NetBackup commands varies
according to the locale setting.
If you are uncertain of the NetBackup command requirements for your
locale, enter the command with the -help option and check the usage.
The following is part of the bparchive usage statement output that
shows the -w option:
[-w [hh:mm:ss]]
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.
EXAMPLES
Example 1
Archive a single file:
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/06" to the
archive of directory /home/kwc and use a progress log that is named
/home/kwc/arch.log:
bparchive -k "Archive My Home Directory 02/02/06" \-L
/home/kwc/arch.log /home/kwc
18 Mar 2005 bparchive(1)