About the bpclntcmd utility

Article:HOWTO72817  |  Created: 2012-02-13  |  Updated: 2012-11-19  |  Article URL http://www.symantec.com/docs/HOWTO72817
Article Type
How To


Environment

Subject


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 software. 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 Current 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.)


Legacy ID



v39648048_v55367249


Article URL http://www.symantec.com/docs/HOWTO72817


Terms of use for this information are found in Legal Notices