TAFJ-AS TAFJ.pdf

TAFJ-AS TAFJ R16

TAFJ-AS TAFJ

Amendment History:

Revisio n

DateAmended

Name

Description

1

1st A pril 2011

TAFJ team

Initial version

2

7st F ebruary 2012

H. Aubert



1! January 201

%

20t$ F ebruary 201

!

1()ar'$201%

6

2%t$ J une 201%

J". #$arpin

+ntry points ,o'umentation- ebservi'es

7

20t$ A u/ust 201%

J". #$arpin

TAFJ te'$ni'al monitor an, webapp basi' aut$enti'ation



26t$ * eptember 201%

R. &in'ent

(

! February 201!

J". #$arpin

10

6t$)ar'$201!

H.Aubert

11

1t$ A pril 201!

J". #$arpin

"ew servlet un'tionalities

12

1!t$ ) ay 201!

J". #$arpin

++6 '$an/e 3 #ontainer mana/e, +J4

1

2n, *e ptember 201!

J". #$arpin

4ean mana/e, +J4

1%

1t$ J anuary 2016

J". #$arpin

*anity '$e'5

1!

1!t$ ) ar'$ 2016

J". #$arpin

R16 A)R review

J". #$arpin R. &in'ent J".#$arpin

R12GA review R1GA review R1%GA review *ervletreview

A,,e, TAFJ *essions monitor ,o'umentation Te'$ni'al monitor 1.!%T+)" R1!A)Rreview

a/e 2

TAFJ-AS TAFJ

16

10t$ January 2017

J". #$arpin

)4s responses a,, timeTo8ive parameter

a/e 

TAFJ-AS TAFJ

Copyright #opyri/$t 9': 201% T+)+";* H;8I"G* "& All ri/$ts reserve,. T$is ,o'ument 'ontains proprietary inormation 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
Errata and Comments 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 'oni/uration.................................................................................................................. TAFJA* T2% 'omponent...........................................................................................................................(

J)* Re@uestEReply '$annel.................................................................................................10 )4 an, +J4 mappin/.........................................................................................................11 )4 #omponents 'oni/uration...........................................................................................12 TAFJJ++)4.arE)+TAI"FEebar.
TAFJJ++)4.arE)+TAI"FEbosseb.
TAFJJ+++J4.arE)+TAI"FEbosseb.
$antom )4 +J4JAR #omponent 'oni/uration.............................................................2 Optional properties............................................................................................................% TAFJJ++ARTAFJ  *ervlet #omponent...........................................................................................6

&eriy installation? TAFJ++ main pa/e.................................................................................( Gettin/ TAFJ installation ,etails? tia/*ervlet.....................................................................%0 Gettin/ routine 'ompilation ,etails? t*$ow*ervlet................................................................%1 Runnin/ a #;4 wit$ TAFJ? +
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#A88AT:.........................................................................!( *8.................................................................................................................................!( Invo'ation..........................................................................................................................!( T+# +vents...............................................................................................................................................60 TAFJ *essions )onitor.............................................................................................................................61 TAFJ Te'$ni'al )onitor............................................................................................................................6

Java melo,y overview...........................................................................................................6! Java melo,y 'oni/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 #oni/uration vali,ation......................................................................................72

resentation..........................................................................................................................72 ro'ess..................................................................................................................................7% Appli'ation parsin/............................................................................................................7! a/e 6

TAFJ-AS TAFJ

Appli'ation server 'oni/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 'oni/uration........................................................................(0 4asi' Aut$enti'ation J4oss...................................................................................................(1 ebapp.............................................................................................................................(1 Jboss +A6 ,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 ile. epen,in/ on your appli'ation server version you $ave to /et t$e 'orrespon,in/ ear ile rom TAFJH;)+EappserverE;=RA*+R&+RR;&I+RE&+R*I;" 

TAFJJ+++AR.ear 'ontains ? o

TAFJJ++)4.ar ? )essa/e riven 4eans to $an,le J)* messa/es

o

TAFJJ+++J4.ar ? +nterprise Java 4eans to pro'ess T2% re@uests

o

TAFJJ++ARTAFJ.war ? *et o servlet an, utilities

o

TAFJJ++*ervi'es.war ? ebservi'es to pro'ess T2% re@uests

MDB is use, in t$is ,o'ument or )essa/e riven 4ean. EJB is use, in t$is ,o'ument or +nterprise Java 4ean.

Application configuration +
a/e 

TAFJ-AS TAFJ

TAFJ-AS T2 component T2% Java ,eployment ar'$ite'ture is t$e ollowin/?

Four types o '$annels are use, in T2% ava ,eployment? 1. ;F* Re@uestEReply base, on J)* re@uestEreply @ueues. T$is '$annel is 'oni/ure,Einstantiate, by ,eault or ;F*- 4rowser- T*- AR#);4T#I4- A)8 an, *+AT. 2. #A88AT Re@uestEReply base, on J)* re@uestEreply @ueues. T$is '$annel will initialiBe a TAFJ *ession wit$ JF.I"ITIA8IK+ an, ,o a #A88 D wit$ parameters. . $antom bas e, on re@ uest J)* Lueue. T$is '$a nnel is use, to mana/e T2% p$antom eature 9start a t$rea, in ba'5/roun,:. %. T+# +vents. T2% T+# is able to publis$ T+# +vents on T+# J)* Topi's. T$is J)* topi' 'oul, be 'onsume, by e
a/e (

TAFJ-AS TAFJ

TAFJJ+++AR.ear ile 'ontains our 'omponents? 1. TAFJJ++)4.ar 'oni/ures all ,eault )4 to operate T2% ava ,eployment- ;F*- T*- T#I4- AR#);4- A)8- *+AT- #A88AT- $antom )4 2. TAFJJ+++J4.ar 'oni/ures all ,eaults +J4 to operate T2% ava ,eployment;F*- T*- T#I4- AR#);4- A)8- *+AT- #A88AT +J4. "ote t$at t$ere is no $antom +J4. . TAFJJ++ARTAFJ.war provi,es set o servlet an, utilities 3

ia/nosti' tools ? tia/ E t*$ow

3

+
3

Troubles$ootin/ an, monitorin/ tools

%. TAFJ*ervi'es.war is an A
J!S "e#uest$"eply channel #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 ,eault '$annels are? 1. ;F* #$annel 2. 4R;*+R #$annel . T* #$annel %. AR#);4 #$annel !. T#I4 #$annels 9T#I4- +A8TH- #;R: 6. A)8 #$annel 7. #A88AT #$annel . *+AT #$annel 9Re/ression purpose:

!%& and EJ& mapping 4eore ,es'ribin/ $ow )4 an, +J4 'an be 'oni/ure,- it is important to un,erstan, t$e 'oni/uration iles involve, in t$e setup. )4E+J4 #oni/uration is ,one t$rou/$ stan,ar, J++ ilesejb-jar.xml an, appli'ation server spe'ii' 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, 'oni/ure mappin/ between an appli'ation resour'e name 9lo/i'al name: an, a spe'ii' appli'ation server name 9p$ysi'al name 3 n,i name:. For e
in

t$e

)+TAI"F

ol,er

o

TAFJJ++)4.ar

an,

a/e 11

TAFJ-AS TAFJ

!%& Components configuration )4 'omponents are ,eine, 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 transorm 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 ,eault is ";" +R*I*T+"T or perorman'e reason.

o

An option to sen, t$e response to t$e ,estination ,eine, in t$e messa/e property getJMSReplyTo() - ,isable, by ,eaut.

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 ,eaut.

+rror $an,lin/? o

An option to ,ont 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 ,eault 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'!%&()ar$!ETA-*+F$e),-)ar(ml T$e sample below presents t$e main 'oni/uration part or a /iven )4 'alle, OFSTra!actedMD"# it 'oul, be oun, wit$in t$e se'tion $eterpr%!e-bea!& o t$e ejbjar.xml It allows ,einin/ t$e man,atory resour'es presente, above an, ,oesnt ma5e use o optional properties. $'e!!age-dr%ve& $d%!play-a'e&Tra!acted %!teer MD" or OFS$/d%!play-a'e& $ejb-a'e&OFSTra!actedMD"$/ejb-a'e& $ejb-cla!!&co'*te'eo!*taj*'db*Tra!actedMD"$/ejb-cla!!& $'e!!ag%g-type&java+*j'!*Me!!age%!teer$/'e!!ag%g-type& $tra!act%o-type&,ota%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"eaocal$/ejb-re-a'e& $ejb-re-type&Se!!%o$/ejb-re-type& $local&co'*te'eo!*taj*!b*OFS.roce!!%g"eaocal$/local& $ejb-l%&OFS.roce!!%g"ea$/ejb-l%& $/ejb-local-re& $re!ource-re& $de!cr%pt%o&0!ed to get coect%o! to JMS or OFS 1ueue! $/de!cr%pt%o& $re!-re-a'e&j'!/TFJueue,oect%oFactory$/re!-re-a'e& $re!-type&java+*j'!*,oect%oFactory$/re!-type& $re!-aut3&,ota%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'!/Replyueue$/'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'!/OFSReplyueue$/'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 ,einition o a new '$annel or spe'ii' nee,. Mmlpat$ ,isplayname ebname eb'lass messa/in/type transa'tiontype

messa/e,estinationtype +J4 reeren'e 'oni/uration eblo'alreNebrenameN

+
+J4 8o'al intera'e reeren'e

a/e 1

TAFJ-AS TAFJ

eblo'alreNebretype eblo'alreNlo'al eblo'alreNeblin5

*ession 'om.temenos.ta.sb.;F* ro'essin/4ean8o'al ;F*ro'essin/4ean

+J4property +J4 'lass implementation *pe'iy w$i'$ +J4 is lin5e, to pro'ess t$e re@uest. e,itable 3 t$is eb name must be ,eine, in t$e TAFJJ+++J4.arE)+TA I"FEebar.
Resour'es reeren'e 'oni/uration resour'ereN resrename

resour'ereN restype resour'ereNresaut$ )essa/e ,estination reeren'e messa/e,estinationreN messa/e,estinationrename

messa/e,estinationreNmessa/e ,estinationtype messa/e,estinationreNmessa/e ,estinationusa/e messa/e,estinationre N messa/e,estinationlin5

msETAFJLueue#onne'tio nFa'tory

#oni/ure t$e J)* #onne'tion a'tory or t$e reply Lueue. "ee,s to be mappe, in Appli'ation server 'oni/uration ile. J)* property

Java<.ms.#onne'tionFa't ory #ontainer J)*property msEReplyLueue

Java<.ms.Lueue

)4 resour'e name or reply @ueue ine'tion. "ee,s to be mappe, in Appli'ation server 'oni/uration ile. J)* property

ro,u'es

J)*property

msE;F*ReplyLueue

eblo/i' only  )4 resour'e name or reply @ueue ine'tion. "ee,s to be mappe, in Appli'ation server 'oni/uration ile. e,itable

a/e 1%

TAFJ-AS TAFJ

Optional properties T$e ollowin/ properties 'oul, be a,,e, wit$in an ebar. $'e!!age-dr%ve& se'tion to reine a spe'ii' )4 setup. *ee table below or ,etaile, e
$-- R7S.O6S7 .RM7T7RS --& $ev-etry& $de!cr%pt%o&De%e re!po!e del%very 'ode (6O6=.7RS5ST76T > 9 .7RS5ST76T > 2) - deault %! o-per!%!tet or peror'ace rea!o$/de!cr%pt%o& $ev-etry-a'e&co'*te'eo!*taj*'db*Tra!actedMD"/re!po!eDel%veryMode $/ev-etry-a'e& $ev-etry-type&java*lag*5teger$/ev-etry-type& $ev-etry-value&9$/ev-etry-value& $/ev-etry& $ev-etry& $de!cr%pt%o&De%e ?3et3er 'e!!age %eld JMSReplyTo !3ould be u!ed or re!po!e (te'porary 1ueue) - deault %! al!e$/de!cr%pt%o& $ev-etry-a'e&co'*te'eo!*taj*'db*Tra!actedMD"/!edToJ'!ReplyTo $/ev-etry-a'e& $ev-etry-type&java*lag*"oolea$/ev-etry-type& $ev-etry-value&al!e$/ev-etry-value& $/ev-etry& $ev-etry& $de!cr%pt%o&De%e ?3et3er 'e!!age 5D !3ould be u!ed to %ll-up re!po!e correlat%o %d - deault %! al!e$/de!cr%pt%o& $ev-etry-a'e&co'*te'eo!*taj*'db*Tra!actedMD"/'e!!age5d!,orrelat%o5D $/ev-etry-a'e& $ev-etry-type&java*lag*"oolea$/ev-etry-type& $ev-etry-value&al!e$/ev-etry-value& $/ev-etry& $ev-etry& $de!cr%pt%o&t3e re!po!e t%'e to l%ve % '%ll%!ecod! ro' %t! d%!patc3 t%'e @ deault %! Aero %! ul%'%ted$/de!cr%pt%o& $ev-etry-a'e&co'*te'eo!*taj*'db*Tra!actedMD"/re!po!eT%'eTo%ve $/ev-etry-a'e& $ev-etry-type&java*lag*og$/ev-etry-type& $ev-etry-value&B$/ev-etry-value& $/ev-etry& $-- 7RROR C6D568 .RM7T7RS --& $ev-etry& $de!cr%pt%o&De%e ?3et3er re-del%vered 'e!!age !3ould be %gored - deault %! true a re-del%vered 'e!!age %! ot !et to T24 - ?3e !et to al!e re-del%vered 'e!!age are !et to T24$/de!cr%pt%o& $ev-etry-a'e&co'*te'eo!*taj*'db*Tra!actedMD"/%goreRedel%veredMe!!age $/ev-etry-a'e& $ev-etry-type&java*lag*"oolea$/ev-etry-type& $ev-etry-value&al!e$/ev-etry-value& $/ev-etry&

a/e 1!

TAFJ-AS TAFJ

$ev-etry& $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 deault t3e JMS prov%der 3adle! t3e 'a+%'u' u'ber o JMS del%very atte'pt - B 'ea! o re-del%very atte'pt $/de!cr%pt%o& $ev-etry-a'e&co'*te'eo!*taj*'db*Tra!actedMD"/'a+J'!Redel%verytte'pt $/ev-etrya'e& $ev-etry-type&java*lag*5teger$/ev-etry-type& $ev-etry-value&9$/ev-etry-value& $/ev-etry& $ev-etry& $de!cr%pt%o&De%e ?3et3er !etRollbacOly %! called or Sy!te' e+cept%o t3ro? % ca!e o JMS error - deault %! true ad curret MD" %! ot d%!carded % ca!e o JMS7+cept%o$/de!cr%pt%o& $ev-etry-a'e&co'*te'eo!*taj*'db*Tra!actedMD"/recoverFro'J'!Fa%lure $/ev-etry-a'e& $ev-etry-type&java*lag*"oolea$/ev-etry-type& $ev-etry-value&true$/ev-etry-value& $/ev-etry& $ev-etry& $de!cr%pt%o&De%e ?3et3er a JMS redel%vered 'e!!age re!po!e !3ould be !et to reply 1ueue % ca!e o redel%vered 'e!!age %gored ad ot proce!!ed- deault %! true $/de!cr%pt%o& $ev-etry-a'e&co'*te'eo!*taj*'db*Tra!actedMD"/!edRedel%veredMe!!ageRe!po!e$/ev-etry-a'e& $ev-etry-type&java*lag*"oolea$/ev-etry-type& $ev-etry-value&true$/ev-etry-value& $/ev-etry&

arameter deaultFor'atter

deault.r%c%pal

re!po!eDel%veryMode

es'ription eaultvalue )essa/e ormattin/ parameter. "one *trin/ parameter. Formatter to be applie, on t$e To use ;F*)8 ormatter messa/e to transorm it. apply? $ev-etry-value&OFAn ;F*)8 ormatter is available SM$/ev-etry-value& in t$e ear ile. To apply a spe'ii' ormatterTo use spe'ii' ormatter $ev-etry-value&co'*te'esimply a,, in t$e value iel, t$e eo!*or'atter*My,u!to'ully @ualiie, 'lass name o t$e For'atter$/ev-etry-value& ormatter an, ma5e it available in t$e appli'ation server 'lasspat$. )essa/e pro'essin/ parameter. *trin/ parameter. ou 'an ,eine a ,eault prin'ipal or t$e asso'iate, messa/e '$annel. Response pro'essin/ parameter. Inte/er parameter. eines w$et$er response messa/e is ,elivere, as a +R*I*T+"T or ";" +R*I*T+"T messa/e.

"one To ,eine a prin'ipal $ev-etry-value&56.0TT/924;<$/ev-etry-value&

1

#lose, set o values ? 1- )eans ";" a/e 16

TAFJ-AS TAFJ

+R*I*T+"T )eans +R*I*T+"T Response pro'essin/ parameter. 4oolean parameter. eines w$et$er response messa/e is sent to t$e ,estination ,eine, t$rou/$ messa/e property 2-

!edToJ'!ReplyTo

alse

/etJ)*ReplyTo

'e!!age5d!,orrelat%o 5D

%goreRedel%veredMe!!a ge

#lose, set o values ? true ? use t$e messa/e property alse ? use t$e msReplyLueue ,eine, at )4 level Response pro'essin/ parameter. 4oolean parameter. eines 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.

alse

true

In 'ase o messa/e re,elivery la/ 'oul, be enable, to avoi,t$is messa/e repro'essin/ in T2%. )4 will re'eive t$e messa/e but not pass it to +J4.

'a+J'!Redel%verytte'p t

#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 0t$e messa/e property JMSDel%very,out is '$e'5e, a/ainst t$is value to prote't a/ainst poison messa/e. T$is eature is ,isable, by ,eault 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, inormation is lo//e, but t$ere is no ,ea,

1 means ,isable, To ,eine no re,elivery set t$is value to 0. To 1 re,elivery only,eine 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 to ,is'ar, t$e )4 w$ene<'eption set to alse.

a/e 1

TAFJ-AS TAFJ

TAFJJEE'!%&()ar$!ETA-*+F$),oss-e),.(ml T$e sample below presents t$e 'orrespon,in/ J4;** +A6 'oni/uration part or t$e )4 OFSTra!actedMD" presente, above. It 'oul, be oun, wit$in t$e se'tion $eterpr%!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/t24OFSueue$/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'!/TFJueue,oect%oFactory$/re!-re-a'e& $re!-type&java+*j'!*,oect%oFactory$/re!-type& $jd%-a'e&java:/,oect%oFactory$/jd%-a'e& $/re!ource-re& $'e!!age-de!t%at%o-re& $'e!!age-de!t%at%o-re-a'e&j'!/Replyueue$/'e!!age-de!t%at%o-re-a'e& $jd%-a'e&java:/1ueue/t24OFSReplyueue$/jd%-a'e& $/'e!!age-de!t%at%o-re& $/'e!!age-dr%ve&

Mml pat$

+
ebname

;F*Transa'te,)4

A'tivation 'oni/ 'oni/uration a'tivation'oni/ ,estination propertyname a'tivation'oni/ ava?E@ueueEt2%;F*Lueue propertyvalue Resour'es reeren'e 'oni/uration resour'ereN resre msETAFJLueue#onne'tionFa'tory name resour'ereN restype resour'ereN n,i name

Java<.ms.#onne'tionFa'tory #onne'tionFa'tory

)essa/e ,estination reeren'e messa/e,estination msEReplyLueue reN messa/e ,estinationrename messa/e,estination ava?E@ueueEt2%;F*ReplyLueue reNn,iname

#omment Hastomat'$t$eeb name o ebar.
a/e 1(

TAFJ-AS TAFJ

TAFJJEE'!%&()ar$!ETA-*+F$i,m-e),-)ar-,nd(ml T$e sample below presents t$e 'orrespon,in/ ebsp$ere .! 'oni/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&

Mmlpat$ messa/e,riven name J'a a,apter a'tivationspe' bin,in/name ,estinationbin,in/ name

+
msEt2%;F*)essa/e)4

msEt2%;F*Lueue

Resour'es reeren'e 'oni/uration resour'ereN resre msETAFJLueue#onne'tionFa'tory name resour'ereN n,i name

#onne'tionFa'tory

)essa/e ,estination reeren'e name msEReplyLueue bin,in/name

msEt2%;F*ReplyLueue

a/e 20

TAFJ-AS TAFJ

TAFJJEE'!%&()ar$!ETA-*+F$we,logic-e),-)ar(ml T$e sample below presents t$e 'orrespon,in/ eblo/i' 12.1.M 'oni/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-eterpr%!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-jd%-a'e&j'!/t24OFSueue$/?l!:de!t%at%o-jd%-a'e& $?l!:coect%o-actory-jd%-a'e&j'!/,oect%oFactory$/?l!:coect%o-actory-jd%-a'e& $/?l!:'e!!age-dr%ve-de!cr%ptor& $?l!:re!ource-de!cr%pt%o& $?l!:re!-re-a'e&j'!/TFJueue,oect%oFactory$/?l!:re!-re-a'e& $?l!:jd%-a'e&j'!/,oect%oFactory$/?l!:jd%-a'e& $/?l!:re!ource-de!cr%pt%o& $/?l!:?eblog%c-eterpr%!e-bea& E $?l!:'e!!age-de!t%at%o-de!cr%ptor& $?l!:'e!!age-de!t%at%o-a'e&j'!/OFSReplyueue$/?l!:'e!!age-de!t%at%o-a'e& $?l!:de!t%at%o-jd%-a'e&j'!/t24OFSReplyueue$/?l!:de!t%at%o-jd%-a'e& $/?l!:'e!!age-de!t%at%o-de!cr%ptor&

Mml pat$ +bname

+
estinationn,i name

msEt2%;F*Lueue

#onne'tiona'tory n,iname

msE#onne'tionFa'tory

Resour'es reeren'e 'oni/uration resrename msETAFJLueue#onne'tionFa'tory

n,iname


)essa/e ,estination ,es'riptor )essa/e,estination msE;F*ReplyLueue name

estinationn,i name

msEt2%;F*ReplyLueue

a/e 21

TAFJ-AS TAFJ

T2 EJ& Components configuration +J4 'omponents are ,eine, in TAFJJ+++AR.earNTAFJJ+++J4.ar. T$ere is two ,ierent +J4 types- ;F* +J4 an, #A88AT +J4. An ;F* +J4 is usin/ t$e ollowin/mandatory reso$rces? 

atasour'es? o

T2% ,ata sour'e

o

T2% 8o'5in/ ,ata sour'e w$en usin/ J4# 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 two invo'ation

Re@uest monitorin/ optional o

T$e re@uest type or monitorin/ 'lassii'ation purpose.

TAFJJEE'EJ&()ar$!ETA-*+F$e),-)ar(ml T$e table below presents t$e main 'oni/uration part or a /iven +J4 'alle, OFS.roce!!%g"ea# it 'oul, be oun, wit$in t$e se'tion $eterpr%!e-bea!& o t$e ejbjar.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 ,einin/ 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&TFJ OFS "ea$/de!cr%pt%o& $d%!play-a'e&TFJ OFS "ea$/d%!play-a'e& $ejb-a'e&OFS.roce!!%g"ea$/ejb-a'e& $bu!%e!!-local&co'*te'eo!*taj*!b*OFS.roce!!%g"eaocal$/bu!%e!!-local& $bu!%e!!-re'ote&co'*te'eo!*taj*!b*OFS.roce!!%g"eaRe'ote$/bu!%e!!-re'ote& $ejb-cla!!&co'*te'eo!*taj*!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 taj !e!!%o --& $ev-etry& $de!cr%pt%o&OFS OFS Source$/de!cr%pt%o& $ev-etry-a'e&co'*te'eo!*taj*!b*OFS.roce!!%g"ea/o!Source$/ev-etry-a'e& $ev-etry-type&java*lag*Str%g$/ev-etry-type& $ev-etry-value&8,S$/ev-etry-value& $/ev-etry& $ev-etry& $ev-etry-a'e&co'*te'eo!*taj*!b*OFS.roce!!%g"ea/o!T%'eout$/ev-etry-a'e& $ev-etry-type&java*lag*5teger $/ev-etry-type& $ev-etry-value&
Mmlpat$ +
TAFJ-AS TAFJ

entryname enventry%enventry-type env entryNenv entryname

e,itable

&'(

)*( (o$rcveal$e

'om.temenos.ta.sb.;F*ro'essin/4eanEos Timeout

roperty name. #oni/ure ;F* timeout.

env+, entry%enventry-type Resour'es reeren'e 'oni/uration resour'e ,b'Et2%ata*our'e reN resre name

resour'e reN resre name

,b'Et2%8o'5in/ata*our'e

resour'e

,b'Et2%R;ata*our'e

reN resre name


msETopi'#onne'tionFa'tory


msEte'+ventsTopi'

)*( timeo$is n t econds e,itable

#oni/ure t$e Appli'ation server J4# resour'e or T2% ,atabase. "ee,s to be mappe, in Appli'ation server 'oni/uration ile. #oni/ure t$e Appli'ation server J4# resour'e or T2% lo'5in/ in ,atabase. "ee,s to be mappe, in Appli'ation server 'oni/uration ile. #oni/ure t$e Appli'ation server J4# resour'e or T2% rea, only ,atabase. "ee,s to be mappe, in Appli'ation server 'oni/uration ile. #oni/ure t$e J)* T;I# a'tory or T+# events publis$in/. "ee,s to be mappe, in Appli'ation server 'oni/uration ile. #oni/ure t$e J)* T;I# or T+# events publis$in/. "ee,s to be mappe, in Appli'ation server 'oni/uration ile.

a/e 2%

TAFJ-AS TAFJ

Mandatory properties As ,es'ribe, above t$ere is two man,atory properties w$i'$ s$oul, be ,eine, or ea'$ '$annel? $ev-etry& $de!cr%pt%o&OFS OFS Source$/de!cr%pt%o& $ev-etry-a'e&co'*te'eo!*taj*!b*OFS.roce!!%g"ea/o!Source$/ev-etry-a'e& $ev-etry-type&java*lag*Str%g$/ev-etry-type& $ev-etry-value&8,S$/ev-etry-value& $/ev-etry& $ev-etry& $ev-etry-a'e&co'*te'eo!*taj*!b*OFS.roce!!%g"ea/o!T%'eout$/ev-etry-a'e& $ev-etry-type&java*lag*5teger$/ev-etry-type& $ev-etry-value&
Optional properties T$e ollowin/ properties 'oul, be a,,e, wit$in an ebar. $!e!!%o& se'tion to reine a spe 'ii' +J4 setup. *ee table below or ,etaile, e
arameter o!Source

o!T%'eout

re!etT3re!3old

es'ription eaultvalue Re@uest pro'essin/ parameter. "one 3 nee,s to be setup *trin/ parameter. Has to mat'$ an 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 'lassiier in TAFJ++ monitorin/ tool. $en not set t$e ;F* sour'e is

"one

use,.

TAFJJEE'EJ&()ar$!ETA-*+F$),oss-e),.(ml T$e sample below presents t$e 'orrespon,in/ J4;** +A6 'oni/uration part or t$e +J4 OFS.roce!!%g"ea presente, above. It 'oul, be oun, wit$in t$e se'tion $eterpr%!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& $jd%-a'e&java:/jdbc/t24DS$/jd%-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& $jd%-a'e&java:/jdbc/t24RODS$/jd%-a'e& $/re!ource-re& $re!ource-re& $re!-re-a'e&jdbc/t24oc%gDataSource$/re!-re-a'e& $re!-type&java+*!1l*DataSource$/re!-type& $jd%-a'e&java:/jdbc/t24oc%gDS$/jd%-a'e& $/re!ource-re& $re!ource-re& $re!-re-a'e&j'!/Top%c,oect%oFactory$/re!-re-a'e& $re!-type&java+*j'!*,oect%oFactory$/re!-type& $jd%-a'e&java:/,oect%oFactory$/jd%-a'e& $/re!ource-re& $re!ource-re& $re!-re-a'e&j'!/tec7vet!Top%c$/re!-re-a'e& $re!-type&java+*j'!*ueue$/re!-type& $jd%-a'e&java:/top%c/tec7vet!Top%c$/jd%-a'e& $/re!ource-re& $/!e!!%o&

TAGEroperty name ebname

+
Has to mat'$ t$e ebname o eb ar.
resour'ereN res rename

,b'Et2%ata*our'e

)aps t$e resrename rom eb ar.
resour'ereNn,i name resour'ereN res rename

ava?E,b'Et2%*

)at'$ t$e T2% J4# resour'e in J4;** appli'ation server. e,itable )aps t$e resrename rom eb ar.
resour'ereNn,i name

ava?E,b'Et2%8o'5in/*


#omment

)at'$ t$e T2% 8o'5in/ J4# resour'e in J4;** appli'ation a/e 26

TAFJ-AS TAFJ

server. e,itable )aps t$e resrename rom eb ar.



ava?E,b'Et2%R;*

)at'$ t$e T2% rea, only J4# resour'e in J4;** appli'ation server. e,itable



)aps t$e resrename rom eb ar.
resour'ereNn,i name resour'ereN res rename

Java?E#onne'tionFa'tory

)at'$ t$e ,eault J)* 'onne'tion a'tory in boss n,i tree. e,itable )aps t$e resrename rom eb ar.

Java?Etopi'Ete'+vents


)at'$ t$e T2% J)* topi' in J4;** n,i tree. e,itable

a/e 27

TAFJ-AS TAFJ

TAFJJEE'EJ&()ar$!ETA-*+F$i,m-e),-)ar-,nd(ml T$e sample below presents t$e 'orrespon,in/ ebsp$ere .! 'oni/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>"OFSrocessingBean" & $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/ToicConnectionFactory" b%d%g-a'e>"jms/t24ConnectionFactory" /& $re!ource-re a'e>"jms/tec&'entsToic" b%d%g-a'e>"jms/tec&'entsToic" /& $/!e!!%o&

Mmlpat$ *essionname

+
Resour'es reeren'e 'oni/uration resour'ereN resre ,b'Et2%ata*our'e name

)aps t$e resrename rom ebar.
resour'ereN bin,in/ name

)at'$ t$e T2% J4# resour'e in A*


resour'ereN resre name









msETopi'#onne'tiona'tory


msEt2%#onne'tionFa'tory



resour'ereN bin,in/


appli'ation server. e,itable )aps t$e resrename rom ebar.
TAFJ-AS TAFJ

name

A* in n,i tree. e,itable

a/e 2(

TAFJ-AS TAFJ

TAFJJEE'EJ&()ar$!ETA-*+F$we,logic-e),-)ar(ml T$e sample below presents t$e 'orrespon,in/ eblo/i' 12.1.M 'oni/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-eterpr%!e-bea& $?l!:ejb-a'e&OFS.roce!!%g"ea$/?l!:ejb-a'e& $?l!:!tatele!!-!e!!%o-de!cr%ptor& $?l!:bu!%e!!-%terace-jd%-a'e-'ap& $?l!:bu!%e!!-re'ote&co'*te'eo!*taj*!b*OFS.roce!!%g"eaRe'ote$/?l!:bu!%e!!re'ote& $?l!:jd%-a'e&ejb/OFS.roce!!%g"eaRe'ote$/?l!:jd%-a'e& $/?l!:bu!%e!!-%terace-jd%-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!:jd%-a'e&jdbc/t24DS$/?l!:jd%-a'e& $/?l!:re!ource-de!cr%pt%o& $?l!:re!ource-de!cr%pt%o& $?l!:re!-re-a'e&jdbc/t24oc%gDataSource$/?l!:re!-re-a'e& $?l!:jd%-a'e&jdbc/t24oc%gDS$/?l!:jd%-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!:jd%-a'e&jdbc/t24RODS$/?l!:jd%-a'e& $/?l!:re!ource-de!cr%pt%o& $?l!:re!ource-de!cr%pt%o& $?l!:re!-re-a'e&j'!/tec7vet!Top%c$/?l!:re!-re-a'e& $?l!:jd%-a'e&j'!/tec7vet!Top%c$/?l!:jd%-a'e& $/?l!:re!ource-de!cr%pt%o $?l!:re!ource-de!cr%pt%o&& $?l!:re!-re-a'e&j'!/Top%c,oect%oFactory$/?l!:re!-re-a'e& $?l!:jd%-a'e&j'!/,oect%oFactory$/?l!:jd%-a'e& $/?l!:re!ource-de!cr%pt%o& $?l!:eable-call-by-reerece&true$/?l!:eable-call-by-reerece& $?l!:jd%-a'e&ejb/OFS.roce!!%g"eaRe'ote$/?l!:jd%-a'e& $?l!:local-jd%-a'e&ejb/OFS.roce!!%g"eaocal$/?l!:local-jd%-a'e& $/?l!:?eblog%c-eterpr%!e-bea&

Mmlpat$ +bname

+
businessintera'e n,iname mapEbusinessremote businessintera'e ebE;F*ro'essin/4eanRemote n,inamemapEn,i name Resour'es reeren'e 'oni/uration resrename ,b'Et2%ata*our'e n,iname

,b'Et2%*

resrename


+J4 n,i name or remote invo'ation

)apst$eresrename rom ebar.
TAFJ-AS TAFJ

n,iname

,b'Et2%8o'5in/*

resrename


n,iname

,b'Et2%R;*

resrename


n,iname


)at'$ t$e T2% lo'5in/ J4# resour'e in weblo/i' appli'ation server. e,itable )apst$eresrename rom ebar.
a/e 1

TAFJ-AS TAFJ

/hantom channel #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

/hantom !%& EJ&-JA" Component configuration 8i5e ot$er re@uest E reply )4s- $antom )4 is 'oni/ure, in TAFJJ+++AR.earNTAFJJ++)4.ar )+TAI"FNejb-jar.xml wit$in t$e $eterpr%!ebea!& se'tion. $'e!!age-dr%ve& $d%!play-a'e&.3ato' 7+ecutor MD"$/d%!play-a'e& $ejb-a'e&TFJ.3ato'%!teerMD"$/ejb-a'e& $'apped-a'e&j'!/t2477,ueue$/'apped-a'e& $ejb-cla!!&co'*te'eo!*taj*'db*.3ato'%!teer$/ejb-cla!!& $'e!!ag%g-type&java+*j'!*Me!!age%!teer$/'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&aco?ledgeMode$/act%vat%o-co%g-property-a'e& $act%vat%o-co%g-property-value&uto-aco?ledge$/act%vat%o-co%g-property-value& $/act%vat%o-co%g-property& $-- J"o!! uco''et t3%! !ect%o ad 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-propertya'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& $ev-etry& $de!cr%pt%o&De%e t3e 'a+ u'ber o atte'pt a 'e!!age ?%ll be del%vered $/de!cr%pt%o& $--Deault %! 9 ?3%c3 'ea! o redel%very % ca!e o a%lure --& $ev-etry-a'e&co'*te'eo!*taj*'db*.3ato'%!teer/'a+J'!Del%verytte'pt $/ev-etrya'e& $ev-etry-type&java*lag*5teger$/ev-etry-type& $ev-etry-value&9$/ev-etry-value& $/ev-etry& $re!ource-re& $de!cr%pt%o&0!ed to get coect%o! to JMS or OFS 1ueue! $/de!cr%pt%o& $re!-re-a'e&j'!/TFJueue,oect%oFactory$/re!-re-a'e& $re!-type&java+*j'!*,oect%oFactory$/re!-type& $re!-aut3&,ota%er$/re!-aut3& $/re!ource-re& $re!ource-re& $de!cr%pt%o&77, 1ueue$/de!cr%pt%o& $re!-re-a'e&j'!/t2477,ueue$/re!-re-a'e& $re!-type&java+*j'!*ueue$/re!-type& $re!-aut3&,ota%er$/re!-aut3& $/re!ource-re& $re!ource-re& $de!cr%pt%o&0!ed to get coect%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&,ota%er$/re!-aut3& $/re!ource-re& $re!ource-re& $de!cr%pt%o&0!ed to get coect%o! JD", loc%g data !ource $/de!cr%pt%o& $re!-re-a'e&jdbc/t24oc%gDataSource$/re!-re-a'e& $re!-type&java+*!1l*DataSource$/re!-type& $re!-aut3&,ota%er$/re!-aut3& $/re!ource-re& $re!ource-re& $de!cr%pt%o&0!ed to get coect%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&,ota%er$/re!-aut3& $/re!ource-re& $re!ource-re& $de!cr%pt%o&0!ed to get coect%o! to JMS or T7, $/de!cr%pt%o& $re!-re-a'e&j'!/Top%c,oect%oFactory$/re!-re-a'e& $re!-type&java+*j'!*,oect%oFactory$/re!-type& $re!-aut3&,ota%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'!/tec7vet!Top%c$/re!-re-a'e& $re!-type&java+*j'!*Top%c$/re!-type& $re!-aut3&,ota%er$/re!-aut3& $/re!ource-re& $/'e!!age-dr%ve&

Mmlpat$ ebname eb'lass

+
transa'tion type mappe, name messa/in/ type messa/e ava<.ms.Lueue ,estination type a'tivation a'5nowle,/e)o,e 'oni/ property name a'tivation Autoa'5nowle,/e 'oni/ property name Resour'es reeren'e 'oni/uration resour'ereN msETAFJLueue#onne'tionFa'tory resrename

resour'ereN resrename






J)*roperty

J)*property

J)*property

#oni/ure t$e J)* #onne'tion a'tory or t$e response reply Lueue. "ee,s to be mappe, in Appli'ation server 'oni/uration ile. #oni/ure t$e Appli'ation server J4# resour'e or T2% ,atabase. "ee,s to be mappe, in Appli'ation server 'oni/uration ile. #oni/ure t$e Appli'ation server J4# resour'e or T2% lo'5in/ in ,atabase. "ee,s to be mappe, in Appli'ation server 'oni/uration ile. #oni/ure t$e Appli'ation server J4# resour'e or T2% rea, only a/e %

TAFJ-AS TAFJ






msEt2%+M+#Lueue

,atabase. "ee,s to be mappe, in Appli'ation server 'oni/uration ile. #oni/ure t$e J)* T;I# a'tory or T+# events publis$in/. "ee,s to be mappe, in Appli'ation server 'oni/uration ile. #oni/ure t$e J)* T;I# or T+# events publis$in/. "ee,s to be mappe, in Appli'ation server 'oni/uration ile. #oni/ure t$e J)* +M+# Lueue to sen, new 'omman,. "ee,s to be mappe, in Appli'ation server 'oni/uration ile.

Optional properties T$e ollowin/ property 'oul, be a,,e, wit$in $'e!!age-dr%ve& se'tion to reine $antom8 istener )4 setup. $-- 7RROR C6D568 .RM7T7RS --& $ev-etry& $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 deault t3e JMS prov%der 3adle! t3e 'a+%'u' u'ber o JMS del%very atte'pt - B 'ea! o re-del%very atte'pt $/de!cr%pt%o& $ev-etry-a'e&co'*te'eo!*taj*'db*Tra!actedMD"/'a+J'!Redel%verytte'pt $/ev-etrya'e& $ev-etry-type&java*lag*5teger$/ev-etry-type& $ev-etry-value&B$/ev-etry-value& $/ev-etry&

arameter es'ription 'a+J'!Redel%verytte'p +rror $an,lin/ parameter. t Inte/er parameter.

eaultvalue 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 JMSDel%very,out is '$e'5e, a/ainst t$is value to prote't a/ainst poison messa/e. 4y ,eault re,elivere, messa/e are i/nore,.

$antom8istener )4 ma5es use o same resour'es t$an ;F* +J4? T2% ,ata sour'es an, T+# events topi' an, 'onne'tion a'tory. lease reer to +J4 'oni/uration se'tion about boss- websp$ere an, weblo/i' or appli'ation server mappin/ e
a/e !

TAFJ-AS TAFJ

Its 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'0A"'TAFJ - Servlet Component T$is is a web mo,ule w$i'$ 'ontains ollowin/ servlets? 

+


tia/*ervlet? to /et inormation about t$e installation



t*$ow*ervlet? to /et inormation 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
TAFJ-AS TAFJ

servlet mappin/Nservle tname servletmappin#%$rlpattern servletNservlet name servletNservlet 'lass servlet mappin/Nservle tname servletmappin#%$rlpattern servletNservlet name servletNservlet 'lass servlet mappin/Nservle tname servletmappin#%$rlpattern servletNservlet name servletNservlet 'lass servlet mappin/Nservle tname servletmappin#%$rlpattern resour'ereN resrename


tia/*ervlet

)apservletmappin/wit$t$e servlet

tDia#

Mappin$ #rl

8o//er*ervlet

*ervletname

'om.temenos.ta.ee.war.8o//er*erv let 8o//er*ervlet

'lass name

lo##er

Mappin$ #rl

#omo*ervlet

*ervletname

'om.temenos.ta.ee.war.#omo*ervl et #omo*ervlet

'lass name

comp

Mappin$#rl

4Tools*ervlet

*ervletname

'om.temenos.ta.ee.war. 4Tools*ervlet 4Tools*ervlet

'lass name

DB/ools

Mappin# $rl

msETAFJLueue#onne'tionFa'tory

#oni/ure t$e J)* #onne'tion a'tory or t$e response reply Lueue. "ee,s to be mappe, in Appli'ation server 'oni/uration ile. #oni/ure t$e J)* +M+# Lueue to sen, new 'omman,. "ee,s to be mappe, in Appli'ation server 'oni/uration ile.

msET2%+M+#Lueue




a/e 

TAFJ-AS TAFJ

1erify installation TAFJEE main page ou 'oul, browse$ttp?EEH;*T"A)+?;RTETAFJ++E w$i'$ will /ive you a response li5e?

a/e (

TAFJ-AS TAFJ

3etting TAFJ installation details t%iagServlet $t tp?EElo'al$ost?00ETAFJ++Etia/ i.e.

a/e %0

TAFJ-AS TAFJ

3etting routine compilation details tShowServlet $ttp?EElo'al$ost?00ETAFJ++Et*$ow to /et ,etails about JF.I"ITIA8I*+.#;""+#TI;"

a/e %1

TAFJ-AS TAFJ

"unning a CO& with TAFJ EecuteServlet 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, 'omos ile was /enerate, in it.

Changing log level and access log file content  4oggerServlet $ttp?EElo'al$ost?00ETAFJ++Elo//er

a/e %2

TAFJ-AS TAFJ

T$is servlet allows '$an/in/ ,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'$ ,oesnt impa't t$e TAFJTra'e properties ile. It 'oul, be useul 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'ii' inormation or lo/ level. ou 'oul, narrow t$e lo/ level wit$ t$e 'ombo bo< to 5eep only lo//in/ inormation 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

Accessing CO!Os  ComoServlet $ttp?EElo'al$ost?00ETAFJ++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! tere is no a$tomatic re0res 0$nctionality! yo$ "ill #et a pict$re o0 te 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 inormation beore 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,iie, ,ate by '$an/in/ t$e sort option value in t$e 'ombo bo<. ou 'oul, also re@uest to see only a spe'ii' 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

%&Tools servlet ou 'oul, e
lease reer to 4Tools ,o'umentation to /et inormation 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 te application server classpat! te 0$nctionality "ill not be available.

a/e %7

TAFJ-AS TAFJ

Its 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 testin/ 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 Reres$- t$e lo/ ile bn5'urren'ysele't.lo/ $as been /enerate,.

lease note t$at t$e lo/ ile siBe 9in bytes: is bein/ ,isplaye, an, 'onsi,er t$is inormation beore 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 Entry points documentation TAFJJ++ARTAFJ '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 ,ierent ways?

 

*yn'$ronously by ,oin/ a ebservi'e or +J4 invo'ation wit$ TAFJ#lient AI. Asyn'$ronously by sen,in/ a J)* messa/e wit$ a J)* 'lient or by usin/ #A88J++ statement.

Synchronous invocation T$ere is two ,ierent 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/ TAFJ#lient AI- +J4 invo'ation re@uires a bit more 'oni/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 intera'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*erverrovi,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 ,eines ports w$i'$ are usually use, by ,eault 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 WES3E4E(+*+, 2*+), //Websphere 7 - 8 - 8.5 '$SS1(*+*+,5551); //JBoss 7 - EAP 6.2

private final String 6efa"lt3ttport; private final String 6efa"ltE'ort;

a/e !1

TAFJ-AS TAFJ

Synchronous invocation 5 0e,service 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, %eho !rg+%e# is he '() re*+es String response 7 client.process$%S(E#8904:.SEEC,,0#9<2=5>?,@C944E#C:); //#"oe ! s+bro+i#e, %eho !rg+%e#s !re he )+bro+i#e #!%e !# !# !rr! o$ s+bro+i#e p!r!%eers 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
Synchronous invocation 5 EJ& As +J4 loo5up re@uires spe'ii' 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, %eho !rg+%e# is he '() re*+es String response 7 client.process$%S(E#8904:.SEEC,,0#9<2=5>?,@C944E#C:); //#"oe ! s+bro+i#e, %eho !rg+%e#s !re he )+bro+i#e #!%e !# !# !rr! o$ s+bro+i#e p!r!%eers 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 reer to t$e +J4 'lasspat$ setup se'tion to /et more ,etails. TAFJJ+++J4#lient.ar 'an be e
a/e !

TAFJ-AS TAFJ

Custom EJ& invocation #ustom +J4 invo'ation allows a spe'ii' initial 'onte
//A(JJEElie#(!cor %eho o ge ! c+so% EJB clie# public static TAFJJEEClient getEjbClient(String 0#00!DC$#EAD%!C$4:, String 4$0FE4D94, MapGObect, ObectH conteItroperties) //A(JJEElie# %ehos o p!r!%erie he '() !# AA be!# #!%e public void set$%Sean#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 properies #ecess!r o loo+p !# i#ii!l co#e $ro% he !pplic!io# ser"er MapGObect, ObectH map 7 new !as"MapGObect, ObectH(); map.p"t(jboss.naming.client.ejb.conteIt, true); //(!cor i#"oc!io#, he i#ii!l co#e #!%e !#  !re pro"ie ih he %!p o$ speci$ic properies TAFJJEEClient client 7 TAFJJEEClientFactory .getEjbClient(org.jboss.naming.remote.client.0nitialConteIt%actorJ, remoteK<?,@C944E#C:); //l!s[ sic response s+bro+i#7e client.call!t(EAC34!E, i#"oc!io# String new String[ B , C3%, >++, /, , , , , ,  );

a/e !!

TAFJ-AS TAFJ

Client application classpath setup

T$e se'tion below provi,es some appli'ation server 'lient libaries e
JBoss 

J4oss %.2. M'$SSD3$NE


J4oss +A !.2 //Ple!se #oe his 9!r 9+s co#!i# ! :A;(E) re$ere#ci#g oher 9!rs $ro% ':E/clie#, see :EA-;(/:A;(E).:(. M'$SSD3$NE


J4oss 7  +A 6.2 Naven 6epen6encJK G6epen6encJH Ggro"p06Horg.jboss.asG
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 reer to #reate *tub 'omman, I4) ,o'umentation$ttp?EEwww01.ibm.'omEsupportE,o'view.wssSui,Psw/21(%1( i.e. Qwas.$omeUEbinE'reate+J4*tubs TAFJJ+++J4.ar newile TAFJJ+++J4*tubs.ar 'p Q#8A**ATH

a/e !7

TAFJ-AS TAFJ

TAFJServices(war 5 0e,service component TAFJ*ervi'es.war is an A
OFS we,service ro'ess t$e os re@uest spe'iie, in t$e ar/ument Request.

0S%4 $ttp?EElo'al$ost?00ETAFJ*ervi'esEservi'esE;F**ervi'eSws,l

*nvocation *en, $ttp re@uest on? ETAFJ*ervi'esEservi'esE;F**ervi'eEInvo5eSRe@uestPTH+;F*R+L=+*T i.e. $ttp?EElo'al$ost?00ETAFJ*ervi'esEservi'esE;F**ervi'eEInvo5eS Re@uestP+"L=IR.*+8+#T--I"=TTE6!%21-A##;="T.+TAI8*-#=RR+"#?+LP+=R

Su,routine *nvo6er we,service 7CA44'AT8 +
0S%4 $ttp?EElo'al$ost?00ETAFJ*ervi'esEservi'esEInvo5er*ervi'eSws,l

*nvocation *en, $ttp re@uest on? ETAFJ*ervi'esEservi'esEInvo5er*ervi'eEInvo5eS *ubroutineP TH+R;=TI"+"A)+VaramPARA)1&A8=+VaramPARA)2&A8=+ W i.e. to e
a/e !

TAFJ-AS TAFJ

TEC Events T2% 'oul, be 'oni/ure, to publis$ T+# events. TAFJ 'omponents are 'oni/ure, to publis$ T+# events via resrename 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+# 'oni/uration.

a/e !(

TAFJ-AS TAFJ

TAFJ Sessions !onitor To setup t$e TAFJ *essions )onitor- untar t$e ile TAFJ*ession)onitor.tar./B in QTAFJH;)+. From QTAFJH;)+ETAFJ*ession)onitor 1.

#$e'5 t$e ile ? QTAFJH;)+ ETAFJ*ession)onitorE'oni/E*ession)onitor.proper ties t'pportP77 OP t$e port use, between TAFJ an, TAFJ*ession)onitor $ttpportP70 OP t$e port use, or t$e HTT =R8

2. 3.

In QTAFJH;)+ ETAFJ*ession)onitorEbin start start.s$ or start.bat 4rowse $ttp?EEOIX?O $ttpport 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  

TFJ Mo%tor

 GGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGG  7able t3e TFJMo%torSe!!%o  te'*taj*rut%'e*!e!!%o*'o%tor*eable

> true

$> to eable t3e 'o%tor

 Co!t a'e or 5. o ?3ere %! t3e TFJMo%torSe!!%o

a/e 61

TAFJ-AS TAFJ

 te'*taj*rut%'e*!e!!%o*'o%tor*3o!t TFJSe!!%oMo%tor

> local3o!t $> ?3ere %! your

 T,. port o t3e TFJMo%torSe!!%o  te'*taj*rut%'e*!e!!%o*'o%tor*port

> HII$> t3e tcp=port o TFJSe!!%oMo%tor

a/e 62

TAFJ-AS TAFJ

TAFJ Technical !onitor TAFJ++ appli'ation 'oul, be monitore, by browsin/ t$e ollowin/ =R8. $ttp?EEO$ostX?OportXE/A*JEEmonitorin# )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'ii' 'oni/uration :



+rror lo/s 9'oul, be ,isable, wit$ a parameter:

a/e 6

TAFJ-AS TAFJ



)4eans an, a'tive sessions



atabase inormations 9,epen,s on t$e 4 provi,er:

a/e 6%

TAFJ-AS TAFJ

Java melody overview Full ava melo,y ,o'umentation 'oul, be oun, $ere? $ttps?EE'o,e./oo/le.'omEpEavamelo,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 ,oesnt re@uire a ,atabase to store events nor 'o,e instrumentation. T$ereore it 'oul, be enable, in pro,u'tion be'ause o its very low over$ea, 9rom null to !Y:. is'ussion about ava melo,y over$ea, 'oul, be oun, $ere? $ttps?EE'o,e./oo/le.'omEpEavamelo,yEwi5iE;ver$ea, T$at bein/ is sai, even i its not a,visable monitorin/ 'oul, be ,isable, an, even totally remove, rom TAFJJ++ appli'ation in 'ase o nee,.

Java melody configuration Java melo,y libraries 'oul, be oun, un,er TAFJJ+++AREAI"FElib? 

avamelo,y.ar- 'ore library- w$i'$ is a pat'$e, version o oi'ial ava melo,y to 'over a,,itional nee,.



robin.ar- RR tool ava implementation- to lo/ ,ata an, ,o /rap$ ren,erin/.

!onitoring filter and listener T$e monitorin/ un'tionalities are enable, t$rou/$ a servlet ilter 'alle, )onitorin/Filter,e'lare, in TAFJJ+++ARETAFJJ++ARTAFJEwebappE+4I"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 ,eines a *ession8istener to monitor $ttp sessions. e ,ont ma5e use o it or TAFJJ++. 5lease re0er to te 6no"n iss$e section "en deployin# in "ebspere to #et te 0ilter correctly initiali7ed.

/arameters T$ere are several parameters t$at 'oul, be 'oni/ure, to reine ava melo,y setup? $ttps?EE'o,e./oo/le.'omEpEavamelo,yEwi5iE=serGui,eZ6.;ptionalparameters T$is se'tion presents t$ose we use to monitor TAFJJ++. arameters 'oul, be ,eine, in several ways? as ilter parameter- 'onte
To ,isable monitorin/ simply set java'elody*d%!abled>true* $-- tur o java'elody --& $cote+t-para'& $para'-a'e&java'elody*d%!abled$/para'-a'e& $para'-value&al!e$/para'-value& $/cote+t-para'&

Counters setup

T$e parameter java'elody*d%!played-couter! is use, to overri,e t$e 'ounters ,is playe, by ,eault. As TAFJJ++ ,oesnt ma5e use o $ttp session we remove some o t$em. $-- couter! - ?e dot ?at to d%!play t3e deault oe K3ttp#!1l#error#logK a! ?e dot eed 3ttp 'o%tor%g --& $cote+t-para'& $para'-a'e&java'elody*d%!played-couter!$/para'-a'e& $para'-value&!1l#log#ejb$/para'-value& $/cote+t-para'&

Data source setup

4y ,eault 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 dya'%cally t3roug3 jd% looup but ?e '%g3t ?at to e+clude !o'e --& $-- %*e* LS %teral derby DS or 7J"T%'er or loc%g DS --& $cote+t-para'& $para'-a'e&java'elody*data!ource!$/para'-a'e& $para'-value&java:co'p/ev/jdbc/t24DataSource#java $/para'value& $/cote+t-para'&

$en ,einin/ multiple ,ata sour'es- t$ey s$oul, be 'oma separate,. T$e irst one will be ,isplaye, in t$e atabase Inormations s'reen. T$ey also nee, to be ,eine, at TAFJJ++ARTAFJ.war level to $ave t$e n,i loo5up resolve, 9optional i t$e property is not use,:.

History storage directory

4y ,eault 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- ,eine, 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 ,eault temporary ,ire'tory. $-- !tat%!t%c !torage d%rectory --& $cote+t-para'& $para'-a'e&java'elody*!torage-d%rectory$/para'-a'e& $para'-value&,:java'elody-!torage-d%r$/para'-value& $/cote+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'iier ollowe, by [N[- or i its prei< 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, J4# monitorin/ w$en set to true* In t$at 'ase *L8 'ounters wont be ,isplaye,. $-- tur o !1l 'o%tor%g ?3e !et to true --& $cote+t-para'& $para'-a'e&java'elody*o-databa!e$/para'-a'e& $para'-value&al!e$/para'-value& $/cote+t-para'&

a/e 67

TAFJ-AS TAFJ

Error log level

T$e property log-t3re!3old-level is a spe'ii' property in t$e pat'$e, TAFJJ++ avam elo,y version. 4y ,eault ava melo,y reports warnin/ an, error messa/es reporte, by t$e ,ierent appli'a tion lo//in/ systems 9ava util lo//in/- lo/%- lo/ba'5:. T$is parameter allows reinin/ t$is setup. 4y ,eault 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 wont be ,isplaye,. $cote+t-para'& $para'-a'e&java'elody*log-t3re!3old-level$/para'-a'e& $para'-value&7RROR$/para'-value& $/cote+t-para'&

Development mode parameters

/is parameter is not advisable in prod$ction and so$ld be $sed only d$rin# development pase. 4y a,,in/ property java'elody*!a'pl%g-!ecod! $otspot ,ete'tion will be enable, an, sta'5tra'e samplin/ will be e
$-- 3ot!pot detect%o --& $cote+t-para'& $para'-a'e&java'elody*!a'pl%g-!ecod!$/para'-a'e& $para'-value&9B$/para'-value& $/cote+t-para'& java'elody*!a'pl%g-e+cluded-pacage! property allows reinin/ t$e ,eault list o pa'5

a/e e<'lu,e, ,urin/ $ot spot ,ete'tion. $cote+t-para'& $para'-a'e&java'elody*!a'pl%g-e+cluded-pacage!$/para'-a'e& $para'-value&java#!u#co'*!u#java+#org*apac3e#org*3%berate#oracle#org*po!tgre!1l#org*ecl%p!e#org*jbo!!#co'*arjua#org*jp$/para'-value& $/cote+t-para'&

EJ& monitoring To monitor +J4s re@uests an inter'eptor $as to be ,e'lare, in t$e ebar.
TAFJ-AS TAFJ

T$e ,eault ava melo,y inter'eptor is et*bull*java'elody*Mo%tor%g5terceptor* It 'an be repla'e, wit$ a spe'ii' TAFJ inter'eptor to 'lassiy re@uest per ;F* sour'e. $%terceptor!& $%terceptor& $%terceptor-cla!!& co'*te'eo!*taj*'o%tor%g*%terceptor*Mo%tor%g,la!!%%er5terceptor $/%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 ebar.
4y ,eault TAFJJ++ is 'oni/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 eb 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'ii' +J4s- t$e inter'eptor bin,in/ se'tion s$oul, be repli'ate, per +J4.

4imitation and 6nown issues

0e,sphere application server Monitoring filter initialisation

$en ,eployin/ ava melo,y in websp$ere- up to version .!- t$e monitorin/ ilter wont be automati'ally initialiBe, at appli'ation startup as it s$oul, be a''or,in/ t$e servlet spe'ii'ation. $ttp?EEwww01.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 wont start until t$e TAFJ++ servlet /ets invo5e,. SQL monitoring

4y ,eault avamelo,y 'ore ,oesnt 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%orin6ing robe06K?*2 4eporterKjava.lang.ClassQa*ab*=c

javaI.naming.#amingEIceptionK com.s"n.proIJ.MroIJ5=.get4eference() ret"rne6 n"ll in violation of the '#F0 !0 at com.ibm.Os.naming."til.3elpers.process'ava$bject%orin6ing(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.javaK11) 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 sipped "it a p atced version o0 javamelody to 0ix tis iss$e.

J&oss 9 EA/ Mbeans )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/EbrowseEF8

Clearing all statistics and graphs *top t$e server an, 'lean up t$e ,ire'tory ,eine, 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

TAFJSanityche6(war 5 Configuration validation /resentation 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 beore runnin/ T2%. It provi,es inormation about 'omponents involve, an, $i/$li/$t possible mista5es base, on a set o rules. T$ese inormation are a''essible wit$ an online ,as$boar, t$at 'oul, be browse, at t$e ollowin/ =R8? $ttp?EElo'al$ost?00ETAFJ++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, ater 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++ 'oni/uration-



a 'arto/rap$y o appli'ation server ,eployment to ,isplay 'urrent resour'es 'oni/uration-



a vali,ation between t$ese two points? w$at is ,eine, at ear ile level must mat'$ w$at is ,eine, 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 'oni/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 'oni/uration- wit$ ,ata sour'es- J)* obe'ts- t$rea,s pool- timeouts an, J&) parameters.

T$e last panel represents t$e vali,ation o t$e 'oni/uration- wit$ vali,ations events an, su//estions about $ow i
a/e 72

TAFJ-AS TAFJ

/rocess

a/e 7

TAFJ-AS TAFJ

Application parsing 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 ,eines )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 ,eault ear ile or ea'$ appli'ation server supporte,. It ,eines some ,eault 'ommuni 'ation '$annels an, t$eir parameters? ormatter- ;F* sour'e an, timeout- t$rea, pool et'W )4s are ,eine, 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 $elpul to run appli'ation analysis or a non,eploye, ear ile or to run some 'omparison between ,ierent 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 'oni/uration. It 'oul, be invo5e, rom t$e TAFJ s$ell? Ear*ile5arser 8-lo#9 pattoear0ile 8JB)((!4A(!4EB;)<9 5arameters : 

lo/ ? optional parameter to appen, t$e ear ile report to /A*J3H)MElo#sanitycec6.lo#



+ar ile pat$? man,atory parameter w$i'$ spe'iies t$e ull pat$ to t$e ear ilein'lu,in/ t$e ear ile name- i.e. EQTAFJH;)+EappserverE TAFJJ+++AR.ear



Appli'ation server provi,er? optional parameter to /enerate t$e report or a spe'ii' provi,er 9value must be J4;**- A* or +48;:. I not spe'iie, t$e report will 'ontain all 'oni/urations.

Limitations

T$e ear ile parsin/ is e
a/e 7!

TAFJ-AS TAFJ

Application server configuration parsing 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. #oni/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 'oni/ure supporte, appli'ation servers. T$ey $elp to 'reate all resour'es? J)* obe'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 Intera'e: 'lient o

'onstraint: #et a connection to te admin server =de0a$lt port is >>>>?! te 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 te ()A5 port o0 te 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,iy t$eir AI to publis$ 'oni/uration inormation.

a/e 77

TAFJ-AS TAFJ

1alidation rules: events: fi and tips T$e last step o t$e pro'ess is to run some vali,ation tests a/ainst 'olle'te, inormation 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 'oni/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 ,einition an, t$e appli'ation server 'oni/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 wont timeout beore t$e ;F* e
o

4 timeout XP ;F* timeout? ensure t$at @uery wont timeout beore ;F* timeout.

o

I/nore stu'5 t$rea,? spe'ii' to weblo/i'- ensure t$at i/nore stu'5 t$rea, parameter is ,eine, or t$e $antom '$annel.

ata sour'e? *pei'i' ,ata sour'e parameters vali,ation o

8o'5in/ ,ata sour'e must not be transa'tional? in 'ase o J4# 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 eent category

a/e 7(

TAFJ-AS TAFJ

Filter by eent seerity

Filter by !hannel " Serer

"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'iy t$e respe'tive pool an, timeout 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 wont 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<)4ool*iBeP1!- ma<+J4ool*iBeP"EA- ma<*ool*iBeP220ma<8o'5in/*ool*iBeP0^ e 'an see t$at t$e appli'ation server 'oni/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- reer to t$e appropriate pool siBe in t$e +J4 viewDsee A,ministrationE#oni/urationE#ontainerE+J4E4+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 wont 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'oni/uration- ava store, un'tion mismat'$- et'W a tip is provi,e, in t$e event an, a lin5 to TAFJ ,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

1alidation report All inormation 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

Securing we, applications As presente, in above se'tions- TAFJJ++ARTAFJ.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 #A88AT t$rou/$ webservi'e

A sample 'oni/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 'oni/uration part at webapp level an, in a spe'ii' 'oni/uration part at webapp an, appli'ation server level ,epen,in/ on t$e appserver provi,er.

&asic Authentication common configuration #omment out in t$e web appli'ation "ebapp4EB-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&TFJReal'$/real'-a'e& $/log%-co%g&

&asic Authentication J&oss

0e,app #omment out in t$e web appli'ation E"ebapp4EB-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 ?ebpp --& $!ecur%ty-do'a%&java:/jaa!/TFJReal'$/!ecur%ty-do'a%&

J,oss EA/9 deployment 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"& $aut3et%cat%o& $log%-'odule code>")sersRo!es" lag>"re*uired"& $'odule-opt%o a'e>"usersroerties" value>"+,j#oss-ser'er-. con(ig-dir/ta(j.users-roerties"/& $'odule-opt%o a'e>"ro!esroerties" value>"+,j#oss-ser'er-. con(ig-dir/ta(j.ro!es-roerties"/& $/log%-'odule& $/aut3et%cat%o& $/!ecur%ty-do'a%&

#reate iles serverstandalonecon0i#$ration ta0j-$ser.properties a,, a user an, passwor,- i.e. taj>pa!!?ord

serverstandalonecon0i#$rationta0j-roles.properties a,, a role TAFJA,min an, asso'iate it to ta user taj>TFJd'%

ou 'oul, reer to $ttps?EE'ommunity.boss.or/Ewi5iEJ4ossA*7*e'ure)yebAppHowoISss''Pt

&asic Authentication 0e,logic

a/e (

TAFJ-AS TAFJ

0e,app #omment out in t$e web appli'ation "ebapp4EB-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 ?ebpp $!ecur%ty-role-a!!%g'et& $role-a'e&TFJd'%$/role-a'e&

--&

$pr%c%pal-a'e&TFJd'%$/pr%c%pal-a'e& $/!ecur%ty-role-a!!%g'et&

0e,logic ;2c deployment A,, a se'urity realm t$rou/$ weblo/i' 'onsole or use t$e ,eault one myrealm. A,, /roup TAFJA,min

A,, a user ta

A,, /roup TAFJA,min to user ta

a/e (0

TAFJ-AS TAFJ

&asic Authentication 0e,sphere 0e,app "o spe'ii' '$an/e applies to webapp.

0AS <(= deployment /e 4ebspere pro0ile m$st be sec$red to per0orm te 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

TAFJ-AS TAFJ

)ap TAFJA,min role ,eine, at webapp level to TAFJA,min /roup.

a/e (

TAFJ-AS TAFJ.pdf

Recommend Documents