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&