=================
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.6 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.6. The following lists
provide brief descriptions of the new features and enhancements.

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

+ FreeBSD 5.3 32-bit

+ Linux 64-bit for Intel platforms

+ Linux 32-bit for PowerPC platforms

+ HP 64-bit for Itanium platforms

+ Mac OS X 10.7

New Features and Enhancements:
------------------------------
nbsu 1.6 contains the following new features and enhancements.

+

=================
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

/usr/openv/netbackup/bin/support

or

<NetBackup install path>\NetBackup\bin\support

directory on the client.

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

Place the correct platform binary of nbsu in the

/usr/openv/netbackup/bin/support/

or

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

directory.

nbsu is self-documenting piece of software. Once installed, run

# nbsu -H

to obtain a detailed set of nbsu instructions and usage examples.

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

/usr/openv/netbackup/bin/support

or

<NetBackup install path>\NetBackup\bin\support

directory.

===================
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 = ET1004846

Description:
Added the NBU_cluster diagnostic. This diagnostic runs on master or
EMM Servers for NetBackup 6.0 or greater where the

/usr/openv/netbackup/bin/cluster

directory exists. If this directory exists, then the following
commands are run if the files exist:

# ls -l /usr/openv/netbackup/bin/cluster/NBU_RSP
# cat -s /usr/openv/netbackup/bin/cluster/NBU_RSP

If these directory or files do not exist, then a ls -l is done of the
parent directories to show their state.
----------------------------------------------------------------------------
Etrack Incident = ET1033208

Description:
Added the NBU_pdde diagnostic. This diagnostic runs on master or
media servers for NetBackup 6.5 or greater where the

/usr/openv/netbackup/pdde/pdcr/bin

directory exists. If this directory exists, then the following
commands are run:

/usr/openv/netbackup/pdde/pdcr/bin/crcontrol --getmode
/usr/openv/netbackup/pdde/pdcr/bin/crcontrol --dsstat
/usr/openv/netbackup/pdde/pdcr/bin/crcontrol --compactstate
/usr/openv/netbackup/pdde/pdcr/bin/crcontrol --queueinfo
/usr/openv/netbackup/pdde/pdcr/bin/crcontrol --processqueueinfo
/usr/openv/netbackup/pdde/pdcr/bin/crcontrol --processqueuestatus
/usr/openv/netbackup/bin/admincmd/bpstsinfo -pi

If this directory does not exist, then a ls -l is done of the
parent directory to show its state.
----------------------------------------------------------------------------
Etrack Incident = ET1251762

Description:
Updated all diagnostics that display the contents of a text file to also
do a

ls -l

or a

dir

of the file (as appropriate by platform).
----------------------------------------------------------------------------
Etrack Incident = ET1592885

Description:
For Windows, updated the OS_event_system diagnostic to remove the
restriction of extracting 200 Event records.

Note: This diagnostic will now take longer based on the number of
records to be extracted.
----------------------------------------------------------------------------
Etrack Incident = ET1887865

Description:
- For NetBackup 5.0 and greater, updated the NBU_jobs diagnostic to
include

# bpdbjobs -report -all_columns

output.

- For all Unix platforms other than Solaris (which already had this
change), updated the OS_syslog diagnostic to alter the collection of
the System Log information from a

tail -50

to a

cat -s

to collect the entire file contents.

- Added the NBU_install_logs diagnostic to collect copies of the
NetBackup, PBX and PDDE install logs.

On Unix, the following are checked:

/tmp
/usr/openv/tmp

for the following files:

install_trace.<pid>
install_cltpkg_trace.<pid>
install_javapkg_trace.<pid>
install_jrepkg_trace.<pid>
trace_install_bp.<pid>
<client name>.<dbagent>.<jobid>.trace_file
trace_install_dbext.<pid>
<client>.SNC.<jobid>.trace_file
update_clients.<datetime>
update_dbclients.datetime>
skipped_clients.<pid>

For PBX install logs, the following directory is checked

/var/tmp

for the following files:

installpbx-<pid>-<datetime>.log

For PDDE install logs, the following directory is checked

/var/log/puredisk

for the following files:

<datetime>-pdde-install.log

On Windows, the following are checked:

C:\Windows\bkupinst.log

For NetBackup versions older than 7.0, the following are checked:

%TEMP%\NetBackup Install*.log
%TEMP%\..\<User ID#>\NetBackup Install*.log
C:\Windows\system32\bepushes.log

For NetBackup versions 7.0 and greater, the following are checked:

%ALLUSERSPROFILE%\Symantec\NetBackup\InstallLogs\*
%ALLUSERSPROFILE%\Symantec\NetBackup\InstallSummary\NBInstallSummary*\*
%ALLUSERSPROFILE%\Symantec\Backup Exec\Logs\bepushes.log
<install path>\NetBackup\Logs\pdde\pddev2conv.log
----------------------------------------------------------------------------
Etrack Incident = ET1984393

Description:
- Improved the NBAC capabilities of nbsu on both Unix and Windows
platforms.

- On NetBackup 7.0 or earlier, if NBAC is enabled, the only way an
end-user can authenticate in order to run nbsu in more than the
Client host role, is to use the -i command line option and go through
the bpnbat -login process.

- On NetBackup 7.0.1 or greater, if NBAC enabled, the method used by
nbsu to authenticate the user is to see if the nbauditreport command
can be run and an exit status of zero obtained. If this is
possible, the end-user is a member of the NBU_Admin NBAC group and
the user is authenticated.

Note: If NBAC authentication fails, nbsu is run in NetBackup Client
host role only.

Note: If NBAC authentication is successful, nbsu NetBackup
environment checks determine the NetBackup host roles
applicable for the system.
----------------------------------------------------------------------------
Etrack Incident = ET2128681

Description:
- Updated nbsu for Windows to check for and use the the 7zip utility
for bundling if it is available. This occurs when nbsu is being run
by nbcplogs (which has 7zip bundled with it), or if 7zip is
installed on the system.
----------------------------------------------------------------------------
Etrack Incident = ET2146830

Description:
- Updated the NBU_tunable diagnostic to check for the following files:

/usr/openv/netbackup/db/config/DEFERRED_IMAGE_LIMIT
/usr/openv/netbackup/db/config/DEFERRED_IMAGE_KBSIZE

if they are present, on Unix, do

ls -l
cat -s

or Windows

dir
type

to gather the details of the files.
----------------------------------------------------------------------------
Etrack Incident = ET2167710

Description:
- Corrected a bug in the Windows OS_filesystem diagnostic to print
the "Drive Type" information correctly.
----------------------------------------------------------------------------
Etrack Incident = ET2175313

Description:
- Added the NBU_host_cache diagnostic. This diagnostic checks for and
creates a bundle for any directory/files (except as noted below)
located in the

/usr/openv/netbackup/var/host_cache

directory. For all bundling programs with the exception of Windows
makecab, you will get both the directory structure and the .txt files
beneath them in a host_cache.<bundle extension> file. For makecab,
you only get copies of the .txt files in a flat directory structure.
----------------------------------------------------------------------------
Etrack Incident = ET2190582

Description:
- Added the NBU_nbdiag diagnostic. On NetBackup 7.1 or greater, this
diagnostic checks to see the state of modules that support nbdiag.
If any modules are enabled, the diagnostic collects a nbdiag dump
from each module and bundles them. The following commands are run:

# nbdiag -modules
# nbdiag -state -module <name> -verbose
# nbdiag -dump -module <name> -format text -file <file name>
----------------------------------------------------------------------------
Etrack Incident = ET2202539

Description:
- Added the NBU_nbauditreport diagnostic. For NetBackup 7.0.1 and
greater on a master server, this diagnostic runs a

# /usr/openv/netbackup/bin/admincmd/nbauditreport -sdate <-30 days>

command to collect audit information.

Note: This is a troubleshooting diagnostic that can take a long
time to run on some systems.
----------------------------------------------------------------------------
Etrack Incident = ET2204044

Description:
- On Solaris, added the DEV_driver_aliases diagnostic to list the
file characteristics and cat -s the contents of the

/etc/driver_aliases

file if it exists.
----------------------------------------------------------------------------
Etrack Incident = ET2204045

Description:
- On Solaris, updated the OS_general diagnostic to include the listing
of the file characteristics and cat -s the contents of the

/etc/release

file.
----------------------------------------------------------------------------
Etrack Incident = ET2216323

Description:
- On Solaris, did the following:

1. Added the DEV_san_client diagnostic. This diagnostic does the
following:

if nbftclnt is on the process list, do a

ls -l /dev/rmt/*cbn

If the /usr/sbin/luxadm process exists run a

luxadm -e port

command and parse for lines that begin with "/devices/pci". If
there are any present, capture the device names.

For each device name captured above, run a separate

luxadm -e dump_map <device name here>

command.

2. Updated the DEV_sgconf diagnostic procedure, adding:

If NetBackup is installed:

ls -l /dev/sg
ls -l /usr/openv/volmgr/bin/driver

If the /usr/openv/volmgr/bin/driver/sg.links file exists

cat -s /usr/openv/volmgr/bin/driver/sg.links

If the /usr/openv/volmgr/bin/driver/sg.conf file exists

cat -s /usr/openv/volmgr/bin/driver/sg.conf

3. Updated the DEV_hba_config diagnostic, adding:

If the /usr/sbin/luxadm process exists run a

luxadm -e port

command and parse for lines that begin with "/devices/pci". If
there are any present, capture the device names.

For each device name captured above, run a separate

luxadm -e dump_map <device name here>

command.
----------------------------------------------------------------------------
Etrack Incident = ET2251821

Description:
Added the NBU_nbconfig diagnostic. This diagnostic runs on master
servers only for NetBackup 6.0 or greater. It collects the following
information:

bppllist -allpolicies
nbstl -l
nbdevquery -listdp
nbdevquery -listdv -stype AdvancedDisk
nbdevquery -liststs
tpconfig -emm_dev_list
vmquery -a -l
vmpool -list_all -bx
bpgetconfig
bpretlevel -j
bpconfig -l
nbemmcmd -brief -listsettings -machinename <name>

This information: that will be used as input for a new in-house
utility for reviewing configurations and configurations changes.
----------------------------------------------------------------------------
Etrack Incident = ET2257048

Description:
On AIX, updated the OS_general diagnostic to include the following
commands:

For AIX 5.1 or earlier

/usr/bin/oslevel -r

For AIX 5.2 and greater

/usr/bin/oslevel -s
----------------------------------------------------------------------------
Etrack Incident = ET2271301

Description:
On Windows, updated the NetBackup environment checks in the area of
the NetBackup version if NetBackup Patches are installed. This is
accomplished by checking for the existence of the

HKEY_LOCAL_MACHINE/Software/VERITAS/Patches/NetBackup/CurrentPatch

Registry key. If this key is present, then the Registry key

HKEY_LOCAL_MACHINE/Software/VERITAS/Patches/NetBackup/<Current Patch>/PatchName

is read and the NetBackup Release level is obtained from the
information. Ex.

Symantec NetBackup 7.0.1 (7.0 Release Update 1)

Has a NetBackup version of 7.0 and a Release Level of 1.

For both Unix and Windows, the full NetBackup version is now printed in
the nbsu_info.txt file.
----------------------------------------------------------------------------
Etrack Incident = ET2325072

Description:
On a Windows cluster, for a number of diagnostics, nbsu was not
checking the Registry for the location of the shared drive and path
to obtain the correct location to check for certain files.
Diagnostics modified to not only check in the standard location but
also to do a Registry query and check in the shared location were:

NBU_evtmgr
NBU_nbdb_info
NBU_tunable
----------------------------------------------------------------------------
Etrack Incident = ET2372890

Description:
Corrected a bug in the creation of makecab cabinet files that limited
the size of the cabinet file to be 1.44MB. Added the makecab
directive

.set MaxDiskSize="0"

which effectively sets the size limit of the cabinet file to be the
amount of free space available on the disk where the cabinet file is
being created.

This change effects not only the cabinet file created by nbsu when it
creates the Support bundle, but also the NBU_host_cache,
NBU_install_logs, NBU_nbdiag and NBU_nbdb_unload diagnostics.
----------------------------------------------------------------------------
Etrack Incident = ET2387433

Description:
Ported nbsu to Mac OS X 10.7. The version version of nbsu is 1.6.1 to
reflect that it includes other fixes to the Mac OS X version of nbsu.
----------------------------------------------------------------------------
Etrack Incident = ET2424343

Description:
Provide nbsu for Linux 64-bit on Intel platforms, Linux 32-bit on the
PowerPC platform and HP 64-bit on Itanium platforms.
----------------------------------------------------------------------------
Etrack Incident = ET2431787

Description:
Corrected an issue on Windows where the tar command was not being
recognized as an available bundling option.
----------------------------------------------------------------------------
Etrack Incident = ET2519844

Description:
Corrected an issue with the printing of the NetBackup version in the
nbsu_info.txt file if the version was a double-dot or triple-dot
release.
----------------------------------------------------------------------------
Etrack Incident = ET2405849

Description:
Provided nbsu for FreeBSD platforms. Support for FreeBSD 5.3 is
included with the internal release to the Support organization only,
as FreeBSD 5.3 is not an included platform with NetBackup 7.5.
----------------------------------------------------------------------------
Etrack Incident = ET2668606

Description:
Corrected an issue with the Mac OS X version of nbsu that was released
with NetBackup 7.5 where it would fail with a Perl runtime error. The
version of nbsu with this fix is 1.6.1.
----------------------------------------------------------------------------
Etrack Incident = ET2669898

Description:
Corrected an issue with the Mac OS X version of nbsu where during the
initial OS environment checks, the ifconfig -a output processing was
not detecting IPv4 or IPv6 addresses to process. The version of nbsu
with this fix is 1.6.1.
----------------------------------------------------------------------------
Etrack Incident = ET2670214

Description:
Corrected an issue with the Mac OS X version of nbsu where the
OS_config and OS_messages diagnostics had the path to the "cat"
command incorrect. The version of nbsu with this fix is 1.6.1.
============================================================================