bpdbm

bpdbm — run NetBackup database manager daemon

SYNOPSIS

<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\

DESCRIPTION

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.

OPTIONS

-alive

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.

-converti2

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.

-logqueries

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.

-terminate

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.

FILES

On UNIX or Linux systems:

/usr/openv/netbackup/db/*
/usr/openv/netbackup/bp.conf
/usr/openv/netbackup/logs/bpdbm/*
/usr/openv/netbackup/bin/initbpdbm

On Windows systems:

install_path\NetBackup\db\*
install_path\NetBackup\logs\bpdbm\*

SEE ALSO

bpadm, bprd