bpconfig [-cd seconds] [-ha hours] [-kl days] [-kt days] [-ma [address]] [-sto seconds] [-mj number] [-period hours] [-prep hours] [-to seconds] [cleanup_int hours] [cleanup_wait minutes] [-tries times] [-wi minutes] [-pui minutes] [-v] [-M master_server,...]
bpconfig [-L | -l | -U [-v] [-M master_server,...]]
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\
The bpconfig command modifies or displays the NetBackup global configuration attributes. These attributes affect operations for all policies and clients. With the exception of the NetBackup administrator's email address, the default values for these attributes are adequate for most installations.
See "About specifying the locale of the NetBackup installation" in the NetBackup Administrator's Guide, Volume II.
For implications of setting the attribute values, see NetBackup Global Attributes in the NetBackup Administrator's Guide, Volume I.
The following describes the two forms of bpconfig:
Errors are sent to stderr. A log of the command activity is sent to the NetBackup admin log file for the current day.
Use the bpimage command to decompress the images.
This option appears in the output display as Image DB Cleanup Interval (see examples).
This value is used to calculate the time range for general reports and media reports. General reports include Backup Status, Client Backups, Problems, and All Log Entries. Media reports include Media List, Media Summary, Media Contents, Images on Media, and Media Log Entries.
Hours Ago is a positive integer in the range of 1 to 32767. The default value is 24 (hours).
NetBackup derives its Backup Status, Problems, All Log Entries, and Media Log Entries reports from the Error database.
This value limits the period that these reports can cover. The range of values is 1 to 24855. The default is 28 days. A value of zero (0) turns logs off.
If no address is provided, the current setting of the Admin Mail Address is cleared. Notification is not sent by email to the NetBackup administrator.
The default Preprocess Interval value is four (4) hours. If the preprocessing interval changes, change it back to the default by specifying -prep -1. The preprocessing interval can be set to preprocess immediately by specifying 0 as the preprocess interval for auto discovery on the bpconfig command line. The maximum Preprocessing Interval is 48 hours.
For more information, see the NetBackup Administrator's Guide, Volume I.
For more details about multihosted drives, see the NetBackup Administrator's Guide, Volume I.
The default is 0, which means no timeout (unlimited wait time). If seconds is not 0, its value range is 1 to 32,767 seconds.
On UNIX systems: /usr/openv/netbackup/logs/admin
On Windows systems: install_path\NetBackup\logs\admin
bpconfig uses the following three different formats to display the current values of the NetBackup global configuration attributes:
The NetBackup graphical user interface uses this display format. This option produces a list with one global attribute per line. Each line has the form global attribute descriptor: value. This list is similar to the -L format, except that the global attribute descriptors are more explicit.
The following is an example of the user display format:
# bpconfig -U
Admin Mail Address:
Job Retry Delay: 1 minutes
Max Simultaneous Jobs/Client: 1
Backup Tries: 2 time(s) in 12 hour(s)
Keep Error/Debug Logs: 28 days
Max drives this master: 0
Keep TrueImageRecovery Info: 1 days
Compress DB Files: (not enabled)
Media Mount Timeout: 0 minutes (unlimited)
Display Reports: 24 hours ago
Preprocess Interval: 0 hours
Image DB Cleanup Interval: 12 hours
Image DB Cleanup Wait Time: 60 minutes
Policy Update Interval: 10 minutes
If the command line contains -L, the display format is long. This option produces a list with one global attribute per line, in the format global attribute descriptor: value. The fields are as follows:
The following example shows the long format:
# bpconfig -L
Mail Admin: *NULL*
Job Retry Delay: 1 minutes
Max Jobs/Client: 1
Backup Tries: 2 in 12 hours
Keep Logs: 28 days
Max drives/master: 0
Compress DB Files: (not enabled)
Media Int Timeout: 0 minutes (unlimited)
Display Reports: 24 hours ago
Keep TIR Info: 1 days
Prep Interval: 0 hours
DB Clean Interval: 12 hours
DB Clean Wait Time: 60 minutes
Policy Update Interval:10 minutes
If the bpconfig command line contains -l or contains no list-format option, the display format is short, which produces a terse listing. This option is useful for the scripts or the programs that rework the list into a customized report format. The list layout is a single line that contains the values for all global attributes. The time units follow the attributes in parentheses for the attributes that are expressed in units of time. The attributes appear in the following order with blanks between them:
The following is an example of the short format:
# bpconfig -l
*NULL* 1 12 1 2 28 0 0 0 0 1 24 1 0 2 10 60
The display fields for the
-l
display are interpreted as follows:
An exit status of zero (0) means that the command ran successfully. Any exit status other than zero (0) means that an error occurred.
If the administrative log function is enabled, the exit status is logged in the administrative daily log under the log directory:
Windows: install_path\NetBackup\logs\admin
UNIX: /usr/openv/netbackup/logs/admin
It has the following form:
bpconfig: EXIT status = exit status
If an error occurred, a diagnostic precedes this message.
Example 1 - While the master server kiwi runs, display the global attribute settings on the master server plim:
# bpconfig -U -M plim Admin Mail Address: ichabod@null.null.com Job Retry Delay: 10 minutes Max Simultaneous Jobs/Client: 1 Backup Tries: 1 time(s) in 8 hour(s) Keep Error/Debug Logs: 6 days Max drives this master: 0 Keep TrueImageRecovery Info: 1 days Compress DB Files: (not enabled) Media Mount Timeout: 30 minutes Display Reports: 24 hours ago Preprocess Interval: 0 hours Image DB Cleanup Interval: 12 hours Image DB Cleanup Wait Time: 60 minutes Policy Update Interval: 10 minutes
Example 2 - Set the Compress Catalog Interval to 604800 seconds, so that NetBackup compresses images more than seven days old:
# bpconfig -cd 604800 #bpconfig -U Admin Mail Address: *NULL* Job Retry Delay: 10 minutes Max Simultaneous Jobs/Client: 1 Backup Tries: 2 time(s) in 12 hour(s) Keep Error/Debug Logs: 28 days Max drives this master: 0 Keep TrueImageRecovery Info: 2 days Compress DB Files: older than 7 day(s) Media Mount Timeout: 0 minutes (unlimited) Display Reports: 24 hours ago Preprocess Interval: 0 hours Image DB Cleanup Interval: 12 hours Image DB Cleanup Wait Time: 60 minutes Policy Update Interval: 10 minutes
Example 3 - Set the Media Mount Timeout to 1800 seconds.
# bpconfig -to 1800 # bpconfig -U Admin Mail Address: sasquatch@wapati.edu Job Retry Delay: 10 minutes Max Simultaneous Jobs/Client: 1 Backup Tries: 1 time(s) in 12 hour(s) Keep Error/Debug Logs: 3 days Max drives this master: 0 Keep TrueImageRecovery Info: 24 days Compress Image DB Files: (not enabled) Media Mount Timeout: 30 minutes Display Reports: 24 hours ago Preprocess Interval: 0 hours Image DB Cleanup Interval: 12 hours Policy Update Interval: 10 minutes
UNIX systems:
/usr/openv/netbackup/logs/admin/* /usr/openv/netbackup/db/config/behavior
Windows systems:
install_path\NetBackup\db\config\behavior install_path\NetBackup\logs\admin\*
bpimage