Veritas NetBackup™ Commands Reference Guide
- Introduction
- Appendix A. NetBackup Commands
Name
bptestnetconn — test and analyze various configurations and connections
SYNOPSIS
[-v] -h | -b | -l
[-v] [-i | -frap] [-s | -H hostname]
[-v] [-c[service_name] [-o time_value] [-t time_value]] [ -H hostname | -s ] [-x]
-6 [-u]
[-v] [-w[webappname] [-O port] [-T timeout] [-e retrycount]] [-s | -H 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 bptestnetconn command performs several tasks that help you analyze DNS and connectivity problems with any specified list of hosts, including the server list in the NetBackup configuration. To help troubleshoot connectivity problems between the services that use CORBA communications, bptestnetconn can perform and report on CORBA connections to named services. The command can also perform and report the responsiveness of the NetBackup Web Service. The command also shows the connection direction, whether the communication was encrypted by a connection to the secure proxy process or not.
Logs for the bptestnetconn command are located in /usr/openv/netbackup/logs/bptestnetconn/*.log
for UNIX and Linux, and in install_path\netbackup\logs\bptestnetconn\*.log
for Windows.
OPTIONS
- -6 or --afcheck
Checks the configuration for IP_ADDRESS_FAMILY requirements.
- -a or --all
Reports all times. This option has the same effect as -fr. This condition is the default.
- -b or --confchecker
Verifies that
bp.conf
(UNIX) or the NetBackup registry entry (Windows) exists.- -c or --connect service_name
Reports the connectToObject times to service. Some CORBA service examples are EMM/EMMServer, NBFSMCLIENT/FSM.ClientClusterMgr, nbrmms/DiskPollingService.DPS nbrmms/STSEventService, and nbsvcmon/NBSvcMon (default). Type this option with no spaces between -c and service_name.
- -e or --retrycount retry_count
Specifies the number of retries that are performed in case of web service connection failures. The default value of this parameter is 5.
- -f or --flkup
Reports all forward DNS lookup times for the specified host or hosts.
- -h or --help
Displays this help message.
- -H hostname
Specifies a single host name of the system, IPv4 address, or name of a file containing a list of such names, one per line.
- -i or --ipservers
Lists the IP addresses of all servers in the NetBackup configuration.
- -l or --listservers
Lists all servers in the NetBackup configuration.
- -O or --port port_number
Specifies the web service port to which the command connects. The default web service port is the PBX port, port number 1556.
- -o or --objconntimeout time_value
Specifies the timeout in seconds for NetBackup level retries in case of CORBA errors.
- -p or --prefnet
Includes how PREFERRED_NETWORK affects connections to the specified hosts or servers in the output display.
- -r or --rlkup
Reports all reverse DNS lookup times for the specified host or hosts.
- -s or --servers
Looks up all NetBackup servers in the configuration.
- -T or --wsconntimeout time_value
Specifies the web service connection timeout in seconds. The CLIENT_CONNECT_TIMEOUT specified in the NetBackup configuration is used by default.
- -t or --orbconntimeout time_value
Specifies the TCP timeout, the socket level time out for establishing the TCP/IP connection. Specify -t larger than -o to distinguish between TCP/IP and CORBA errors. Otherwise, all failures time out after retries_timeout seconds (-o time_value).
- -u or --update
Updates the bp.conf (UNIX) or the Host Properties (Windows) based on the action of the --afcheck operation. This option is used only as part of installation.
- -v or --verbose
Reports in verbose mode. The reverse lookup report shows which servers are media servers, EMMSERVER (if not local), and if any server is also the PREFERRED_NETWORK or CLUSTERNAME.
- -w or --web webappname
Reports the web service responsiveness. The supported names for the webappname value are the default nbwmc/netbackup and nbwmc/security. Type this option with no spaces between -w and webappname.
- -x or --skipproxyinfo
Skip displaying information about the secure CORBA connection via proxy.
EXAMPLES
Example 1 - List all the servers in the NetBackup configuration.
# bptestnetconn -l knothead.example.com www.google.com r2d2.starwars.galaxy.com whoknows.what.com zebra lawndartsvm2 lawndartsvm1
Example 2 - List all the non-default settings.
# bptestnetconn -b CLIENT_PORT_WINDOW (min) = 2024 [0] CLIENT_PORT_WINDOW (max) = 4048 [0] CLIENT_CONNECT_TIMEOUT = 30 [300] SERVER_CONNECT_TIMEOUT = 10 [30] DEFAULT_CONNECT_OPTIONS (daemon port) = vnetd [Automatic] CONNECT_OPTIONS = [configured] PREFERRED_NETWORK = knothead [NULL] FIREWALL_IN = [configured] REVERSE_NAME_LOOKUP = PROHIBITED [ALLOWED]
Example 3 - Report all forward DNS lookup times for all NetBackup servers in the configuration.
# bptestnetconn -f -s ---------------------------------------------------------------------- FL: knothead.example.com -> 10.80.73.101 : 0 ms [local] FL: www.google.com -> 74.125.19.106 : 0 ms FL: r2d2.starwars.galaxy.com -> 0.0.0.0 : 4 ms FL: whoknows.what.com -> 209.139.193.224 : 0 ms [cluster/ri] FL: zebra -> 10.80.120.103 : 0 ms FL: lawndartsvm2 -> 10.80.74.153 : 0 ms FL: lawndartsvm1 -> 10.80.74.154 : 0 ms ---------------------------------------------------------------------- Slow (>5 sec) or/and failed forward lookups: r2d2.starwars.galaxy.com : 0 sec [FAILED] ---------------------------------------------------------------------- Total elapsed time: 0 sec
Example 4 - Report all reverse DNS lookup times for all NetBackup servers in the configuration.
# bptestnetconn -r -s ---------------------------------------------------------------- RL: 10.80.73.101 -> knothead.example.com : 0 ms RL: 74.125.19.106 -> nuq04s01-in-f106.1e100.net : 156 ms MISMATCH RL: **LKUP FAIL** -> r2d2.starwars.galaxy.com : 0 ms RL: 209.139.193.224 -> **LKUP FAIL** : 739 ms RL: 10.80.120.103 -> zebra.example.com : 0 ms RL: 10.80.74.153 -> lawndartsvm2.example.com : 0 ms RL: 10.80.74.154 -> lawndartsvm1.example.com : 0 ms ---------------------------------------------------------------- Slow (>5 sec) or/and failed/mismatched reverse lookups: www.google.com : 0 sec [MISMATCH] -> nuq04s01-in-f106.1e100.net r2d2.starwars.galaxy.com : 0 sec [FAILED] whoknows.what.com : 0 sec [FAILED] ---------------------------------------------------------------- Total elapsed time: 1 sec
Example 5 - Report all reverse DNS lookup times for all NetBackup servers in the configuration.
# bptestnetconn -s -c -t 10 -o 5 ------------------------------------------------------------------------ CN: knothead.example.com : 49 ms [SUCCESS] CN: www.google.com : 4 sec [TRANSIENT] CN: r2d2.starwars.galaxy.com : 4 sec [TRANSIENT] CN: whoknows.what.com : 4 sec [TRANSIENT] CN: zebra : 4 sec [TRANSIENT] CN: lawndartsvm2 : 4 sec [NO_PERMISSION] CN: lawndartsvm1 : 20 sec [TRANSIENT] --------------------------------------------------------------------- Total elapsed time: 40 sec
Example 6 - Report NetBackup Web Service responsiveness for all NetBackup servers in the configuration.
# bptestnetconn -s -w -T 30 -e 2 nbwmc/netbackup web service test for host: server.domain.com : 450 ms [SUCCESS] nbwmc/netbackup web service test for host: sample.server2.domain2.com : 800 ms [FAIL] nbwmc/netbackup web service test for host: testvm2 : 550 ms [SUCCESS]
Example 7 - Report NetBackup Web Service responsiveness for the security webapp on a specified NetBackup master server.
# bptestnetconn - wnbwmc/security -T 30 - H server.domain.com nbwmc/security web service test for host: server.domain.com : 450 ms [SUCCESS]
Example 8: Reports the Secure CORBA connection via proxy by connecting nbsl service on the example.server.domain.com
# bptestnetconn.exe -cnbsl/HSFactory -H example.server.domain.com -v adding hostname = example.server.domain.com ------------------------------------------------------------------------ Connecting to 'nbsl/HSFactory' CN: example.server.domain.com : 91 ms [SUCCESS] PBX: No VNETD: No 127.0.0.1:4667 -> 127.0.0.1:4668 PROXY 10.210.77.101:4662 -> 10.210.77.101:1556 Certificate Information: local_cert_info: { "certificate_subject_common_name": "08a1395f-81fe-40c6-af59-2631988ca076", "certificate_issuer_name": "/CN=broker/OU=root@example.server.domain.com/O=vx" } peer_cert_info: { "certificate_subject_name": "/CN=08a1395f-81fe-40c6-af59-2631988ca076/OU=NBU_HOSTS/O=vx", "certificate_subject_common_name": "08a1395f-81fe-40c6-af59-2631988ca076", "certificate_issuer_name": "/CN=broker/OU=root@example.server.domain.com/O=vx", "certificate_issuer_org_unit_name": "root@example.server.domain.com", "master_server": "example.server.domain.com", "peer_hostname": "example.server.domain.com" } ------------------------------------------------------------------------ Total elapsed time: 1 sec
Example 9: Skip secure CORBA connection information via proxy for host example.server.domain.com
# bptestnetconn -cnbsl/HSFactory -t 10 -o 5 -H example.server.domain.com - x adding hostname = example.server.domain.com ------------------------------------------------------------------------ Connecting to 'nbsl/HSFactory' CN: example.server.domain.com : 126 ms [SUCCESS] PBX: No VNETD: No ------------------------------------------------------------------------ Total elapsed time: 1 sec