Search <book_title>...

Veritas NetBackup™ 8.0 Troubleshooting Guide

Last Published: 2017-07-13

Product(s): NetBackup (8.0)

About the bpclntcmd utility

The bpclntcmd utility resolves IP addresses into host names and host names into IP addresses. It uses the same system calls as the NetBackup application modules. The following directory contains the command that starts the utility:

Windows	install_path\NetBackup\bin
UNIX	/usr/openv/netbackup/bin

On Windows, run this bpclntcmd command in an MS-DOS command window so you can see the results.

The bpclntcmd options that are useful for testing the functionality of the host name and IP address resolution are -ip, -hn, -sv, and -pn. The following topics explain each of these options:

-ip	bpclntcmd -ip IP_Address The -ip option lets you specify an IP address. bpclntcmd uses gethostbyaddr() on the NetBackup node and gethostbyaddr() returns the host name with the IP address as defined in the following: the node's DNS, WINS, NIS, or local hosts file entries. No connection is established with the NetBackup server.
-hn	bpclntcmd -hn Hostname The -hn option specifies a host name. bpclntcmd uses gethostbyname() on the NetBackup node to obtain the IP address that is associated with the host name defined in the following: the node's DNS, WINS, NIS, or local hosts file entries. No connection is established with the NetBackup server.
-sv	bpclntcmd -sv The -sv option displays the NetBackup version number on the master server.
-pn	When the -pn option is run on a NetBackup client, it initiates an inquiry to the NetBackup master server. The server then returns information to the requesting client. First, the server is the first server in the server list. Then it displays the information that the server returns. For example: bpclntcmd -pn expecting response from server rabbit.friendlyanimals.com dove.friendlyanimals.com dove 123.145.167.3 57141 The following is true of this command example: expecting response from server rabbit.friendlyanimals.com is the master server entry from the server list on the client. dove.friendlyanimals.com is the connection name (peer name) returned by the master server. The master server obtained this name through gethostbyaddress(). dove is the client name configured in the NetBackup policy client list. 123.145.167.3 is the IP address of the client connection at the master server. 57141 is the port number of the connection on the client.

Use -ip and -hn to verify the ability of a NetBackup node to resolve the IP addresses and host names of other NetBackup nodes.

For example, to verify that a NetBackup server can connect to a client, do the following:

On the NetBackup server, use bpclntcmd -hn to verify the following: The operating system can resolve the host name of the NetBackup client (as configured in the client list for the policy) to an IP address. The IP address is then used in the node's routing tables to route a network message from the NetBackup server.
On the NetBackup client, use bpclntcmd -ip to verify that the operating system can resolve the IP address of the NetBackup server. (The IP address is in the message that arrives at the client's network interface.)

Note:

The bpclntcmd command logs messages to the usr/openv/netbackup/logs/bpclntcmd directory (UNIX) or the install_path\NetBackup\logs\bpclntcmd (Windows). For earlier versions of NetBackup, bpclntcmd logs are sent to the bplist directory, not the bpclntcmd directory.