EBS Benchmark Kit: Tuning pre-requisites before running ATS

2013
Author: Richard Barry, EBS erformance Team
Contents
!ore"ord####################################################################################################################################################$
%id Tier Tuning#########################################################################################################################################$
&B Tier Tuning##########################################################################################################################################$
ATS specific tuning####################################################################################################################################'
&atabase &ata Setup to enab(e App(ications to proper(y function############################################################)
%emory configuration *ATS####################################################################################################################)
Foreword
The fo((o"ing information is pro+ided to interna( *rac(e Teams and ,ard"are artners "ho are using
the *rac(e EBS Benchmark kit re(eases $'#$#- and *rac(e App(ication Test Suite .*ATS/ to dri+e
on(ine "ork(oad# %inima( tuning must be done to the mid-tier and &B prior to running any of the ATS
scripts# This "i(( a+oid unnecessary conferences and speed up testing#
Mid Tier Tuning
*n the %idTier check the fo((o"ing +a(ues
- FORMS_TIMEOUT: $APPL_TOP/VIS_hostname.env, chane to a h!he" # !$ nee%e%.
Resta"t a&& se"v!ces a$te" chane. 'eca(se some t"ansact!ons have )* m!n(tes
+ac!n !nte"va& the, -!&& t!meo(t !$ th!s va&(e !s &e$t at %e$a(&t va&(e.
- A+ache: $I.ST_TOP/o"a/)/.).0/A+ache/A+ache/1con$1/htt+%.con$.
2 3ee+A&!veT!meo(t sho(&% 4e set to )* m!n(tes 56// secon%s7
2 Ma8c&!ents: set to h!he" # !$ nee%e%.
- OPM.: $I.ST_TOP/o"a/)/.).0/o+mn/con$/o+mn.8m&, sea"ch $o"
9+"ocess-t,+e !%:;oaco"e; 4&oc<
2 =m8:=ms:)> 5o" ?>7
2 Ma8 @VM th"ea%s A: )/)B s,stem co"e co(nt
n(m+"ocs ) $o" each */-)// (se"s. 'e s("e to chane t-o +&aces, the secon%
$o" O"ac&e Fo"ms.
DB Tier Tuning
*n the &B, init01S#ora as is "i(( on(y support around $22 concurrent users before contention issues
cause timeouts to the ATS scripts# To a+oid that prob(em increase the S3A and 3A to suitab(e (e+e(s
gi+en the a+ai(ab(e memory on the ser+er# &etermining the right +a(ues is done "ith tria( and error but
EBS Benchmark Kit: Tuning pre-requisites before running ATS
2013
Author: Richard Barry, EBS erformance Team
a ru(e of thumb is gi+e *rac(e ti(( s"apping and paging occur, then back off in $3B increments ti((
s"apping and paging go to 4ero#
There are other +a(ues needing updates as "e((, guidance is gi+en "ithin the init01S#ora fi(e on suitab(e
+a(ues#
processes
sessions
shared5poo(
*ther +ariab(es impacting performance can be found by issuing 6u(imit -a7# 6open fi(es7 and ma-
user processes can cause e-ecution prob(ems if set too (o"# !or instance if you "ant to run $222
concurrent users and ma- user processes is (eft a defau(t of $222, the ATS e-ecution "i(( fai(# 8onsu(t
the +endor specific insta(( guides for recommended +a(ues#
T9S configuration needs ad:ustments as "e(( as documented in this meta(ink note $$$;<;2#$ "hich
dea(s "ith *RA-22;2< errors in the a(ert#(og fi(e# Specifica((y these changes to these +a(ues or higher:
Sq(net#ora: S=>9ET#19B*?9&58*99E8T5T1%E*?T@$A2
>istener#ora: 19B*?9&58*99E8T5T1%E*?T5listener_name@$'2

ATS specific tuning
ATS runs as a :a+a app(ication and is sub:ect to memory (imits as any :+m# ?nder the ATS home
directory is agentmanagerBbinBAgent%anagerSer+ice#conf This fi(e sets the heap si4e to ;Cmb and
shou(d be changed to at (east $3B upto '3B for )' bit systems#
"rapper#:a+a#ma-memory@'2CA on )' bit systems, other"ise tune as memory permits on ;C bit# This
is a sensiti+e +ariab(e depending upon the memory a+ai(ab(e on your *ATS ser+ers used from dri+ing
user (oads# *n )' bit ser+ers, increasing the +a(ue up to the )' bit ma- can be attempted during tuning
efforts if sufficient memory is a+ai(ab(e#
E-amp(e:
D 1nitia( Ea+a ,eap Si4e .in %B/
"rapper#:a+a#initmemory@$2'C
D %a-imum Ea+a ,eap Si4e .in %B/
"rapper#:a+a#ma-memory@'2CA
!or each scenario there are t"o parameters affecting memory usage, particu(ar(y Agent F$ out of
memory errors# ?nder Too(s G *ptions G Scenario &efau(ts are a(( the settings for a scenario#
%a-imum users per process shou(d be changed from 6defau(t7 to at (east $22# 3i+en that each process,
o(t-agent#e-e is (imited to the ma- memory set by the 6"rapper#:a+a#ma-memory7 +a(ue, the ma-
usersHprocess +a(ue dictates the memory dedicated for that number of users# !or instance gi+en the
EBS Benchmark Kit: Tuning pre-requisites before running ATS
2013
Author: Richard Barry, EBS erformance Team
abo+e settings, one o(t-agent#e-e "ou(d consume $gb of memory to run $22 +irtua( users# The higher
the number of usersHprocess, the more 8? is consumed by each o(t-agent#e-e# The higher the +a(ue in
"rapper#:a+a#ma-memory, the higher the memory consumed by o(t-agent#e-e#
3i+en these t"o parameters, tuning can be done to best ba(ance a+ai(ab(e 8? and memory for a gi+en
"ork(oad in *>T#
The ne-t parameter to change is change 68(ear 8ache after e+ery e-ecution7 to 6true7# Again this is to
minimi4e Agent F$ aborts due to out of memory#
?sing *ATS R$'#$#2#' and ear(ier bui(ds, a simp(e ratio guides ho" much memory and cpu is required
to run a gi+en +irtua( user count# The ratio is $22:$gb:$cpu
$22 0?Is need $#' gb of memory and $ cpu core to run for ma-imum performance# As the ratio of the
number of o(t-agent to number of 8?Is e-ceeds $#2, the more 8? "aits "i(( degrade benchmark
resu(ts#
Database Data Setup to enable Applications to properly function
1n order for apps to function, setup S=> must be run after the &B has been started# Jithout preforming
these steps, the ATS "i(( fai(#
1. Run T8-&ate?pdate#sq( fi-es T8-Entry prob(ems "ith dates being too o(d from the system
date#
2. Run credit5card5o+er)2days#sq( and this script must be run e+ery )2 days during the
benchmark
e-ercise to ensure 8reate5=uery58ash and 8reate5=uery58redit "i(( proper(y e-ecute using
transaction dates "ithin )2 days of the system date#
3. 3(!i-#sq( to ensure the 3>5Eourna(5Entry script runs correct(y#
9ote: Refer to EBS Benchmark Kit 1nsta((ation documents for a(( data updates information#
Meory configuration !ATS
?sing *ATS R$'#$#2#' and ear(ier bui(ds, a simp(e ratio guides ho" much memory and cpu is required
to run a gi+en +irtua( user count# The ration is $22:$gb:$cpu
$22 +us need $#' gb of memory and $ cpu core to run#