bpdbm — run NetBackup database manager daemon


<nbu_dir_path>bpdbm [consistency [-move]] [converti2] [ctime timestamp] [-terminate] [-alive] [-verbose -logqueries -wakeup minutes]

On Windows systems, <nbu_dir_path> is <install_path>\NetBackup\bin\


bpdbm responds to the queries that are related to the NetBackup internal databases (catalogs). bpdbm must be running for NetBackup commands and utilities to work properly. This daemon runs only on the master server and can be started only by the administrator. The NetBackup request daemon (bprd) or the following script starts bpdbm:

On UNIX and Linux: /usr/openv/netbackup/bin/initbpdbm

On Windows: install_path\NetBackup\bin\initbpdbm

When bpdbm starts, the following sequence occurs in the order listed:

  • It logs a message that indicates that it has started and verifies that no other instances are running. If another process is found, the program terminates.

  • bpdbm finds its port number by checking the services file for an entry with a service name of bpdbm and a protocol name of tcp. For example:

    bpdbm 13721/tcp
  • bpdbm starts to respond to queries from bprd and the NetBackup administrative utilities. A child process is created to respond to each query.



Sends a query to bpdbm to determine if the bpdbm service is up.

-consistency [0-2]

Runs the consistency checks on the catalog. The following are the three consistency levels:

0 - A quick check of the NetBackup image database (the default).

1 - Performs more checks than the default check.

2 - The most in-depth consistency check. In addition to the level 0 and 1 checks, this level checks that the media that is mentioned in the image exists. (That is, it cross-references the media servers databases.) On a large NetBackup installation, the process takes much longer to complete than the other checks.


Converts the old catalogs that were created by using the old directory name scheme without the time-stamp subdirectories for each client to the new scheme. Use caution on this operation and make sure that a valid catalog backup is in hand and ready to use to recover the catalog.

-ctime timestamp

Converts a UNIX timestamp to human-readable form.


Causes bpdbm to log each bpdbm query to the file BPDBMqueries of the tmp directory. Each query has an entry at the start of the log of the form:

date_stamp process_id  query type

And one at the end of the query of the form:

date_stamp process_id  query type  status status

Where date_stamp is a 10-digit integer, process_id is the identifier for the process that runs the query, type is an integer that identifies the type of query, and status is the status returned by the query.


Terminates bpdbm. Any currently running child process continues to run until its task is complete.

-verbose -logqueries

Causes bpdbm to operate at verbose level 1 if it is configured to run in bp.conf at verbose level 0 and creates the bpdbm log directory and file.

-wakeup minutes

Overrides the default timeout interval (in minutes) that bpdbm uses when it establishes the initial connection on the port. Used on UNIX and Linux systems only.


On UNIX or Linux systems:


On Windows systems:



bpadm, bprd