Maintenance Pack NB_ORA_60_6_M.tar provides updates and fixes for Veritas NetBackup (tm) Enterprise Server / Server 6.0 for Oracle Database Agent on UNIX platforms.

Problem

Maintenance Pack NB_ORA_60_6_M.tar provides updates and fixes for Veritas NetBackup (tm) Enterprise Server / Server 6.0 for Oracle Database Agent on UNIX platforms.

Solution

ORA 6.0GA Pack NB_ORA_60_6_M README OEBU February 7, 2008
Requirement: NB_CLT_60_6_M
================================================================================
This Maintenance Pack provides updates and fixes for Veritas NetBackup (tm) for
Oracle Database Agent.

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


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

-- Installation of this Maintenance Pack requires version 1.33.10.18
of Vrts_pack.install.

-- NB_CLT_60_6_M must be installed prior to installing this Maintenance
Pack.


I. NEW FEATURES AND PLATFORM PROLIFERATIONS
II. KNOWN ISSUES
III. DOWNLOAD INSTRUCTIONS
IV. INSTALLATION INSTRUCTIONS
V. UNINSTALL INSTRUCTIONS
VI. CURRENT MAINTENANCE PACK INDEX
VII. MAINTENANCE PACK CONTENT
Conventions
Current Maintenance Pack
NB_ORA_60_6_M
Maintenance Pack History
NB_ORA_60_5_M
NB_ORA_60_4_M
NB_ORA_60_2_M
NB_ORA_60_1_M


============================================
I. NEW FEATURES AND PLATFORM PROLIFERATIONS
============================================
Many new features, enhancements, and platform proliferations have been made
to NetBackup 6.0 MP6 in general. For a complete list of these additions, refer
to the New Features and Platform Proliferations section in the NB_CLT_60_6_M
online Readme that you installed prior to installing this package.




=================
II. KNOWN ISSUES
=================
This section contains known issues with this maintenance pack that have not
yet been fixed in NetBackup. These issues will likely be fixed in future
Maintenance Packs for this version of NetBackup.

There are no known issues with this Maintenance Pack.




==========================
III. DOWNLOAD INSTRUCTIONS
==========================
1) Download NB_ORA_60_6_M_<6 digit number>.tar into the /tmp
directory.

where <6 digit number> is an internal tracking identifier

2) Extract NB_ORA_60_6_M_<6 digit number>.tar
/bin/tar -xvf NB_ORA_60_6_M_<6 digit number>.tar

This will create the files:
Vrts_pack.install
VrtsNB_ORA_60_6_M.README
VrtsNB_ORA_60_6_M.postinstall
VrtsNB_ORA_60_6_M.postuninstall
VrtsNB_ORA_60_6_M.OEBU.alpha_5.tar.Z
VrtsNB_ORA_60_6_M.OEBU.hp11.00.tar.Z
VrtsNB_ORA_60_6_M.OEBU.hpia64.tar.Z
VrtsNB_ORA_60_6_M.OEBU.linux2.4.tar.Z
VrtsNB_ORA_60_6_M.OEBU.linux64.tar.Z
VrtsNB_ORA_60_6_M.OEBU.plinuxR_2.6.tar.Z
VrtsNB_ORA_60_6_M.OEBU.plinuxS_2.6.tar.Z
VrtsNB_ORA_60_6_M.OEBU.rs6000_51.tar.Z
VrtsNB_ORA_60_6_M.OEBU.sgi65.tar.Z
VrtsNB_ORA_60_6_M.OEBU.solaris8.tar.Z




=============================
IV. INSTALLATION INSTRUCTIONS
=============================

NOTE: Click on the "Download Now" link, near the bottom of this document
prior to running the following installation procedure for this pack.

There are two ways to install database agent maintenance pack software.

1. Remote Installation: Loads the software on a master server with
the intent of pushing database software out to affected clients.

2. Local Installation: Loads and installs the software only to this
local machine.

---

Remote Installation:

Warning: Before installation - If production rman scripts are found in
the /usr/openv/netbackup/ext/db_ext/oracle/samples/rman, please save them
in another location to prevent them from being overwritten.

1. Log in as the Oracle user on the clients to receive the pack software
and shut down all Oracle instances. (Recommended)

Login as root on the NetBackup Master/Media server:

2. Install the Maintenance Pack binaries.

cd /tmp
/bin/sh Vrts_pack.install

Pick option 1 (Remote Installation) when prompted for the installation
method.

3. The pack install logs can be found in /usr/openv/pack/pack.history once the
installation is complete.

4. Run update_dbclients to push pack software affected database agent clients:

/usr/openv/netbackup/bin/update_dbclients Oracle ALL ALL

This command will look at all possible clients and only update and only
update the ones currently in Oracle policy type. For more information on
how to run update_dbclients, refer to the NetBackup for Oracle System
Administrator's Guide.

5. For every client to which you pushed the pack software in step 3, the
following steps must be performed:

5.1 Verify that Oracle Agent library is located in /usr/openv/netbackup/bin
directory.

5.2 Verify that library is visible to Oracle.
If $ORACLE_HOME/lib[32,64]/libobk.<platform extension> is a soft link to
/usr/openv/netbackup/bin/libobk.<platform extension>
then library is visible to Oracle.

Perform step 5.3 only if library is not visible to Oracle.

5.3 Make the library visible to Oracle
Run /usr/openv/netbackup/bin/oracle_link script OR Perform manual linking.

For more information on how to manually link the library,
refer to Oracle System Administrator Guide.

5.4 Restart any Oracle instances. (Recommended)

----

Local Installation:

Warning: Before installation - If production rman scripts are found in
the /usr/openv/netbackup/ext/db_ext/oracle/samples/rman, please save them
in another location to prevent them from being overwritten.

1. Log in as the Oracle user and shut down all Oracle instances. (Recommended)

As root on the NetBackup for Oracle client:

2. Install the Maintenance Pack binaries.

cd /tmp
/bin/sh Vrts_pack.install

Pick option 2, Local Installation, when prompted.

This will install the updated NetBackup files for the Oracle library
in /usr/openv/netbackup/bin.

3. The pack install logs can be found in /usr/openv/pack/pack.history once the
installation is complete.

4. Verify that Oracle Agent library is located in
/usr/openv/netbackup/bin directory.

5. Verify that library is visible to Oracle.
If $ORACLE_HOME/lib[32,64]/libobk.<platform extension> is a soft link to
/usr/openv/netbackup/bin/libobk.<platform extension> then library is
visible to Oracle.

Perform step 6 only if library is not visible to Oracle.

6. Make the library visible to Oracle
Run /usr/openv/netbackup/bin/oracle_link script OR
Perform manual linking.

For more information on how to manually link the library, refer to Oracle
System Administrator Guide.


7. Log in as the Oracle user and restart any Oracle instances. (Recommended.)




=========================
V. UNINSTALL INSTRUCTIONS
=========================
1) Close the NetBackup user interfaces.

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.EN_US} in the following command:

cd /usr/openv/pack/${PACK.EN_US}/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) Only if the pack was originally pushed to remote clients using
update_dbclients, re-run update_dbclients after the pack was
successfully uninstalled on the server to "push" the uninstall.




==================================
VI. CURRENT MAINTENANCE PACK INDEX
==================================

This section contains a master index for all UNIX packages of Etracks that
have been fixed in this release, sorted according to the containers that
they comprise.


NB_60_6_M
---------
819221 1065715 1133900 971561 1051431 1064859 917571 1050256 1077696 1047273
786040 1086515 962767 937157 971736 1019102 1060918 1075048 1075976 1101998
1110609 1102522 1108542 1112393 1099114 1089269 1102716 1081386 1118152 1053711
1122376 1056577 1016205 1103635 1032459 1122873 1078507 1081410 856463 1119141
609282 788886 1125132 1074817 701767 1058587 930868 1124179 1128964 1115039
1061995 1032486 993132 1077799 1125794 1034245 991063 1067776 1062667 1129777
1130930 1131165 1131156 1101047 999338 862454 1059861 1132293 1072957 1087582
834749 1133604 1131174 1131176 1131169 1064771 1096991 1118074 1127677 1124931
1098793 1131177 1131183 1094037 1131285 1128915 1136368 1052440 1054432 1129714
1054522 1122310 1016365 1030320 1138853 1051726 1139766 1107694 1138823 1141194
1049452 1143290 1141860 1131162 1078652 1141801 1146112 1145873 1141129 1043447
1150050 1137310 1154517 1154458 829241 1152641 1142057 1157508 1077555 1161182
1161349 1163510 1161334 1167061 1166792 1150787 1151846 1174720 1162317 1159724
1177687 1173328 1176655 1176304 1177982 1177072 1178397 1140137 1183648 1176200
1182020 1177985 1182062 1173920 1186192 1187051 1165566 1190469 1143454 1055679
1188445 1190635 1190602 1188080 1198270 1210874

NB_ADC_60_6_M
-------------
1111632 1118215 1116287 1131098 1119235 1137969 1155362 1161161 1127680 1152595
1170164 791283 1178736 1183173 1179361 1186775 1187805

NB_BBS_60_6_M
-------------
1113798 1128744 1134158 1091226

NB_BMR_60_6_M
-------------
1100826 1116059 1109594 1115944 1119044 1130594 1131126 602147 1162774 1148909
1172182 1171778 1166347 1159518 1160487 1177593 1182143 1181897

NB_CLT_60_6_M
-------------
819221 1065715 1133900 971561 1051431 1064859 917571 1050256 1077696 1047273
786040 1086515 962767 937157 971736 1019102 1060918 1075048 1075976 1101998
1110609 1102522 1108542 1112393 1099114 1089269 1102716 1081386 1118152 1053711
1122376 1056577 1016205 1103635 1032459 1122873 1078507 1081410 856463 1119141
609282 788886 1044598 1126542 1126545 1125132 1074817 701767 1058587 930868
1124179 1128964 1115039 1061995 1032486 993132 1077799 1125794 1034245 991063
1067776 1062667 1129777 1130930 1131165 1131156 1101047 999338 862454 1059861
1132293 1072957 1087582 834749 1133604 1131174 1131176 1131169 1064771 1096991
1118074 1127677 1124931 1098793 1131177 1131183 1094037 1131285 1128915 1136368
1120743 786841 1052440 1054432 1129714 1054522 1122310 1016365 1030320 1138853
1051726 1139766 1107694 1138823 1141194 1049452 1143290 1141860 1131162 1078652
1141801 1146112 1145873 1141129 1043447 1150050 1137310 1154517 1154458 829241
1152641 1142057 1157508 1077555 1161182 1161349 1163510 1161334 1167061 1168990
1166792 1150787 1151846 1172601 1002113 1174720 1162317 1159724 1177687 1173328
1176655 1176304 1177982 1177072 1178397 1140137 1183648 1176200 1182020 1177985
1182062 1173920 1186192 1187051 1165566 1190469 1143454 1055679 1188445 1190635
1190602 1188080 1198270 1210874

NB_DB2_60_6_M
-------------
1014122 1152840

NB_DMP_60_6_M
-------------
1135508 1162159

NB_ENC_60_6_M
-------------
1172601

NB_INX_60_6_M
-------------
1112364

NB_JAV_60_6_M
-------------
1096255 1113358 1066322 1066330 1067652 1039772 1026840 1115060 1135357 1137877
1173731 1179942

NB_LOT_60_6_M
-------------
1095195 1075535 969293 1075540 1060843 1075552 1129723 1154418 1167648

NB_NOM_60_6_M
-------------
1131094 1131134 1131137 1131103 1131138 1131108 1137125 1171031 1167658 1167639
1170302 1186173

NB_ORA_60_6_M
-------------
1095133 1173881

NB_SAP_60_6_M
-------------
642819 637916 1082843

NB_SMC_60_6_M
-------------
1078643

NB_SMU_60_6_M
-------------
1101108 1114252 1157026

NB_SYB_60_6_M
-------------
1112364 1115046

NB_VLT_60_6_M
-------------
1104857 1075835 619266 1051239 1054735 1168696 1169329 1160350




=============================
VII. MAINTENANCE PACK CONTENT
=============================
This section contains the maintenance pack 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 Maintenance Pack
subsection describes a feature, enhancement, or issue fixed with this
Maintenance Pack.

Description
Describes a particular problem contained in this pack.

** 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, Symantec strongly recommends
the "best practice" of being at the latest available patch level.

Additional Notes
Any additional information regarding a problem is included.



Current Maintenance Pack
------------------------
Each item listed in this section describes a feature, enhancement, or change
that comprises this Maintenance Pack. Please read this section thoroughly to
understand the contents of this update.
--------------------------------------------------------------------------------
Etrack Incident = ET1095133
Associated Primary Etrack = ET1075401
Titan cases: 220-099-852

Description:
When using the Oracle templates created with NetBackup, the
"NB_ORA_SCHED" parameter is not used when the actual RMAN commands
are executed.

This happens only for the first or initial subset of channel
allocations. Meaning, if the database is backed up, and then the
archive logs and the control file, the "NB_ORA_SCHED" parameter is
not used just for the database portion, it is also passed for the
archive logs and control file.

When the templates are converted to backup scripts, the "NB_ORA_SCHED"
parameter is present in all backup steps.

Workaround:
To resolve this issue, convert the Template to a script and use the
script in the policy.
--------------------------------------------------------------------------------
Etrack Incident = ET1173881

Description:
Oracle Block Level Incremental (BLI) backups would fail on a cluster
file system because the checkpoint could not be mounted.
--------------------------------------------------------------------------------



Maintenance Pack History
------------------------

This section contains an accumulative list of all maintenance pack information
contained in previous releases.

=============
NB_ORA_60_5_M
=============
--------------------------------------------------------------------------------
Etrack Incident = ET570561
Associated Primary Etrack = ET808113
Titan cases: 240160597

Description:
This fix improves the performance of advanced method Oracle database
backups.
--------------------------------------------------------------------------------
Etrack Incident = ET863428
Associated Primary Etrack = ET806075
Titan cases: 280-518-572

Description:
The Oracle agent no longer ignores BPBACKUP_SCHED in the bp.conf file on
the client system.
--------------------------------------------------------------------------------
Etrack Incident = ET534732

Description:
A fix was added that resolves a UTF8 to GB18030 conversion problem in the
Oracle XML Archiver agent in which GB18030 strings were being truncated.
--------------------------------------------------------------------------------
Etrack Incident = ET427447

Description:
In the NetBackup Oracle client restore user interface, an incorrect restore
may occur if you select the "Point In Time rollback" restore type, go
through the restore wizard and supply a tag to the "backup set identifier"
field, and then run the restore. The result is it restores from the latest
backup instead of restoring from the backup with the supplied backup set.

In addition, if you choose to save it as template, the key words
"from tag ..." are missing from RMAN RUN statement in the template. And
if you choose to run the restore from a normal backup, the tag field works
as expected.
--------------------------------------------------------------------------------
Etrack Incident = ET799779
Associated Primary Etrack = ET799774
Titan cases: 290-174-274

Description:
The recovery manager (RMAN) catalog maintenance functions were taking too
long and using excessive resources on the master server.

Additional Notes:
To ensure a faster search for catalog entries, use a %t on the format
parameter during an Oracle backup.
--------------------------------------------------------------------------------
Etrack Incident = ET923486
Associated Primary Etrack = ET922740
Titan cases: 290-502-581

Description:
jbpSA/bpubsbora would produce a segmentation fault when the oratab file had
more than 50 valid entries.
--------------------------------------------------------------------------------
Etrack Incident = ET937829

Description:
Accessing the Oracle wizard though the BAR Java user interface causes an
error box to appear with the following messages after clicking on the
"Oracle" node.

- /usr/lib/dld.sl invalid version for shared library
- /usr/openv/java/jre/lib/PA_RISC2.0/libjava.sl (status 134)
--------------------------------------------------------------------------------
Etrack Incident = ET926476

Description:
bporaexp no longer fails with a segmentation fault on X64 Windows systems.
--------------------------------------------------------------------------------
Etrack Incident = ET973638

Description:
Added support for compressed backups to Oracle & MSSQL.
--------------------------------------------------------------------------------
Etrack Incident = ET995110
Associated Primary Etrack = ET983973
Titan cases: 280-987-773

Description:
Because of changes in Oracle10gR2, multi-streamed backups will restore using
one stream.

Workaround:
To avoid this issue, use the RMAN syntax: "SET PARALLELMEDIARESTORE OFF;".
--------------------------------------------------------------------------------
Etrack Incident = ET996117
Associated Primary Etrack = ET990855
Titan cases: 220-092-720

Description:
Changes were made so that direct calls to the signal (),SBT implementation
no longer occurs.

--------------------------------------------------------------------------------
Etrack Incident = ET1029007
Associated Primary Etrack = ET1026162
Titan cases: 320-040-465

Description:
Oracle stream-based backups would intermittently fail with an error 25.
--------------------------------------------------------------------------------
Etrack Incident = ET1028004
Associated Primary Etrack = ET1021953
Titan cases: 281-064-967

Description:
A change was added to remove BLI clones that would sometimes remain on a
system after a failed Oracle BLI backup.
--------------------------------------------------------------------------------




=============
NB_ORA_60_4_M
=============
Etrack Incident = ET609197

Description:
Oracle, DB2, and XBSA aplication programmer interface (API) agents
(such as, Teradata) performing shared memory backups (that is, the media
server and the client are the same machine) or restores were using
excessive CPU resources on Linux. Changes have been added to address
this issue.

The database agents debug log shows high "delayed" counts:

08:54:33.385 [4799] <4> CleanUpShM: INF - dbclient waited 40577 times for
emptybuffer, delayed 227209505 times
--------------------------------------------------------------------------------
Etrack Incident = ET527990

Description:
Added error detection for Oracle restores that would fail because of
corruption.
--------------------------------------------------------------------------------
Etrack Incident = ET643841

Description:
A Recovery Manager (RMAN) restore could not be redirected to an Oracle
instance owned by a different Oracle user.

Additional Notes:
After you have installed this pack, a new backup of the source Oracle
database is required so the correct group permission is on the image to
allow the alternate user to performed a restore to the new
instance/database.
--------------------------------------------------------------------------------
Etrack Incident = ET613708

Description:
An Oracle 9.2 backup on a Linux RedHat 2.1 AS x86 system failed with
a dl_lookup_symbol error in the Oracle trace file.
--------------------------------------------------------------------------------
Etrack Incident = ET763208

Description:
A change has been added to correct a libobk library load failure that
occurred with Oracle 8.1.7 on Tru64 platforms.
--------------------------------------------------------------------------------
Etrack Incident = ET784650

Description:
NetBackup communication between components that were separated by a
firewall did not work. For instance, when a master server was behind the
firewall and a media server was outside the firewall, all communication
from the master server had an internal host address that was not accessible
from outside systems.

This is the same when clients and other services are in question.

Additional Notes:
To activate NAT address replacement, systems outside of the firewall should
have the FIREWALL_IN parameter specified in their bp.conf/registry.

Format: FIREWALL_IN=hostname1,nat_address1|hostname2,nat_address2|...

Where: <hostname> is the name of the host system that needs to be accessed
and <nat_address> is the actual NAT address for the firewall to do
forwarding.
--------------------------------------------------------------------------------



=============
NB_ORA_60_2_M
=============
Etrack Incident = ET416985

Description:
The NetBackup Oracle agent would not recognize the RMAN PARMS option.
--------------------------------------------------------------------------------
Etrack Incident = ET492770

Description:
Users can now use the NetBackup-Java Administration Console to perform
backups and restores of DB2 and Oracle table spaces with multi-byte
character names on Solaris and HP-UX.
--------------------------------------------------------------------------------
Etrack Incident = ET391070

Description:
Added support for the following UTF8 locales:

- ja_JP.UTF-8
- zh_CN.UTF-8
--------------------------------------------------------------------------------
Etrack Incident = ET525104

Description:
Oracle users can now perform XML exports/imports on tables that contain
timestamps and interval data types.
--------------------------------------------------------------------------------
Etrack Incident = ET320480

Description:
This fix prevents a segmentation fault on Windows that can occur when
using the Backup, Archive, and Restore (BAR) user interface to access
multiple Oracle instances.
--------------------------------------------------------------------------------
Etrack Incident = ET525101

Description:
A change has been made to prevent any potential segmentation faults that
can occur on Windows when performing multi stream Oracle backups.
--------------------------------------------------------------------------------
Etrack Incident = ET412591

Description:
Oracle proxy backups, using multiple RMAN channels, fail with a
status 156, �snapshot error encountered.�
================================================================================



=============
NB_ORA_60_1_M
=============

Etrack Incident = ET376807

Description:
Users can now use the NetBackup-Java Administration Console to perform
backups and restores of DB2 and Oracle table spaces with multi-byte
character names on Solaris and HP-UX platforms.
================================================================================




Terms of use for this information are found in Legal Notices.

Search

Survey

Did this article answer your question or resolve your issue?

No
Yes

Did this article save you the trouble of contacting technical support?

No
Yes

How can we make this article more helpful?

Email Address (Optional)