SYNOPSIS

       /usr/openv/netbackup/bin/admincmd/bpconfig [-cd seconds] [-ha hours] [-kl  days]
              [-kt  days]  [-ma  address]  [-mdtm drives]  [-mj number] [-period hours]
              [-prep hours] [-to seconds] [-max_copies 2...10] [-tries times] [-wi min-
              utes] [-v] [-M master_server,...]

       /usr/openv/netbackup/bin/admincmd/bpconfig   [-L  |  -l  |  -U]  [-v]  [-M  mas-
              ter_server,...]


DESCRIPTION

       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 should be adequate for most installations. The sec-
       tion on NetBackup Global Attributes, in  the  NetBackup  System  Administrator's
       Guide describes the implications of setting the attribute values.

             The  first  form of bpconfig modifies one or more of the NetBackup global
              configuration attributes. At least one option that  changes  a  NetBackup
              global configuration attribute must be on the command line.

             The  second  form  of  bpconfig displays the current settings of the Net-
              Backup global configuration attributes. See the section  DISPLAY  FORMATS
              for more detail on the displays.

       Errors  are  sent to stderr. A log of the command's activity is sent to the Net-
       Backup admin log file for the current day.

       This command can be executed by authorized users.  For  more  information  about
       NetBackup authorization, refer to "Enhanced Authorization and Authentication" in
       the NetBackup System Administrator's Guide.


OPTIONS

        -cd seconds
                 The number of seconds that is the Compress-image-Database time  inter-
                 val.  When  seconds is a positive integer, an image will be compressed
                 after this number of seconds has elapsed since  the  creation  of  the
                 image. On Windows NT, NetBackup uses NTFS file compression only if the
                 database is in an NTFS partition. Otherwise, it is not compressed.

                 The effect of compression is that less disk space is  needed  for  the
                 image  database. However, when browsing the image database for restor-
                 ing, the images need to be decompressed before they can  be  searched.
                 While browsing for a restore, the compressed images will not be found.
                 To decompress the images, you must use bpimage(1M).

                 The default is 0, which means no compression is done.

       -mdtm drives
                 The maximum drives for this master, the maximum number of  drives  for
                 this  master  and  remote  media server cluster that the master server
                 should consider available  when  scheduling  backups.  An  appropriate
                 lems,  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.  The default value is 24 hours.

       -kl days  The  number  of  days  to keep logs. This determines how long the Net-
                 Backup master server keeps its Error database  and  debug  logs.  Net-
                 Backup derives its Backup Status, Problems, All Log Entries, and Media
                 Log Entries reports from the Error database, so this value limits  the
                 period that these reports can cover. The default is 28 days.

       Note:     This  attribute  has  no  effect  on  remote  media servers or clients
                 (remote media servers apply only to NetBackup Enterprise Server).

       -kt days  The number of days to Keep True-image-recovery (TIR) data. This deter-
                 mines  how  long  to keep TIR information for those policies that have
                 specified that TIR information is to be collected.  The default  is  1
                 day.

       -L        The  list  type  is  long.  See  the  section DISPLAY FORMATS for more
                 detail.

       -l        The list type is short. This is the default if the command line has no
                 list-type option (for instance, if you enter "bpconfig" and a carriage
                 return). See the section DISPLAY FORMATS for more detail.

       -M master_server,...
                 A list of master servers. This is a comma-separated list of hostnames.
                 If  this  option  is present, the command is run on each of the master
                 servers in this list.  The master servers must  allow  access  by  the
                 system issuing the command.  If an error occurs for any master server,
                 processing stops at that point in the list. The default is the  master
                 server for the system where the command is entered.

       -ma address
                 The  mail  address  for the NetBackup administrator. This is the email
                 address to which NetBackup  sends  notification  of  failed  automatic
                 backups,  administrator-directed  manual  backup operations, and auto-
                 matic database backups. The default is NULL (no email address).  If no
                 address  is provided, the current setting of the Admin Mail Address is
                 cleared.  This means that notification no longer will be sent by email
                 to the NetBackup administrator.

       -max_copies 2...10
                 Specify the maximum number of copies per backup. Copies can range from
                 between 2 and 10. The default is 2.

       -mhto seconds
                 The multihosted-media-mount timeout, the length of time,  in  seconds,
                 that  NetBackup  waits  for a shared medium to be mounted, positioned,
                 and become ready on backups and restores. Use this timeout  to  elimi-
                 nate  excessive  waits  when  a shared medium is being used by another
                 server. The default is 0,  which  means  no  timeout  (unlimited  wait

       Note:     This attribute does not apply to user-directed backups and archives.

       -prep hours
                 The  preprocessing interval. This is the minimum time in hours between
                 client queries to discover new paths if NetBackup is  using  auto-dis-
                 cover-streaming mode. For additional information, see the "Setting the
                 Preprocess Interval for Auto Discovery" section in the topic on  File-
                 List  Directives  for  Multiple  Data  Streams in the NetBackup System
                 Administrator's Guide.  The default Preprocessing Interval value is  4
                 hours.   If  the  preprocessing interval is changed, it can be changed
                 back to the default by specifying -prep -1.

                 The preprocessing interval can be set for immediate  preprocessing  by
                 specifying  0  as  the  preprocess  interval for auto discovery on the
                 bpconfig command line.

                 The maximum Preprocessing Interval is 48 hours.

       -to seconds
                 This is the media-mount timeout, the length of time, in seconds,  that
                 NetBackup waits for the requested media to be mounted, positioned, and
                 become ready on backups and restores. Use this  timeout  to  eliminate
                 excessive  waits  when  it  is  necessary to manually mount media (for
                 example, when robotic media is out of the robot  or  off  site).   The
                 default is 0, which means no timeout (unlimited wait time). If seconds
                 is not 0, its value must be 300 (5 minutes) or greater.

       -tries times
                 The number of retries for a backup, during the configured time  period
                 (see  -period).  NetBackup  tries  to  run  a  backup  job for a given
                 client/policy/schedule combination this many times in  the  configured
                 period.  This allows you to limit the number of backup attempts should
                 repeated failures occur.

       Note:     This attribute does not apply to user-directed backups and archives.

                 Usually the number of tries should be greater than 0. Specifying 0 for
                 the  number  of  tries  is  legal but stops all scheduled backups. The
                 default is 2 tries. If defaults are used for both -tries and  -period,
                 NetBackup will attempt the backup 2 times in 12 hours.

       -U        The  list  type  is  user.   See  the section DISPLAY FORMATS for more
                 detail.

       -v        Select verbose mode for logging. This is only meaningful when  running
                 with  debug  logging  turned  on  (the /usr/openv/netbackup/logs/admin
                 directory is defined).

       -wi minutes
                 This is the wakeup Interval, the length in time in  minutes  that  the
                 scheduler waits before checking if any automatic backups are scheduled
                 to begin. A long wakeup interval can cause the scheduler to  miss  too

              Admin Mail Address

              Wakeup Interval

              Max Simultaneous Jobs/Client

              Backup Tries (x tries in y hours)

              Keep Error/Debug Logs

              Max drives this master

              Keep TrueImageRecovery Info

              Compress Image DB Files

              Maximum Backup Copies

              Media Mount Timeout

              Display Reports

              Preprocess Interval

             Long Format (-L)

       If  the  command  line contains -L, the display format is long. This option pro-
       duces a listing with one  global  attribute  per  line,  in  the  format  global
       attribute descriptor: value. The fields in this display are as follows:

              Mail Admin

              Wakeup Interval

              Max Jobs/Client

              Backup Tries (x in y hours)

              Keep Logs

              Max drives/master

              Compress DB Files

              Maximum Backup Copies

              Media Mnt Timeout

              Postprocess Image

              Display Reports

              NetBackup administrator email address

              Wakeup interval (minutes)

              Time period (hours)

              Maximum simultaneous jobs per client

              Tries per period

              Keep logs (days)

              Maximum drives this master

              Compress image database interval (seconds; 0 denotes no compression)

              Media mount timeout (seconds; 0 denotes unlimited)

              Multihosted-media-mount timeout (seconds; 0 denotes unlimited)

              Postprocess images flag (0 denotes deferred, otherwise immediate)

              Display reports from <x> hours ago (hours)

              Keep TIR information (days)

              Preprocessing interval (hours)

             Example of How the Formats Differ

       Here is an example of how the display formats differ. bpconfig runs with each of
       the three display formats on a  NetBackup  installation.  The  NetBackup  global
       attributes are the same for the three displays.

       The first display format, -U, looks like this:

              bpconfig -U
              Admin Mail Address:
              Wakeup Interval:              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 Image DB Files:      (not enabled)
              Media Mount Timeout:          0 minutes (unlimited)
              Display Reports:              24 hours ago
              Preprocess Interval:          0 hours
              Maximum Backup Copies:    10

              The second display format, -L, looks like this:
              Maximum Backup Copies: 10

              The third display format, -l, looks like this:

              bpconfig -l
              *NULL* 1 12 1 2 28 0 0 0 0 1 24 1 0

              The display fields for the -l display are interpreted as follows:

              NetBackup administrator email address has not been set

              Wakeup interval is 1 minute

              Time period is 12 hours

              Maximum simultaneous jobs per client is 1

              Tries per period is 2

              Keep logs for 28 days

              Maximum drives this master is 0

              Compress image database interval is 0 seconds; 0 denotes no compression

              Media mount timeout is 0seconds; 0 denotes unlimited

              Multihosted-media-mount timeout is 0 seconds; 0 denotes unlimited

              Postprocess images flag is 1 (immediate)

              Display reports from 24 hours ago

              Keep TIR information for 1 day

              Preprocessing interval is 0 hours


RETURN VALUES

       An exit status of 0 means that the command ran successfully.

       Any exit status other than 0 means that an error occurred.

       If  administrative logging is enabled, the exit status is logged in the adminis-
       trative daily log under the  directory  /usr/openv/netbackup/logs/admin  in  the
       form:

              bpconfig: EXIT status = exit status

       If an error occurred, a diagnostic precedes this message.


EXAMPLES

       Example 1
              Media Mount Timeout:          30 minutes
              Display Reports:              24 hours ago
              Preprocess Interval:          0 hours
              Maximum Backup Copies:      10

       Example 2

       Set the Compress-image-database interval to 604800 seconds,  so  that  NetBackup
       compresses images more than 7 days old:

              bpconfig -cd 604800
              bpconfig -U

              Admin Mail Address:
              Wakeup Interval:              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 Image DB Files:      older than 7 day(s)
              Media Mount Timeout:          0 minutes (unlimited)
              Display Reports:              24 hours ago
              Preprocess Interval:          0 hours
              Maximum Backup Copies:         10

       Example 3

       Set the Media Mount Timeout to 1800 seconds.

              bpconfig -to 1800
              bpconfig -U

              Admin Mail Address:           sasquatch@wapati.edu
              Wakeup Interval:              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
              Maximum Backup Copies:         10


FILES

       /usr/openv/netbackup/logs/admin/*

       /usr/openv/netbackup/db/config/behavior


SEE ALSO