nbsu

nbsu — run the NetBackup Support Utility

SYNOPSIS

<nbu_support_dir_path>nbsu [-c] [-d diag] [-debug] [-g group_name] [-h] [-H] [-i] [-l] [-L] [-mm_e ###] [-nbu_down] [-nbu_e ###] [-no_nbu] [-nozip] [-r host_role] [-s name] [-t] [-v] [-xml]

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

DESCRIPTION

The nbsu command is a Symantec utility that gathers a wide range of diagnostic information. With no command line options, nbsu runs all diagnostic commands that are appropriate for the following: OS platform, OS version, NetBackup host roll, and NetBackup version.

By default, nbsu gathers the appropriate diagnostic information that is based on the operating system and NetBackup environment. Several command line options allow the diagnostic information that is gathered to be "tuned" as desired.

If necessary, create a bundled support package. nbsu creates the following nbsu and output directories:

/usr/openv/netbackup/bin/support/nbsu
/usr/openv/netbackup/bin/support/output/nbsu

PREREQUISITES

The following items are needed before you can use the nbsu command:

nbsu is designed for use with NetBackup version 3.4 and greater.
For nbsu to create a support package (if required), the path to the tar and gzip programs must be included in the %PATH% environment variable. If these programs are not available, nbsu creates a single XML formatted output file.
The appropriate services or daemons must be running in the master server and media server environments.

PROGRAM USAGE

Consider the following items when you program using the nbsu command:

With no command line options, nbsu selects all appropriate diagnostics to run and to gather information for.
To view a list of the diagnostic commands that nbsu selects, run nbsu with the -l command line option.
Use the appropriate command line options for the following items:
- Individual diagnostic commands
- Groups of related diagnostic commands
- Configuration or troubleshooting related diagnostic commands
- NetBackup or Media Manager exit status-related diagnostic commands
To omit individual diagnostic commands or groups of related diagnostic commands, use the -s command line option.

OPTIONS

-c

Runs only NBU configuration-related commands or procedures. This option is the default condition.

-d diag

Runs only the diagnostic command or procedure listed. For a list of diagnostic commands or procedures, run nbsu with the -l command line option. Multiple -d options may appear in the list. For example:

Windows systems: -d OS_general -d OS_set

-debug

Runs nbsu in debug mode. Debug mode places additional program information into the file.

-g group_name

Runs only the diagnostic commands or procedures that are related to the group name. Diagnostic groups are "OS", "DEV", "NET", "NBU", and "MM". Multiple -g options may be listed. For example:

-g OS -g DEV

-h

Displays the terse nbsu command-line help information.

-H

Displays the full nbsu command-line help information.

-i

Interactive mode. Used to log on as a NetBackup security administrator.

-l

Lists the diagnostic commands to be selected to run. Use with other command line options to display the appropriate diagnostic commands or procedures.

-L

Lists all of the nbsu 1.0 diagnostics and commands. Can be used to output a detailed report of each diagnostic to STDOUT. Includes the selection criteria and commands to be executed.

-mm_e ###

Runs only the diagnostic commands or procedures that are related to the Media Manager exit status. Multiple -mm_e options may be listed. For example:

-mm_e 12 -mm_e 20

-nbu_down

Runs only the diagnostic commands or procedures that do not make use of NetBackup or Media Manager commands. This command line option selects DEV, NET, and OS diagnostics and a subset of NBU and MM diagnostics.

-nbu_e ###

Runs only the diagnostic commands or procedures that are related to the NetBackup exit status. Multiple -nbu_e options may be listed. For example:

-nbu_e 25 -nbu_e 41

-no_nbu

Runs only DEV, NET, and OS related diagnostics.

-nozip

Specifies that the output files are not to be compressed.

-r host_role

Runs only the diagnostic commands or procedures that are related to the NetBackup host role. The following are the accepted host role parameter abbreviations:

ma = Master server

me = Media server

d_me = Disk media server

t_me = Tape media server

cl = Client

emm = EMM server

gdm = Global Domain Manager

rah = Remote Administration Host

Multiple -r options may be listed. For example:

-r ma -r cl

-s name

Skips the diagnostic command, procedure, or group listed. For a list of diagnostic commands or procedures, run nbsu with the -l command line option. Diagnostic groups are OS, DEV, NET, NBU, and MM. Multiple -s options may be listed. For example:

-s OS_general -s DEV

-t

Runs only the diagnostic commands or procedures that are related to the NetBackup troubleshooting.

-v

Outputs the internal version of nbsu.

-xml

Outputs all nbsu output into a single XML formatted file.

EXAMPLES

EXAMPLE 1: List the diagnostics to be selected to run on a NetBackup node:

	# ./nbsu -l

EXAMPLE 2: Select an individual diagnostic command to run; do not compress the resulting support bundle:

	# ./nbsu -d NBU_version -nozip

EXAMPLE 3: Select the network group of diagnostics to run, but skip the NET_dd diagnostic:

	# ./nbsu -g NET -s NET_dd

EXAMPLE 4: Select the diagnostics that are associated with the NetBackup exit status code 41:

	# ./nbsu -nbu_e 41

EXAMPLE 5: List the diagnostics that would be selected to run for the network diagnostic groups and operating system diagnostic groups on a NetBackup node:

	# ./nbsu -l -g NET -g OS

EXAMPLE 6: Select an individual diagnostic command to run and to not zip the resulting support bundle:

	# ./nbsu -d NBU_version -nozip

EXAMPLE 7: Select the network and operating system groups of diagnostics to run, but skip the NET_dd diagnostic:

	# ./nbsu -g NET -s NET_dd -g OS

EXAMPLE 8: Select the diagnostics that are associated with the NetBackup exit status codes 21, 25, and 41:

	# ./nbsu -nbu_e 21 -nbu_e 25 -nbu_e 41