/usr/openv/netbackup/bin/bpbackup [-p policy] [-s schedule] [-S mas-
ter_server...] [-t policy_type] [-L progress_log [-en]] [-w [hh:mm:ss]]
[-help] [-k "keyword_phrase"] -f listfile | filenames
/usr/openv/netbackup/bin/bpbackup -i [-p policy] [-h hostname] [-s schedule] [-S
master_server...] [-t policy_type] [-L progress_log [-en]] [-w
[hh:mm:ss]] [-k "keyword_phrase"]
/usr/openv/netbackup/bin/bpbackup -dssu DSSUname
bpbackup starts either of the following processes:
Using the first form of the command above, bpbackup starts a user backup that is
the equivalent to what is performed by using the interface on the client. This
type of backup can be started from any NetBackup client in order to back up
files from that client.
The bpbackup command processes the files that you list on the command line or in
the file that you specify with the -f listfile option. A file path can be a file
or directory name. If the named files include a directory, bpbackup backs up all
files and subdirectories of that directory starting at the directory itself.
On master servers
Using the second form of the command shown above, bpbackup starts an immediate-
manual backup of a client. This variation requires the -i option on the bpbackup
command and is available only to the administrator on the master server. It is
the equivalent of starting a manual backup from the NetBackup administrator's
interface. Use the -h option to specify the host.
Since progress logs are written only on clients, and since this form of the
bpbackup command is run from the master server only, the -L option is undefined.
The following restrictions apply to this command:
· You must be the owner of the file or an administrator to back up a file
· You can back up files and directories owned by other users if you have
the necessary permissions.
· If you specify a UNIX file that is a link, bpbackup backs up only the
link itself, not the file to which it links.
· bpbackup does not back up the "." or ".." directory entries.
By default, you are returned to the system prompt after bpbackup is successfully
submitted. The command works in the background and does not return completion
$HOME/bp.conf file or a root user specifies it in the /usr/openv/net-
backup/bp.conf file, NetBackup sends mail on the backup completion status to
mail_address. This message is sent when the backup process is complete.
-p policy Names the policy to use for the backup.
If this option is not specified for a user backup, NetBackup uses the
first policy it finds that includes the client and a user backup
The -p option is required for an immediate-manual backup (-i option).
-i Starts an immediate-manual backup. This is the equivalent of starting
a manual backup from the NetBackup administrator interface. You must
be the administrator on the master server to use the -i option.
NetBackup starts an immediate running of the schedule associated with
the disk staging storage unit. The -i option is the implied behavior
and therfore is not necessary.
It names the client host on which to run the backup. If it is not
specified, NetBackup runs the backup on all clients in the policy.
Names the schedule to use for the backup. If it is not specified, the
NetBackup server uses the first user backup schedule it finds for the
client in the policy it is using (see the -p option).
-S master_server [,master_server,...]
Specifies the name(s) of the NetBackup master server(s). The default
is the first SERVER entry found in the /usr/openv/netbackup/bp.conf
Specifies one of the following numbers corresponding to the policy
type. The default for Windows clients is 13,for Netware clients the
default is 10, and the default for all others is 0:
0 = Standard
4 = Oracle
6 = Informix-On-BAR
7 = Sybase
10 = NetWare
13 = MS-Windows
18 = DB2
20 = FlashBackup
21 = Split-Mirror
22 = AFS
-L progress_log [-en]
Specifies the name of a file in which to write progress information.
NetBackup creates the file if it doesn't exist.
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.
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 backup is complete, the command exits with a time-
out status. The backup, however, still completes on the server.
The bpbackup -w option causes the shell to wait for a return code.
The operating system shell can only return one return code. Therefore,
if you use -w without specifying a wait time or you specify a value of
0, NetBackup waits indefinitely for the completion status.
It is possible to start a manual or administrative backup using
bpbackup -i along with the -w function. This type of backup has the
potential to start multiple jobs because it is based on policy
attributes. If the manual backup starts multiple jobs, the -w func-
tion will still only return one return code to the shell.
If you use the -i with the -w option and more than one job begins,
NetBackup waits until all of the jobs have completed before returning
a status. However, because only one status code will be returned to
the shell, it is unknown which jobid the status code belongs to.
If the multiple jobs are due to there being more than one client and
the policy does not have Allow Multiple Data Streams selected, you can
include the -h option to restrict the operation to one client and
between the keyword phrase and the backup policy and image.
The keyword phrase is a textual description of the backup 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 backed
up. This option can be used instead of the filenames option, but can-
not be used with the -i option. List each file on a separate line.
The format required for the file list depends on whether the files
have spaces or newlines in the names.
To back up files that do not have spaces or newlines in the names, use
Where filepath is the path to the file you are backing up. For exam-
To back up files that have spaces or newlines in the names, use this
Where filepath is the path to the file you are backing up and
filepathlen is the number of characters in the file path.
19 /home/abc/test file
filenames Names one or more files to be backed up. This option can be used
instead of the -f option, but cannot be used with the -i option. Any
C and may be different for other locales.
For more information on locale, see the locale(1) man page for your system.
To perform a user backup of a single file, enter:
The following command starts a user backup of the files that are listed in a
file named backup_list.
bpbackup -f backup_list
The following command (all on one line) starts an immediate-manual backup of the
client host named diablo, in the policy named cis_co. The policy type is Stan-
dard policy and is in the configuration on the master server named hoss.
bpbackup -p cis_co -i -h diablo -S hoss -t 0
The following command (all on one line, or using the backslash continuation
character) associates the keyword phrase "Backup My Home Directory 01/01/01" to
the user backup of the directory /home/kwc. The progress log is:
bpbackup -k \
"Backup My Home Directory 01/01/01" -L /home/kwc/bkup.log /home/kwc
The following command (all on one line) associates the keyword phrase "Policy
Win 01/01/01" to the immediate-manual backup of the client host named slater in
the policy named win_nt_policy.
bpbackup -k "Policy Win 01/01/01" -i -h slater \
-p win_nt_policy -t 13