NetBackup™ Commands Reference Guide

Last Published:
Product(s): NetBackup & Alta Data Protection (10.1)
  1. Introduction
    1.  
      About NetBackup commands
    2.  
      Navigating multiple menu levels
    3.  
      NetBackup command conventions
    4.  
      NetBackup Media Manager command notes
    5.  
      IPV6 updates
  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.  
      bpcleanrestore
    22.  
      bpclient
    23.  
      bpclimagelist
    24.  
      bpclntcmd
    25.  
      bpclusterutil
    26.  
      bpcompatd
    27.  
      bpconfig
    28.  
      bpdbjobs
    29.  
      bpdbm
    30.  
      bpdgclone
    31.  
      bpdown
    32.  
      bpduplicate
    33.  
      bperror
    34.  
      bpexpdate
    35.  
      bpfis
    36.  
      bpflist
    37.  
      bpgetconfig
    38.  
      bpgetdebuglog
    39.  
      bpimage
    40.  
      bpimagelist
    41.  
      bpimmedia
    42.  
      bpimport
    43.  
      bpinst
    44.  
      bpkeyfile
    45.  
      bpkeyutil
    46.  
      bplabel
    47.  
      bplist
    48.  
      bpmedia
    49.  
      bpmedialist
    50.  
      bpminlicense
    51.  
      bpnbat
    52.  
      bpnbaz
    53.  
      bppficorr
    54.  
      bpplcatdrinfo
    55.  
      bpplclients
    56.  
      bppldelete
    57.  
      bpplinclude
    58.  
      bpplinfo
    59.  
      bppllist
    60.  
      bpplsched
    61.  
      bpplschedrep
    62.  
      bpplschedwin
    63.  
      bppolicynew
    64.  
      bpps
    65.  
      bprd
    66.  
      bprecover
    67.  
      bprestore
    68.  
      bpretlevel
    69.  
      bpschedule
    70.  
      bpschedulerep
    71.  
      bpsetconfig
    72.  
      bpstsinfo
    73.  
      bpstuadd
    74.  
      bpstudel
    75.  
      bpstulist
    76.  
      bpsturep
    77.  
      bptestbpcd
    78.  
      bptestnetconn
    79.  
      bptpcinfo
    80.  
      bpup
    81.  
      bpverify
    82.  
      cat_convert
    83.  
      cat_export
    84.  
      cat_import
    85.  
      configureCerts
    86.  
      configureMQ
    87.  
      configurePorts
    88.  
      configureWebServerCerts
    89.  
      create_nbdb
    90.  
      csconfig cldinstance
    91.  
      csconfig cldprovider
    92.  
      csconfig meter
    93.  
      csconfig reinitialize
    94.  
      csconfig throttle
    95.  
      duplicatetrace
    96.  
      importtrace
    97.  
      jbpSA
    98.  
      jnbSA
    99.  
      ltid
    100.  
      mklogdir
    101.  
      msdpcldutil
    102.  
      nbauditreport
    103.  
      nbcallhomeproxyconfig
    104.  
      nbcatsync
    105.  
      NBCC
    106.  
      NBCCR
    107.  
      nbcertcmd
    108.  
      nbcertupdater
    109.  
      nbcldutil
    110.  
      nbcloudrestore
    111.  
      nbcomponentupdate
    112.  
      nbcplogs
    113.  
      nbcredkeyutil
    114.  
      nbdb_admin
    115.  
      nbdb_backup
    116.  
      nbdb_move
    117.  
      nbdb_ping
    118.  
      nbdb_restore
    119.  
      nbdb_unload
    120.  
      nbdb2adutl
    121.  
      nbdbms_start_server
    122.  
      nbdbms_start_stop
    123.  
      nbdc
    124.  
      nbdecommission
    125.  
      nbdelete
    126.  
      nbdeployutil
    127.  
      nbdevconfig
    128.  
      nbdevquery
    129.  
      nbdiscover
    130.  
      nbdna
    131.  
      nbemm
    132.  
      nbemmcmd
    133.  
      nbfindfile
    134.  
      nbfirescan
    135.  
      nbfp
    136.  
      nbftadm
    137.  
      nbftconfig
    138.  
      nbgetconfig
    139.  
      nbhba
    140.  
      nbholdutil
    141.  
      nbhostidentity
    142.  
      nbhostmgmt
    143.  
      nbhypervtool
    144.  
      nbidpcmd
    145.  
      nbimageshare
    146.  
      nbinstallcmd
    147.  
      nbjm
    148.  
      nbkmiputil
    149.  
      nbkmscmd
    150.  
      nbkmsutil
    151.  
      nboraadm
    152.  
      nborair
    153.  
      nbpem
    154.  
      nbpemreq
    155.  
      nbmlb
    156.  
      nbperfchk
    157.  
      nbplupgrade
    158.  
      nbrb
    159.  
      nbrbutil
    160.  
      nbreplicate
    161.  
      nbrepo
    162.  
      nbrestorevm
    163.  
      nbseccmd
    164.  
      nbserviceusercmd
    165.  
      nbsetconfig
    166.  
      nbsmartdiag
    167.  
      nbsnapimport
    168.  
      nbsnapreplicate
    169.  
      nbsqladm
    170.  
      nbstl
    171.  
      nbstlutil
    172.  
      nbstop
    173.  
      nbsu
    174.  
      nbsvrgrp
    175.  
      netbackup_deployment_insights
    176.  
      resilient_clients
    177.  
      restoretrace
    178.  
      stopltid
    179.  
      tldd
    180.  
      tldcd
    181.  
      tpautoconf
    182.  
      tpclean
    183.  
      tpconfig
    184.  
      tpext
    185.  
      tpreq
    186.  
      tpunmount
    187.  
      verifytrace
    188.  
      vltadm
    189.  
      vltcontainers
    190.  
      vlteject
    191.  
      vltinject
    192.  
      vltoffsitemedia
    193.  
      vltopmenu
    194.  
      vltrun
    195.  
      vmadd
    196.  
      vmchange
    197.  
      vmcheckxxx
    198.  
      vmd
    199.  
      vmdelete
    200.  
      vmoprcmd
    201.  
      vmphyinv
    202.  
      vmpool
    203.  
      vmquery
    204.  
      vmrule
    205.  
      vmupdate
    206.  
      vnetd
    207.  
      vssat
    208.  
      vwcp_manage
    209.  
      vxlogcfg
    210.  
      vxlogmgr
    211.  
      vxlogview
    212.  
      W2KOption
  3.  
    Index

Name

bpclntcmd — test functionality of a NetBackup system and enable Fibre Transport services on a NetBackup client

SYNOPSIS

bpclntcmd [-sv] [-pn [-verbose]] [-self] [-hn hostname] [-server NBU_master] [-ip ip_address] [-gethostname] [-is_local_host hostname] [-is_server hostname] [-is_media_server hostname] [ -is_master_server hostname] [-is_emm_server hostname] [-get_local_client_patch_version] [-get_local_server_patch_version] [-check_vxss] [-check_vxss_with_host hostname] [-get_pbx_port hostname] [-get_remote_host_version hostname] [-refresh_use_at] [-reverse_name_lookup [allowed | restricted | prohibited]] [-sanclient [0 | 1]] [-get_fqdn hostname] [-get_local_dn] [-get_local_fqdn] [-get_local_sn] [-is_trusted_master hostname]

 

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

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

DESCRIPTION

The bpclntcmd command tests the functionality of a NetBackup system and displays information about it. It also enables and disables the Fibre Transport services on a NetBackup client.

OPTIONS

-check_vxss

Checks if NBAC is configured correctly on the local system.

-check_vxss_with_host hostname

Checks if NBAC is configured correctly on the local system to connect to the remote host hostname.

-clear_host_cache

NetBackup caches host name to IP address mappings to minimize DNS lookups. Each NetBackup process typically has its own in-memory cache and all the processes also share a cache that is stored on the file system. This option removes all the entries in the shared cache on the file system.

If host names/IP addresses have recently been updated on DNS or other host lookup services, the NetBackup caches may be out of sync for up to an hour. To ensure that NetBackup is in sync with host name changes, you can do the following: Stop NetBackup, run bpclntcmd -clear_host_cache, then restart NetBackup.

-get_fqdn hostname

Returns the fully qualified domain name for the specified hostname.

-gethostname

Returns the host name that NetBackup uses on the local system.

-get_local_client_patch_version

Returns the version of the local client patch software.

-get_local_dn

Returns the domain name of the local host.

-get_local_fqdn

Returns the fully qualified domain name of the local host.

-get_local_server_patch_version

Returns the version of the local server patch software.

-get_local_sn

Returns the short host name of the local host.

-get_pbx_port hostname

Displays the number that hostname considers the PBX port number. If hostname is not specified, the option displays the number that the local host considers the PBX port number.

-get_remote_host_version hostname

Returns the version of NetBackup that is running on the system that is identified in the hostname variable.

-hn hostname

Returns the host name, alias, and IP address information about the host name that is identified in the hostname variable.

-ip ip_address

Returns the host name, alias, and IP address information about IP address, ip_address.

-is_emm_server hostname

Checks if hostname is operating as the EMM server on the local system.

-is_local_host hostname

Checks if hostname is a network interface on the local system.

-is_master_server hostname

Checks if hostname is the master server on the local system.

-is_media_server hostname

Checks if hostname is a media server on the local system.

-is_server hostname

Checks if hostname is a master server or a media server on the local system.

-is_trusted_master hostname

Checks if hostname is a trusted master server on the local system.

-pn [-verbose]

Returns what the master server considers your host name (or peer name) to be.

Use the -verbose option to return how the master server sees the connecting host: Source IP address and port number, host name to which the IP resolves, and policy client for that host name. The - verbose option shows additional connection details including the host certificates that NetBackup uses to authenticate the hosts.

-refresh_use_at

For a NetBackup media server, queries the master server for the NetBackup Enhanced Auditing authentication setting (USE_AUTHENTICATION) and updates the local cache with said setting. By default, NetBackup updates the authentication cache setting on media servers hourly.

-reverse_name_lookup [allowed | restricted | prohibited]

Determines if NetBackup can use the reverse name lookup of the host name-IP. Use of this function can be allowed, prohibited, or restricted.

-sanclient [ 0 | 1 ]

0 - Disables the client Fibre Transport (FT) service. The command returns a NetBackup SAN client to normal client functionality.

1 - Enables the client FT service, which effectively turns a regular NetBackup client into a SAN client.

-self

Returns the information about the local system.

-server NBU_master

Returns the host name information of the NetBackup master server.

-sv

Returns the NetBackup version of the master server.

SEE ALSO

See bpnbat.