Veritas NetBackup™ Commands Reference Guide
- Introduction
- Appendix A. NetBackup Commands
Name
bptestbpcd — test bpcd connections and verify connect options
SYNOPSIS
[-host hostname] [-client client_name] [-M server] [-connect_options 0|1|2 0|1|2 0|1|2|3] [-connect_timeout seconds [-wait_to_close seconds] [-verbose]
On UNIX systems, the directory path to this command is /usr/openv/netbackup/bin/admincmd/
On Windows systems, the directory path to this command 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 consists of 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 you use legacy (random port) callback and 1 if you use
vnetd
callback.The third digit is 1 if the connection is initiated on the PBX or
vnetd
port number. The third digit is 2 if the connection is initiated on the legacy bpcd port number.
The remaining lines display the following items: the NetBackup server IP address and port number, the connection direction, 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 source port to use when you connect to bpcd on the host or client. If you use the traditional callback method, this setting also designates the type of server port on which to listen for the inbound connection.
0 = Use a reserved port number.
1 = Use a nonreserved port number.
2 = Use the value defined by the DEFAULT_CONNECT_OPTIONS configuration entry on the server.
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 host or client:
0 = Connect to the host or client through the PBX port (1556). If unsuccessful, connect through the vnetd port (13724). If still unsuccessful, connect through the daemon port (13782).
1 = Connect to the host or client through the PBX port (1556). If unsuccessful, connect through the vnetd port (13724). If still unsuccessful, fail the connection attempt.
2 = Connect to the host or client through the daemon port (13782).
3 = Use the value that the DEFAULT_CONNECT_OPTIONS configuration entry on the server defines.
If -connect_options is not specified for -client, any CONNECT_OPTIONS configured in the Client Attributes for clientname are used. Otherwise, any CONNECT_OPTIONS for clientname are used. Otherwise, the DEFAULT_CONNECT_OPTIONS are used.
- -client client_name
The client name of the system to connect to. This creates the same legacy connections to bpcd that would normally be used when connecting to a NetBackup client for a multiplex backup. If neither -host nor -client is specified, the host name of the local system is used.
- -connect_timeout seconds
Specifies the number of seconds to wait for a connection attempt from the server to the host or client to fail. If not specified, the default is the CLIENT_CONNECT_TIMEOUT that is configured on the server that tries to make the connection.
- -host hostname
Specifies the host name of the system to connect to. Typically, hostname is the host name of a NetBackup server. This creates the same legacy connections to bpcd that would normally be used when connecting to a NetBackup server. If neither -host nor -client is specified, the host name of the local system is used.
- -M server
Specifies the host name of the NetBackup server that initiates the connections to the target host or client. If this option is not specified, the local host makes the connections. If it is specified, the local host connects to bpcd on the specified server, which then connects to bpcd on the target host or client.
- -wait_to_close seconds
Specifies the number of seconds that the server waits before it closes the connections to bpcd on the target host or client. The default is 0 (no waiting).
- -verbose
After successfully connecting to bpcd on the target host or client, request and display key configuration information from the remote host. This information can include the hostname, client name, master server, peername for the connecting server, operating system, and NetBackup version.
EXAMPLES
Example 1 - Try to connect from the local system to server fred 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 - Request the server fred to connect to the host wilma as a client by using the daemon port and no-call-back method. If successful, display the key configuration from wilma:
$ bptestbpcd -M fred -client wilma -connect_options 1 1 2 -verbose 1 1 2 10.0.0.59:36207 -> 10.0.0.104:13782 10.0.0.59:1556 <- 10.0.0.104:32829 PEER_NAME = fred HOST_NAME = wilma CLIENT_NAME = wilma VERSION = 0x07100000 PLATFORM = solaris10 PATCH_VERSION = 7.1.0.0 SERVER_PATCH_VERSION = 7.1.0.0 MASTER_SERVER = wilma EMM_SERVER = wilma NB_MACHINE_TYPE = MASTER_SERVER 10.0.0.59:1556 <- 10.0.0.104:32830