Upload
satish-raju
View
222
Download
0
Embed Size (px)
Citation preview
8/12/2019 BW Training Basic
1/24
Monitoring and Managing BW Processes
Start/Stop
To start or stop a BW Process using TIBCO Administrator, locate the BW process under
Application Management --> All Serice Instances! or under Application Management! in thecorresponding "older#
$nder All Serice Instances!, %ou can appl% a "ilter and then use Search!& Once %ou "ound the
process in 'uestion, mar( the corresponding chec()o* as it is sho+n "or the ConsumerPA! process
in the screenshot, and clic( on the Start! or Stop! )utton as desired&
ou should aoid using ill!& I" ill! is used, BusinessWor(s +ill terminate the engine regardless
o" an% .o)s that might still )e actie inside the BW /ngine& Also, +hen using ill!, under rare
circumstances, the process might sho+ as stopped in TIBCO Administrator )ut might still )e
present on the OS leel& Al+a%s chec( on the OS leel a"ter using ill!, and terminate the process
using OS leel (ill command i" it should still )e there&
$se ill! onl% i" %ou are not a)le to stop the engine using Stop!& ill the engine on the OS leel
onl% i" %ou cannot terminate it using TIBCO Administrator&
To "ind the PI0 o" the OS leel process, clic( on the serice instance 1the chec(ed ConsumerPA!
in the screenshot a)oe& A screen li(e the "ollo+ing +ill appear#
8/12/2019 BW Training Basic
2/24
In the second line "rom the top, the Process I0! can )e retrieed&
Change Configuration and Re-Deploy
The con"iguration o" a BW /ngine can )e changed using TIBCO Administrator& The e*isting
application archie needs to )e re-deplo%ed in order to do that&
There are multiple places +here con"igurations can )e changed&
The most common occurrence is that a glo)al aria)le needs to )e changed&
Other common occurrences are that the 2o) Starter settings need to )e changed or that the serer
settings need to )e changed&
In order to change an% con"iguration, either locate the application in the tree under Application
Management! and naigate to its Con"iguration! "older, or us the All Applications! console to
"ind the application, as sho+n in the screenshot )elo+#
8/12/2019 BW Training Basic
3/24
ou search the application )% entering a pattern at the top o" the screen& 3ocate the application, and
clic( on its name& The application +ill )e opened up in the tree o" all applications, as sho+n in the
screenshot )elo+#
8/12/2019 BW Training Basic
4/24
Change Global Variable
4lo)al aria)les are intoduced )% the deeloper o" an application, to ma(e the application
con"igura)le upon deplo%ment& The mechanism is mostl% used to adopt the application to the
enironment into +hich it is deplo%ed& 5or e*ample, +hen an application is deplo%ed in the test
enironment, it needs to connect to a 2MS serer that is di""erent "rom the one that is used in the
production enironment& 4lo)al aria)les are also used as a general mechanism to ma(e an
application con"igura)le&
In order to change a glo)al aria)le, clic( on the application in the Con"iguration Builder! 1see
preious screenshot6& To change a glo)al aria)le, clic( on the top-leel 1consumer! in the
e*ample6& A screen li(e the "ollo+ing +ill appear#
Clic( on the Adanced! Ta) 7 the list o" glo)al aria)les +ill appear& 5or real-li"e production
applications, the list might )e e*tensie and the depth o" the tree o" glo)al aria)les might )econsidera)le& 8aigate to the glo)al aria)le that %ou +ant to change& 5or e*ample, clic( on the
Consumer! "older and therein on the 2MSConnection! "older to change the Proider$rl! glo)al
aria)le& To actuall% change the alue o" a aria)le, clic( on the edita)le "ield in the 9alue!
column, and then clic( on Sae!& The 0e"ault! column onl% sho+s the alues that +ere pre-set )%
the deeloper o" the application&
8/12/2019 BW Training Basic
5/24
A"ter saing the changed glo)al aria)le1s6, a screen +ill displa% sho+ing that there +as a
con"iguration change "or the application and that it should )e re-deplo%ed#
8/12/2019 BW Training Basic
6/24
Clic( on the 0eplo%! )utton to deplo% the application -->
$nselect an% o" the options, as sho+n in the screenshot a)oe& Ignore the +arning& Clic( O! -->
8/12/2019 BW Training Basic
7/24
A"ter this, go to the serice instance 1clic( on Serice Instances! )elo+ Con"iguration!6& ou +ill
see that the serice instance is sho+n as out-o"-s%nc!#
Select the serice instance and clic( Stop!& Once the serice instance sho+s as Stopped!, clic(
Start!, to )ring it )ac( up again& It +ill displa% as Starting $p! "or a +hile, and then "innal% sho+
as :unning!#
8/12/2019 BW Training Basic
8/24
In some cases, there might )e more than one serice instance "or an application& In that case, all
serice instances that sho+ as out-o"-s%nc! should )e simultaneousl% stopped and then started
again&
Change Job Starter Configuration
To change the con"iguration o" .o) starters in a BW engine, naigate to the application as descri)ed
earlier#
8/12/2019 BW Training Basic
9/24
In the Con"iguration Builder!, clic( on the second leel in the hierarch% 1node ending +ith the
su""i* &par!6#
Clic( on the Adanced! ta) and scroll all the +a% to the )ottom#
8/12/2019 BW Training Basic
10/24
5or each .o) starter, i&e& "or each separate process implementation that processes some t%pe o" eent,
there +ill )e one line +here the .o) starter can )e ena)led or disa)led, and the .o) creator limits +ill
)e set&
The settings "or MSITS are al+a%s done in such a +a% that onl% a limited num)er o" .o)s can )e
processed in parallel, and .o)s +ill not )e paged out once started processing& The screenshot a)oe
sho+s an e*ample +here ; consumer processes can )e actiel% processed in parallel, )ut no more
than ; at an% time&
Clic( on the Sae! )utton at the top o" the screen a"ter ma(ing an% changes& ou +ill )e ta(en to a
screen "rom +hich %ou can trigger deplo%ment& Proceed in the same manner as a"ter ma(ingchanges to glo)al aria)les, "orm here&
Change Server Settings
To change the serer settings o" a BW engine, naigate to the application as descri)ed earlier#
8/12/2019 BW Training Basic
11/24
In the Con"iguration Builder!, clic( on the third leel in the hierarch% 1gear-+heel s%m)ol,
C
8/12/2019 BW Training Basic
12/24
Clic( on Serer Settings!#
=ere %ou can con"igure the log "ile parameters, the num)er o" threads to )e used )% the )+engine,
and the 29M heap and stac( memor%#
8/12/2019 BW Training Basic
13/24
On $ni* plat"orms, the 8T Serice! settings are not aaila)le& Clic( on Sae! a"ter ma(ing an%
changes& ou +ill )e ta(en to a screen "rom +hich %ou can trigger deplo%ment& Proceed in the same
manner as a"ter ma(ing changes to glo)al aria)les, "orm here&
Moving a Service Instance to Another Machine
When %ou +ant to moe a serice instance to another machine, %ou need to undeplo% it on themachine +here it is currentl% running, and deplo% it to the ne+ target machine& In order to do this,
the starting point is again to locate the application#
8/12/2019 BW Training Basic
14/24
Clic( on the second leel entr% in the Con"iguration Builder 1&par! item6#
8/12/2019 BW Training Basic
15/24
Select the serice instance and clic( on :emoe "rom selected machines!& The serice instance on
that machine +ill sho+ as deplo%ment status 0eplo%a)le, 1:emoe6!& Then clic( on Add toAdditional Machines! 1the e*ample is ta(en "rom the production domain +here there are man%
machines6& Select the machine, then clic( O!#
8/12/2019 BW Training Basic
16/24
8o+ %ou +ill see t+o serice instances, one as 0eplo%a)le, 1:emoe6! and one as 0eplo%a)le,
18e+6!#
8/12/2019 BW Training Basic
17/24
Clic( on Sae! and then e*ecute the deplo%ment, as descri)ed earlier& The deplo%ment +ill
simultaneousl% remoe one serice instance and create the other&
Monitoring Jobs in a B !ngine
A .o) is created in a BW /ngine at each time that an eent occurs that the BW engine should
process&
5or e*ample, a BW /ngine ma% contain process de"initions, process de"inition A and process
de"inition B& Process de"inition A has to )e e*ecuted "or messages arriing on topic A? process
de"inition B "or messages arriing on topic B&
Process de"inition A is no+ getting instantiated each time that a message arries on topic A 1a .o) is
created6 and process de"inition B "or each message that arries on topic B&
The .o) creator limits that +ere descri)ed )e"ore are used to limit the ma*imum amount o" eents
or messages that can )e processed in parallel& I" a lot o" messages arrie to )e processed, and the
)+engine cannot process them "ast enough, the% +ill sta% in memor% until processing is "inished&
This can lead to a situation +here all memor% o" the )+engine gets e*hausted&
5or that reason, it is important to limit the ma*imum num)er o" .o)s in a )+engine& This is done at
deplo%ment time "or each indiidual process de"inition .o) starter, as e*plained )e"ore&
The .o)s that currentl% e*ist inside a )+engine can )e monitored )% going to the All Serices!
Panel and clic(ing on the respectie )+engine#
8/12/2019 BW Training Basic
18/24
This +ill ta(e %ou to the "ollo+ing ie+#
Clic( on the BWProcesses! ta)& Per de"ault 1unless another "unction is selected "rom the drop-
do+n at the top o" the screen6, the Actie Processes! 1.o)s6 inside the )+engine are sho+n#
8/12/2019 BW Training Basic
19/24
In a )+engine that per"orms +ell, no .o)s or onl% a "e+ ones are t%picall% isi)le, and the% come
and go "ast& 8o .o)s are there that sta% isi)le "or a long time, and hae a high num)er in the
0uration! column& 2o)s that sta% "or a long time are pro)a)l% haing a pro)lem, as the% are not
getting processed 'uic(l%& The% ma% )e +aiting in an actiit% that has a pro)lem, "or e*ample inside
a 20BC call that is going to time out at some point&
2o)s can (illed, suspended, and resumed on this screen&
ill# Immediatel% stop processing the .o) "urther and delete it
Suspend# halt the processing o" the .o) 7 it can later )e resumed
:esume# resume a .o) that has preiousl% )een suspended
8ote that .o)s can )e suspended manuall% on this screen, )ut also programaticall% )% the .o) inside
the )+engine itsel"& The application /SBSerices! "or e*ample ma(es use o" this possi)ilit%&
8ote that the most processes are programmed in such a +a% that the% reach the 2MS con"irm
actiit% onl% a"ter all other processing is done& Thus, +hen %ou (ill a .o), its start message +ill
t%picall% )e sent "rom the /MS again, at a later time, and it is not .ust lost&
!nabling and Disabling Job Starters
When a )+engine is started, the .o) starters are either initiall% in ena)led or disa)led state, as per
the deplo%ment con"iguration& 5or e*ample, "or the SAP-5ISerices, the deplo%ment con"iguration
currentl% de"ines that some .o) starters should )e disa)led, as sho+n in the screenshot )elo+
1column /na)led!6#
8/12/2019 BW Training Basic
20/24
1"or ho+ to naigate to this ie+, please re"er to chapter Change 2o) Starter Con"iguration!6
In order to ena)le or disa)le a .o) starter in a running )+engine, locate the )+engine in the All
Serice Instances! ie+ and clic( on it#
8/12/2019 BW Training Basic
21/24
4o to the BW Processes! Ta)#
8/12/2019 BW Training Basic
22/24
In the drop-do+n, select Process Starters!#
8/12/2019 BW Training Basic
23/24
As %ou can see, the .o) starters are currentl% ena)led or disa)led according to their settings in the
deplo%ment& To change the setting, select the .o) starter using the chec()o* and use the /na)le! or
0isa)le! )utton, then clic( on the done! )utton&
When a .o) starter is disa)led, this is as i" the )+engine +ould )e partiall% not doing its .o) 7 not
processing certain t%pes o" )usiness eents& The disa)led! state is normall% set deli)eratel%
)ecause a certain "unctionalit% should not %et )e e*ecuted 1dependent component not %et read%6, or
temporaril% not )e e*ecuted 1disa)led )ecause o" a (no+n pro)lem6&
Flow-Controlled Job Starters
A .o) starter can also )e in "lo+-controlled state& The state "lo+-controlled! is reached +hen all
.o) slots are e*hausted? i&e&, +hen there are so man% concurrentl% e*ecuting .o)s that the limit that
has )een set "or the respectie .o) starter upon deplo%ment is e*hausted& A .o) starter in "lo+-controlled state ma% signal a temporar% oerload, )ut more li(el% signals a mal"unction#
too man% .o) slots )loc(ed )% processes that hae )een suspended automaticall% )ecause o" an
error condition
too man% .o) slots )loc(ed )% processes that are running too long, such as processes +aiting to
connect to a data)ase that is not aaila)le, +ith no timeout or a generous timeout con"igured&
When a .o) starter is "ound in "lo+-controlled state, determine i" it is still "inishing e*isting .o)s and
processing ne+ .o)s at an accepta)le rate& When the .o) slots "or the "lo+-controlled .o) creator are
used up )% .o)s in suspended state, or )% .o)s +ith high e*ecution times 1more than @& ms is
de"initel% 8OT o(6 or a com)ination thereo", %ou must assume a more seere pro)lem that leads to
hea% degradation o" the serice, up to the point that it is processing no longer&
Other+ise, there ma% )e onl% a temporar% oerload situation 7 the .o) creator settings ma% need to
8/12/2019 BW Training Basic
24/24
)e set more generousl%&
When there are suspended .o)s, or .o)s +ith er% high e*ecution times )loc(ing the .o) slots, the
root cause must )e determined& The "ollo+ing general rule applies#
I" it can )e assumed that the root cause o" the pro)lem +ill not a""ect ne+ eents to )e
processed 1e&g& data)ase +as temporaril% unaaila)le )ut is mean+hile )ac( again6, "or a
'uic( "i*, .ust (ill the .o)s that are )loc(ing the .o) slots& 5or a thorough "i*, therea"ter alsore-start the engine&
I" it must )e assumed that the root cause o" the pro)lem still e*ists, do nothing, )ecause onl%
more errors +ould )e created i" processing +ould )e allo+ed to continue&
I" the root cause cannot )e determined, (ill the .o)s that are )loc(ing the processing and test
i" processing therea"ter goes smoothl%&
In an% case, in addition, it should )e anal%ed using the )+engine log "ile and other mechanisms
+hat caused the pro)lem&