You are on page 1of 24

SOA Suite 11g R1 Administration Configuring & Monitoring JCA Adapter

Description: BISP is committed to provide BEST learning material to the beginners and advance learners. In the same series, we have prepared a complete end-to end Hands-on Beginner’s G ide !or "racle So#. The doc ment !oc ses on $on!ig ring % &onitoring '$# #dapter. 'oin o r pro!essional training program and learn !rom e(perts.

Histor)* +ersion -.. -..

,escription $hange Initial ,ra!t 3eview4.

# thor Shiva /ant Pande) #mit Sharma

P blish ,ate 0.st 1ov 0-.2 05th 1ov 0-.2

www.bispsol tions.com

www.bisptrainigs.com

www.h)periong r .com

Page .

Contents
$ontents....................................................................................................................................... 0 '$# #dapter............................................................................................................................... 2 $on!ig ring end point properties o! inbo nd '$#6!ile #dapter..................................................7 $on!ig ring end point properties o! o tbo nd '$#6!ile #dapter...............................................7 &onitoring Inbo nd oracle '$#6!ile #dapters..........................................................................5 &onitoring " tbo nd oracle '$#6!ile #dapters ......................................................................0.

www.bispsol tions.com

www.bisptrainigs.com

www.h)periong r .com

Page 0

JCA Adapter
'ava $onnector #rchitect re 8'$#9 or '0EE '$# is a generic architect re based on 'ava technolog) that is sed !or connecting and integrating the legac) s)stems incl ding databases ,the EIS 8Enterprise In!ormation S)stems9 and '$# standard compliant application servers as part o! E#I 8Enterprise #pplication Integration9 sol tions .#s a analog), : st as the 'ava ,atabase $onnectivit) 8',B$9 is a database connectivit) standard that is speci!icall) sed to connect 'ava EE applications to databases8generall) relational based9, the '$# is a generic architect re that provides a standardi;ed legac) s)stem-independent wa) to comm nicate with the di!!erent bac<end s)stems !or '0EE incl ding an) t)pe o! databases and applications to be integrated !or the so!tware pro:ect. #rchitect re is described b) the speci!ication as !ollows*
• Connection management=$onnection management enables an application server to pool

connections to the nderl)ing EIS and enables application components to connect. This leads to a scalable application environment that can s pport a large n mber o! clients. • Transaction management=Transaction management enables an application server to se a transaction manager to manage transactions across m ltiple reso rce managers. This contract also s pports transactions that are managed internal to an EIS reso rce manager witho t the necessit) o! involving an e(ternal transaction manager.
• Security management=Sec rit) management red ces sec rit) threats to the EIS and

protects val able in!ormation reso rces managed b) the EIS.'$# +ersion ..7 adds s)stem contracts to the speci!ication as !ollows*
• Life cycle management=>i!e c)cle management enables an application server to manage

the li!e c)cle o! a reso rce adapter !rom initiation thro gh pgrades to obsolescence. This contract provides a mechanism !or the application server to bootstrap a reso rce adapter instance d ring its deplo)ment or application server start p, and to noti!) the reso rce adapter instance d ring its deplo)ment or d ring an orderl) sh tdown.

or! management=?or< management enables a reso rce adapter to do wor< 8monitor networ< endpoints, invo<e application components, and so on9 b) s bmitting wor< instances to an application server !or e(ec tion. The application server dispatches threads to e(ec te s bmitted wor< instances. This allows a reso rce adapter to avoid creating or managing threads directl), and allows an application server to e!!icientl) pool threads and have more control over its r ntime environment. The reso rce adapter can control the transaction conte(t with which wor< instances are e(ec ted. adapter to propagate an imported transaction to an application server. This contract also allows a reso rce adapter to transmit transaction completion and crash recover) calls initiated b) an EIS, and ens res that the #tomicit), $onsistenc), Isolation and , rabilit) 8#$I,9 properties o! the imported transaction are preserved. as)nchrono sl) deliver messages to message endpoints residing in the application server, independent o! the speci!ic messaging st)le, messaging semantics and messaging in!rastr ct re sed to deliver messages. This contract also serves as the standard message provider pl g abilit) contract that allows a wide range o! message providers 8'ava &essage

• Transaction inflo" management=Transaction in!low management enables a reso rce

• Message inflo" management=&essage in!low management enables a reso rce adapter to

www.bispsol tions.com

www.bisptrainigs.com

www.h)periong r .com

Page 2

Service 8'&S9, 'ava #PI !or @&> &essaging 8'#@&9, and so on9 to be pl gged into an) 'ava EE compatible application server with a reso rce adapter.

www.bispsol tions.com

www.bisptrainigs.com

www.h)periong r .com

Page A

Configuring end point properties of inbound JCA/file Adapter.
Stepwise proced re o! con!ig ring end point properties o! inbo nd '$# #dapter. Step 1: Start weblogic admin server ---B "pen browser ---B"pen "racle Enterprise &anager ..g C sion &iddle?are $ontrol 8b) writing D3> http*66localhost*E--.6em9

>ogin   

to "racle C sion &iddleware $ontrol Enter Dser 1ame F weblogic Password F welcome. $lic< >ogin

Step #: E(pand S"# b) clic<ing on it

www.bispsol tions.com

www.bisptrainigs.com

www.h)periong r .com

Page 7

Step $* E(pand soa !older ---B right clic< on soa- in!ra select service % re!erences % clic< on it to : mp into services % re!erence home page.

Step %: $lic< on services % choose a service on it !or e(ample !ileread service % clic< to open it .

www.bispsol tions.com

www.bisptrainigs.com

www.h)periong r .com

Page G

Step &: clic< on properties

www.bispsol tions.com

www.bisptrainigs.com

www.h)periong r .com

Page E

Adding 'redefined 'roperties for an (n)ound Adapter Step *: $lic< on #dd b tton to add a new propert) with its val e .

Step +: clic< on browse icon so clic< on it to browse a new propert)

www.bispsol tions.com

www.bisptrainigs.com

www.h)periong r .com

Page H

Step ,: Scroll down % select a propert) relevant to '$# adapter con!ig ration !or e(ample clic< on 'u)lis- Si.e then clic< "/

Step /: Enter p blish si;e .- into +al e col mn .

$lic< to #ppl) www.bispsol tions.com www.bisptrainigs.com www.h)periong r .com Page 5

To save properties clic< IES

$lic< "<

S ccess! ll) added p blish Si;e 83ead9 propert)

Deleting 'redefined 'roperties for an (n)ound Adapter

www.bispsol tions.com

www.bisptrainigs.com

www.h)periong r .com

Page .-

Step 10: $lic< p blish Si;e to select it % then $lic< to delete

Step 11: It will prompt a con!irmation message as<ing that J,o )o want to delete propert) so clic< IES

1ow propert) s ccess! ll) deleted . 1diting 'redefined 'roperties for an (n)ound Adapter Step 1#: To edit a partic lar propert) clic< to its val e % Edit it. Cor e(ample i have changed here #3$HC">,E3 to "DTC">,E3 as shown below

www.bispsol tions.com

www.bisptrainigs.com

www.h)periong r .com

Page ..

$lic< to #ppl) % clic< "/ to in!ormation.

So whenever a !ile is read !rom In!older will be saved into "DTC">,E3 rather than I1C">,E3 Step 1$: "pen soa composite #pplication home page o! !ile readK..-L % observe that there is no composite instances !o nd % the service is p . So open the I1C">,E3 !rom where !ile is read b) service .

www.bispsol tions.com

www.bisptrainigs.com

www.h)periong r .com

Page .0

Step 1%: >oo< both the !olders i.e in!older % o t!older are empt) .

Step 1&: so p t a !ile inside in!older so that service can read it % <eep it inside o t!older a tomaticall) .

www.bispsol tions.com

www.bisptrainigs.com

www.h)periong r .com

Page .2

wait !or 2- second , % now !ile has been read b) service % <ept a tomaticall) inside o t!older rather than arch!older beca se o! setting has been edited b) ser .

Step 1** "pen !ileread soa composite application home page . Since one !ile has been read b) service % hence one instance is created % the stat s o! instance is completed.

www.bispsol tions.com

www.bisptrainigs.com

www.h)periong r .com

Page .A

Configuring end point properties of outbound JCA/file Adapter.
Step 1+* E(pand soa !older ---B right clic< on soa- in!ra select service % re!erences % clic< on it to : mp into services % re!erence home page

Step 1,: $lic< 3e!erences % then choose a re!erence % clic< on it .Cor e(ample file"riteref so clic< on it.

www.bispsol tions.com

www.bisptrainigs.com

www.h)periong r .com

Page .7

Adding 'redefined 'roperties for an Out)ound Adapter Step 1/: clic< on Properties to Edit ,#dd or delete a partic lar propert) o! re!erence .

Step #0* $lic< on #dd b tton to add a new propert) with its val e so clic< on browse icon so clic< on it to browse a new propert)

Step #1: Select $h n<Si;e % clic< "/

www.bispsol tions.com

www.bisptrainigs.com

www.h)periong r .com

Page .G

Step ##: Enter $h n<Si;e 7-- into +al e col mn .

Step #$ : $lic< to #ppl) % To save properties clic< IES

$lic< "<

s ccess! ll) added $h n<Si;e F 7-- Propert) Deleting 'redefined 'roperties for an Out)ound Adapter Step #%: $lic< $h n<Si;e to select it % then $lic< to delete

www.bispsol tions.com

www.bisptrainigs.com

www.h)periong r .com

Page .E

Step #&: It will prompt a con!irmation message as<ing that J,o )o want to delete propert) so clic< IES

1ow propert) s ccess! ll) deleted . 1diting 'redefined 'roperties for an Out)ound Adapter Editing an) prede!ined propert) is as similar as inbo nd adapter so to edit an) propert) simpl) clic< on its val e % edit it then clic< on #ppl) .

www.bispsol tions.com

www.bisptrainigs.com

www.h)periong r .com

Page .H

Monitoring Inbound oracle JCA/file Adapters.
Step #*: E(pand soa !older --B right clic< on soa-in!ra8#dmin server9 --B clic< to Services % 3e!erences

Step #+: Select desired Service o! '$# #dapter T)pe % clic< on it to monitor . Cor e(ample !ilereadservice

Step #,: $lic< ,ashboard tab inside !ileread service home page to monitor instances % !a lts , recent !a lt % re:ected messages , observe total n mber o! incoming messages vers s server start time into graphical chart . so bl e line indicates total n mber o! messages since server start % brown line indicates !a lts since server start

www.bispsol tions.com

www.bisptrainigs.com

www.h)periong r .com

Page .5

Step #/: $lic< on !a lts % re:ected messages tab % !rom here monitor % search !a lt % re:ected messages b) entering either one or all message in!ormation s ch as Error message contains , !a lt I, , !a lt time !rom , !a lt time to , composite instance id , choose !a lt t)pe 8all !a lts, s)stem !a lts onl) , b siness !a lts onl) , "?S& polic) !a lts onl) 9 then clic< to searc- % view desired error message i! an) .

Step $0: To &onitor % con!ig re Properties o! :ca6!ile adapters clic< on Properties to open it .

www.bispsol tions.com

www.bisptrainigs.com

www.h)periong r .com

Page 0-

Monitoring Outbound oracle JCA/file Adapters
Step $1: E(pand soa !older --B right clic< on soa-in!ra8#dmin server9 --B clic< to Services % 3e!erences

Step $#: Select desired re!erence o! '$# #dapter T)pe % clic< on it to monitor . Cor e(ample !ilewritere!

www.bispsol tions.com

www.bisptrainigs.com

www.h)periong r .com

Page 0.

Step $$: $lic< ,ashboard tab inside !ilewrite re!erence 8Cile adapter9 home page to monitor instances % !a lts , recent !a lt % re:ected messages , observe total n mber o! incoming messages vers s server start time into graphical chart . So bl e line indicates total n mber o! messages since server start % brown line indicates !a lts since server start

www.bispsol tions.com

www.bisptrainigs.com

www.h)periong r .com

Page 00

2ote: Policies can be onl) attached to web service bindings % S"# components

Step 2A* : $lic< on !a lts % re:ected messages tab % !rom here monitor % search !a lt % re:ected messages b) entering either one or all message in!ormation s ch as Error message contains , !a lt I, , !a lt time !rom , !a lt time to , composite instance id , choose !a lt t)pe 8all !a lts, s)stem !a lts onl) , b siness !a lts onl) , "?S& polic) !a lts onl) 9 then clic< to searc- % view desired error message i! an)

www.bispsol tions.com

www.bisptrainigs.com

www.h)periong r .com

Page 02

Step 27* To &onitor % con!ig re Properties o! '$#6!ile adapters clic< on Properties .

www.bispsol tions.com

www.bisptrainigs.com

www.h)periong r .com

Page 0A