BPGETCONFIG
Section: NetBackup Commands (1M)
Updated: 2015-10-29
Index
NAME
bpgetconfig - get configuration information
SYNOPSIS
bpgetconfig -M master [-x | -X | -d | -D] [config_item ...]
bpgetconfig [-u | -h] [-x | -X | -d | -D] [config_item ...]
bpgetconfig -g server [-L | -U | -l] [-c] [-A]
bpgetconfig -s server [-L | -U | -l] [-c] [-A]
bpgetconfig -i | -e filename client [policy [schedule]]
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\
DESCRIPTION
bpgetconfig
can be used as a stand-alone program or as a helper program for the
backuptrace
and the
restoretrace
commands to obtain configuration information. This command is available for all NetBackup server platforms. It displays the configuration information of a specified server in various formats.
bpgetconfig
also retrieves general host information from a specified host server by using the
-g
or
-s
option.
You must have administrator privileges to run this command.
OPTIONS
- -A
-
Displays all available system information. The
-A
option can be used only with the
-g
or
-s
option.
- -c
-
Displays the ciphers, one per line, that are appended to the
-g
or
-s
option output. The
-c
option can be used only with the
-g
or
-s
option.
- -D | -d
-
The
-D
option returns a listing of configuration entry names, the existing configuration values in brackets, and the default configuration values in parentheses. This operation can be performed locally or remotely. The remote machine with an identical version of NetBackup is installed. The
-D
and
-d
options may be combined with the
-M,
-h, and
-u
options.
The following is a portion of a full display of all configuration items:
REQUEST_DELIVERY_TIMEOUT [300] (300)
DISABLE_SCSI_RESERVE [NO] (NO)
Time_Overlap [60] (60)
Buffer_Size [16] (16)
Use_Archive_Bit [YES] (YES)
Perform_Default_Search [YES] (YES)
Accumulate_Files [NO] (NO)
The
-d
option functions like the
-D
option, except
-d
displays only the entries that are changed from the configuration defaults. The following is an example display:
PEM_VERBOSE [-1] (0)
JM_VERBOSE [-1] (0)
RB_VERBOSE [-1] (0)
CONNECT_OPTIONS [**configured**] ()
Exclude [**configured**] ()
Browser [host1.min.vrts.com] ()
AUTHENTICATION_DOMAIN [**not configured**] ()
VXSS_NETWORK [**not configured**] ()
PREFERRED_NETWORK [**not configured**] ()
- -e filename server [class [schedule]]
-
Retrieves the
exclude_list
file from
server
and writes it to the location specified by
filename. The
policy
and
schedule
qualifiers allow the
exclude_list.policy
file and the
exclude_list.policy.schedule
to be retrieved. The files in the exclude list are excluded from being backed up.
This option applies only to UNIX.
- -g server
-
Selects the host server (server) for which the following general NetBackup information appears:
- •
-
Master or Client
- •
-
NetBackup Client Platform
- •
-
NetBackup Client Protocol Level
- •
-
Product Type
- •
-
Version Name
- •
-
Version number
- •
-
Installed Path for NetBackup Bin
- •
-
Installed OS for host server
- -h
-
Displays the default local host configuration.
- -i filename server [class [schedule]]
-
Retrieves the
include_list
file from
server
and writes it to the location specified by
filename. The
class
(policy) and
schedule
qualifiers allow the
include_list.class
file and the
include_list.class.schedule
to be retrieved. The files in the include list are the exceptions to the exclude list. They are therefore included in a backup operation.
This option applies only to UNIX.
- -L
-
Displays a long, user-readable list. The
-L
option can be used only with the
-g
or
-s
option.
- -l
-
Displays a compact, machine-readable list. The
-l
option can be used only with the
-g
or
-s
option.
- -M master
-
Specifies the master server (master) whose host configuration appears.
- -s server
-
Selects the host server (server) for which bpgetconfig outputs the following field information:
- •
-
Field 1 = Server type (master, media, or client)
- •
-
Field 2 = OS type of the specified server
- •
-
Field 3 = NetBackup client protocol level
- •
-
Field 4 = NetBackup product type (e.g., NetBackup)
- •
-
Field 5 = NetBackup version name (e.g., 7.5)
- •
-
Field 6 = NetBackup version number (e.g., 750000)
- •
-
Field 7 = Installation path to the NetBackup bin on the server
- •
-
Field 8 = Installed OS for host server
- -t
-
Displays the tier information, one item per line, that is appended to the -s option output. The
-t
option can be used only with the
-g
or
-s
option.
- -U
-
Displays a brief, user-readable list (default). The
-U
option can be used only with the
-g
or
-s
option.
- -u
-
Displays the current user configuration.
- -X
-
Lists all configuration items by default. The
-x
and
-X
options may be combined with the
-M,
-h, and
-u
options. The
-x
and
-X
options have no effect if one or more configuration items are specified on the command line.
If
config_item
is specified, it appears on the specified configuration items.
- -x
-
Excludes the items not explicitly listed in the configuration.
EXAMPLES
Example 1 - Retrieve the VERSIONINFO option setting from the bp.conf file.
# bpgetconfig VERSIONINFO
VERSIONINFO = "SunOS" "5.9" "Unknown" "NetBackup" "7.0" 700000
Example 2 - Retrieve all available system information and display a long, user-readable list.
# bpgetconfig -s hagar -A -L
Client/Master = Master
NetBackup Client Platform = Solaris9
NetBackup Client Protocol Level = 7.5
Product = NetBackup
Version Name = 7.5
Version Number = 750000
NetBackup Installation Path = /usr/openv/netbackup/bin
Client OS/Release = SunOS 5.9
Cipher =
Patch Level = 7.0
Example 3 - On a UNIX system, retrieve the file
exclude_list
from client
sun01
and write it to
sun01_exclude_list
in directory
/usr/openv/netbackup/lists.
# bpgetconfig -e /usr/openv/netbackup/lists/sun01_exclude_list sun01
SEE ALSO
bpsetconfig
nbgetconfig
nbsetconfig
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- OPTIONS
-
- EXAMPLES
-
- SEE ALSO
-