L|nk|ng Net8ackup for Crac|e w|th kMAN

Problem
Linking NetBackup Ior Oracle with RMAN
Solution

Linking RMAN with a library provided by NetBackup Ior Oracle on UNIX is the only
NetBackup requirement. BeIore writing to sequential devices such as tape, you must link the
Oracle Server soItware with the media management API library installed by NetBackup Ior
Oracle on UNIX. Oracle uses this library when it needs to write to, or read Irom devices
supported by Media Manager.

* To link Oracle with NetBackup for Oracle on UNIX

1. Become the Oracle user.
su - oracle

2. Shutdown all oI the Oracle instances (SIDs). The user must connect as sysdba, either using
OS Authentication or Oracle Authentication (set up in the Oracle password Iile). The
Iollowing example is Ior Oracle9i.
Set the ORACLESID environment variable to the Iirst SID.
Connect as sysdba using OS Authentication:
sqlplus /nolog
connect / as sysdba
shutdown immediate
exit
Connect as sysdba using Oracle Authentication (via password Iile):
sqlplus /nolog
connect userid/password as sysdba
shutdown immediate
exit
Change the ORACLESID environment variable to any other SID that uses this Oracle
installation and repeat above commands.
. Set up automatic linking.
a. Change directory to installpath/netbackup/bin/
b. Run the oraclelink script:
./oracle_link
This script determines the Oracle version level and then links Oracle to NetBackup
accordingly. All output Irom this script will be captured in a /tmp/make_trace.pid Iile. To
change the trace Iile location, change the TRvariable in the oracle_link script.





Linking tbe Uracle Recovery Manager {RMAN] witb
NetBackup for UNIX and Linux platforms
The procedures in this topic show how to link RMAN with NetBackup. The automatic
method is preIerred. Use the manual method only iI the link script Iails or iI you receive
Oracle messages to indicate that manual linking is required.
Link the library with NetBackup in the Iollowing circumstances:
O II you licensed NetBackup Ior Oracle Ior the Iirst time.
Note: II you have a later Oracle release, you do not have to use the make(1) command to
make a new Oracle executable to use the API library because the Oracle executable
always searches Ior the shared library (Ior example,
$ORACLE_HOME/lib/libobk.so).
The procedures reIlect this change and describe the conditions under which you need to
issue the make(1) command.
To automatically link the Oracle Recovery Manager (RMAN) with NetBackup
1. Run the oracle_link script that is located in /usr/openv/netbackup/bin/.
This script determines the Oracle version level and then links Oracle with the
NetBackup API library. This script writes output to /tmp/maketrace.pid~. To
change the trace Iile location, change the MAKETRACE variable in the oracle_link
script.
2. II this installation is an upgrade, restart the Oracle instance.
To manually link the Oracle Recovery Manager (RMAN) with NetBackup





CENERAL ERRUR: Uracle backups failing on HP-UX . client witb
URA-: Failed to load Media Management Library errors due to
incorrect library defined in SBTLIBRARY.
Problem
GENERAL ERROR: Oracle backups failing on HP-UX 11.2 client with
"ORA-27211: Failed to load Media Management Library" errors due to
incorrect library defined in SBT_LIBRARY.
Lrror
C8A27211 lalled Lo load Medla ManagemenL Llbrary

SoluLlon
Cverv|ew

1he Cracle reLurn code C8A27211 lmplles a fallure Lo load a shared ob[ecL llbrary lnLo process
space Cracle 8ecovery Manager (8MAn) backups wlll fall wlLh a message C8A27211 lalled Lo
load Medla ManagemenL Llbrary lf Lhe S81_LI8kAk keyword ls deflned and polnLs Lo an lncorrecL
llbrary name 1he S81_LI8kAk keyword musL be seL ln Lhe A8MS clause of Lhe ALLCCA1L
CPAnnLL sLaLemenL ln Lhe 8MAn scrlpL 1hls keyword ls noL valld wlLh Lhe SENDcommand and ls
new Lo Cracle 9l lf Lhls value ls seL lL overrldes Lhe defaulL search paLh for Lhe ||bobk llbrary 8y
defaulLS81_LI8kAk ls noL seL

1roub|eshoot|ng

lf an C8A27211 error ls seen for an Cracle 8MAn backup lL ls necessary Lo revlew Lhe Cracle 8MAn
scrlpL and verlfy lf S81_LI8kAk ls elLher noL seL or ls seL correcLly lf seL Lhe fllename should be
||bobks| for Pux 10 1100 and 1111 buL ||bobkso for Pux 1123 (la64) cllenLs

Lxample of an lnvalld enLry for Pux 1123 (la64) cllenLs
PARMS='SBT_LIBRARY=/usr/openv/netbackup/bin/libobk.sl'

Lxample of a correcL enLry for Pux 1123 (la64) cllenLs
PARMS='SBT_LIBRARY=/usr/openv/netbackup/bin/libobk.so'

Master Server Log I||es n/a

Med|a Server Log I||es n/a

C||ent Log I||es

1he 8MAn log flle on Lhe cllenL wlll show Lhe followlng error message
RMAN-00571: ===========================================
RMAN-00569: ======= ERRJR MESSAGE STACK FJLLJWS =======
RMAN-00571: ===========================================
RMAN-03009: failure of allocate command on ch00 channel at 05/21/2005
16:39:17
JRA-19554: error allocating device, device type: SBT_TAPE, device name:
JRA-27211: Failed to load Media Management Library
Additional information: 25

keso|ut|on

1he Cracle reLurn code C8A27211 lmplles a fallure Lo load a shared ob[ecL llbrary lnLo process
space Cracle 8MAn backups wlll fall wlLh a message C8A27211 lalled Lo load Medla
ManagemenL Llbrary lf Lhe S81_LI8kAk keyword ls deflned and polnLs Lo an lncorrecL llbrary
name

1o manually seL LheS81_LI8kAk paLh follow Lhe sLeps descrlbed below

1 Modlfy Lhe 8MAn ALLCCA1L CPAnnLL sLaLemenL ln Lhe backup scrlpL Lo reference Lhe Pux
1123 llbrary flle dlrecLly
PARMS='SBT_LIBRARY=/usr/openv/netbackup/bin/libobk.so'

Note 1hls seLLlng would be added Lo each ALLCCA1L CPAnnLL sLaLemenL A resLarL of Lhe Cracle
lnsLance ls noL needed for Lhls change Lo Lake affecL

2 8un a LesL backup or walL for Lhe nexL scheduled backup of Lhe Cracle daLabase