TAFJ-AS TAFJ R16
TAFJ-AS TAFJ
Amendment History:
Revisio n
Date Amended
Name
Description
1
1st A Ap pril 2011
TAFJ team
Initial version
2
7st F Fe ebruary 2012
H. Aubert
R12GA review
1! January 201
J". #$arpin
R1GA review
%
20t$ F Fe ebruary 201
R. &in'ent
R1%GA review
!
1( )ar'$ 201%
J".#$arpin
*ervlet review
6
2%t$ J Ju une 201%
J". #$arpin
+ntry points ,o'umentation- ebservi'es
7
20t$ A Au u/ust 201%
J". #$arpin
TAFJ te'$ni'al monitor an, webapp basi' aut$enti'ation
26t$ * *ep epte tem mber 201 01% %
R. &in' n'en entt
(
! February 201!
J". #$arpin
10
6t$ )ar'$ 201!
H. Aubert
11
1t$ A Ap pril 201!
J". #$arpin
"ew servlet u un'tionalities
12
1!t$ ) )a ay 201!
J". #$arpin
++6 '$an/e 3 #ontainer mana/e, +J4
1
2n, *e *ep ptember 20 201!
J". #$ #$arpin
4ean ma mana/e, +J +J4
1%
1t$ J Ja anuary 2016
J". #$arpin
*anity '$e'5
1!
1!t$ ) )a ar'$ 2016
J". #$arpin
R16 A)R review
A,, A, ,e, TA TAFJ FJ *es essi sion ons s mo mon nito torr ,o ,o'u 'um men enta tati tion on Te'$ni'al monitor 1.!%T+)" R1! A)R review
a/e 2
TAFJ-AS TAFJ
Amendment History:
Revisio n
Date Amended
Name
Description
1
1st A Ap pril 2011
TAFJ team
Initial version
2
7st F Fe ebruary 2012
H. Aubert
R12GA review
1! January 201
J". #$arpin
R1GA review
%
20t$ F Fe ebruary 201
R. &in'ent
R1%GA review
!
1( )ar'$ 201%
J".#$arpin
*ervlet review
6
2%t$ J Ju une 201%
J". #$arpin
+ntry points ,o'umentation- ebservi'es
7
20t$ A Au u/ust 201%
J". #$arpin
TAFJ te'$ni'al monitor an, webapp basi' aut$enti'ation
26t$ * *ep epte tem mber 201 01% %
R. &in' n'en entt
(
! February 201!
J". #$arpin
10
6t$ )ar'$ 201!
H. Aubert
11
1t$ A Ap pril 201!
J". #$arpin
"ew servlet u un'tionalities
12
1!t$ ) )a ay 201!
J". #$arpin
++6 '$an/e 3 #ontainer mana/e, +J4
1
2n, *e *ep ptember 20 201!
J". #$ #$arpin
4ean ma mana/e, +J +J4
1%
1t$ J Ja anuary 2016
J". #$arpin
*anity '$e'5
1!
1!t$ ) )a ar'$ 2016
J". #$arpin
R16 A)R review
A,, A, ,e, TA TAFJ FJ *es essi sion ons s mo mon nito torr ,o ,o'u 'um men enta tati tion on Te'$ni'al monitor 1.!%T+)" R1! A)R review
a/e 2
TAFJ-AS TAFJ
16
10t$ J Ja anu nua ary 20 201 17
J".. #$a J" $arp rpiin
)4s re res spo pon nse ses s a, a,, , ti time meTo To8 8ive para rame mete terr
a/e
TAFJ-AS TAFJ
Copyright #opyri/$t 9': 201% T+)+";* H;8I"G* "& All ri/$ts reserve,. T$is ,o'ument 'ontains proprietary inormation t$at is prote'te, by 'opyri/$t. "o part o t$is ,o'ument may be repro,u'e,- transmitte,- or ma,e available ,ire'tly or in,ire'tly to a t$ir, party wit$out t$e e
8imite,. Re'eipt o t$is material ,ire'tly T+)+";* => 8imite, 'onstitutes its e
Erra ta a nd Co m m e n t s I you $ave any 'omments re/ar,in/ t$is manual or wis$ to report any errors in t$e ,o'umentation- please ,o'ument t$em an, sen, t $em to t$e a,,ress below? Te'$nolo/y epartment Temenos Hea,@uarters *A 2 Rue ,e l+'ole,e#$imie#H 120! Geneva*witBerlan, Tel *4? C%1 90: 22 70 11!0 Fa
a/e %
TAFJ-AS TAFJ
Table o #ontents #opyri/$t.......................................... ......................................... ......................................... .................... % +rrata an, #omments.................................... ......................................... ........................ ....................... % ;verview............................................. ........................................ ................................. .......................... Appli'ation server 'oni/uration.............................................................................................................. TAFJA* T2% 'omponent................................ ........................................ ................................ ............... (
J)* Re@uestEReply '$annel.............................................................................................10 )4 an, +J4 mappin/..................................................................................................... 11 )4 #omponents 'oni/uration........................................................................................12 TAFJJ++)4.arE)+TAI"FEebar.
TAFJJ++)4.arE)+TAI"FEbosseb.
TAFJJ+++J4.arE)+TAI"FEbosseb.
$antom )4 +J4JAR #omponent 'oni/uration...........................................................2 Optional properties.........................................................................................................% TAFJJ++ARTAFJ *ervlet #omponent........................................................................................6
&eriy installation? TAFJ++ main pa/e...............................................................................( Gettin/ TAFJ installation ,etails? tia/*ervlet...................................................................%0 Gettin/ routine 'ompilation ,etails? t*$ow*ervlet..............................................................%1 Runnin/ a #;4 wit$ TAFJ? +
servlet.................................................................................................................%7 a/e !
TAFJ-AS TAFJ
TAFJ +ntry points ,o'umentation......................................................................................!1 TAFJ ++ +ntry points....................................... ......................................... ......................... .................. !1
*yn'$ronous invo'ation.................................................................................................... !1 *yn'$ronous invo'ation 3 ebservi'e..............................................................................! *yn'$ronous invo'ation 3 +J4..........................................................................................!% #ustom +J4 invo'ation..................................................................................................!! #lient appli'ation 'lasspat$ setup..................................................................................!7 JBoss............................................................................................................................. !7 Weblogic........................................................................................................................ !7 Websphere.................................................................................................................... !7 TAFJ*ervi'es.war 3 ebservi'e 'omponent.......................................................................................!(
;F* webservi'e................................................................................................................ !( *8............................................................................................................................ !( Invo'ation...................................................................................................................... !( *ubroutine Invo5er webservi'e 9#A88AT:.......................................................................!( *8............................................................................................................................ !( Invo'ation...................................................................................................................... !( T+# +vents............................................. ......................................... .............................. ...................... 60 TAFJ *essions )onitor...................................... ......................................... ......................................... 61 TAFJ Te'$ni'al )onitor......................................... ........................................ ................................... .... 6
Java melo,y overview.......................................................................................................6! Java melo,y 'oni/uration.................................................................................................6! )onitorin/ ilter an, listener...........................................................................................6! arameters.................................................................................................................... 66 +J4 monitorin/...............................................................................................................6( 8imitation an, 5nown issues..............................................................................................6( ebsp$ere appli'ation server........................................................................................6( J4oss 6 +A..................................................................................................................70 Mbeans.......................................................................................................................... 70
#learin/ all statisti's an, /rap$s.......................................................................................71 TAFJ*anity'$e5.war 3 #oni/uration vali,ation...................................................................................72
resentation...................................................................................................................... 72 ro'ess............................................................................................................................. 7% Appli'ation parsin/.........................................................................................................7! a/e 6
TAFJ-AS TAFJ
Appli'ation server 'oni/uration parsin/........................................................................77 &ali,ation rules- events- i< an, tips...............................................................................7( &ali,ation report............................................................................................................. *e'urin/ web appli'ations...................................... ......................................... ............................ ......... (0
4asi' Aut$enti'ation 'ommon 'oni/uration......................................................................(0 4asi' Aut$enti'ation J4oss...............................................................................................(1 ebapp......................................................................................................................... (1 Jboss +A6 ,eployment................................................................................................(1 4asi' Aut$enti'ation eblo/i'..........................................................................................(1 ebapp......................................................................................................................... (2 eblo/i' 12' ,eployment..............................................................................................(2 4asi' Aut$enti'ation ebsp$ere.......................................................................................( ebapp......................................................................................................................... ( A* .! ,eployment..................................................................................................... (
a/e 7
TAFJ-AS TAFJ
Overview TAFJ J++ appli'ation is pa'5a/e, wit$in TAFJJ+++AR.ear TAFJJ+++AR.ear ile. ile. epen,in/ on your appli'atio epen,in/ appli'ation n server version you $ave to /et t$e 'orrespon,in/ ear ile rom TAFJH;)+EappserverE;=RA*+R&+RR;&I+RE&+R*I;"
TAFJJ+++AR.earr 'ontains ? TAFJJ+++AR.ea o
TAFJJ++)4.ar TAFJJ++)4 .ar ? )essa/e riven 4eans to $an,le J)* messa/es
o
TAFJJ+++J4.arr ? +nterprise Java 4eans to pro'ess T2% re@uests TAFJJ+++J4.a
o
TAFJJ++ARTAFJ.war TAFJJ++AR TAFJ.war ? *et o servlet an, utilities
o
TAFJJ++*ervi'es.war TAFJJ++*ervi 'es.war ? ebservi'e ebservi'es s to pro'ess T2% re@uests
MDB is MDB is use, in t$is ,o'ument or )essa/e riven 4ean. EJB is EJB is use, in t$is ,o'ument or +nterprise Java 4ean.
A p p li l i c a ti t i o n s er e r ve v e r c o nf nf i g u r a t i o n +
a/e
TAFJ-AS TAFJ
TA FJ - A S T 24 24 c o m p o n e n t T2% Java ,eployment ar'$ite'ture is t$e ollowin/?
Four types o '$annels are use, in T2% ava ,eployment? 1. ;F* Re@ue Re@uestERe stEReply ply base, base, on J)* J)* re@uestE re@uestErepl reply y @ueues. @ueues. T$is '$annel is 'oni/ure,Einstantiate, by ,eault or ;F*- 4rowser- T*- AR#);4T#I4- A)8 an, *+AT. 2. #A #A88 88AT AT Re Re@u @ues estER tERep eply ly ba base se, , on J) J)* * re re@u @ues estE tEre repl ply y @u @ueu eues es.. T$ T$is is '$ '$an anne nell wil illl initialiBe initiali Be a TAFJ *ession wit$ JF.I"ITIA8IK+ an, ,o a #A88 D wit$ parameters. . $ $an anto tom m ba base se, , on re@ue re@uest st J)* Lu Lueu eue. e. T$is '$ann '$annel el is us use, e, to ma mana na/e /e T2% p$antom eature 9start a t$rea, in ba'5/roun, ba'5/roun,:. :. %. T+# +vents. +vents. T2% T2% T+# is is able to publ publis$ is$ T+# +vents +vents on on T+# J)* J)* Topi's. Topi's. T$is T$is J)* topi' 'oul, be 'onsume, by e
a/e (
TAFJ-AS TAFJ
TAFJJ+++AR.earr ile TAFJJ+++AR.ea ile 'ontains our 'omponents? 1. TAFJJ++ TAFJJ++)4. )4.ar ar 'oni/u 'oni/ures res all ,eaul ,eaultt )4 to operate operate T2% ava ava ,eployment,eployme nt- ;F*- T*- T#I4- AR#);4- A)8- *+AT- #A88AT- $antom )4 2. TAFJJ++ TAFJJ+++J4. +J4.ar ar 'oni/ure 'oni/ures s all ,eaults ,eaults +J4 to operate operate T2% ava ava ,eployme ,eploymentnt;F*- T*- T#I4- AR#);4- A)8- *+AT- #A88AT +J4. "ote t$at t$ere is no $antom +J4. . TAFJ TAFJJ++ J++AR ARTAFJ.w TAFJ.war ar provi,es provi,es set set o servlet servlet an, utilitie utilities s 3
ia/ i a/no nost sti' i' too tools ls ? t tia ia/ / E t*$ t*$ow ow
3
+
3
Troubl Tro ubles$ es$oot ootin in/ / an, an, mon monito itorin rin/ / too tools ls
%. TAFJ*ervi TAFJ*ervi'es.w 'es.war ar is an A
J M S R e qu q u e s t / R e p l y c ha ha n n e l #omponent ar'$ite'ture?
a/e 10
TAFJ-AS TAFJ
For J)* Re@uestEReply '$annels- TAFJ sets up )4s to listen on J)* Lueues an, 'onsume J)* messa/es. T$e )4 is 'allin/ an +J4 responsible to pro'ess t$e T2% re@uest. +J4 response is passe, to t$e )4 w$i'$ will sen, a response ba'5 to a reply @ueue. T$e ,eault '$annels are? 1. 2. . %. !. 6. 7. .
;F* #$annel 4R;*+R #$annel T* #$annel AR#);4 #$annel T#I4 #$annels 9T#I4- +A8TH- #;R: A)8 #$annel #A88AT #$annel *+AT #$annel 9Re/ression purpose:
M DB a nd EJB m a p p i n g 4eore ,es'ribin/ $ow )4 an, +J4 'an be 'oni/ure,- it is important to un,erstan, t$e 'oni/uration iles involve, in t$e setup. )4E+J4 #oni/uration is ,one t$rou/$ stan,ar, J++ iles ejb-jar.xml an, appli'ation server spe'ii' ile jboss-ejb.xml- ibm-ejb-jar-bnd.xml! "eblo#ic-ejb-jar.xml respe'tively or 4oss- I4)- eblo/i'. For ea'$ )4E+J4- you 'oul, 'oni/ure mappin/ between an appli'ation resour'e name 9lo/i'al name: an, a spe'ii' appli'ation server name 9p$ysi'al name 3 n,i name:. For e
in
t$e
)+TAI"F
ol,er
o
TAFJJ++)4.ar
an,
a/e 11
TAFJ-AS TAFJ
MD B Co mp o n e n t s co nf i gu r a ti o n )4 'omponents are ,eine, in TAFJJ+++AR.earNTAFJJ++)4.ar. A re@uest E response )4 is usin/ t$e ollowin/ mandatory reso$rces?
A 'onne'tion a'tory to 'onne't to t$e J)* provi,er.
A estination Lueue to re'eive t$e in'omin/ messa/e.
A Reply @ueue to sen, T2% response.
An +J4 to $an,le t$e re@uest an, ,o t$e T2% pro'essin/.
A re@uest E response )4 is usin/ t$e ollowin/ optional properties?
)essa/e pro'essin/? o
An optional ormatter to transorm t$e in'omin/ messa/e 9i.e. ;F*)8 ormatter:.
o
An optional prin'ipal to be passe, to T2%.
Response pro'essin/? o
A messa/e response ,elivery mo,e ? +R*I*T+"T ";" +R*I*T+"T 3 ,eault is ";" +R*I*T+"T or perorman'e reason.
o
An option to sen, t$e response to t$e ,estination ,eine, in t$e messa/e property getJMSReplyTo() - ,isable, by ,eaut.
o
An option to use t$e in'omin/ messa/e messa/e I as t$e 'orrelation I or t$e reply 3 ,isable, by ,eaut.
+rror $an,lin/? o
An option to ,ont sen, to T2% re,elivere, messa/e.
o
An option to i/nore poison messa/e ,epen,in/ on t$e number o messa/e re ,elivery attempt ,isable, by ,eault as it s$oul, be a eature o t$e J)* provi,er.
o
An option to ,is'ar, t$e )4 in 'ase o J)* +<'eption.
a/e 12
TAFJ-AS TAFJ
TAFJJEE_MDB.jar /META- INF/ejb- jar.xml T$e sample below presents t$e main 'oni/uration part or a /iven )4 'alle, OFSTra!actedMD"# it 'oul, be oun, wit$in t$e se'tion $eterpr%!e-bea!& o t$e ejb jar.xml It allows ,einin/ t$e man,atory resour'es presente, above an, ,oesnt ma5e use o optional properties. $'e!!age-dr%ve & $d%!play-a'e &Tra!acted %!teer MD" or OFS $/d%!play-a'e& $ejb-a'e&OFSTra!actedMD" $/ejb-a'e& $ejb-cla!! &co'*te'eo!*taj*'db*Tra!actedMD" $/ejb-cla!!& $'e!!ag%g-type &java+*j'!*Me!!age%!teer $/'e!!ag%g-type & $tra!act%o-type&,ota%er $/tra!act%o-type & $'e!!age-de!t%at%o-type &java+*j'!*ueue $/'e!!age-de!t%at%o-type & $ejb-local-re& $ejb-re-a'e &ejb/OFS.roce!!%g"eaocal $/ejb-re-a'e & $ejb-re-type &Se!!%o$/ejb-re-type& $local&co'*te'eo!*taj*!b*OFS.roce!!%g"eaocal $/local& $ejb-l%&OFS.roce!!%g"ea $/ejb-l%& $/ejb-local-re& $re!ource-re & $de!cr%pt%o &0!ed to get coect%o! to JMS or OFS 1ueue! $/de!cr%pt%o & $re!-re-a'e &j'!/TFJueue,oect%oFactory $/re!-re-a'e& $re!-type&java+*j'!*,oect%oFactory $/re!-type& $re!-aut3&,ota%er $/re!-aut3& $/re!ource-re & $'e!!age-de!t%at%o-re& $de!cr%pt%o &OFS 1ueue$/de!cr%pt%o & $'e!!age-de!t%at%o-re-a'e &j'!/Replyueue $/'e!!age-de!t%at%o-re-a'e& $'e!!age-de!t%at%o-type &java+*j'!*ueue $/'e!!age-de!t%at%o-type & $'e!!age-de!t%at%o-u!age &.roduce!$/'e!!age-de!t%at%o-u!age & $'e!!age-de!t%at%o-l% &j'!/OFSReplyueue $/'e!!age-de!t%at%o-l%& $/'e!!age-de!t%at%o-re& $/'e!!age-dr%ve &
roperty value mar5e, e,itable 'oul, be '$an/e, in 'ase o ,einition o a new '$annel or spe'ii' nee,. Mml pat$ ,isplayname ebname eb'lass messa/in/type transa'tiontype
messa/e,estinationtype +J4 reeren'e 'oni/uration eblo'alreNebrenameN
+
ava<.ms.Lueue ebE;F*ro'essin/4ean8 o'al
#omment *ele
a/e 1
TAFJ-AS TAFJ
eblo'alreNebretype eblo'alreNlo'al eblo'alreNeblin5
Resour'es reeren'e 'oni/uration resour'ereN resrename
resour'ereN restype resour'ereN resaut$ )essa/e ,estination reeren'e messa/e,estinationreN messa/e,estinationrename
*ession 'om.temenos.ta.sb.;F* ro'essin/4ean8o'al ;F*ro'essin/4ean
msETAFJLueue#onne'tio nFa'tory
Java<.ms.#onne'tionFa't ory #ontainer msEReplyLueue
messa/e,estinationreNmessa/e Java<.ms.Lueue ,estinationtype messa/e,estinationreNmessa/e ro,u'es ,estinationusa/e messa/e,estinationre N msE;F*ReplyLueue messa/e,estinationlin5
+J4 property +J4 'lass implementation *pe'iy w$i'$ +J4 is lin5e, to pro'ess t$e re@uest. e,itable 3 t$is eb name must be ,eine, in t$e TAFJJ+++J4.arE)+TA I"FEebar.
a/e 1%
TAFJ-AS TAFJ
Optional properties T$e ollowin/ properties 'oul, be a,,e, wit$in an ebar. $'e!!age-dr%ve& se'tion to reine a spe'ii' )4 setup. *ee table below or ,etaile, e
$-- R7S.O6S7 .RM7T7RS --& $ev-etry & $de!cr%pt%o &De%e re!po!e del%very 'ode (6O6=.7RS5ST76T > 9 .7RS5ST76T > 2) - deault %! o-per!%!tet or peror'ace rea!o $/de!cr%pt%o & $ev-etry-a'e &co'*te'eo!*taj*'db*Tra!actedMD"/re!po!eDel%veryMode $/ev-etrya'e& $ev-etry-type &java*lag*5teger $/ev-etry-type & $ev-etry-value &9$/ev-etry-value & $/ev-etry& $ev-etry & $de!cr%pt%o &De%e ?3et3er 'e!!age %eld JMSReplyTo !3ould be u!ed or re!po!e (te'porary 1ueue) - deault %! al!e $/de!cr%pt%o & $ev-etry-a'e &co'*te'eo!*taj*'db*Tra!actedMD"/!edToJ'!ReplyTo $/ev-etry-a'e & $ev-etry-type &java*lag*"oolea $/ev-etry-type & $ev-etry-value &al!e$/ev-etry-value & $/ev-etry& $ev-etry & $de!cr%pt%o &De%e ?3et3er 'e!!age 5D !3ould be u!ed to %ll-up re!po!e correlat%o %d - deault %! al!e $/de!cr%pt%o & $ev-etry-a'e &co'*te'eo!*taj*'db*Tra!actedMD"/'e!!age5d!,orrelat%o5D $/ev-etry-a'e& $ev-etry-type &java*lag*"oolea $/ev-etry-type & $ev-etry-value &al!e$/ev-etry-value & $/ev-etry& $ev-etry & $de!cr%pt%o &t3e re!po!e t%'e to l%ve % '%ll%!ecod! ro' %t! d%!patc3 t%'e @ deault %! Aero %! ul%'%ted $/de!cr%pt%o & $ev-etry-a'e &co'*te'eo!*taj*'db*Tra!actedMD"/re!po!eT%'eTo%ve $/ev-etry-a'e & $ev-etry-type &java*lag*og $/ev-etry-type & $ev-etry-value &B$/ev-etry-value & $/ev-etry& $-- 7RROR C6D568 .RM7T7RS --& $ev-etry & $de!cr%pt%o &De%e ?3et3er re-del%vered 'e!!age !3ould be %gored - deault %! true a re-del%vered 'e!!age %! ot !et to T24 - ?3e !et to al!e re-del%vered 'e!!age are !et to T24$/de!cr%pt%o& $ev-etry-a'e &co'*te'eo!*taj*'db*Tra!actedMD"/%goreRedel%veredMe!!age $/ev-etry-a'e& $ev-etry-type &java*lag*"oolea $/ev-etry-type & $ev-etry-value &al!e$/ev-etry-value & $/ev-etry&
a/e 1!
TAFJ-AS TAFJ
$ev-etry & $de!cr%pt%o &De%e t3e u'ber o re-del%very atte'pt % ca!e o a%lure - -9 'ea! d%!abled by deault t3e JMS prov%der 3adle! t3e 'a+%'u' u'ber o JMS del%very atte'pt - B 'ea! o re-del%very atte'pt $/de!cr%pt%o & $ev-etry-a'e &co'*te'eo!*taj*'db*Tra!actedMD"/'a+J'!Redel%verytte'pt $/ev-etrya'e& $ev-etry-type &java*lag*5teger $/ev-etry-type & $ev-etry-value &9$/ev-etry-value & $/ev-etry& $ev-etry & $de!cr%pt%o &De%e ?3et3er !etRollbacOly %! called or Sy!te' e+cept%o t3ro? % ca!e o JMS error - deault %! true ad curret MD" %! ot d%!carded % ca!e o JMS7+cept%o$/de!cr%pt%o& $ev-etry-a'e &co'*te'eo!*taj*'db*Tra!actedMD"/recoverFro'J'!Fa%lure $/ev-etrya'e& $ev-etry-type &java*lag*"oolea $/ev-etry-type & $ev-etry-value &true$/ev-etry-value& $/ev-etry& $ev-etry & $de!cr%pt%o &De%e ?3et3er a JMS redel%vered 'e!!age re!po!e !3ould be !et to reply 1ueue % ca!e o redel%vered 'e!!age %gored ad ot proce!!ed- deault %! true $/de!cr%pt%o & $ev-etry-a'e &co'*te'eo!*taj*'db*Tra!actedMD"/!edRedel%veredMe!!ageRe!po!e $/ev-etry-a'e & $ev-etry-type &java*lag*"oolea $/ev-etry-type & $ev-etry-value &true$/ev-etry-value& $/ev-etry&
arameter deaultFor'atter
deault.r%c%pal
re!po!eDel%veryMode
es'ription )essa/e ormattin/ parameter. *trin/ parameter. Formatter to be applie, on t$e messa/e to transorm it. An ;F*)8 ormatter is available in t$e ear ile. To apply a spe'ii' ormattersimply a,, in t$e value iel, t$e ully @ualiie, 'lass name o t$e ormatter an, ma5e it available in t$e appli'ation server 'lasspat$.
eault value "one
)essa/e pro'essin/ parameter. *trin/ parameter. ou 'an ,eine a ,eault prin'ipal or t$e asso'iate, messa/e '$annel. Response pro'essin/ parameter. Inte/er parameter. eines w$et$er response messa/e is ,elivere, as a +R*I*T+"T or ";" +R*I*T+"T messa/e.
"one
To use ;F*)8 ormatter apply? $ev-etry-value &OFSM$/ev-etry-value&
To use spe'ii' ormatter $ev-etry-value &co'*te'eeo!*or'atter*My,u!to'For'atter $/ev-etry-value&
To ,eine a prin'ipal $ev-etry-value&56.0TT/924;< $/ev-etry-value&
1
#lose, set o values ? 1- )eans ";" a/e 16
TAFJ-AS TAFJ
!edToJ'!ReplyTo
'e!!age5d!,orrelat%o 5D
%goreRedel%veredMe!!a ge
'a+J'!Redel%verytte'p t
+R*I*T+"T 2- )eans +R*I*T+"T Response pro'essin/ parameter. 4oolean parameter. eines w$et$er response messa/e is sent to t$e ,estination ,eine, t$rou/$ messa/e property /etJ)*ReplyTo #lose, set o values ? true ? use t$e messa/e property alse ? use t$e msReplyLueue ,eine, at )4 level Response pro'essin/ parameter. 4oolean parameter. eines w$et$er response messa/e 'orrelation I is set wit$ t$e ori/inal messa/e I. #lose, set o values ? true ? use t$e messa/e I alse? use t$e messa/e 'orrelation I +rror $an,lin/ parameter. 4oolean parameter. In 'ase o messa/e re,elivery t$is la/ 'oul, be enable, to avoi, messa/e repro'essin/ in T2%. )4 will re'eive t$e messa/e but not pass it to +J4. #lose, set o values ? alse? re,elivere, messa/e are sent to +J4ET2% true? messa/e are i/nore, an, a response is sent to t$e 'lient t$at t$is is a re,elivere, messa/e. +rror $an,lin/ parameter. Inte/er parameter. In 'ase o messa/e re,elivery- i t$is value is /reater or e@ual t$an 0- t$e messa/e property JMSDel%very,out is '$e'5e, a/ainst t$is value to prote't a/ainst poison messa/e. T$is eature is ,isable, by ,eault as it must be alrea,y 'overe, by t$e J)* provi,er. $en usin/ t$is eature- messa/e is simply i/nore, an, inormation is lo//e, but t$ere is no ,ea,
alse
alse
true
1 means ,isable, To ,eine no re,elivery set t$is value to 0. To ,eine 1 re,elivery only set t$is value to 1.
a/e 17
TAFJ-AS TAFJ
recoverFro'J'!Fa%lure
letter @ueue asso'iate,. +rror $an,lin/ parameter. 4oolean parameter.
true
In 'ase o J)* e<'eption at )4 level t$is la/ w$en set to true will 'all setRollba'5;nly or t$row an +J4 e<'eption to ,is'ar, t$e )4 w$en set to alse.
a/e 1
TAFJ-AS TAFJ
TA FJJ EE_ M D B . j a r / M E T A - I N F/ j b o s s - e jb 3 . x m l T$e sample below presents t$e 'orrespon,in/ J4;** +A6 'oni/uration part or t$e )4 OFSTra!actedMD" presente, above. It 'oul, be oun, wit$in t$e se'tion $eterpr%!ebea!& o t$e jboss-ejb.xml $'e!!age-dr%ve & $ejb-a'e&OFSTra!actedMD" $/ejb-a'e& $act%vat%o-co%g& $act%vat%o-co%g-property & $act%vat%o-co%g-property-a'e &de!t%at%o $/act%vat%o-co%g-property-a'e& $act%vat%o-co%g-property-value &java:/1ueue/t24OFSueue$/act%vat%o-co%g-property-value & $/act%vat%o-co%g-property & $/act%vat%o-co%g & $re!ource-re & $re!-re-a'e &j'!/TFJueue,oect%oFactory $/re!-re-a'e& $re!-type&java+*j'!*,oect%oFactory $/re!-type& $jd%-a'e &java:/,oect%oFactory$/jd%-a'e & $/re!ource-re & $'e!!age-de!t%at%o-re& $'e!!age-de!t%at%o-re-a'e &j'!/Replyueue $/'e!!age-de!t%at%o-re-a'e& $jd%-a'e &java:/1ueue/t24OFSReplyueue $/jd%-a'e & $/'e!!age-de!t%at%o-re& $/'e!!age-dr%ve&
Mml pat$ ebname
+
A'tivation 'oni/ 'oni/uration a'tivation'oni/ ,estination propertyname a'tivation'oni/ ava?E@ueueEt2%;F*Lueue propertyvalue Resour'es reeren'e 'oni/uration resour'ereN resre msETAFJLueue#onne'tionFa'tory name resour'ereN restype resour'ereN n,i name
Java<.ms.#onne'tionFa'tory #onne'tionFa'tory
)essa/e ,estination reeren'e messa/e,estination msEReplyLueue reN messa/e ,estinationrename messa/e,estination ava?E@ueueEt2%;F*ReplyLueue reNn,iname
#omment Has to mat'$ t$e eb name o ebar.
a/e 1(
TAFJ-AS TAFJ
TA FJJ EE_ M D B . j a r / M E T A - I N F/ i b m - e jb - ja r- b n d . x m l T$e sample below presents t$e 'orrespon,in/ ebsp$ere .! 'oni/uration part or t$e )4 OFSTra!actedMD" presente, above. It 'oul, be oun, wit$in t$e main se'tion o t$e ibmejb-jar-bnd.xml $'e!!age-dr%ve a'e>"OFSTransactedMDB" & $jca-adapter act%vat%o-!pec-b%d%g-a'e >"jms/t24OFSMessageMDB" de!t%at%o-b%d%g-a'e >"jms/t24OFSQueue" /& $re!ource-re a'e>"jms/TAFJQueueConnectionFactory" b%d%g-a'e >"jms/t24ConnectionFactory" /& $'e!!age-de!t%at%o-re b%d%g-a'e >"jms/t24OFSRe!yQueue" a'e>"jms/Re!yQueue" /& $/'e!!age-dr%ve&
Mml pat$ messa/e,riven name J'a a,apter a'tivationspe' bin,in/name ,estinationbin,in/ name
+
#omment Has to mat'$ t$e eb name o ebar.
msEt2%;F*)essa/e)4
ebsp$ere internal a'tivation spe'. name e,itable "ame o t$e @ueue- in websp$ere n,i tree- t$e )4 is listenin/ on e,itable
msEt2%;F*Lueue
Resour'es reeren'e 'oni/uration resour'ereN resre msETAFJLueue#onne'tionFa'tory name resour'ereN n,i name
#onne'tionFa'tory
)essa/e ,estination reeren'e name msEReplyLueue bin,in/name
msEt2%;F*ReplyLueue
#oni/ure t$e J)* #onne'tion a'tory or t$e response reply Lueue. )at'$ t$e ,eault J)* resour'e #onne'tion a'tory in J4;** e,itable )appin/ wit$ t$e reply @ueue. "ame o t$e reply @ueue in websp$ere n,i tree e,itable
a/e 20
TAFJ-AS TAFJ
TA FJJ EE_ M D B . j a r / M E T A - I N F/ w e b l o g i c - e jb - j ar .x m l T$e sample below presents t$e 'orrespon,in/ eblo/i' 12.1.M 'oni/uration part or t$e )4 OFSTra!actedMD" presente, above. It 'oul, be oun, wit$in t$e $?l!:?eblog%cejb-jar & se'tion o t$e "eblo#ic-ejb-jar.xml $?l!:?eblog%c-eterpr%!e-bea& $?l!:ejb-a'e &OFSTra!actedMD" $/?l!:ejb-a'e & $?l!:'e!!age-dr%ve-de!cr%ptor& $?l!:de!t%at%o-jd%-a'e &j'!/t24OFSueue $/?l!:de!t%at%o-jd%-a'e& $?l!:coect%o-actory-jd%-a'e &j'!/,oect%oFactory $/?l!:coect%o-actory-jd%-a'e & $/?l!:'e!!age-dr%ve-de!cr%ptor& $?l!:re!ource-de!cr%pt%o & $?l!:re!-re-a'e &j'!/TFJueue,oect%oFactory $/?l!:re!-re-a'e & $?l!:jd%-a'e &j'!/,oect%oFactory $/?l!:jd%-a'e& $/?l!:re!ource-de!cr%pt%o & $/?l!:?eblog%c-eterpr%!e-bea& E $?l!:'e!!age-de!t%at%o-de!cr%ptor & $?l!:'e!!age-de!t%at%o-a'e&j'!/OFSReplyueue $/?l!:'e!!age-de!t%at%o-a'e & $?l!:de!t%at%o-jd%-a'e&j'!/t24OFSReplyueue $/?l!:de!t%at%o-jd%-a'e & $/?l!:'e!!age-de!t%at%o-de!cr%ptor &
Mml pat$ +bname
+
estinationn,iname
msEt2%;F*Lueue
#onne'tiona'tory n,iname
msE#onne'tionFa'tory
Resour'es reeren'e 'oni/uration resrename msETAFJLueue#onne'tionFa'tory
n,iname
msE#onne'tionFa'tory
)essa/e ,estination ,es'riptor )essa/e,estination msE;F*ReplyLueue name
estinationn,iname
msEt2%;F*ReplyLueue
#omment Has to mat'$ t$e eb name o ebar.
a/e 21
TAFJ-AS TAFJ
T2 4 EJB C om p o n e n t s c on fi g u r a t i o n +J4 'omponents are ,eine, in TAFJJ+++AR.earNTAFJJ+++J4.ar. T$ere is two ,ierent +J4 types- ;F* +J4 an, #A88AT +J4. An ;F* +J4 is usin/ t$e ollowin/ mandatory reso$rces?
atasour'es? o
T2% ,ata sour'e
o
T2% 8o'5in/ ,ata sour'e w$en usin/ J4# lo'5in/ or ,atabase lo'5in/.
o
T2% rea, only ,ata sour'e w$en usin/ rea, only ,ata mo,el
A J)* 'onne'tion a'tory or T+# events
A J)* topi' or T+# events
An ;F* +J4 is usin/ t$e ollowin/ properties?
Re@uest pro'essin/? o
T$e ;F* sour'e
o
T$e ;F* timeout
o
$et$er t$e session s$oul, be 'lean up between t wo invo'ation
Re@uest monitorin/ optional o
T$e re@uest type or monitorin/ 'lassii'ation purpose.
TAFJJEE_EJB.jar/M ETA- INF/ejb- jar.xml T$e table below presents t$e main 'oni/uration part or a /iven +J4 'alle, OFS.roce!!%g"ea# it 'oul, be oun, wit$in t$e se'tion $eterpr%!e-bea!& o t$e ejb jar.xml! t$is +J4 is asso'iate, to t$e OFSTra!actedMD" presente, above but 'oul, also be invo5e, by ,ire't +J4 invo'ation. It allows ,einin/ t$e man,atory resour'es presente, above. $!e!!%o& $-- "ea or OFS re1ue!t proce!!%g u!ed by Tra!acted"ea --& $de!cr%pt%o &TFJ OFS "ea $/de!cr%pt%o& $d%!play-a'e &TFJ OFS "ea$/d%!play-a'e & $ejb-a'e&OFS.roce!!%g"ea$/ejb-a'e& $bu!%e!!-local &co'*te'eo!*taj*!b*OFS.roce!!%g"eaocal $/bu!%e!!-local & $bu!%e!!-re'ote &co'*te'eo!*taj*!b*OFS.roce!!%g"eaRe'ote $/bu!%e!!-re'ote & $ejb-cla!! &co'*te'eo!*taj*!b*OFS.roce!!%g"ea $/ejb-cla!! & $!e!!%o-type &Statele!! $/!e!!%o-type & $tra!act%o-type &"ea$/tra!act%o-type &
a/e 22
TAFJ-AS TAFJ
$-- For taj !e!!%o --& $ev-etry & $de!cr%pt%o &OFS OFS Source $/de!cr%pt%o & $ev-etry-a'e &co'*te'eo!*taj*!b*OFS.roce!!%g"ea/o!Source $/ev-etry-a'e & $ev-etry-type &java*lag*Str%g $/ev-etry-type & $ev-etry-value &8,S$/ev-etry-value& $/ev-etry& $ev-etry & $ev-etry-a'e &co'*te'eo!*taj*!b*OFS.roce!!%g"ea/o!T%'eout $/ev-etry-a'e & $ev-etry-type &java*lag*5teger $/ev-etry-type & $ev-etry-value &
Mml pat$ ebname business lo'al business remote eb'lass session type transa'tion type
+
#omment +J4 name. e,itable +J4 TAFJ 8o'al intera'e.
4ean
Transa'tion mana/ement mo,e 3 T$e bean $an,le t$e transa'tion.
+J4 TAFJ Remote intera'e. +J4 TAFJ Remote intera'e. +J4 property
roperty 'oni/uration env 'om.temenos.ta.sb.;F*ro'essin/4eanEos roperty name. entryNenv *our'e =se, to 'oni/ure ;F* sour'e. a/e 2
TAFJ-AS TAFJ
entryname env&'( entry%enventry-type env 'om.temenos.ta.sb.;F*ro'essin/4eanEos entryNenv Timeout entryname env+, entry%enventry-type Resour'es reeren'e 'oni/uration resour'e ,b'Et2%ata*our'e reN resre name
resour'e ,b'Et2%8o'5in/ata*our'e reN resre name
resour'e ,b'Et2%R;ata*our'e reN resre name
resour'e msETopi'#onne'tionFa'tory reN resre name
resour'e msEte'+ventsTopi' reN resre name
)*( (o$rce val$e e,itable
roperty name. #oni/ure ;F* timeout. )*( timeo$t in seconds e,itable
#oni/ure t$e Appli'ation server J4# resour'e or T2% ,atabase. "ee,s to be mappe, in Appli'ation server 'oni/uration ile. #oni/ure t$e Appli'ation server J4# resour'e or T2% lo'5in/ in ,atabase. "ee,s to be mappe, in Appli'ation server 'oni/uration ile. #oni/ure t$e Appli'ation server J4# resour'e or T2% rea, only ,atabase. "ee,s to be mappe, in Appli'ation server 'oni/uration ile. #oni/ure t$e J)* T;I# a'tory or T+# events publis$in/. "ee,s to be mappe, in Appli'ation server 'oni/uration ile. #oni/ure t$e J)* T;I# or T+# events publis$in/. "ee,s to be mappe, in Appli'ation server 'oni/uration ile.
a/e 2%
TAFJ-AS TAFJ
Ma n d a t o r y pro p e r t i e s As ,es'ribe, above t$ere is two man,atory properties w$i'$ s$oul, be ,eine, or ea'$ '$annel? $ev-etry & $de!cr%pt%o &OFS OFS Source $/de!cr%pt%o & $ev-etry-a'e &co'*te'eo!*taj*!b*OFS.roce!!%g"ea/o!Source $/ev-etry-a'e & $ev-etry-type &java*lag*Str%g $/ev-etry-type & $ev-etry-value &8,S$/ev-etry-value& $/ev-etry& $ev-etry & $ev-etry-a'e &co'*te'eo!*taj*!b*OFS.roce!!%g"ea/o!T%'eout $/ev-etry-a'e & $ev-etry-type &java*lag*5teger $/ev-etry-type & $ev-etry-value &
Optional properties T$e ollowin/ properties 'oul, be a,,e, wit$in an ebar. $!e!!%o& se'tion to reine a spe 'ii' +J4 setup. *ee table below or ,etaile, e
arameter o!Source
o!T%'eout
re!etT3re!3old
es'ription Re@uest pro'essin/ parameter. *trin/ parameter. Has to mat'$ an e
eault value "one 3 nee,s to be setup
Re@uest pro'essin/ parameter. Inte/er parameter. Time in se'on,s beore re@uest e
0 3 means no timeout
B @ 'ea! ever re!et
a/e 2!
TAFJ-AS TAFJ
re1ue!tType
Re@uest monitorin/ parameter. *trin/ parameter. T$e value asso'iate, to t$is parameter will be use, as a 'lassiier in TAFJ++ monitorin/ tool. $en not set t$e ;F* sour'e is use,.
"one
TAFJJEE_EJB.jar/META- INF/jbos s- ejb3.xm l T$e sample below presents t$e 'orrespon,in/ J4;** +A6 'oni/uration part or t$e +J4 OFS.roce!!%g"ea presente, above. It 'oul, be oun, wit$in t$e se'tion $eterpr%!ebea!& o t$e jboss-ejb.xml $!e!!%o& $ejb-a'e&OFS.roce!!%g"ea $/ejb-a'e& $re!ource-re & $re!-re-a'e &jdbc/t24DataSource $/re!-re-a'e& $re!-type&java+*!1l*DataSource $/re!-type& $jd%-a'e&java:/jdbc/t24DS $/jd%-a'e& $/re!ource-re & $re!ource-re & $re!-re-a'e &jdbc/t24RODataSource $/re!-re-a'e& $re!-type&java+*!1l*DataSource $/re!-type& $jd%-a'e &java:/jdbc/t24RODS $/jd%-a'e& $/re!ource-re & $re!ource-re & $re!-re-a'e &jdbc/t24oc%gDataSource $/re!-re-a'e & $re!-type&java+*!1l*DataSource $/re!-type& $jd%-a'e &java:/jdbc/t24oc%gDS$/jd%-a'e & $/re!ource-re & $re!ource-re & $re!-re-a'e &j'!/Top%c,oect%oFactory $/re!-re-a'e & $re!-type&java+*j'!*,oect%oFactory $/re!-type& $jd%-a'e &java:/,oect%oFactory$/jd%-a'e & $/re!ource-re & $re!ource-re & $re!-re-a'e &j'!/tec7vet!Top%c $/re!-re-a'e& $re!-type&java+*j'!*ueue $/re!-type& $jd%-a'e &java:/top%c/tec7vet!Top%c $/jd%-a'e& $/re!ource-re & $/!e!!%o&
TAGEroperty name ebname
+
#omment
;F*ro'essin/4ean
resour'ereN res ,b'Et2%ata*our'e rename
Has to mat'$ t$e ebname o eb ar.
resour'ereNn,i ava?E,b'Et2%* name resour'ereN res ,b'Et2%8o'5in/ata*our'e rename
)at'$ t$e T2% J4# resour'e in J4;** appli'ation server. e,itable )aps t$e resrename rom eb ar.
resour'ereNn,i ava?E,b'Et2%8o'5in/* name
)at'$ t$e T2% 8o'5in/ J4# resour'e in J4;** appli'ation a/e 26
TAFJ-AS TAFJ
resour'ereN res ,b'Et2%R;ata*our'e rename resour'ereNn,i ava?E,b'Et2%R;* name
server. e,itable )aps t$e resrename rom eb ar.
resour'ereN res msETopi'#onne'tionFa'tory rename
)at'$ t$e T2% rea, only J4# resour'e in J4;** appli'ation server. e,itable )aps t$e resrename rom eb ar.
resour'ereNn,i Java?E#onne'tionFa'tory name resour'ereN res msEte'+ventsTopi' rename
)at'$ t$e ,eault J)* 'onne'tion a'tory in boss n,i tree. e,itable )aps t$e resrename rom eb ar.
resour'ereNn,i name
)at'$ t$e T2% J)* topi' in J4;** n,i tree. e,itable
Java?Etopi'Ete'+vents
a/e 27
TAFJ-AS TAFJ
TAFJJEE_EJB.jar/META- INF/ibm- ejb- jar- bnd.xml T$e sample below presents t$e 'orrespon,in/ ebsp$ere .! 'oni/uration part or t$e +J4 OFS.Roce!!%g"ea presente, above. It 'oul, be oun, wit$in t$e main se'tion o t$e ibmejb-jar-bnd.xml $!e!!%o a'e>"OFSrocessingBean" & $re!ource-re a'e>"jd#c/t24DataSource" b%d%g-a'e >"jd#c/t24DataSource" /& $re!ource-re a'e>"jd#c/t24RODataSource" b%d%g-a'e >"jd#c/t24RODataSource" /& $re!ource-re a'e>"jd#c/t24$oc%ingDataSource" b%d%g-a'e >"jd#c/t24$oc%ingDataSource" /& $re!ource-re a'e>"jms/ToicConnectionFactory" b%d%g-a'e >"jms/t24ConnectionFactory" /& $re!ource-re a'e>"jms/tec&'entsToic" b%d%g-a'e >"jms/tec&'entsToic" /& $/!e!!%o&
Mml pat$ *ession name
+
Resour'es reeren'e 'oni/uration resour'ereN resre ,b'Et2%ata*our'e name resour'ereN bin,in/ ,b'Et2%ata*our'e name
resour'ereN resre name
,b'Et2%8o'5in/ata*our'e
resour'ereN bin,in/ ,b'Et2%8o'5in/ata*our'e name
resour'ereN resre name
,b'Et2%R;ata*our'e
resour'ereN bin,in/ ,b'Et2%R;ata*our'e name
resour'ereN resre name
msETopi'#onne'tiona'tory
resour'ereN bin,in/ msEt2%#onne'tionFa'tory name resour'ereN resre name
msEte'+ventsTopi'
resour'ereN bin,in/
msEte'+ventsTopi'
#omment Has to mat'$ t$e eb name o ebar.
TAFJ-AS TAFJ
name
in A* n,i tree. e,itable
a/e 2(
TAFJ-AS TAFJ
TA FJJ EE_ EJ B .j a r / M E T A- I N F/ w e b l o g i c - e jb - j ar .x m l T$e sample below presents t$e 'orrespon,in/ eblo/i' 12.1.M 'oni/uration part or t$e +J4 OFS.roce!!%g"ea presente, above. It 'oul, be oun, wit$in t$e $?l!:?eblog%cejb-jar & se'tion o t$e "eblo#ic-ejb-jar.xml $?l!:?eblog%c-eterpr%!e-bea & $?l!:ejb-a'e &OFS.roce!!%g"ea $/?l!:ejb-a'e& $?l!:!tatele!!-!e!!%o-de!cr%ptor & $?l!:bu!%e!!-%terace-jd%-a'e-'ap & $?l!:bu!%e!!-re'ote &co'*te'eo!*taj*!b*OFS.roce!!%g"eaRe'ote $/?l!:bu!%e!!re'ote& $?l!:jd%-a'e &ejb/OFS.roce!!%g"eaRe'ote $/?l!:jd%-a'e& $/?l!:bu!%e!!-%terace-jd%-a'e-'ap & $/?l!:!tatele!!-!e!!%o-de!cr%ptor & $?l!:re!ource-de!cr%pt%o & $?l!:re!-re-a'e &jdbc/t24DataSource $/?l!:re!-re-a'e& $?l!:jd%-a'e &jdbc/t24DS $/?l!:jd%-a'e & $/?l!:re!ource-de!cr%pt%o & $?l!:re!ource-de!cr%pt%o & $?l!:re!-re-a'e &jdbc/t24oc%gDataSource $/?l!:re!-re-a'e & $?l!:jd%-a'e &jdbc/t24oc%gDS $/?l!:jd%-a'e & $/?l!:re!ource-de!cr%pt%o & $?l!:re!ource-de!cr%pt%o & $?l!:re!-re-a'e &jdbc/t24RODataSource $/?l!:re!-re-a'e & $?l!:jd%-a'e &jdbc/t24RODS $/?l!:jd%-a'e& $/?l!:re!ource-de!cr%pt%o & $?l!:re!ource-de!cr%pt%o & $?l!:re!-re-a'e &j'!/tec7vet!Top%c $/?l!:re!-re-a'e& $?l!:jd%-a'e &j'!/tec7vet!Top%c $/?l!:jd%-a'e& $/?l!:re!ource-de!cr%pt%o & $?l!:re!ource-de!cr%pt%o & $?l!:re!-re-a'e &j'!/Top%c,oect%oFactory $/?l!:re!-re-a'e & $?l!:jd%-a'e &j'!/,oect%oFactory $/?l!:jd%-a'e& $/?l!:re!ource-de!cr%pt%o & $?l!:eable-call-by-reerece &true$/?l!:eable-call-by-reerece & $?l!:jd%-a'e&ejb/OFS.roce!!%g"eaRe'ote $/?l!:jd%-a'e & $?l!:local-jd%-a'e&ejb/OFS.roce!!%g"eaocal $/?l!:local-jd%-a'e & $/?l!:?eblog%c-eterpr%!e-bea&
Mml pat$ +bname
+
businessintera'e 'om.temenos.ta.sb.;F*ro'essin/4e n,iname anRemote mapEbusinessremote businessintera'e ebE;F*ro'essin/4eanRemote n,inamemapEn,i name Resour'es reeren'e 'oni/uration resrename ,b'Et2%ata*our'e n,iname
,b'Et2%*
resrename
,b'Et2%8o'5in/ata*our'e
#omment Has to mat'$ t$e eb name o ebar.
+J4 n,i name or remote invo'ation
)aps t$e resrename rom ebar.
TAFJ-AS TAFJ
n,iname
,b'Et2%8o'5in/*
resrename
,b'Et2%R;ata*our'e
n,iname
,b'Et2%R;*
resrename
msETopi'#onne'tionFa'tory
n,iname
msE#onne'tionFa'tory
)at'$ t$e T2% lo'5in/ J4# resour'e in weblo/i' appli'ation server. e,itable )aps t$e resrename rom ebar.
a/e 1
TAFJ-AS TAFJ
Ph a nt o m ch a n n e l #omponent ar'$ite'ture?
For t$e J)* $antom '$annel- TAFJ sets up a )4 to listen on J)* +M+# Lueue an, 'onsume J)* messa/es in Bean mana#ed mode. MA transa'tions are not possible in t$is ar'$ite'ture be'ause T2% nee,s to republis$ 'omman,s in t$e +M+# Lueue. $antom )4 will 'all ,ire'tly T2% 'o,e. For e
a/e 2
TAFJ-AS TAFJ
Ph a nt o m MD B EJB- JAR Co mp o n e n t c on fi g u r a t i o n 8i5e ot$er re@uest E reply )4s- $antom )4 is 'oni/ure, in TAFJJ+++AR.earNTAFJJ++)4.ar )+TAI"FNejb-jar.xml wit$in t$e $eterpr%!ebea!& se'tion. $'e!!age-dr%ve & $d%!play-a'e &.3ato' 7+ecutor MD" $/d%!play-a'e & $ejb-a'e&TFJ.3ato'%!teerMD" $/ejb-a'e& $'apped-a'e&j'!/t2477,ueue $/'apped-a'e & $ejb-cla!! &co'*te'eo!*taj*'db*.3ato'%!teer $/ejb-cla!! & $'e!!ag%g-type &java+*j'!*Me!!age%!teer $/'e!!ag%g-type & $tra!act%o-type&"ea$/tra!act%o-type& $'e!!age-de!t%at%o-type &java+*j'!*ueue $/'e!!age-de!t%at%o-type & $act%vat%o-co%g& $act%vat%o-co%g-property & $act%vat%o-co%g-property-a'e &aco?ledgeMode $/act%vat%o-co%g-property-a'e & $act%vat%o-co%g-property-value &uto-aco?ledge $/act%vat%o-co%g-property-value & $/act%vat%o-co%g-property & $-- J"o!! uco''et t3%! !ect%o ad co%gure 'a+Se!!%o value 'ore t3a 9; co!u'er! are eeded --& $act%vat%o-co%g-property& $act%vat%o-co%g-property-a'e&'a+Se!!%o$/act%vat%o-co%g-propertya'e& $act%vat%o-co%g-property-value&;B$/act%vat%o-co%g-property-value& $/act%vat%o-co%g-property& $/act%vat%o-co%g & $ev-etry & $de!cr%pt%o &De%e t3e 'a+ u'ber o atte'pt a 'e!!age ?%ll be del%vered $/de!cr%pt%o& $--Deault %! 9 ?3%c3 'ea! o redel%very % ca!e o a%lure --& $ev-etry-a'e &co'*te'eo!*taj*'db*.3ato'%!teer/'a+J'!Del%verytte'pt $/ev-etrya'e& $ev-etry-type &java*lag*5teger $/ev-etry-type & $ev-etry-value &9$/ev-etry-value & $/ev-etry& $re!ource-re & $de!cr%pt%o &0!ed to get coect%o! to JMS or OFS 1ueue! $/de!cr%pt%o & $re!-re-a'e &j'!/TFJueue,oect%oFactory $/re!-re-a'e& $re!-type&java+*j'!*,oect%oFactory $/re!-type& $re!-aut3&,ota%er $/re!-aut3& $/re!ource-re& $re!ource-re & $de!cr%pt%o &77, 1ueue$/de!cr%pt%o & $re!-re-a'e &j'!/t2477,ueue $/re!-re-a'e & $re!-type&java+*j'!*ueue $/re!-type& $re!-aut3&,ota%er $/re!-aut3& $/re!ource-re& $re!ource-re & $de!cr%pt%o &0!ed to get coect%o! JD", T24 data !ource $/de!cr%pt%o & $re!-re-a'e &jdbc/t24DataSource $/re!-re-a'e & $re!-type&java+*!1l*DataSource $/re!-type & $re!-aut3&,ota%er $/re!-aut3& $/re!ource-re& $re!ource-re & $de!cr%pt%o &0!ed to get coect%o! JD", loc%g data !ource $/de!cr%pt%o & $re!-re-a'e &jdbc/t24oc%gDataSource $/re!-re-a'e& $re!-type&java+*!1l*DataSource $/re!-type & $re!-aut3&,ota%er $/re!-aut3& $/re!ource-re& $re!ource-re & $de!cr%pt%o &0!ed to get coect%o! JD", RO data !ource $/de!cr%pt%o&
a/e
TAFJ-AS TAFJ
$re!-re-a'e &jdbc/t24RODataSource $/re!-re-a'e & $re!-type&java+*!1l*DataSource $/re!-type & $re!-aut3&,ota%er $/re!-aut3& $/re!ource-re& $re!ource-re & $de!cr%pt%o &0!ed to get coect%o! to JMS or T7, $/de!cr%pt%o & $re!-re-a'e &j'!/Top%c,oect%oFactory $/re!-re-a'e & $re!-type&java+*j'!*,oect%oFactory $/re!-type& $re!-aut3&,ota%er $/re!-aut3& $/re!ource-re& $re!ource-re & $de!cr%pt%o &T7, top%c$/de!cr%pt%o & $re!-re-a'e &j'!/tec7vet!Top%c $/re!-re-a'e & $re!-type&java+*j'!*Top%c $/re!-type& $re!-aut3&,ota%er $/re!-aut3& $/re!ource-re& $/'e!!age-dr%ve&
Mml pat$ ebname eb'lass
+
transa'tion type mappe, msEt2%+M+#Lueue name messa/in/ ava<.ms.)essa/e8istener type messa/e ava<.ms.Lueue ,estination type a'tivation a'5nowle,/e)o,e 'oni/ property name a'tivation Autoa'5nowle,/e 'oni/ property name Resour'es reeren'e 'oni/uration resour'ereN msETAFJLueue#onne'tionFa'tory resrename
resour'ereN resrename
,b'Et2%ata*our'e
resour'ereN resrename
,b'Et2%8o'5in/ata*our'e
resour'ereN resrename
,b'Et2%R;ata*our'e
#omment )4 name TAFJ implementation 'lass Transa'tion mana/ement type- not e,itable. eblo/i'only ,eines t$e p$ysi'al @ueue t$e )4 is listenin/ on. J)* property J)*roperty
J)* property
J)* property
#oni/ure t$e J)* #onne'tion a'tory or t$e response reply Lueue. "ee,s to be mappe, in Appli'ation server 'oni/uration ile. #oni/ure t$e Appli'ation server J4# resour'e or T2% ,atabase. "ee,s to be mappe, in Appli'ation server 'oni/uration ile. #oni/ure t$e Appli'ation server J4# resour'e or T2% lo'5in/ in ,atabase. "ee,s to be mappe, in Appli'ation server 'oni/uration ile. #oni/ure t$e Appli'ation server J4# resour'e or T2% rea, only a/e %
TAFJ-AS TAFJ
resour'ereN resrename
msETopi'#onne'tionFa'tory
resour'ereN resrename
msEte'+ventsTopi'
resour'ereN resrename
msEt2%+M+#Lueue
,atabase. "ee,s to be mappe, in Appli'ation server 'oni/uration ile. #oni/ure t$e J)* T;I# a'tory or T+# events publis$in/. "ee,s to be mappe, in Appli'ation server 'oni/uration ile. #oni/ure t$e J)* T;I# or T+# events publis$in/. "ee,s to be mappe, in Appli'ation server 'oni/uration ile. #oni/ure t$e J)* +M+# Lueue to sen, new 'omman,. "ee,s to be mappe, in Appli'ation server 'oni/uration ile.
Optional properties T$e ollowin/ property 'oul, be a,,e, wit$in istener )4 setup.
$'e!!age-dr%ve &
se'tion to reine $antom8
$-- 7RROR C6D568 .RM7T7RS --& $ev-etry & $de!cr%pt%o &De%e t3e u'ber o re-del%very atte'pt % ca!e o a%lure - -9 'ea! d%!abled by deault t3e JMS prov%der 3adle! t3e 'a+%'u' u'ber o JMS del%very atte'pt - B 'ea! o re-del%very atte'pt $/de!cr%pt%o & $ev-etry-a'e &co'*te'eo!*taj*'db*Tra!actedMD"/'a+J'!Redel%verytte'pt $/ev-etrya'e& $ev-etry-type &java*lag*5teger $/ev-etry-type & $ev-etry-value &B$/ev-etry-value & $/ev-etry&
arameter 'a+J'!Redel%verytte'p t
es'ription +rror $an,lin/ parameter. Inte/er parameter.
eault value 0 means ,o re,elivery in 'ase o ailure
In 'ase o messa/e re,elivery- i t$is value is /reater or e@ual t$an 0- t$e messa/e property JMSDel%very,out is '$e'5e, a/ainst t$is value to prote't a/ainst poison messa/e. 4y ,eault re,elivere, messa/e are i/nore,.
$antom8istener )4 ma5es use o same resour'es t$an ;F* +J4? T 2% ,ata sour'es an, T+# events topi' an, 'onne'tion a'tory. lease reer to +J4 'oni/uration se'tion about boss- websp$ere an, weblo/i' or appli'ation server mappin/ e
a/e !
TAFJ-AS TAFJ
Its important to note t$at $antom )4 is not only usin/ +M+#Lueue to re'eive messa/e but also to sen, 'omman,s.
a/e 6
TAFJ-AS TAFJ
TAFJJEE_WAR_TAFJ - Se rv le t Co mp o n e n t T$is is a web mo,ule w$i'$ 'ontains ollowin/ servlets?
+
tia/*ervlet? to /et inormation about t$e installation
t*$ow*ervlet? to /et inormation about a T2% routine i present in t$e 'lasspat$
8o//er*ervlet? to '$an/e ,ynami'ally lo/ level an, a''ess lo/ iles
#omo*ervlet? to a''ess 'omo 'ontent wit$ some ilterin/ 'apabilities
4Tools*ervlet? to e
It also 'ontains some ,o'umentation about intera'tion 'apabilities wit$ TAFJ++ rom e
+
#omment *ervlet name
'om.temenos.ta.ee.war.+
'lass name
Exec$te
Mappin# $rl
t*$ow*ervlet
*ervlet name
'om.temenos.ta.ee.war.T*$ow*erv let t*$ow*ervlet
'lass name
t(o"
Mappin# $rl
tia/*ervlet
*ervlet name
'om.temenos.ta.ee.war.Tia/*ervl et
'lass name
)ap servlet mappin/ wit$ t$e servlet
)ap servlet mappin/ wit$ t$e servlet
a/e 7
TAFJ-AS TAFJ
servlet mappin/Nservle tname servletmappin#%$rlpattern servletNservlet name servletNservlet 'lass servlet mappin/Nservle tname servletmappin#%$rlpattern servletNservlet name servletNservlet 'lass servlet mappin/Nservle tname servletmappin#%$rlpattern servletNservlet name servletNservlet 'lass servlet mappin/Nservle tname servletmappin#%$rlpattern resour'ereN resrename
resour'ereN resrename
tia/*ervlet
)ap servlet mappin/ wit$ t$e servlet
tDia#
Mappin# $rl
8o//er*ervlet
*ervlet name
'om.temenos.ta.ee.war.8o//er*erv let 8o//er*ervlet
'lass name )ap servlet mappin/ wit$ t$e servlet
lo##er
Mappin# $rl
#omo*ervlet
*ervlet name
'om.temenos.ta.ee.war.#omo*ervl et #omo*ervlet
'lass name
comp
Mappin# $rl
4Tools*ervlet
*ervlet name
'om.temenos.ta.ee.war. 4Tools*ervlet 4Tools*ervlet
'lass name
DB/ools
Mappin# $rl
msETAFJLueue#onne'tionFa'tory
#oni/ure t$e J)* #onne'tion a'tory or t$e response reply Lueue. "ee,s to be mappe, in Appli'ation server 'oni/uration ile. #oni/ure t$e J)* +M+# Lueue to sen, new 'omman,. "ee,s to be mappe, in Appli'ation server 'oni/uration ile.
msET2%+M+#Lueue
)ap servlet mappin/ wit$ t$e servlet
)ap servlet mappin/ wit$ t$e servlet
a/e
TAFJ-AS TAFJ
Ve ri f y i ns t a l l a t i o n : TAFJEE m a i n p a g e ou 'oul, browse $ttp?EEH;*T"A)+?;RTETAFJ++E w$i'$ will /ive you a response li5e?
a/e (
TAFJ-AS TAFJ
Ge tt i n g TAFJ in s ta l l a t i o n d et a i l s: tD ia g S e r v l e t $ttp?EElo'al$ost?00ETAFJ++Etia/ i.e.
a/e %0
TAFJ-AS TAFJ
G e tt t t i n g r o ut u t i n e c om o m p i l a ti t i o n d et e t a il i l s : t S ho ho w S e r v l e t $ttp?EElo'al$ost?00ETAFJ++Et*$ow to /et ,etails about JF.I"ITIA8I*+.#;""+#TI;" JF.I"ITIA8I*+.#;""+#TI;"
a/e %1
TAFJ-AS TAFJ
R u n n i n g a C O B w i th t h TA F J : Ex E x ec ec u t e S e r v l e t it$ t$is web appli'ation you 'oul, laun'$ 'omman, to T2% spe'ially *TART.T*).
To laun'$ t$e #;4 ? ost *TART.T*) in t$e orm. #$e'5 t$at t$e 'omo ol,er is 'reate, an, 'omos ile was /enerate, in it.
C h a ng n g i n g l o g l e v el e l a n d a c ce c e s s l o g f i l e c o nt n t e n t : L o g g er e r S e r vl vl e t $ttp?EElo'al$ost?00ETAFJ++Elo//er
a/e %2
TAFJ-AS TAFJ
T$is servlet allows '$an/in/ ,ynami'ally ,ynami'ally t$e lo/ level o any TFAJ lo//ers wit$out $avin/ to restart t$e appli'ation server. T$is is a runtime '$an/e w$i'$ ,oesnt impa't t$e TAFJTra'e properties ile. It 'oul, be useul in 'ase o une
a/e %
TAFJ-AS TAFJ
T$is lo/ viewer also provi,es ilterin/ un'tionalities i you are intereste, in a spe'ii' inormation or lo/ level. ou 'oul, narrow t$e lo/ level wit$ t$e 'ombo bo< to 5eep only lo//in/ inormation e@uals or $i/$er to t$e sele'te, level- i.e. i you sele't AR" you will /et AR"I"G an, +RR;R messa/es only.
a/e %%
TAFJ-AS TAFJ
Ac ce s s i n g COMO s : Co m o S e rv l e t $ttp?EElo'al$ost?00ETAFJ++E'omo ou 'oul, browser 'omo ile 'ontent rom t$is servlet. T$is tool is mainly a $elper to provi,e ,ire't a''ess to t$e 'omo an, is not a ')B monitor! tere is no a$tomatic re0res 0$nctionality! yo$ "ill #et a pict$re o0 te como 0older at a point o0 time only. ou 'oul, re'all t$e servlet perio,i'ally to /et an up,ate, view. lease note t$at t$e 'omo siBe 9in bytes: is bein/ ,isplaye, an, 'onsi,er t$is inormation beore viewin/ $u/e ile rom t$e servlet as t$e ile 'ontent will be loa,e, into memory. ou 'oul, sort 'omos by name- last mo,iie, ,ate by '$an/in/ t$e sort option value in t$e 'ombo bo<. ou 'oul, also re@uest to see only a spe'ii' ile by provi,in/ its name or t$e last 10 iles or e
a/e %!
TAFJ-AS TAFJ
a/e %6
TAFJ-AS TAFJ
D BT o o l s s er vl e t ou 'oul, e
lease reer to 4Tools ,o'umentation to /et inormation about 4Tools 'apabilities an, 4Tools 'omman, synta<. DB/ools servlet as to be $sed in conj$nction "it DB/ools.jar. 10 DB/ools.jar is not part o0 te application server classpat! te 0$nctionality "ill not be available.
a/e %7
TAFJ-AS TAFJ
Its really important to note t$at 4Tools provi,es a ull ,atabase a''ess an, t$e tool s$oul, not be ,eploye, on pro,u'tion environment or to a stri'tly restri'te, set o users. T$e purpose o t$e tool is to provi,e a''ess to 4Tools 'omman, t$rou/$ t$e appli'ation server ,eployment to ,atabase a,ministrator ,urin/ ,evelopment or t estin/ p$ases. 4y e#=RR+"# T$e 'omman, will be e
a/e %
TAFJ-AS TAFJ
i.e. +nter a *L8 'omman,
ress *ubmit
ress Reres$- t$e lo/ ile bn5'urren'ysele't.lo/ $as been /enerate,.
lease note t$at t$e lo/ ile siBe 9in bytes: is bein/ ,isplaye, an, 'onsi,er t$is inormation beore viewin/ $u/e ile rom t$e servlet as t$e ile 'ontent will be loa,e, into memory. 8o/ ile 'oul, be ,elete, i t$ey are not more nee,e,.
a/e %(
TAFJ-AS TAFJ
TAFJ En tr y p oi n t s d oc u m e n t a t i o n TAFJJ++ARTAFJ 'ontains an online ,o'umentation w$i'$ e
TAFJ EE Entry points TAFJ++ provi,es entry points to pro'ess ;F* re@uests an, to invo5e routines wit$ parameters. T$is 'oul, be ,one in two ,ierent ways?
*yn'$ronously by ,oin/ a ebservi'e or +J4 invo'ation wit$ TAFJ#lient AI. Asyn'$ronously by sen,in/ a J)* messa/e wit$ a J)* 'lient or by usin/ #A88J++ statement.
Sy nc h r o n o u s inv o ca t i o n T$ere is two ,ierent entry points to syn'$ronously pro'ess ;F* re@uests an, to #A88 routines rom a 'lient appli'ation?
ebservi'es +J4
a/e !0
TAFJ-AS TAFJ
Alt$ou/$ bot$ met$o,s 'an be a'$ieve, easily by usin/ T AFJ#lient AI- +J4 invo'ation re@uires a bit more 'oni/uration an, ,eployment 5nowle,/e. TAFJJ++#lientFa'tory is t$e entry point to /et a TAFJJ++#lient eit$er or ebservi'e or +J4 invo'ation.
package com.temenos.tafj.j2ee.client.impl; public class TAFJJEEClientFactory public static TAFJJEEClient getWebServiceClient(String hostname, String port) public static TAFJJEEClient getEjbClient(AppServerProvider appServer, String hostname, String port) TAFJJ++#lient is t$e intera'e w$i'$ provi,es met$o,s to pro'ess an ;F* re@uest or to 'all a subroutine.
package com.temenos.tafj.j2ee.client; public interface TAFJJEEClient String[ call!t(String ro"tine#ame, String[ parameters); String process$%S(String re&"est);
App*erverrovi,er is an enumeration use, by t$e a'tory to retrieve t$e +J4 'lient 'orrespon,in/ to t$e appli'ation server version. As a $elper- it also ,eines ports w$i'$ are usually use, by ,eault or HTT re@uest an, +J4 loo5up.
package com.temenos.tafj.j2ee.client; public enum AppServerProvider '$SS(*+*+, +), //JBoss 4.2.3 - EAP 5.2 WE$/0C(1++, 1++), //Weblogic 10.3 - 12.1.1 WES3E4E(+*+, 2*+), //Websphere 7 - 8 - 8.5 '$SS1(*+*+,5551); //JBoss 7 - EAP 6.2
private final String 6efa"lt3ttport; private final String 6efa"ltE'ort;
a/e !1
TAFJ-AS TAFJ
Sy nc h r o n o u s inv o ca t i o n – We bs e r vi c e ebservi'e invo'ation is ,eployment a/nosti'. T$e 'all is ,one t$rou/$ t$e HTT '$annel o t$e appli'ation server. TAFJJ++#lientFa'tory ar/uments to /et a webservi'e 'lient are t$e server $ostname an, t$e $ttp port o t$e appli'ation server.
//Ge ! Webser"ice clie# $ro% ser"er 10.21.2.&& TAFJJEEClient client 7 TAFJJEEClientFactory.getWebServiceClient(+.2.2., *+*+); //Process !# '() re*+es, %eho !rg+%e# is he '() re*+es String response 7 client.process$%S(E#8904:.SEEC,,0#9<2=5>?,@C944E#C: ); //#"oe ! s+bro+i#e, %eho !rg+%e#s !re he )+bro+i#e #!%e !# !# !rr! o$ s+bro+i#e p!r!%eers String[ response 7 client.call!t(EAC34!E, new String[ B , C3%, >++, /, , , , , , );
a/e !2
TAFJ-AS TAFJ
T$e 'lient appli'ation 'lasspat$ must 'ontain Axis 2 libraries. A
Sy nc h r o n o u s inv o ca t i o n – EJB As +J4 loo5up re@uires spe'ii' parameters su'$ as initial 'onte
//Ge !# EJB clie# $ro% ! JBoss7 eplo%e# o# ser"er 10.21.2.&& TAFJJEEClient client 7 TAFJJEEClientFactory.getEjbClient(AppServerProvider.'$SS1, +.2.2., 5551); //Process !# '() re*+es, %eho !rg+%e# is he '() re*+es String response 7 client.process$%S(E#8904:.SEEC,,0#9<2=5>?,@C944E#C: ); //#"oe ! s+bro+i#e, %eho !rg+%e#s !re he )+bro+i#e #!%e !# !# !rr! o$ s+bro+i#e p!r!%eers String[ response 7 client.call!t(EAC34!E, new String[ B , C3%, >++, /, , , , , , );
T$e 'lient appli'ation 'lasspat$ must 'ontain /A*JJEE3EJB'lient.jar. T$e 'lient appli'ation 'lasspat$ must 'ontain t$e application server client libraries to pro'ess t$e +J4 loo5up. lease reer to t$e +J4 'lasspat$ setup se'tion to /et more ,etails. TAFJJ+++J4#lient.ar 'an be e
a/e !
TAFJ-AS TAFJ
Cu s t o m EJB i n vo c a t i o n #ustom +J4 invo'ation allows a spe'ii' initial 'onte
//A(JJEElie#(!cor %eho o ge ! c+so% EJB clie# public static TAFJJEEClient getEjbClient(String 0#00!DC$#EAD%!C$4:, String 4$0FE4D94, MapGObect, ObectH conteItroperties) //A(JJEElie# %ehos o p!r!%erie he '() !# AA be!# #!%e public void set$%Sean#ame(String bean#ame);
public void setC!!ean#ame(String bean#ame);
T$e sample below illustrate a J4oss 6.2 +A 'ustom invo'ation. a/e !%
TAFJ-AS TAFJ
//re!e he %!p o$ speci$ic properies #ecess!r o loo+p !# i#ii!l co#e $ro% he !pplic!io# ser"er MapGObect, ObectH map 7 new !as"MapGObect, ObectH(); map.p"t(jboss.naming.client.ejb.conteIt , true); //(!cor i#"oc!io#, he i#ii!l co#e #!%e !# !re pro"ie ih he %!p o$ speci$ic properies TAFJJEEClient client 7 TAFJJEEClientFactory.getEjbClient(org.jboss.naming.remote.client.0nitialConteIt%actorJ , remoteK<?,@C944E#C: ); //l!ssic s+bro+i#e i#"oc!io# String[ response 7 client.call!t(EAC34!E, new String[ B , C3%, >++, /, , , , , , );
a/e !!
TAFJ-AS TAFJ
Cli en t a pp li c a t i o n cl as s p a t h s et u p
T$e se'tion below provi,es some appli'ation server 'lient libaries e
JBos s
J4oss %.2. M'$SSD3$NE
J4oss +A !.2 //Ple!se #oe his 9!r 9+s co#!i# ! :A;(E) re$ere#ci#g oher 9!rs $ro% ':E/clie#, see :EA-;(/:A;(E).:(. M'$SSD3$NE
J4oss 7 +A 6.2 Naven 6epen6encJK G6epen6encJH Ggro"p06Horg.jboss.as G
Weblogic
eblo/i' 10..6 MWE$D3$NE
eblo/i' 12.1.1 MWE$D3$NE
Websphere
A* .!.! a/e !6
TAFJ-AS TAFJ
MW!SD3$NE.+.jar MW!SD3$NE.+.jar
To be able to ,o remote +J4 invo'ation in a ebsp$ere environment rom a t$in 'lient you woul, nee, to /enerate +J4s stubs or t$e TAFJ +J4 'lient library an, a,, it to t$e 'lient appli'ation 'lasspat$. lease reer to #reate *tub 'omman, I4) ,o'umentation$ttp?EEwww01.ibm.'omEsupportE,o'view.wssSui,Psw/21(%1( i.e. Qwas.$omeUEbinE'reate+J4*tubs TAFJJ+++J4.ar newile TAFJJ+++J4*tubs.ar 'p Q#8A**ATH
a/e !7
TAFJ-AS TAFJ
TAFJS er vi c e s . w a r – We b s e rv i c e c om p o n e n t TAFJ*ervi'es.war is an A
OF S w e b s e r v i c e ro'ess t$e os re@uest spe'iie, in t$e ar/ument Request.
W SD L $ttp?EElo'al$ost?00ETAFJ*ervi'esEservi'esE;F**ervi'eSws,l
Invocation *en, $ttp re@uest on? ETAFJ*ervi'esEservi'esE;F**ervi'eEInvo5eSRe@uestPTH+;F*R+L=+*T i.e. $ttp?EElo'al$ost?00ETAFJ*ervi'esEservi'esE;F**ervi'eEInvo5eS Re@uestP+"L=IR.*+8+#T--I"=TTE6!%21-A##;="T.+TAI8*-#=RR+"#?+LP+=R
S ub r o u t i n e Inv o k e r w eb s e r v i c e (CALL_AT ) +
WSDL $ttp?EElo'al$ost?00ETAFJ*ervi'esEservi'esEInvo5er*ervi'eSws,l
Invocation *en, $ttp re@uest on? ETAFJ*ervi'esEservi'esEInvo5er*ervi'eEInvo5eS *ubroutinePTH+R;=TI"+"A)+VaramPARA)1&A8=+VaramPARA)2&A8=+ W i.e. to e
a/e !
TAFJ-AS TAFJ
TEC Events T2% 'oul, be 'oni/ure, to publis$ T+# events. TAFJ 'omponents are 'oni/ure, to publis$ T+# events via resrename msETopi'#onne'tionFa'tory or t$e J)* Topi' 'onne'tion a'tory an, msEte'+ventsTopi' or t$e J)* topi' resour'e. To ,isable t$e T+# +vents publis$in/ rom TAFJ Runtime you 'oul, set t$e property temn.ta.runtime.enable.ms.lo//er to alse in t$e ta.properties. It will stop t$e T+# events publis$in/ wit$out '$an/in/ t$e T2% T+# 'oni/uration.
a/e !(
TAFJ-AS TAFJ
TAFJ Se s s i o n s M on i t o r To setup t$e TAFJ *essions )onitor- untar t$e ile TAFJ*ession)onitor.tar./B in QTAFJH;)+. From QTAFJH;)+ETAFJ*ession)onitor 1.
#$e'5 t$e ile ? QTAFJH;)+ ETAFJ*ession)onitorE'oni/E*ession)onitor.proper ties t'pportP77 OP t$e port use, between TAFJ an, TAFJ*ession)onitor $ttpportP70 OP t$e port use, or t$e HTT =R8
2. 3.
In QTAFJH;)+ ETAFJ*ession)onitorEbin start start.s$ or start.bat 4rowse $ttp?EEOIX?O $ttpport XE*ession)onitorE
i.e $ttp?EE127.0.0.1?70E*ession)onitorE
a/e 60
TAFJ-AS TAFJ
"ow wit$ TAFJ in t$e properties ile setup ? GGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGG
TFJ Mo%tor
GGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGG 7able t3e TFJMo%torSe!!%o te'*taj*rut%'e*!e!!%o*'o%tor*eable
> true
$> to eable t3e 'o%tor
Co!t a'e or 5. o ?3ere %! t3e TFJMo%torSe!!%o
a/e 61
TAFJ-AS TAFJ
te'*taj*rut%'e*!e!!%o*'o%tor*3o!t TFJSe!!%oMo%tor
> local3o!t $> ?3ere %! your
T,. port o t3e TFJMo%torSe!!%o te'*taj*rut%'e*!e!!%o*'o%tor*port
> HII$> t3e tcp=port o TFJSe!!%oMo%tor
a/e 62
TAFJ-AS TAFJ
TAFJ Te c h n i c a l M o ni t o r TAFJ++ appli'ation 'oul, be monitore, by browsin/ t$e ollowin/ =R8. $ttp?EEO$ostX?OportXE /A*JEEmonitorin# )onitorin/ is a'$ieve, usin/ ava melo,y w$i'$ is an open sour'e appli'ation to monitor ava ++ appli'ations. it$ very low over$ea, it /ives some statisti's an, '$arts about?
)emory- t$rea,s- #=
*L8 statements 9'oul, be ,isable, wit$ a parameter:
"umbers o +J4s 'all an, response time 9'oul, be remove, - spe'ii' 'oni/uration :
+rror lo/s 9'oul, be ,isable, wit$ a parameter:
a/e 6
TAFJ-AS TAFJ
)4eans an, a'tive sessions
atabase inormations 9,epen,s on t$e 4 provi,er:
a/e 6%
TAFJ-AS TAFJ
Jav a m e l o d y o ve r vi e w Full ava melo,y ,o'umentation 'oul, be oun, $ere? $ttps?EE'o,e./oo/le.'omEpEavamelo,yE Ta5en rom ava melo,y ,o'umentation? T$e /oal o Java)elo,y is to monitor Java or Java ++ appli'ation servers in LA an, pro,u'tion envi ronments. It is not a tool to simulate re@uests rom users- it is a tool to measure an, 'al'ulate statisti's on real operation o an appli'ation ,epen,in/ on t$e usa/e o t$e appli'ation by users. Java)elo,y is mainly base, on statisti's o re@uests an, on evolution '$arts.
Java melo,y ,oesnt re@uire a ,atabase to store events nor 'o,e instrumentation. T$ereore it 'oul, be enable, in pro,u'tion be'ause o its very low over$ea, 9rom null to !Y:. is'ussion about ava melo,y over$ea, 'oul, be oun, $ere? $ttps?EE'o,e./oo/le.'omEpEavamelo,yEwi5iE;ver$ea, T$at bein/ is sai, even i its not a,visable monitorin/ 'oul, be ,isable, an, even totally remove, rom TAFJJ++ appli'ation in 'ase o nee,.
Jav a m e l o d y c on f i g u r a t i o n Java melo,y libraries 'oul, be oun, un,er TAFJJ+++AREAI"FElib?
avamelo,y.ar- 'ore library- w$i'$ is a pat'$e, version o oi'ial ava melo,y to 'over a,,itional nee,.
robin.ar- RR tool ava implementation- to lo/ ,ata an, ,o /rap$ ren,erin/.
M on i t or i n g fil te r a nd li st e n e r T$e monitorin/ un'tionalities are enable, t$rou/$ a servlet ilter 'alle, )onitorin/Filter,e'lare, in TAFJJ+++ARETAFJJ++ARTAFJEwebappE+4I"FEweb.
a/e 6!
TAFJ-AS TAFJ
$%lter-'app%g& $%lter-a'e&'o%tor%g $/%lter-a'e& $url-patter&/G$/url-patter& $/%lter-'app%g&
Java melo,y also ,eines a *ession8istener to monitor $ttp sessions. e ,ont ma5e use o it or TAFJJ++. 5lease re0er to te 6no"n iss$e section "en deployin# in "ebspere to #et te 0ilter correctly initiali7ed.
Parameters T$ere are several parameters t$at 'oul, be 'oni/ure, to reine ava melo,y setup? $ttps?EE'o,e./oo/le.'omEpEavamelo,yEwi5iE=serGui,eZ6.;ptionalparameters T$is se'tion presents t$ose we use t o monitor TAFJJ++. arameters 'oul, be ,eine, in several ways? as ilter parameter- 'onte
To ,isable monitorin/ simply set java'elody*d%!abled>true* $-- tur o java'elody --& $cote+t-para'& $para'-a'e&java'elody*d%!abled$/para'-a'e& $para'-value&al!e$/para'-value& $/cote+t-para'&
Counters setup
T$e parameter java'elody*d%!played-couter! is use, to overri,e t$e 'ounters ,is playe, by ,eault. As TAFJJ++ ,oesnt ma5e use o $ttp session we remove some o t$em. $-- couter! - ?e dot ?at to d%!play t3e deault oe K3ttp#!1l#error#logK a! ?e dot eed 3ttp 'o%tor%g --& $cote+t-para'& $para'-a'e&java'elody*d%!played-couter!$/para'-a'e& $para'-value&!1l#log#ejb$/para'-value& $/cote+t-para'&
Data source setup
4y ,eault a n,i loo5up is issue, to retrieve all ,ata sour'es ,e'lare, at appli'ation level.
a/e 66
TAFJ-AS TAFJ
T$e optional parameter java'elody*data!ource! allows ,e'larin/ t$e ,ata sour'es to monitor i t$ere is a nee, to e<'lu,e some 9i.e. t$e lo'5in/ ,ata sour'e or websp$ere internal +J4 timer ,erby ,ata sour'e:. $-- data!ource! to be 'o%tored --& $-- t3ey could be retr%eved dya'%cally t3roug3 jd% looup but ?e '%g3t ?at to e+clude !o'e --& $-- %*e* LS %teral derby DS or 7J"T%'er or loc%g DS --& $cote+t-para'& $para'-a'e&java'elody*data!ource!$/para'-a'e& $para'-value&java:co'p/ev/jdbc/t24DataSource#java $/para'value& $/cote+t-para'&
$en ,einin/ multiple ,ata sour'es- t$ey s$oul, be 'oma separate,. T$e irst one will be ,isplaye, in t$e atabase Inormations s'reen. T$ey also nee, to be ,eine, at TAFJJ++ARTAFJ.war level to $ave t$e n,i loo5up resolve, 9optional i t$e property is not use,:.
History storage directory
4y ,eault ava melo,y stores .rr, iles or /rap$s an, ./B iles or statisti's on ,is5 in t$e temporary ,ire'tory o t$e appli'ation server or in t $e temporary ,ire'tory o t$e $ost- ,eine, by system property java*%o*t'pd%r* T$is is t$e ,ire'tory to 'lear to 'lean up all statisti's an, /rap$s. T$e property java'elody*!torage-d%rectory is use, to overri,e t$is ,eault temporary ,ire'tory. $-- !tat%!t%c !torage d%rectory --& $cote+t-para'& $para'-a'e&java'elody*!torage-d%rectory$/para'-a'e& $para'-value&,:java'elody-!torage-d%r$/para'-value& $/cote+t-para'&
Ta5en rom t$e ,o'umentation I t$e name o t$e ,ire'tory starts wit$ [E[ 9or on in,ows- wit$ ,rive spe'iier ollowe, by [N[- or i its prei< is \NN\:- it is 'onsi,ere, as an absolute pat$- ot$erwise it is 'onsi,ere, as relative to t$e tempo rary ,ire'tory. I t$is parameter is '$an/e, it is re'ommen,e, to rename t$e p$ysi'al ,ire'tory at t$e same time.
Disable SQL and JDBC monitoring
T$e property java'elody*o-databa!e will ,isable all *L8 an, J4# monitorin/ w$en set to true* In t$at 'ase *L8 'ounters wont be ,isplaye,. $-- tur o !1l 'o%tor%g ?3e !et to true --& $cote+t-para'& $para'-a'e&java'elody*o-databa!e$/para'-a'e& $para'-value&al!e$/para'-value& $/cote+t-para'&
a/e 67
TAFJ-AS TAFJ
Error log level
T$e property log-t3re!3old-level is a spe'ii' property in t$e pat'$e, TAFJJ++ avam elo,y version. 4y ,eault ava melo,y reports warnin/ an, error messa/es reporte, by t$e ,ierent appli'a tion lo//in/ systems 9ava util lo//in/- lo/%- lo/ba'5:. T$is parameter allows reinin/ t$is setup. 4y ,eault we want to report only +RR;R mes sa/es. It 'oul, also be use, to turn o t$is un'tionality. )a5in/ use o lowest lo//er level value is not a,visable as it 'an be really verbose an, t$is is not t$e inten,e, purpose o t$is un'tionality w$i'$ is to report only last 100 lo/s mes sa/es re'eive,. &ali, values or t$is parameter are +RR;R AR"I"G I"F; +4=G ;FF. $en set to ;FF- t$e lo/ 'ounter wont be ,isplaye,. $cote+t-para'& $para'-a'e&java'elody*log-t3re!3old-level$/para'-a'e& $para'-value&7RROR$/para'-value& $/cote+t-para'&
Development mode parameters
/is parameter is not advisable in prod$ction and so$ld be $sed only d$rin# development pase. 4y a,,in/ property java'elody*!a'pl%g-!ecod! $otspot ,ete'tion will be enable, an, sta'5tra'e samplin/ will be e
$-- 3ot!pot detect%o --& $cote+t-para'& $para'-a'e&java'elody*!a'pl%g-!ecod!$/para'-a'e& $para'-value&9B$/para'-value& $/cote+t-para'& java'elody*!a'pl%g-e+cluded-pacage! property allows reinin/ t$e ,eault list o pa'5
a/e e<'lu,e, ,urin/ $ot spot ,ete'tion. $cote+t-para'& $para'-a'e&java'elody*!a'pl%g-e+cluded-pacage!$/para'-a'e& $para'-value&java#!u#co'*!u#java+#org*apac3e#org*3%berate#oracle#org*po!tgre!1l#org*ecl%p!e#org*jbo!!#co'*arjua#org*jp $/para'-value& $/cote+t-para'&
EJB m o ni t o r i n g To monitor +J4s re@uests an inter'eptor $as to be ,e'lare, in t$e ebar.
TAFJ-AS TAFJ
T$e ,eault ava melo,y inter'eptor is et*bull*java'elody*Mo%tor%g5terceptor* It 'an be repla'e, wit$ a spe'ii' TAFJ inter'eptor to 'lassiy re@uest per ;F* sour'e. $%terceptor! & $%terceptor& $%terceptor-cla!!& co'*te'eo!*taj*'o%tor%g*%terceptor*Mo%tor%g,la!!%%er5terceptor $/%terceptor-cla!!& $/%terceptor& $/%terceptor!&
T$is inter'eptor nee,s to be asso'iate, to t$e tar/ete, +J4 E )4 wit$in t$e assembly ,es'riptor se'tion o t$e ebar.
4y ,eault TAFJJ++ is 'oni/ure, to monitor all +J4s a'tivity. It 'oul, be 'ompletely ,isable, by removin/ t$is inter'eptor ,e'laration or by restri'tin/ t$e eb name to t$e +J4 to be monitore, instea, o mappin/ t$em all? $ejb-a'e&G$/ejb-a'e& ,ould be replaced ?%t3 $ejb-a'e&"ROLS7R.roce!!%g"ea$/ejb-a'e&
To monitor multiple spe'ii' +J4s- t$e inter'eptor bin,in/ se'tion s$oul, be repli'ate, per +J4.
Lim it a ti o n a nd kn ow n is s u e s
We b sp h e r e a pp li c a t i o n s er v er Monitoring filter initialisation
$en ,eployin/ ava melo,y in websp$ere- up to version .!- t$e monitorin/ ilter wont be automati'ally initialiBe, at appli'ation startup as it s$oul, be a''or,in/ t$e servlet spe'ii'ation. $ttp?EEwww01.ibm.'omEsupportE,o'view.wssSui,Psw/1)62(0( a/e 6(
TAFJ-AS TAFJ
ou will nee, to a,, a 'ustom property? com.ibm.Os.Oebcontainer.invoPe%ilter0nit!tStart"p 7 tr"e
to t$e web'ontainer o t$e server- as mentione, in t$e lin5 above. ;t$erwise t$e monitorin/ ilter wont start until t$e TAFJ++ servlet /ets invo5e,. SQL monitoring
4y ,eault avamelo,y 'ore ,oesnt provi,e rewrappin/ to monitor websp$ere ,ata sour'e. It will pro,u'e ollowin/ error. %%FC EIceptionKjavaI.naming.#amingEIception So"rce06Kcom.ibm.Os.naming."til.3elpers.process'ava$bject%orin6ing robe06K?*2 4eporterKjava.lang.ClassQa*ab*=c
javaI.naming.#amingEIceptionK com.s"n.proIJ.MroIJ5=.get4eference() ret"rne6 n"ll in violation of the '#F0 !0 at com.ibm.Os.naming."til.3elpers.process'ava$bject%orin6ing(3elpers.javaK?1+) at com.ibm.Os.naming.jn6icos.C#ConteIt0mpl.6o4ebin6(C#ConteIt0mpl.javaK2+1?) at com.ibm.Os.naming.jn6icos.C#ConteIt0mpl.rebin6(C#ConteIt0mpl.javaK?1) at com.ibm.Os.naming."til.Wsn0nitCtI.rebin6(Wsn0nitCtI.javaK2==) at com.ibm.Os.naming."til.Wsn0nitCtI.rebin6(Wsn0nitCtI.javaK25>) at org.apache.aries.jn6i.FelegateConteIt.rebin6(FelegateConteIt.javaK11) at javaI.naming.0nitialConteIt.rebin6(0nitialConteIt.javaK5>2) at net.b"ll.javamelo6J.'6bcWrapper3elper.rebin6FataSo"rce('6bcWrapper3elper.javaK ) at net.b"ll.javamelo6J.'6bcWrapper.rebin6FataSo"rces('6bcWrapper.javaK5>2)
/A*J is sipped "it a patced version o0 javamelody to 0ix tis iss$e.
JB os s 6 EA P
Mb e a n s )beans are not bein/ ,isplaye, in J4oss 6.1 +A be'ause o ollowin/ J4oss re,$at issue. error J)M J4A*01((0! *$oul, not /et 'alle, $ttps?EEissues.boss.or/EbrowseEF8
Cl ea ri n g al l s ta ti s t i c s a nd gr ap h s *top t$e server an, 'lean up t$e ,ire'tory ,eine, in property java'elody*!toraged%rectory*
eletin/ t$e .rr, iles will 'lean up t$e /rap$s- ,eletin/ ./B iles will 'lean up t$e statisti's.
a/e 70
TAFJ-AS TAFJ
TAFJS an i t y c h e k . w a r – Co nf i g u r a t i o n val id a t i o n Presentation T$e sanity '$e'5 appli'ation is ,esi/ne, to $elp user to ,ia/nose by $imsel w$at 'oul, be wron/ or not optimal in a T2% ava ,eployment. 4ase, on t$e ail ast prin'iple it s$oul, ensure t$at appli'ation an, resour'es are 'o$erent beore runnin/ T2%. It provi,es inormation about 'omponents involve, an, $i/$li/$t possible mista5es base, on a set o rules. T$ese inormation are a''essible wit$ an online ,as$boar, t$at 'oul, be browse, at t$e ollowin/ =R8? $ttp?EElo'al$ost?00ETAFJ++Esanity'$e'5E,as$boar,.<$tml T$ere is also in a te
+rror preventin/ t$e appli'ation server to start an, E or appli'ation to ,eploy. *ystem is not available.
+rror w$ere appli'ation server starts- appli'ation ,eploys but T2% is not or partially available.
+rror w$ere appli'ation is up an, runnin/ but be$avior is altere, ater a 'ertain time.
T$e sanity '$e'5 is $ere to $elp solvin/ t$e last two points by provi,in/ a tool to run?
a 'arto/rap$y o TAFJ+++AR ile to ,isplay 'urrent TAFJ++ 'oni/uration-
a 'arto/rap$y o appli'ation server ,eployment to ,isplay 'urrent resour'es 'oni/uration-
a vali,ation between t$ese two points? w$at is ,eine, at ear ile level must mat'$ w$at is ,eine, at appli'ation server level-
a vali,ation t$at appli'ation- server an, resour'es are wor5in/ 'orre'tly all to/et$er-
a proposition o i< an, tips w$en vali,ation warnin/ or errors are raise,.
T$e ,as$boar, is ma,e o main panels- t$e irst one represents t$e appli'ation 'oni/uration- wit$ t$e '$annel view- t$e )4s view an, t$e +J4s view.
a/e 71
TAFJ-AS TAFJ
T$e se'on, panel represents t$e appli'ation server 'oni/uration- wit$ ,ata sour'es- J)* obe'ts- t$rea,s pool- timeouts an, J&) parameters.
T$e last panel represents t$e vali,ation o t$e 'oni/uration- wit$ vali,ations events an, su//estions about $ow i
a/e 72
TAFJ-AS TAFJ
Process
a/e 7
TAFJ-AS TAFJ
Ap pl i c a t i o n p ar s i n g T$e irst step o t$e pro'ess is t$e parsin/ an, t$e reportin/ o t$e main 'omponent involve, in a T2% ava enterprise ,eployment- w$i'$ is t$e TAFJ ear ile. T$is 'omponent is t$e /lue between 'lient appli'ations? 4rowser- T#I4- T*W an, T2%. It $an,les in'omin/ re@uests- pass t$em to T2% an, sen, ba'5 responses. T$e 'ommuni'ation mo,el use, is J)*. TAFJ ear ile ,eines )4s to $an,le J)* messa/es an, +J4s to invo5e T2%. T$ere is a one to one relations$ip between a )4 an, an +J4- t$is asso'iation is w$at we 'all in t$is ,o'ument a #HA""+8. TAFJ ,istribution provi,es a ,eault ear ile or ea'$ appli'ation server supporte,. It ,eines some ,eault 'ommuni'ation '$annels an, t$eir parameters? ormatter- ;F* sour'e an, timeout- t$rea, pool et'W )4s are ,eine, wit$in TAFJJ++)4.ar an, +J4s in TAFJJ+++J4.ar wit$ ,eployment ,es'riptors.
T$is parsin/ is available as a stan,alone appli'ation- it 'oul, be $elpul to run appli'ation analysis or a non,eploye, ear ile or to run some 'omparison between ,ierent ear ile versions. Execute E! file parser in standalone
a/e 7%
TAFJ-AS TAFJ
T$e ear ile parser is available as a stan,alone appli'ation- to appen, in a 'onsole t$e ear ile 'oni/uration. It 'oul, be invo5e, rom t$e TAFJ s$ell? Ear*ile5arser 8-lo#9 pattoear0ile 8JB)((!4A(!4EB;)<9 5arameters :
lo/ ? optional parameter to appen, t$e ear ile report to /A*J3H)MElo#sanitycec6.lo#
+ar ile pat$? man,atory parameter w$i'$ spe'iies t$e ull pat$ to t$e ear ilein'lu,in/ t$e ear ile name- i.e. EQTAFJH;)+EappserverE TAFJJ+++AR.ear
Appli'ation server provi,er? optional parameter to /enerate t$e report or a spe'ii' provi,er 9value must be J4;**- A* or +48;:. I not spe'iie, t$e report will 'ontain all 'oni/urations.
Limitations
T$e ear ile parsin/ is e
a/e 7!
TAFJ-AS TAFJ
App li c a t io n s er v er c on fi g u r a t i o n pa rs i n g T$e se'on, step o t$e pro'ess is t$e appli'ation server 'arto/rap$y- w$i'$ /oal is to provi,e a 'lear pi'ture o t$e appli'ation server parameters an, resour'es w$i'$ are relevant or T2% ava appli'ation. #oni/uration ,etails $ave to be e
ata sour'es an, relate, parameters? n,i bin,in/- =R8- pool siBeW
J)* resour'es an, relate, parameters? n,i bin,in/- @ueue ,ept$W
+J4 an, )4 parameters? timeout- pool siBe
TAFJ ,istribution provi,es a set o s'ripts to 'oni/ure supporte, appli'ation servers. T$ey $elp to 'reate all resour'es? J)* obe'ts- ,ata sour'es an, s$are, libraries- nee,e, by TAFJJ++ appli'ation. T$e e
J4oss 6+A an, $i/$er ? J4;** #8I 9#omman, 8ine Intera'e: 'lient o
'onstraint: #et a connection to te admin server =de0a$lt port is >>>>?! te server m$st be $p and r$nnin#.
eblo/i' 12' an, $i/$er ? J)M 'lient
ebps$ere .! an, $i/$er? J)M 'lient o
'onstraint: #et a connection on te ()A5 port o0 te application server =de0a$lt port is @@@,?.
For eblo/i' an, ebsp$ere t$e stan,ar, ava mana/ement e
TAFJ-AS TAFJ
Limitations
T$e 'urrently supporte, appli'ation server are?
J4oss 6+A
eblo/i' 12.1
ebps$ere .!.!
Hi/$er appli'ation server version s$oul, be supporte, i appli'ation server provi,ers ,o not mo,iy t$eir AI to publis$ 'oni/uration inormation.
a/e 77
TAFJ-AS TAFJ
Va li da t i o n ru le s , ev e n t s , fix a nd ti ps T$e last step o t$e pro'ess is to run some vali,ation tests a/ainst 'olle'te, inormation to ensure t$at?
T$ere is no missin/ resour'es at appli'ation server level re/ar,in/ w$at is nee,e, at appli'ation level
#lasspat$ is 'orre'tly 'oni/ure,- T2% 'o,e is available
ool siBe an, timeout are 'o$erent
)emory setup is 'o$erent wit$ e
4ase, on t$e '$annels ,einition an, t$e appli'ation server 'oni/uration a rule en/ine vali,ates t$e 'o$eren'e between all t$ese parameters. It e
+nsure T2% 'o,e 9;F*.4=8>.)A"AG+R: an, eventually e
o
+nsure 'orre't
)emory ? memory setup is 'orre't to run t$e e
)4 t$rea, pool XP )4 pool ? ensure t$ere is enou/$ t$rea, to $an,le t$e e
o
)4 pool OP +J4 pool? ensure t$ere is enou/$ +J4 to $an,le t$e e
o
+J4 pool OP * pool? ensure t$ere is enou/$ ,ata sour'e 'onne'tion or t$e '$annel.
a/e 7
TAFJ-AS TAFJ
o
Total +J4 pool C bat'$ '$annel pool OP * pool? ensure t$ere is enou/$ ,ata sour'e 'onne'tion to 'over t$e ma
o
$antom listener pool XP number o A=T; E *TART t*As ? ensure t$at all servi'es 'oul, be starte, t$rou/$ t$e +
Timeout ? #o$eren'e between 'omponents timeout o
)4 Timeout XP +J4 timeout? ensure t$e )4 $as t$e $i/$est timeout o t$e '$ain
o
+J4 timeout XP ;F* timeout? ensure t$at t$e +J4 wont timeout beore t$e ;F* e
o
4 timeout XP ;F* timeout? ensure t$at @uery wont timeout beore ;F* timeout.
o
I/nore stu'5 t$rea,? spe'ii' to weblo/i'- ensure t$at i/nore stu'5 t$rea, parameter is ,eine, or t$e $antom '$annel.
ata sour'e? *pei'i' ,ata sour'e parameters vali,ation o
8o'5in/ ,ata sour'e must not be transa'tional? in 'ase o J4# lo'5in/ ma5e sure t$at t$e lo'5in/ ,ata sour'e is not part o t$e transa'tion.
atabase ? +nsure t$e ava store, un'tions loa,e, in t$e ,atabase are up to ,ate wit$ t$e one provi,e, wit$ t$e 'urrent runtime. T$e vali,ation result is outputte, in t$e &ali,ation panel. *ome ilterin/ options are available? Filter by eent category
a/e 7(
TAFJ-AS TAFJ
Filter by eent seerity
Filter by !hannel " Serer
"e
a/e 0
TAFJ-AS TAFJ
For t$e R+*;=R#+ vali,ation rule we 'an see t$e @ueues an, ,ata sour'es involve, in t$e vali,ation. T$e ;;8 an, TI)+;=T vali,ation rules spe'iy t$e respe'tive pool an, t imeout parameters 'onsi,ere, by t$e rules or ea'$ 'omponent involve, or t$e '$annel. In 'ase o AR"I"G or +RR;R t$e Help tab propose some tips an, i
T$e vali,ation event reports t$e ollowin/- it means t$at t$e rules ,ete'te, t$at t$ere 'oul, be up to 210 'on'urrent sessions on t$e server- an, t$at t$e 'urrent memory setup or t$e J&) $eap siBe is 1G. T$is wont be enou/$ in 'ase o 210 sessions- w$ere ,epen,in/ on t$e loa, E ob e
T$e $elp tab provi,e an e
a/e 1
TAFJ-AS TAFJ
;;8 vali,ation +&+"T wit$ *+&+RIT +RR;R.
T$e vali,ation event reports t$e ollowin/- it means t$at t$e rules ,ete'te, t$at t$ere 'oul, be up to 20 'on'urrent t$rea, or t$is '$annel- 1! )4s available rom t$e pool an, 220 ,atabase 'onne'tion. ]ma<)4T$rea,P20- ma<)4ool*iBeP1!- ma<+J4ool*iBeP"EA- ma<*ool*iBeP220ma<8o'5in/*ool*iBeP0^ e 'an see t$at t$e appli'ation server 'oni/uration relate, pool is also $i/$li/$te, R+.
a/e 2
TAFJ-AS TAFJ
T$e asso'iate, '$annel will not be$ave as e
T$e Help tab provi,es an e
a/e
TAFJ-AS TAFJ
T$e )4 pool siBe 'oul, be un,ersiBe, to run t$e e
Review t$e m,b pool siBe or t$is '$annel- reer to t$e appropriate pool siBe in t$e +J4 viewDsee A,ministrationE#oni/urationE#ontainerE+J4E4+A" ;;8*E)a< ool *iBe 4ase, on t$e total number o t*A w$i'$ 'oul, be a'tive on t$e system- t $e rule ,ete'te, t$at t$ere wont be enou/$ )4 to $an,le t$em. A i< su//estion woul, be to review t$e )4 pool siBe or t$is '$annel- t$e lin5 to t $e asso'iate, appli'ation server parameter is provi,e, so as t$e relate, s'reens$ot.
Limitations
a/e %
TAFJ-AS TAFJ
In 'ase o /eneri' or te'$ni'al error- i.e. missin/ resour'e- 'lasspat$ mis'oni/uration- ava store, un'tion mismat'$- et'W a tip is provi,e, in t$e event an, a lin5 to T AFJ ,o'umentation is propose, as t$e i< re@uires ollowin/ step by step instru'tions.
T$e appli'ation server e
a/e !
TAFJ-AS TAFJ
Va li d at i o n r ep o r t All inormation represente, in t$e online ,as$boar, 'oul, be oun, in t$e te
W
W
a/e 6
TAFJ-AS TAFJ
a/e 7
TAFJ-AS TAFJ
Se c ur i n g we b app li c at i o n s As presente, in above se'tions- TAFJJ++ARTAFJ.war an, TAFJ*ervi'es.war provi,e a''ess to several un'tionalities t$at mi/$t nee, a prote'te, a''ess?
TAFJ++E+
TAFJ++Emonitorin/ to a''ess TAFJ te'$ni'al monitor
TAFJ*ervi'esEservi'esE;F**ervi'e to pro'ess ;F* re@uest t$rou/$ webservi'e
TAFJ*ervi'esEservi'esEInvo5er*ervi'e to pro'ess #A88AT t$rou/$ webservi'e
A sample 'oni/uration is available to a,, a 4A*I# Aut$enti'ation 9role- user an, passwor,: to t$ese appli'ations. It 'onsists in a 'ommon 'oni/uration part at webapp level an, in a spe'ii' 'oni/uration part at webapp an, appli'ation server level ,epen,in/ on t$e appserver provi,er.
Ba si c Aut he n t i c at i o n co m m o n co nf i gu r a ti o n #omment out in t$e web appli'ation "ebapp4EB-1N*"eb.xml t$e se'tion relate, to se'urity at t$e en, o t$e ile. *ample below is e
a/e
TAFJ-AS TAFJ
$real'-a'e&TFJReal'$/real'-a'e& $/log%-co%g&
Ba si c Aut h e n ti c a t i o n JBo s s
Webapp #omment out in t$e web appli'ation E "ebapp4EB-1N*jboss-"eb.xml t$e se'tion relate, to se'urity at t$e en, o t$e ile. $-- te'plate co%gurat%o to !ecure t3e ?ebpp --& $!ecur%ty-do'a%&java:/jaa!/TFJReal'$/!ecur%ty-do'a%&
Jbo s s EA P6 d ep l o y m e n t A,, a se'urity ,omain in t$e se'urity ,omains se'tion o t$e stan,alone."TAFJRea!m" cac3e-type>"de(au!t"& $aut3et%cat%o& $log%-'odule code>")sersRo!es" lag>"re*uired" & $'odule-opt%o a'e>"usersroerties" value>"+,j#oss-ser'er-. con(ig-dir/ta(j.users-roerties"/& $'odule-opt%o a'e>"ro!esroerties" value>"+,j#oss-ser'er-. con(ig-dir/ta(j.ro!es-roerties"/& $/log%-'odule& $/aut3et%cat%o& $/!ecur%ty-do'a%&
#reate iles serverstandalonecon0i#$ration ta0j-$ser.properties a,, a user an, passwor,- i.e. taj>pa!!?ord
serverstandalonecon0i#$rationta0j-roles.properties a,, a role TAFJA,min an, asso'iate it to ta user taj>TFJd'%
ou 'oul, reer to $ttps?EE'ommunity.boss.or/Ewi5iEJ4ossA*7*e'ure)yebAppHowoISss''Pt
Ba si c Aut h e n ti c a t i o n We bl o g i c
a/e (
TAFJ-AS TAFJ
Webapp #omment out in t$e web appli'ation "ebapp4EB-1N*"eblo#ic.xml t$e se'tion relate, to se'urity at t$e en, o t$e ile. $-- te'plate co%gurat%o to !ecure t3e ?ebpp $!ecur%ty-role-a!!%g'et& $role-a'e&TFJd'%$/role-a'e& $pr%c%pal-a'e&TFJd'%$/pr%c%pal-a'e& $/!ecur%ty-role-a!!%g'et&
--&
We bl o g i c 1 2c d ep lo y m e n t A,, a se'urity realm t$rou/$ weblo/i' 'onsole or use t$e ,eault one myrealm. A,, /roup TAFJA,min
A,, a user ta
A,, /roup TAFJA,min to user ta
a/e (0
TAFJ-AS TAFJ
Ba si c Aut h e n ti c a t i o n We bs p h e r e Webapp "o spe'ii' '$an/e applies to webapp.
WAS 8 .5 d ep l oy m e n t /e 4ebspere pro0ile m$st be sec$red to per0orm te 0ollo"in# con0i#$ration. +nable a,ministrative se'urity an, appli'ation se'urity.
a/e (1
TAFJ-AS TAFJ
#reate user an, /roup.
a/e (2
