bptestbpcd

bptestbpcd — test bpcd connections and verify connect options

SYNOPSIS

<admin_dir_path>bptestbpcd [-connect_options 0|1|2 0|1|2 0|1|2|3] [-host host_name] [-client client_name] [-M server] [-wait_to_close seconds] [-verbose]

On Windows systems, <admin_dir_path> is <install_path>\NetBackup\bin\admincmd\

DESCRIPTION

The bptestbpcd command tries to establish a connection from a NetBackup server to the bpcd daemon on another NetBackup system. If successful, it reports information about the sockets that are established.

The first line of output is three digits that represent the effective connect options. The first digit is 0 if reserved ports are used and 1 if non-reserved ports are used. The second digit is 0 if legacy (random port) call-back is used and 1 if vnetd call-back is used. The third digit is 1 if the connection is initiated on the vnetd port number. The third digit is 2 if the connection is initiated on the legacy bpcd port number.

The second and third lines display the following items: the NetBackup server IP address and port number, the connection direction, and the bpcd IP address and port number for the first two established sockets. If the connection is to a NetBackup client, a third socket is established. The following items appear in an additional line: the NetBackup server IP address and port number, the direction of the connection, and the bpcd IP address and port number.

OPTIONS

-connect_options 0|1|2 0|1|2|3 0|1|2|3

The first setting indicates the type of port to use to connect to bpcd on the client:

0 = Use a reserved port number.

1 = Use a nonreserved port number. If you select this option, enable Allow Nonreserved Ports for the client. See the Universal Settings dialog under Host Properties > Media Servers.

2 = Use the value that the DEFAULT_CONNECT_OPTIONS configuration entry on the server defines.

The second setting indicates the bpcd call-back method to use to connect to the client:

0 = Use the traditional call-back method.

1 = Use the vnetd no call-back method.

2 = Use the value that the DEFAULT_CONNECT_OPTIONS configuration entry on the server defines.

The third setting indicates the connection method to use to connect the client:

0 = Connect to a daemon on the client using vnetd if possible, otherwise, connect by using the traditional port number of the daemon.

1 = Connect to a daemon on the host using vnetd only.

2 = Connect to a daemon on the server by using the traditional port number of the daemon only.

3 = Use the value that the DEFAULT_CONNECT_OPTIONS configuration entry on the server defines.

If -connect_options is not specified, the configured connect options from the client database, the CONNECT_OPTIONS configuration entry, or the DEFAULT_CONNECT_OPTIONS configuration entry is used.

-client client_name

The client name of the system to connect to. If neither -host nor -client is specified, the host name of the local system is used.

-host host_name

The host name of the system to connect to. Typically, host_name is the host name of a NetBackup server. If neither -host nor -client is specified, the host name of the local system issued.

-M server

The host name of the NetBackup server that initiates the connection. If -server is specified, the host name of the local system is used.

-wait_to_close seconds

Number of seconds to wait before you close the sockets after the connection to bpcd is established. The default is 0.

-verbose

Display additional information about the bpcd host or client such as the bpcd protocol number.

EXAMPLES

EXAMPLE 1

A connection from the local system to server fred is tried by using the legacy connect options:

# bptestbpcd -host fred -connect_options 0 0 2
0 0 2
10.0.0.32:748 -> 10.0.0.59:13782
10.0.0.32:983 <- 10.0.0.59:635

EXAMPLE 2

A connection from the server fred is tried to the client wilma by using the vnetd port number if possible:

# bptestbpcd -M fred -client wilma -connect_options 2 2 0 1 1 1
10.0.0.59:40983 -> 10.0.0.104:13724
10.0.0.59:40984 -> 10.0.0.104:13724
10.0.0.59:40985 -> 10.0.0.104:13724