NBCC 7.0.1 README                                            May 11, 2010
Requirement: None
Co-requirement: None
Directives:
============================================================================
NBCC is a utility that is used to confirm the integrity of portions of the
NetBackup catalog.

NBCC 7.0.1 provides enhancements and fixes to previous versions of NBCC.

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


=================
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 NBCC 7.0.1 utility:
      - Should be applied to the NetBackup master server.
      - Is compatible with NetBackup versions 3.X, 4.X, 5.X, 6.X and 7.X.
      - Can be run in environments where previous versions of NBCC have
        been 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 NBCC 7.0.1.  The following lists
provide brief descriptions of the platform proliferations, and the new
features.

For those new features that have more detailed information available, a link
is provided to a corresponding TechNote.


Platform Proliferations:
------------------------
NBCC 7.0.1 offers no new platform proliferations.


New Features and Enhancements:
------------------------------
NBCC 7.0.1 offers the following enhancements:

+  Improved the checking of the exit status from various NetBackup
   commands.

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

+  ET1011048 and ET1183767.  Running NBCC in a different locale than
   US English.  For more information about this issue, refer to the
   following TechNote on the Symantec Support Web site.

   http://entsupport.symantec.com/docs/306889

+  ET1235580 and ET1260035.  NBCC does not support running in an "App cluster"
   environment.


==========================
III. DOWNLOAD INSTRUCTIONS
==========================
Download the correct NBCC platform binary into the

/usr/openv/netbackup/bin/support

or

<NetBackup install path>\NetBackup\bin\support

directory on the master server.


=============================
IV. INSTALLATION INSTRUCTIONS
=============================
Place the correct platform binary of NBCC on the master server in the

/usr/openv/netbackup/bin/support

or

<NetBackup install path>\NetBackup\bin\support

directory.

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

# NBCC -help

to obtain a detailed set information that describes how to prepare for and
execute NBCC.


=========================
V. UNINSTALL INSTRUCTIONS
=========================
Manually remove NBCC 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 = ET2020578

Description:
    Added or improved the checking and reporting of the exit status value
    from the following NetBackup commands during the catalog/database
    gathering section.

    Command                             Status    Action
    -------                             ------    ------
    nbemmcmd -listmedia -conflicts      != 0      STDERR messages
    bpimagelist -l -d 1/1/70            != 0,227  STDERR messages
    bpmedialist -l -h <host>            != 0,227  STDOUT messages
    vmoprcmd -h <host>                  != 0      STDOUT messages
    bpmedialist -l -owner <group name>  != 0,227  STDOUT messages
    bpmedialist -ls -owner ALL          != 0,227  STDOUT messages
    vmquery -a -j32 -h <host>           != 0,35      STDERR messages
    vmpool -listall -bx -h <host>       != 0      STDERR messages
    vmpool -h <host> -listscratch       != 0      STDERR messages
    nbemmcmd -listmedia -mergetable     != 0      STDERR messages

----------------------------------------------------------------------------
Etrack Incident = ET2039216

Description:
    With the additional exit status checking for ET2020578, it was found
    that in configurations where the EMM Server hostname was also only
    the name of a cluster, the use of the "-machinetype media" option
    would result in an exit status 136.  This would stop the NBCC
    processing.  Added logic to alter the -machinetype option based on
    other EMM entries that share the same hostname.
============================================================================