DMP 5.0GA Pack NB_DMP_50_5_M README April 12, 2005
================================================================================
This Maintenance Pack should only be applied to VERITAS NetBackup UNIX servers
running NetBackup for NDMP.

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

==================
PACK DEPENDENCIES
==================

-- Installation of this Maintenance Pack requires version 1.17.4.25 of
the Vrts_pack.install.

-- NB_50_5_M server Maintenance Pack should be installed prior to
installing this Maintenance Pack.

I. DOWNLOAD INSTRUCTIONS
II. INSTALLATION INSTRUCTIONS
III. UNINSTALL INSTRUCTIONS
IV. DESCRIPTION OF PROBLEMS FIXED
Current Pack
NB_DMP_50_4_M
NB_DMP_50_1_M

=========================
I. DOWNLOAD INSTRUCTIONS
=========================
1) Download NB_DMP_50_5_M_<6 digit number>.<platform>.tar into the
/tmp directory.

where <6 digit number> is an internal tracking identifier

where <platform> is: hp_ux, linux, rs6000, solaris

2) Extract NB_DMP_50_5_M_<6 digit number>.<platform>.tar
/bin/tar xvf NB_DMP_50_5_M_<6 digit number>.<platform>.tar

This will create the files
Vrts_pack.install
VrtsNB_DMP_50_5_M.README
VrtsNB_DMP_50_5_M.<platform>.tar.Z


==============================
II. INSTALLATION INSTRUCTIONS
==============================
UNIX:
As root on the NetBackup Server with NetBackup for NDMP:
1) Install Maintenance Pack binaries.

cd /tmp
/bin/sh Vrts_pack.install


============================
III. UNINSTALL INSTRUCTIONS
============================
Note: This will ONLY uninstall the Maintenance Pack from your local machine.

1) Close the NetBackup user interfaces.

Make sure the NetBackup server has no active jobs running (for
example, backups, restores, or duplications).

If a database agent is being used, such as Oracle,
ensure that the database services are stopped.

2) Change directory to the patch save directory.
Substitute the pack name for ${PACK} in the following command:

cd /usr/openv/pack/${PACK}/save

3) Run the un-install script:

./Vrts_pack.uninstall

4) Verify that the pack uninstalled successfully by checking
/usr/openv/pack/pack.history.

5) If update_clients was run after the pack was originally INSTALLED,
run it again after that pack is successfully UNINSTALLED.

6) If necessary, restart the NetBackup and Media Manager daemons:
/usr/openv/netbackup/bin/goodies/netbackup start


===================================
IV. DESCRIPTION OF PROBLEMS FIXED
===================================
The following are descriptions of the problems fixed.
Please read the entire document before installing.

README Conventions:

Description
Describes particular problem or feature contained in this patch.

** Description **
Describes a problem that can lead to potential data loss. Please
read these problem descriptions carefully.

Workaround
Any available workarounds to a problem are also listed. Workarounds
can be used INSTEAD of applying the patch, however, VERITAS strongly
recommends the "best practice" of being at the latest patch level.

Additional Notes
Any additional information regarding this problem or feature is included.


=============
Current pack
=============

================================================================================
Description:
Using the encryption algorithm, blowfish, on Solaris 9 platforms caused
set_ndmp_attr of ndmpmoveragent to fail. The following data is an example
of this failure.

[root@galvatron]:/:>set_ndmp_attr -verify
Verify Host name: galvatron
Connecting to host "galvatron" as user "root"...
Waiting for connect notification message...
Opening session--attempting with NDMP protocol version 2...
Opening session--successful with NDMP protocol version 2
host supports TEXT authentication
Logging in using TEXT method...
17:44:53.152 [03044] ndmp_net_read: connection 0x3e0d0: (5) end of file
detected
17:44:53.153 [03044] ndmp_message_receive: xdr_ndmp_header failed, unable
to
XDR decode
ndmp_connect_client_auth failed
set_ndmp_attr: host "galvatron" failed
NDMP failed to verify host


(All NetBackup Servers: HP Intel-NT Linux RS6000 Solaris)
--------------------------------------------------------------------------------
Description:
The "set_ndmp_attr -verify server" for remote NDMP would fail, if the
server's root/administrator password was more than eight characters long.

(All NetBackup Servers: HP Intel-NT Linux RS6000 Solaris)
--------------------------------------------------------------------------------
Description:
For NDMP restores on NetApp filers, more than 1024 files can be restored
using DAR.

(All NetBackup Servers: HP Intel-NT Linux RS6000 Solaris)
--------------------------------------------------------------------------------
Description:
The NetBackup bptm process could core dump if NDMP processes file history
with inodes with the 32nd bit set as code paths used signed integets for
this value, making the inode appear negative.

Additional Notes:
This problem was encountered while running a third party file system, the
SGI open source XFS file system. This file system actually uses 64-bit
nodes; However, in this instance the NDMP file history was altered which
caused the 32nd bit to be set.

(All NetBackup Servers: HP Intel-NT Linux RS6000 Solaris)
================================================================================

=============
NB_DMP_50_4_M
=============
Description:
An NDMP backup in the ASCII catalog format would fail and produce the
following error in the bptm log:

08:42:17.202 [5704.5624] <2> write_data_ndmp: calling
ndmp_bpfsmap_create
08:42:18.304 [5704.5624] <2> write_data_ndmp: bpfsmap longjmp: setjmp
returned 6; aborting backup
...
08:42:18.764 [5704.5624] <2> write_data: write_data_ndmp() returned -8,
EXIT_Status 6, Kbytes = 1359099
08:42:18.774 [5704.5624] <2> write_backup: write_data() returned,
exit_status = 6, CINDEX = 0, TWIN_INDEX = 0, backup_status = -8


(All NetBackup Servers: HP Intel-NT Linux RS6000 Solaris)
--------------------------------------------------------------------------------
Description:
When attempting to restore from a Hitachi Lightning NAS Blade 9900V image
that was backed up with the file list "set files=dir1 dir2 dir3" directive
specifying multiple files, the restore fails with status 5.

(All NetBackup Servers: HP Intel-NT Linux RS6000 Solaris)
--------------------------------------------------------------------------------
Description:
The following log entry in the bptm log was confusing (in this patch, the
word DEBUG has been removed):

09:37:46.035 [16536] <4> ndmp_internal_open_and_auth: NDMP server DEBUG
suggests protocol version 3

(All NetBackup Servers: HP Intel-NT Linux RS6000 Solaris)
--------------------------------------------------------------------------------

=============
NB_DMP_50_1_M
=============
Description:
NDMP backup fails writing TIR data.

bptm log shows:
19:56:36.854 [2969] <16> write_data_tir: ERR - Cannot write TIR data to
media, NDMP return code 9.

ndmp logs shows:
19:56:36.801 [02969] 162988 -> (8) 267 [0] 19:56:36 NDMP_TAPE_WRITE
(0x304) NDMP_NO_ERR (0x0)
19:56:36.801 [02969] 162988 . data_out(0)=
19:56:36.801 [02969] 162988 ** End NDMP_TAPE_WRITE
19:56:36.850 [02969] 162988 <- (8) 599 [267] 19:57:51 NDMP_TAPE_WRITE
(0x304) NDMP_NO_ERR (0x0)
19:56:36.850 [02969] 162988 . error=NDMP_ILLEGAL_ARGS_ERR (0x9)
19:56:36.850 [02969] 162988 . count=0 (0x0)
19:56:36.850 [02969] 162988 ** End NDMP_TAPE_WRITE

(All NetBackup Servers: HP Intel-NT Linux RS6000 Solaris)
================================================================================