DOCUMENTATION AND DOWNLOAD: NetBackup Support Utility (NBSU) 1.7 - Usage and Examples for 7.x and previous versions

Article:TECH160944  |  Created: 2011-05-26  |  Updated: 2013-10-24  |  Article URL http://www.symantec.com/docs/TECH160944
Article Type
Technical Solution

Product(s)

Environment

Subject

Issue



nbsu 1.7 README June 18, 2013
Requirement: None
Co-requirement: None
Directives:
==================================================================
The Symantec nbsu utility that gathers diagnostic information
on a NetBackup server or client.
The nbsu 1.7 release provides enhancements and fixes to previous versions of nbsu.
==================================================================


Solution



=================

DEPENDENCIES
=================

I. NEW FEATURES AND PLATFORM PROLIFERATIONS
II. KNOWN ISSUES
III. DOWNLOAD INSTRUCTIONS
IV. INSTALLATION INSTRUCTIONS
V. UNINSTALL INSTRUCTIONS
VI. RELEASE CONTENT
Conventions
Current Release Update


-------------------------------------------------------------------------
The following information describes the upgrade and downgrade rules or
scenarios that apply to this utility.

- Upgrade scenarios:
The nbsu 1.7 utility:
- Should be applied to all NetBackup servers and clients.
- Is compatible with NetBackup versions 3.X, 4.X, 5.X, 6.X and 7.X
- Can be run in environments where nbsu has been previously run.

- Downgrade scenarios:
None.


============================================
I. NEW FEATURES AND PLATFORM PROLIFERATIONS
============================================
This section describes the new UNIX and Windows features and platform
proliferations that are being released in nbsu 1.7. The following lists
provide brief descriptions of the new features and enhancements.

Platform Proliferations:
------------------------

+ Solaris 11

+ Mac OS X for i386


New Features and Enhancements:
------------------------------
The nbsu 1.7 release contains the following new features and enhancements.

+ Added the -q and --quiet command line options to suppress STDOUT output
from nbsu.

+ Added the -odir command line option to allow the designation of a
directory for nbsu to place its output information.

+ Updated nbsu to recognize when it is being run on a NetBackup appliance
and collect various pieces of information specific to a NetBackup
appliance.

=================
II. KNOWN ISSUES
=================
This section contains known issues with this release.


==========================
III. DOWNLOAD INSTRUCTIONS
==========================
Save a copy of the existing nbsu binary before installing.

Download the correct nbsu platform binary into the
appropriate director on the client:

/usr/openv/netbackup/bin/support

or

<NetBackup install path>\NetBackup\bin\support


=============================
IV. INSTALLATION INSTRUCTIONS
=============================
Save a copy of the existing nbsu binary before installing.

Place the correct platform binary of nbsu in the
appropriate directory:

/usr/openv/netbackup/bin/support/

or

<NetBackup install path>\NetBackup\bin\support\


nbsu is self-documenting piece of software. Once installed, use
the -H option to obtain a details set of nbsu instructions and
usage examples, as follows:

# nbsu -H


=========================
V. UNINSTALL INSTRUCTIONS
=========================
Revert to the saved copy of the existing nbsu binary, or completely
remove nbsu from the appropriate directory:

/usr/openv/netbackup/bin/support

or

<NetBackup install path>\NetBackup\bin\support


===================
VI. RELEASE CONTENT
===================
This section contains the Release Update conventions, content, and
historical content that is applicable to the release.

Conventions:
------------
The following list describes the conventions used in the subsections that
following this section. Each item listed in the Current Release Update
subsection describes a feature, enhancement, or issue fixed with this
Release Update.

Description
Describes a particular enhancement or correction contained in this
Release Update.


Current Release Update
----------------------
Each item listed in this section describes a feature, enhancement, or change
that comprises this Release Update. Please read this section thoroughly to
understand the contents of this update.

----------------------------------------------------------------------------
Etrack Incident = ET1437611

Description:
Altered the MM_tpautoconf diagnostic procedure to also run the
following command and parse for ACS hosts:

bpstulist -L

If ACS hosts are found, the following command runs for each
ACS host:

tpautoconf -report_disc -acs_host <hostname>
----------------------------------------------------------------------------
Etrack Incident = ET2207341, ET3097715 and ET3145811

Description:
Added the NBU_bptestnetconn diagnostic. The behavior of this
diagnostic is dependent on the version of NetBackup that nbsu is being
run on.

If you use NetBackup 6.5.6 or greater OR NetBackup 7.0 or greater AND the
file /usr/openv/netbackup/bin/bptestnetconn exists and is an executable,
the following commands are run:

/usr/openv/netbackup/bin/bptestnetconn -bv
/usr/openv/netbackup/bin/bptestnetconn -frap -v -s
/usr/openv/netbackup/bin/bptestnetconn -v -a -s -cnbrmms/STSEventService

If NetBackup you use 7.1 or greater, the following commands are also run:

/usr/openv/netbackup/bin/bptestnetconn -a -s -p -c -v6 -t 20
/usr/openv/netbackup/bin/bptestnetconn -v -fra -s
/usr/openv/netbackup/bin/bptestnetconn -v -fra -s -c -o 15 -t 30
----------------------------------------------------------------------------
Etrack Incident = ET2595823

Description:
Ported nbsu to 64-bit for the Solaris x86 platform.
----------------------------------------------------------------------------
Etrack Incident = ET2644794

Description:
Updated nbsu for Solaris 11 support.
----------------------------------------------------------------------------
Etrack Incident = ET2654244

Description:
On AIX, corrected an issue in the OS_resource diagnostic procedure,
updating the syntax to the "sar" command.
----------------------------------------------------------------------------
Etrack Incident = ET2668606 and ET2669898

Description:
Fixed the Mac OS X version of nbsu. Changes made for nbsu 1.5 were
inadvertently missed in 1.6, resulting in Perl run-time errors.
----------------------------------------------------------------------------
Etrack Incident = ET2668781

Description:
Fixed an issue where the NetBackup version was not displayed in the
nbsu_info.txt file when nbsu is run on a "pure" NetBackup client
system.
----------------------------------------------------------------------------
Etrack Incident = ET2670195

Description:
Fixed an issue where the correct title was not displayed in the
NBU_host_cache.txt diagnostic output file.
----------------------------------------------------------------------------
Etrack Incident = ET2670214

Description:
Fixed an issue on Mac OS X where the correct path to the "cat"
command was not used in the OS_config and OS_messages diagnostics.
----------------------------------------------------------------------------
Etrack Incident = ET2670966

Description:
Added the -q and --quiet command line options to nbsu in order to
suppress STDOUT output.
----------------------------------------------------------------------------
Etrack Incident = ET2670985

Description:
Added the -odir command line option to allow the designation
of a directory for nbsu to place its output information in.
----------------------------------------------------------------------------
Etrack Incident = ET2715710

Description:
Added versioninfo information to nbsu.
----------------------------------------------------------------------------
Etrack Incident = ET2717081

Description:
Added the NET_tcpip_tunable_reg diagnostic on Windows. Added the
NET_tune diagnostic on Linux. Updated the NET_ndd diagnostic for
both Solaris and HP.
----------------------------------------------------------------------------
Etrack Incident = ET2732787

Description:
Fixed an issue with the internal nbsu check for deselecting
diagnostics based on the version of NetBackup that
would result in some diagnostics being selected and
run when they should not have been.
----------------------------------------------------------------------------
Etrack Incident = ET2760917

Description:
Updated the NET_netstat diagnostic procedure on all platforms to
include the -n command line option so that netstat commands
run correctly.
----------------------------------------------------------------------------
Etrack Incident = ET2770199

Description:
Updated the OS_resource diagnostic on all UNIX platforms to run the
following command in order to get a current snapshot of the OS
resource utilization

vmstat 15 8
----------------------------------------------------------------------------
Etrack Incident = ET2770214

Description:
Added the NET_kstat diagnostic for the Solaris platform to run the
following command in order to collect NIC information and settings.

kstat -c net
----------------------------------------------------------------------------
Etrack Incident = ET2739092

Description:
Added the NBU_nbwmc diagnostic for NetBackup 7.6 and greater master
servers to collect Web Manager Console configuration information if
it exists.
----------------------------------------------------------------------------
Etrack Incident = ET2740726

Description:
Added the NBU_nbdb_unload_full diagnostic to run the
the following command to unload and package the entire NBDB
database.

nbdb_unload

Due to the intrusive nature of unloading the entire NBDB database
on systems with large databases, this diagnostic can only be
executed on NetBackup EMM Servers with use of the
nbsu -d command line option.
----------------------------------------------------------------------------
Etrack Incident = ET2747538

Description:
Updated the NBU_nbstl diagnostic for NetBackup 7.0 and greater to run
the following command in order to add SLP information to output:

nbstl -L -all_versions

----------------------------------------------------------------------------
Etrack Incident = ET2795844

Description:
Added the NBU_nbgetconfig diagnostic for NetBackup 7.6 and greater
clients to run the following command to collect the associated
NetBackup configuration information.

nbgetconfig
----------------------------------------------------------------------------
Etrack Incident = ET2835525

Description:
Added the NBU_ost_plugins diagnostic for NetBackup 6.5 and greater
to examine the following OST Plugins directories for the existence of any
.conf files.

/usr/openv/lib/ost-plugins
<install path>\NetBackup\bin\ost-plugins

If any are present, nbsu will do a ls -l/dir and cat -s/type commands on
each.
----------------------------------------------------------------------------
Etrack Incident = ET2861596

Description:
Updated the NBU_tunable diagnostic for NetBackup 7.6 and greater to
include execution of the following command in order to list
tunable files.

bpconverttouch -f

If any files are reported, nbsu will do a ls -l/dir and
cat -s/type commands on each.
----------------------------------------------------------------------------
Etrack Incident = ET2895604 and ET3097674

Description:
Update the nbsu environment checks to recognize when it is being run
on a NetBackup appliance.
----------------------------------------------------------------------------
Etrack Incident = ET2924413

Description:
For the Windows version of nbsu, fixed an issue in the NBU_versioninfo
diagnostic procedure where the path to the following directory was
incorrect causing the versioninfo command to have an issue.

./NetBackup/Bin/Goodies
----------------------------------------------------------------------------
Etrack Incident = ET2978992

Description:
Updated the default FTP credentials used by nbsu.
----------------------------------------------------------------------------
Etrack Incident = ET2980285

Description:
Updated the processing of the -ftp command line option to accommodate
the case ID formats of both the old and new Symantec issue tracking
systems.

-ftp [<###-###-###> | <########>]
----------------------------------------------------------------------------
Etrack Incident = ET3096027

Description:
Updated the NBU_install_logs diagnostic to collect the
following files, if they exist.

/tmp/install_telem_output.<pid>
/tmp/install_nbcheck_stderr.<pid>
----------------------------------------------------------------------------
Etrack Incident = ET3097688

Description:
Added the NBU_appliance diagnostic to run the following commands if
nbsu is run on a NetBackup appliance:

ls -l /etc/nbapp-release
cat -s /etc/nbapp-release
ls -l /etc/nbapp-rpms
cat -s /etc/nbapp-rpms
ls -l /opt/NBUAppliance/log.conf
cat -s /opt/NBUAppliance/log.conf
find /opt/NBUAppliance/ -type f -exec cksum {} \;
find /opt/NBUAppliance/ -type l -exec ls -l {} \;
ls -l /usr/openv/runtime_data/
cat -s /usr/openv/runtime_data/*
----------------------------------------------------------------------------
Etrack Incident = ET3097699

Description:
Added the NBU_appliance_logs diagnostic to run the following commands
if nbsu is run on a NetBackup appliance:

ls -l /logs/
ls -l /usr/openv/netbackup/db/jobs/trylogs/
ls -l /opt/VRTSpbx/log/
ls -l /usr/openv/netbackup/vault/sessions/
ls -lR /log/
ls -lR /var/VRTSvcs/log/
----------------------------------------------------------------------------
Etrack Incident = ET3097722

Description:
Added the NBU_appliance_hdw diagnostic to collect the following
hardware maintenance information if nbsu is run on a NetBackup
appliance:

/usr/openv/pdde/pdcr/bin/crcontrol --compactstate
/usr/openv/pdde/pdcr/bin/crcontrol --rebasestate
----------------------------------------------------------------------------
Etrack Incident = ET3097908

Description:
Added the NBU_appliance_cmdb_info diagnostic to collect the following
CMDB information if nbsu is run on a NetBackup appliance:

/opt/NBUAppliance/scripts/nbapp_user_setting.pl -print

----------------------------------------------------------------------------
Etrack Incident = ET3097909

Description:
Added the OS_modinfo diagnostic on Linux to collect the Kernel module
information.
----------------------------------------------------------------------------
Etrack Incident = ET3111342

Description:
Updated the OS_resource diagnostic on Linux to additionally collect
the following information:

/bin/cat -s /proc/meminfo
/usr/bin/free -m
----------------------------------------------------------------------------
Etrack Incident = ET3118479

Description:
Added the NBU_appliance_CallhomeDataGather diagnostic to collect the
following information if nbsu is run on a NetBackup appliance and the
-d NBU_appliance_CallhomeDataGather command line option is used:

/opt/NBUAppliance/scripts/CallhomeDataGather.sh -f .

nbsu will run the script and bundle up the resulting information into
the following file:

CallhomeDataGather.tar
----------------------------------------------------------------------------
Etrack Incident = ET3118486

Description:
Added the OS_supportconfig diagnostic to be run on SuSE Linux to
collect the following information if nbsu is run with the
-d OS_supportconfig command line option:

/sbin/supportconfig -Q -R . -g

nbsu will run the script and bundle up the resulting information into
the following file:

supportconfig.tar
----------------------------------------------------------------------------
Etrack Incident = ET3216593

Description:
Added the NBU_Logging_Assistant_dbdump diagnostic for NetBackup 7.6
and greater.
----------------------------------------------------------------------------
Etrack Incident = ET3219773

Description:
For the nbsu included with the NetBackup Mac OS X 10.6 and 10.7
clients, changed the binary platform type to i386 (from PowerPC).
----------------------------------------------------------------------------
Etrack Incident = ET3230898

Description:
Added the NBU_hostuuid diagnostic to collect the NetBackup telemetry
hostuuid information.
=========================================================
 

 


Attachments

NBSU 1.7
1.7_nbsu.zip (29.9 MBytes)


Legacy ID



303813


Article URL http://www.symantec.com/docs/TECH160944


Terms of use for this information are found in Legal Notices