Veritas NetBackup™ Commands Reference Guide

Last Published:
Product(s): NetBackup (8.0)
  1. Introduction
    1.  
      About NetBackup commands
    2.  
      Navigating multiple menu levels
    3.  
      NetBackup command conventions
    4.  
      NetBackup Media Manager command notes
  2. Appendix A. NetBackup Commands
    1.  
      acsd
    2.  
      add_media_server_on_clients
    3.  
      backupdbtrace
    4.  
      backuptrace
    5.  
      bmrc
    6.  
      bmrconfig
    7.  
      bmrepadm
    8.  
      bmrprep
    9.  
      bmrs
    10.  
      bmrsrtadm
    11.  
      bp
    12.  
      bparchive
    13.  
      bpbackup
    14.  
      bpbackupdb
    15.  
      bpcatarc
    16.  
      bpcatlist
    17.  
      bpcatres
    18.  
      bpcatrm
    19.  
      bpcd
    20.  
      bpchangeprimary
    21.  
      bpclient
    22.  
      bpclimagelist
    23.  
      bpclntcmd
    24.  
      bpclusterutil
    25.  
      bpcompatd
    26.  
      bpconfig
    27.  
      bpdbjobs
    28.  
      bpdbm
    29.  
      bpdgclone
    30.  
      bpdown
    31.  
      bpduplicate
    32.  
      bperror
    33.  
      bpexpdate
    34.  
      bpfis
    35.  
      bpflist
    36.  
      bpgetconfig
    37.  
      bpgetdebuglog
    38.  
      bpimage
    39.  
      bpimagelist
    40.  
      bpimmedia
    41.  
      bpimport
    42.  
      bpinst
    43.  
      bpkeyfile
    44.  
      bpkeyutil
    45.  
      bplabel
    46.  
      bplist
    47.  
      bpmedia
    48.  
      bpmedialist
    49.  
      bpminlicense
    50.  
      bpnbat
    51.  
      bpnbaz
    52.  
      bppficorr
    53.  
      bpplcatdrinfo
    54.  
      bpplclients
    55.  
      bppldelete
    56.  
      bpplinclude
    57.  
      bpplinfo
    58.  
      bppllist
    59.  
      bpplsched
    60.  
      bpplschedrep
    61.  
      bppolicynew
    62.  
      bpps
    63.  
      bprd
    64.  
      bprecover
    65.  
      bprestore
    66.  
      bpretlevel
    67.  
      bpschedule
    68.  
      bpschedulerep
    69.  
      bpsetconfig
    70.  
      bpstsinfo
    71.  
      bpstuadd
    72.  
      bpstudel
    73.  
      bpstulist
    74.  
      bpsturep
    75.  
      bptestbpcd
    76.  
      bptestnetconn
    77.  
      bptpcinfo
    78.  
      bpup
    79.  
      bpverify
    80.  
      cat_convert
    81.  
      cat_export
    82.  
      cat_import
    83.  
      configurePorts
    84.  
      create_nbdb
    85.  
      csconfig
    86.  
      duplicatetrace
    87.  
      importtrace
    88.  
      jbpSA
    89.  
      jnbSA
    90.  
      ltid
    91.  
      mklogdir
    92.  
      nbauditreport
    93.  
      nbcatsync
    94.  
      NBCC
    95.  
      NBCCR
    96.  
      nbcertcmd
    97.  
      nbcertupdater
    98.  
      nbcomponentupdate
    99.  
      nbcplogs
    100.  
      nbdb_admin
    101.  
      nbdb_backup
    102.  
      nbdb_move
    103.  
      nbdb_ping
    104.  
      nbdb_restore
    105.  
      nbdb_unload
    106.  
      nbdbms_start_server
    107.  
      nbdbms_start_stop
    108.  
      nbdc
    109.  
      nbdecommission
    110.  
      nbdelete
    111.  
      nbdeployutil
    112.  
      nbdevconfig
    113.  
      nbdevquery
    114.  
      nbdiscover
    115.  
      nbdna
    116.  
      nbemm
    117.  
      nbemmcmd
    118.  
      nbexecute
    119.  
      nbfindfile
    120.  
      nbfirescan
    121.  
      nbftadm
    122.  
      nbftconfig
    123.  
      nbgetconfig
    124.  
      nbhba
    125.  
      nbholdutil
    126.  
      nbhypervtool
    127.  
      nbjm
    128.  
      nbkmsutil
    129.  
      nboraadm
    130.  
      nbpem
    131.  
      nbpemreq
    132.  
      nbperfchk
    133.  
      nbplupgrade
    134.  
      nbrb
    135.  
      nbrbutil
    136.  
      nbregopsc
    137.  
      nbreplicate
    138.  
      nbrestorevm
    139.  
      nbseccmd
    140.  
      nbsetconfig
    141.  
      nbsnapimport
    142.  
      nbsnapreplicate
    143.  
      nbsqladm
    144.  
      nbstl
    145.  
      nbstlutil
    146.  
      nbsu
    147.  
      nbsvrgrp
    148.  
      resilient_clients
    149.  
      restoretrace
    150.  
      stopltid
    151.  
      tl4d
    152.  
      tl8d
    153.  
      tl8cd
    154.  
      tldd
    155.  
      tldcd
    156.  
      tlhd
    157.  
      tlhcd
    158.  
      tlmd
    159.  
      tpautoconf
    160.  
      tpclean
    161.  
      tpconfig
    162.  
      tpext
    163.  
      tpreq
    164.  
      tpunmount
    165.  
      verifytrace
    166.  
      vltadm
    167.  
      vltcontainers
    168.  
      vlteject
    169.  
      vltinject
    170.  
      vltoffsitemedia
    171.  
      vltopmenu
    172.  
      vltrun
    173.  
      vmadd
    174.  
      vmchange
    175.  
      vmcheckxxx
    176.  
      vmd
    177.  
      vmdelete
    178.  
      vmoprcmd
    179.  
      vmphyinv
    180.  
      vmpool
    181.  
      vmquery
    182.  
      vmrule
    183.  
      vmupdate
    184.  
      vnetd
    185.  
      vxlogcfg
    186.  
      vxlogmgr
    187.  
      vxlogview
    188.  
      W2KOption

Name

nbdb_admin — start or stop individual databases and change default password

SYNOPSIS

nbdb_admin -dba new_password [-dbn NBDB | NBAZDB] [-backup directory]

nbdb_admin -start | stop [database_name]

nbdb_admin [-vxdbms_nb_data directory] [-vxdbms_nb_staging directory] [-vxdbms_nbdb_backup_owner y|n] [-vxdbms_nb_server servername | EMMSERVER] [-auto_start NONE | NBDB | BMRDB | NBAZDB]

nbdb_admin -adjust_server_settings [database_name]

nbdb_admin -enable_request_logging [-persistent] [-duration minutes] [-logfile filename]

nbdb_admin -disable_request_logging

nbdb_admin -analyze_request_log -logfile filename

nbdb_admin -list

nbdb_admin -reorganize [database_name]

nbdb_admin -validate [database_name] [-full]

 

On UNIX systems, the directory path to this command is /usr/openv/db/bin/

On Windows systems, the directory path to this command is <install_path>\NetBackup\bin\

DESCRIPTION

The nbdb_admin command can be used to start or stop the NetBackup database (NBDB), the NetBackup Authorization database (NBAZDB), or the Bare Metal Restore database (BMRDB).

The nbdb_admin command line utility can also be used to enable the customer to change the DBA and application passwords. The DBA and application passwords are encrypted and stored in the vxdbms.conf file. The permissions on the file enable the root user on UNIX or a Windows administrator to read or write it.

During installation, a randomly generated password is created for the NBDB, NBAZDB, and BMRDB databases for all DBA and application accounts. The same password is used for the NBDB and the BMRDB DBA and application accounts such as EMM_MAIN. A different randomly generated password is created for the NBAZDB database.

This command can enable and disable a request logging tool that is used to troubleshoot NetBackup database performance issues at the highest SyBase database logging level. Use request logging for a problem that has an active support case. An analyze_request_log option reads the request log that the NBDB generates and performs some basic log analysis. Because of the excessive resource usage and general overhead, we do not recommend that you use this tool in a production environment.

OPTIONS

-adjust_server_settings directory

Adjusts the settings of the given database directory through the Sybase utility. If no database is specified, the default is to adjust all databases.

-analyze_request_log

Reads the request log generated by the NetBackup database and does some basic analysis. This procedure can cause excessive resource utilization and is not recommended for use on a production environment. Request logging for NBDB may be useful only if the customer is experiencing NBDB performance issues and has an active support case.

-auto_start NONE | NBDB | BMRDB | NBAZDB

Sets which databases are automatically started when the database server is started. You can specify the NetBackup database (NBDB), the BMR database (BMRDB), or the NetBackup Authorization database (NBAZDB). The database daemon must be stopped and restarted to take effect. Or you can choose not to start any of the databases by using NONE.

-dba new_password [-backup directory], -dba new_password [-dbn NBDB | NBAZDB] [-backup directory]

Changes the existing password for the NBDB and the BMRDB databases for all DBA and application accounts if -dbn is not specified or if -dbn NBDB is specified. It changes the existing password for the NBAZDB database if the -dbn NBAZDB option is specified. The NBAZDB database password is different than the password for the NBDB and the BMRDB databases and application accounts. The password must be an ASCII string. Non-ASCII characters are not allowed in the password string

If the -backup option is used, the new password is saved in the specified directory with the file name nbdbinfo.dat. Otherwise, it is saved under the default location with the same file name.

Note:

If the password is set to the old default password (nbusql), it is reset to a randomly generated password at the next NetBackup upgrade.

This action is also true for the NBAZDB password which is reset to a different randomly generated password. If the NBAZDB password is the same as the NBDB password, the NBAZDB password is reset to a randomly generated password at the next NetBackup upgrade.

This action will require a restart of the NetBackup Web Management Console service.

-disable_request_logging

Deactivates request logging and removes any request log settings from the server.conf file. Any change in server.conf requires that you restart the NetBackup relational database service.

-duration minutes

Disable request logging after the specified time in minutes. Specify 0 to manually disable later.

-enable_request_logging

Activates request level logging for NBDB at the maximum level for troubleshooting. The overhead of request logging may affect performance and is not recommended for regular use. Request logging for NBDB may be useful only if the customer is experiencing NBDB performance issues and has an active support case.

-list

Lists all database files.

-logfile filename

Specifies the absolute path to the log file for NBDB to use. If this option is not present, the absolute path is generated at the default location.

-persistent

Saves the request logging settings to the server.conf file so that request logging continues after the NetBackup relational database service (NBDB) is restarted.

-reorganize database_name

Reorganizes the given database through the Sybase utility. If no database is specified, the default is to reorganize all databases.

-start | -stop database_name

Starts or stops the database that is identified in the database_name field. You can specify the NBDB database or the BMRDB database. The database_name field is optional. The NBDB database is the default for this command.

Note:

Before you take the database offline with the -stop option, stop all services that are running except SQL Anywhere.

-validate database_name [-full]

Validates the indexes and keys on all of the tables in the specified database. If no database name is specified, the option validates all the databases. It scans each table and checks that each row exists in the appropriate indexes. The number of rows in the table must match the number of entries in the index.

The -full option performs a full validation of the database or databases. It ensures that every row that is referenced in each index exists in the corresponding table. For foreign key indexes, it also ensures that the corresponding row exists in the primary table.

The validation checks do not require that all NetBackup activity be suspended. However, the checks may report any transient errors that are a result of transactions that are in progress.

-vxdbms_nb_data directory

This command updates the VXDBMS_NB_DATA parameter that is stored in the bp.conf file on UNIX systems and in the registry on Windows systems. This parameter contains the main location of the NBDB and the BMRDB databases.

-vxdbms_nbdb_backup_owner y|n

This command updates the VXDMS_NBDB_BACKUP_OWNER parameter in the bp.conf file on UNIX systems and in the registry on Windows systems. This command specifies if the master server owns the backup of the databases that are included in the catalog backup. The default for this parameter is yes.

-vxdbms_nb_server servername | EMMSERVER

Changes the database server name to the given servername or EMMSERVER from bp.conf file.

-vxdbms_nb_staging directory

Changes the staging directory from the default to the specified directory. This option saves the information in the vxdbms.conf file.

SEE ALSO

See nbdb_backup.

See nbdb_move.

See nbdb_ping.

See nbdb_restore.

See nbdb_unload.