nbdna

nbdna — the utility that analyzes the NetBackup domain and its configuration

SYNOPSIS

<nbu_support_dir_path>nbdna [-phase=<0|1|2>] [-verbose] [-sfo] [-server | -lookup] [-odir=override_output_directory] [-tmp=override_tmp_directory] [-dump] [-f=listfile.txt] [-overwritelist] [-version]

On Windows systems, <nbu_support_dir_path> is <install_path>\NetBackup\bin\support

DESCRIPTION

The NetBackup Domain Network Analyzer (nbdna) command utility analyzes the NetBackup domain and its configuration for network issues, performance, and behavior. It addresses hostname lookup and connectivity between NetBackup hosts and their role within the NetBackup domain.

nbdna does the following:

  • Discovers and maps the NetBackup domain

  • Extracts the hostname memberships by querying the configuration

  • Evaluates hostname lookup and socket connectivity to these hostnames to validate their network relationship status according to their domain configuration

nbdna can be run on a NetBackup master server or media server. It creates and identifies a zip archive containing all generated reports. You can return the zip archive to Symantec upon request.

OPTIONS

-dump

Does not run the test, but dumps server, client, and lookup test list to the specified file.

-f=listfile.txt

Reads the hostnames from the specified ASCII text file and adds them to the test lists. The format of the text file is the following:

SERVER hostname
CLIENT hostname-b
LOOKUP hostname-c

Lines beginning with SERVER are imported to the server test list.

Lines beginning with CLIENT are imported to the client test list.

Lines beginning with LOOKUP are imported to the lookup-only test list.

-lookup

Runs the name lookup test only. This option cannot be run with the -server option.

-odir=override_output_directory

Overrides the output directory with the specified directory.

The default directory is the following:

  • For UNIX: /usr/openv/netbackup/bin/support/output/nbdna/YYYYMMDD.HHMMSS/

  • For Windows: <install_path>\NetBackup\bin\support\output\nbdna\YYYYMMDD.HHMMSS

If the NetBackup path cannot be found, the default is changed to the same directory as the nbdna binary.

-overwritelist

Overwrites all test lists with the list file.

-phase=pn

Specifies the phase number (pn) of the test to be run.

The possible values of pn are the following:

  • 0 - Phase 0 runs the name lookup test and the socket connection test. Phase 0 is the default mode.

  • 1 - Phase 1 tests include phase 0 tests plus the basic NetBackup service test for the SERVER list.

  • 2 - Phase 2 tests include phase 0 tests plus the basic NetBackup service test for the SERVER list and the CLIENT list.

-server

Runs the server test only. This option cannot be run with the -lookup option.

-sfo

Produces script friendly reports.

-tmp=override_tmp_directory

Overrides the temporary directory. The default condition is the system temp directory.

-verbose

Displays progress to the standard out (on-screen). The same information is captured to the progress-trace log regardless of this switch. You do not need to capture verbose output to a file.

-version

Displays the version information then exits the utility.

FILES

nbdna creates up to five files:

ANONYMOUS.NBDNA.YYYYMMDD.HHMMSS.dna
hostname.NBDNA.YYYYMMDD.HHMMSS.zip archive file
hostname.NBDNA.failure-report.YYYYMMDD.HHMMSS.txt
hostname.NBDNA.failure-report.YYYYMMDD.HHMMSS.html
hostname.NBDNA.failure-errorlog.YYYYMMDD.HHMMSS.log.

The last three files that are listed are generated only if there are errors.

EXAMPLES

EXAMPLE 1

In this UNIX example, nbdna runs with report files written to an alternate directory:

# nbdna -odir=/user/home/winter/

EXAMPLE 2

In this example, nbdna is run with verbose output. It imports a hostname list file (hostnames.txt) that overwrites all the existing test lists:

# nbdna -verbose -f=hostnames.txt -overwritelist

The hostname file format is as follows:

SERVER dellpe2400
CLIENT 10.12.249.20
LOOKUP 10.82.108.136