IJnit 1: GenercLting Senices

' Generate SOAP Service for the Perform Credit Check

operation

. Design SOAP client process

' Test Credit Check Service implementation

Lab lmplementation
Complete the lab exercises that tbllow to implement the Credit Check
Web Service.

TIBCO So.ftware Inc. Page l0l

M-BWE: TIBCO BusinessWorks|M 5.4 EssentiaLs

Notes

PcLge 102 TIBCO Education P roprams

 Inb B: ImpLement CrediÍ Check Service

Lab B Implement Credit Check Seruice

Overview
In this lab you generate a Web Service fiom an existing business process.

Objectives
t Generate Credit Check Service, page 104
t Test Credit Check Service, page 107

Prerequisites
r TIBCO Sofiware installed and configured on your userXX machine:
a Runtime Agent (TRA) 5.5.0
a Administrator 5.4.0 (userXX domain created)
a BusinessWorks 5.4.0
a EMS 4.4.0 (added to the userXX domain)
r Connectivity to the EDUSVR instructor server fbr:
a BWP Home Page at httsp: / / eduswr :8080 /bw/index.html
a Oracle Database
r C:\BWEDU lab files
r Completion of previous lab exercises

Directions
Complete the exercises that fbllow.

TIBCO Software Inc. Page 103

M -B WE : TIB C O B us iness Worts'r'vr 5. 4 E s s e nt icLLs

Lab B - Exercise 1: Generate Credit

Gheck Service
In this exercise you expose PerformCreditCheck as a Web Service and available fbr clients who
would want to call it.

Steps

1 . In your bwpXX project, add and confìgure new resource /BWP.Core/Connections/HTTP

Connection.

Analysis: This connection provides the transport for the Web Service. BW
supports HTTP and JMS for transporting SOAP messages.

r Name: SOAPSeTveTHTTP
r Host: VoVobwplhost.NameTo Vo (delete the detault value localhost and replace with this
global variable, see "To do this" below)
r Port:7575

To do this: To use a global variable instead of hard-coding a value:

r Selecl the Global Variables tab
r Expand the bwp global variable group
r Drag-and-drop the host.Name global variable to the Hosr field
Notl: lf tl. n"tO has a globe icJn ,narke, to its rieht, you must f irst select
this icon, then drag-and--drop the desired global v*ariafle.
Note: If vou want vou can create a slobal variabte for the oort value instead
oi hard-coding it.

Page 104 TIBCO Education Programs

 Inb B: ImpLement Credit Check Service

2. Expose PerformCreditCheck as a Web Service,

I From the Project tree select process PerformCreditCheck

I Right-click and select TooLs or MuLti-User > Generate Web Service > From Process
I Confìgure the service as fbllows and click Generate:
a Namespace: http: / /w-rtrr.Èibco.com/bry/ services/
credi ÈcheckabsÈract
a Port Type: portType
a Transport: /BWP.Core/Connections/SOAPSeTveTHTTP
a Location: Browse to and select /BWP.Core/Services/CreditCheck/Interface

trpo dType

!/BWP.Core/ConÍÈct ons/SOAPSeNeTHITP sharedhttp

l/BWP.Cof e/BÈtuiceslCredÌtCheckrlnleface

Analysis: Once generated. the service agenL(intfPerformCreditCheck-senice),

SOAP server pro."r, (wsPe rformC redilCheck\,and abstract WSDL
(intfPerformòreditCheck) arà generated for you in folder
/BW P.Core/Services/Credi tCheck/In terface.

TIBCO Sofnuare Inc. Pnoe IO5

 -[
M - BW E : I BC O B us irrc.r.t Work.sTrlr 5. 4 Es s e rtti a Is

3. Save the concrete WSDL file ior use by clients to call the Credit Check SOAP Service.

r From the Pro.ject tree select the intfPerformCreditCheck-service resource

t WSDL Source Íab'.
a Target Nanrcspace: http : / /www. tíbco .com/bwp/ services/
crediÈcheckconcret,e
. Click Apply
a Scroll to the bottom of the WSDL source and notice that it contains the cndpoint
binding and transport URL, indicating that this is the concrete WSDL:

confguration f'iBDL Source I oleMewl

SeMc€ URI: IIE VP CorerseBrcesrcredilchecklntelacefnlPetrarfrCeditoheckseMce gerúceagenl

Tafg€l l{mespace: ìhllp l^^Wnbco uom'hwp;sP^ (Pgicredikherkcnrr rHle

Embed in WSDL: !t lnteface 17 lypes T JNDI Propodìes lMs Ohry)

<rÉd : íryut r,ì r!ù!:,='rr: : lrlili :hè.I: []î1:,ri />

<iÉd : 6ut9st irn: :..i:-="hr! : ilÈédr : :hÈ,-! l È i.r1r' />
</cù: @èraùio^>
</€d:poÈtT)Tè>
<Fd:biúE,-ì:*:='rbti'.:!er!.r&i.:.::.4:*:h!r:dèrrnr!;:!rnr:É i'ìi,=rÉ:È'rÈiÉè">
<Boe:biÈry irtr:!='&.,-eÉr:t' rfr,jaJrfj= ùtrÈ:/i:rÌ,è!3:.!újràap.6.'r1jaà.l.t-.-! />
<Ed : Ee!atio^ r..rcr-" rÉL aÈraarÈci! the.kCÉ' >
<so4:oD.r.tio^i:,-l::=no{úètr! i..rir-r::'-::r;=,JÈ1ùt.a.Jre,,3É!vr,:e6j:redritueck/I!!ÈriÉi./:r!f!Èri!1!ùfrÈd!!L_hÈrÈ-
-:€d: iEùt>
<ao+:bodI ìri i- ii.Èr!l l,.,fi rE'Ier6r'eî,i:i />
</€d: ieut>
<€d:outpùt>

O Click Save WSDL and save this WSDL to project fblder C:\BWEDI-AbwpXX\
BWP.core\Services\CreditCheck\Contract with the l'ile nan.re
Credi tCheckServí ce_Concre ÈeWSDL (case sensitive)
r To display the saved WSDL fìle, tiom the Project tree select fblder Contract then fiom the
Designer menu bar selecf Resources > Refresh

Page 106 TI BCO Educatiort Prutgrams

 ktb B: Implement Credit Cher:k Sen,ice

Lab B - Exercise 2: Test Credit

Check Service

Overview
Te.stCreclitChect is a simple client to the CreditClteckService used to test this service. As a client to
the service. TestCreditCheck uscs thÈ concrete WSDL fìle to call the service.

Steps

l. Create new process TestCreditCheck that includes a SOAP client actrvity.

r Create new process /BWP.Core/Serviccs/CreditChecUUnitTest/TestCrediÈCheck

r To this process acld a SOAP Request Reply resource
r Transition fì'om Start to SOAP Request Reply to End

2. Initiate TestCreditCheck with the CreclitCheckRequest element type.

r Confi-qure the Start activity with the CreditCheckSchema:

a Outpttt Editor tab:
- Content: XML Element Reference
- Schema: /BWP.Core/Schemir,/CreditCheckSchema

- Element: CreditCheckRequest

TIBCO Sofrware Inc. Page 107

 Nr
M-BWE:'l'IBCO Busine.sslVoi*s] 5.4 Essenrials

3. Call the CreditCheckSe rvlce process by configuring the SOAP Request Reply activity.

Configuration tab:
a Name: Invoke Credit,CheckService
a Servicc: Browse to and select resource /BWP.Core/Services/CreditCheck/Contract/
CreditCheckService ConcreteWSDL
lnput tab. map:
a inputMessage/CreditCheckRcquest: $start/crediÈCheckRequest
- Mappin.g Wizartl'. Select "Make a copy of CreditCheckRequest" and click Finish
OLúput tab. verify:
a outputMessage/CreditCheckResult/Status is returned

4. Return the result of the credit check by confìguring the E,nd activity.

Irtput Eclitor tab:

a Content: XML Element Reference
a Schema: /BWP.Core/Schema,/CreditCheckSchema
a Element: CreditCheckResult
lnpttt tab, map
a CreditCheckResullStatus: $Invoke-CreditCheckSerwice,/
outputMessage/Credi tCheckResul t/S batus

5. Verity the design of your completed TestCreditClteck process detìnition.

G*nu*-W
Start truote End
CreditCheckService

Pttge 108 TIB CO Education P ro gratn s

 ktb B: lmplemertt Credit Check Senice

6. Tesr, CreditCheckService and debus anv errors.

I Validate the projcct and dcbug any errors (Project > Validate Project For Deployment')
I In the Pro.jecl tree selcct process BWP.Core/Services/CreditCheck/UnitTest/
TestCreditCheck so that it is in vrew
Tester tab'.
a Click the green arrow icon, bringing up the "Select Process to Load" dialog
a Click Clear All. check only the fbllowing components then click Load Selected:
BWP.Core/Scrvices/CreditCheck/Interiace/intfPerformCreditCheck-service
- B WP.Core/Scrvices/CreditCheck/Uni tTest/TestCreditCheck
Create a.job instance ol'the leslCreditClteck process and test 1'or "Accepted" and
"Rejected" credit checks usin-g the fbllowing data:

Input Accepted Reiected

Amount 3000.00 4000.00

AccountID L234L234L234L234 1_l_ t_ t_1_ 1_1 t_ 1 l-1L 1111

r Verify the expected results:

a In the Ie.r/e r "Jobs" tblder select and expand the crlmpletedTestCreditClreck proccss
a Select the complcted job's End activity
a In the Inpltt Data tab verify the Status
Stack ì* Efi iF!!F LlnÌÈiSpiire!/trÈlrúnÈLrrrnillest(estcfÉdtaherknfrrÈ!!l

confqùralíùnlhputEditorlrnsutirnorscle*ae!proeesiDak lnpdDrhlErnorlput

' . enus ! Co jl
ilenl SourP
l.
-ns0.Cred lCner€esu
'' ?nsÙcreddchE r:::'::'

TIBCO Sofnuare [nc. Page 109

M - BW E : T I B C O B us ine s swo rks't Nt 5. 4 E s s e ntia Ls

Notes

Page 110 TIBCO Education Programs

 Unit 5: Deployment and Management

Unit 5 Deployment and Management

This unit introduces you to the BusinessWorks deployment

environment with an emphasis on key tèatures and capabilities.

Topics
t Objecrives, page I l2

t Deployment Steps, page 113

t VaLidating Project for Deployment, page 1 14
t Building Enterprise Archives, page 115

t Process, Adapter and Shared Archives, page I 16

t AppLication DepLoyment in Administrator, page l17

t Configuring Deployment DetaiLs, page 1 18

t DepLoying, page 119

t RedepLoying and Versioning, page 120

t Managing and Monitoring DepLoyments, page 121

t Domain Communications, page 122
t User Management, page 123

t Domain Authorization and Access, page I24

t Domain Resource Management, page 125
t Version Control Using TIBCO XML CanonrM, page 127
t Why Use XML Canon with BW?, page 128

t Lab Introduction, page 129

TIBCO Sofware Inc. Page lll

M - BW E :'l' I B C O B us iness Worts rNr 5. 4 E s s e tt t i a I s

. Knowledge
. Explain BW deployment techniques
. Define runtime components and environment
. Describe application deployment and management

. Skills
. Validate a project and build enterprise archive
. Configureapplication deployment
. Deploy. manage and monitor process application
. Manage domain resources and users

Objectives
Afier completing this unit you will know:
r Key f'eatures and requirements of the BusinessWorks deployment
environment
I What deployment means in context of BusinessWorks
r What BusinessWorks components can be deployed
r How to confìgure a project component fbr deployment
r How to deploy a project componcnt
r What monitoring infbrmation is provided by default and how to
customize monitoring
r How to manage domain users and resources using the
Administrator interfàce

Page I l2 T I BCO Education P rograms

 Unit 5: Deplotment cutd Managemenl

Designer
r \l: lidrta nr^ia.t
. Configure deployrnenl and build archivs

Administrator
. Upload archive .configure application
. Deploy and run
. Manage and monitor

Deployment Steps
Deployment is a two step process: first you design and test your
pro.ject using Designer. and then. still usin_e Designer, you create the
project archive deployment package.

The deployment package is then uploaded to the BW runtime

environment using Administrator, and you use this tool to confìgure
the application(s) fbr deployment and then deploy.

TIBCO BusinessWorks process engines and TIBCO Adapter Agents

are the components you can deploy.

TIBCO Sofnuare Inc. Page ll3

M - BW E :'l' I B C O B us irt e^rs ll'or*s I Nr 5.4 E s se rt t ia Is

. Designer utility for validating project deployment

rr=JlT .eJ-?J
Fovid 4 Èrofs and 1 0 wamìnqs

" Provides error

. Details
: r:
?i SatesDrde€ubscrpljor
:l: dl orderPro.eGsing Èar
. Go to resource
-:, :-ri shaf ed('onneclDns
:r -web,lrderHfrPBerure

. Sorting and saving

. Revalìdating Delails:
*:
F- *'- r+ó'umx*- i;;;;;!:;;;'*
l!esÌ!Èd ssL cùr,irúr!aEion FropErtres, !rea3e 3È1e.i rflÈ ,:l
bo Incesgl:l ctase I

Validating Project for Deployment

Thc f irst thin_e to do when preparing a pro.ject lbr deployment (atier
testing and dcbu_gging), is to use the Designcr validator utility to
verity that the prolect is ready fbr deployment.

l'age I Ì4 'f I B CO Etl ucctt irnt P ro g ram s

 Unit 5: Deplot'ment cutcl Marngement

" Build using Designer or thrCIugh command line

. tAn Contents
. Pnocess archives
. Shared archives
-. Audprer
A/"1-^+^r drur
-r^1^'ltVgS

. Designer options
. Tools > Create Project EAR for quick archiving
* Confisure nranually using deployment palettes

Building Enterprise Archives

Once validated you then create the project archive file that contains
proccss, adapter services and shared resourccs. You can build thc
package manually or use the "Create Project EAR" option to quickly
create a project deployment packa-9e.

Clicking "Build Archive" creates the deployrnent package 'k.ear. This

archive can then be given to the administrator fbr deployment.

TIBCO Sofnuare lttc. Page l15

 Nt 5.4 E.ssenricLls
ll4-BWE: TIBCO BusirrcssWorÀ.ir

. Containers for processes. . Shared archives contain shared

servtces and adapters fo be TCSOUTCCS
donlnrrod

d:-*'- toocesloèfhillorl ..-

,F!fP a ner!4./ r:tsrLlrÈn(ilhÈ/ ! rlÈraiÉl.nPFft. m,lÌÈd.laIerl-qÈMcè sÈr\rrei0Ènl
irProfesslerli,rÈrsia+ferarirlpdúsDltilr+sDrîiPes rlrútrv\rjú-FÈfrilr:

. Resources can be manuallv addediremoved

Process, Adapter and Shared

Archives
TIBCO Administrator. BW Process Engine(s). and. optionally.
TIBCO Adapter sof tware, provide the runtime environment tbr
deploycd BusinessWorks applications.
The deployment package pro.ject archive can potentially include three
sub-archives: shared, process and adapter.

I A proccss archives contains process del'initions

r An adapter archive contains adapter services
I Shared archives contain shared resources

Together these components provide the enterprise archive packa,ee

that can be uploaded to the runtime environment and then deployed.

Page ll6 Tl BCO Etlucation P rograns

 ('trit 5 : Deplotnrettt LttrLl Muttttgerttettl

. Create new deployment application and upload EAR

. Use folders to organize applications

-
u é

Application Deployment in
Administrator
TIBCO Administrator is a browser-based GUI fbr managing the
TIBCO domain. You can use the interface to add, modify or delete
user authorization entries tbr the domain. You can also monitor and
manage domain services such as the Administrator Server and Project
Repository Server. In addition. you can monitor and ntanage any
deployments registered with the domain. Deployment components
that can be monitored and n.ranaged include BusinessWorks process
engine instances and BusinessWorks-supported TIBCO Adapters.
You can monitor at either a component or machine granularity. You
can examine and search fbr specitìc entries in the trace files fbr any of
the services in the domain. TIBCO Adrninistrator also provides
running statistics of the number of jobs in the BusinessWorks engine,
throughput and.lob-level tracing.

TIBCO Sofnt,cLre [nc Page I l7

ùl-BWE: TI BCO BusirtessWo,'ksr rr 5.4 Esserttials

. Basic
. Applicationparameters
. Service settings E ? ordùph.è:;io'

. Target machines E S
s! ererdÈfilbJíot,o. 3r,

q,
l: + ù,de,F'oièi;rnoEno,ne !rr
. Advanced f eous,
":e
-

' Global and environment variables

. Cuslom monitoring

Config uring Deployment Details

Administrator provides robust f'acilities fbr con fi-quri ng deployment.
Global variables and classpaths are exposed and can be adjusted as
necessary fbr runtime proccssing. Application paranreters and scrvice
instances can also be contigured, and you can choosc on what
machine(s) to deploy components.

Page I I8 T I BCO Education P rogranr s

 []rùt 5: Depl.ovment antl Managentent

' Sefore Options during

. Quìck deploy ("on save")
-w*"'*. / *., *\dd.'"..*s . Aillo-slarl d-onloved Servlces
IÍÍ*íÈìfif" E

. After

Deploying
TIBCO Administrator creates a deployable applicatitrn in two steps:
r Upload the deployable application's EAR file
r Set deploymcnt parameters and creatc a deployment

Deployable applications can be organized within TIBCO

Administrator fblders.
Before deployment Administrator indicates the "deployability" oi
archivcd components.
There are various options during deploynrent, including a quick
deploy option as well as the option to automatically start deployed
components.

After deployment Administrator displays the deployment status.

TIBCO So.t'twctre lnc Page I 19

lvl - B W E :' I' I B C O I] us i n e.s.! Wrr r/tr'r rvt 5. 4 E.t s e u t i cL I s

lf project changes . Deployment configuration

" Validate and archive is versioned and revertible
" Upload new EAR
. fiedeploy . Deployment history is kept

Loqeèd inro u*ro3 as u+ú3 a!a! I b13 I Looout

ffiÎjÍffiiii?ffiÌllliiiiillili!ffitrffi31iÌlilllliffi.?triÍiíit@,,* !ffiiiiÌi;iilffitrffitriliììliiliiil[ffiffii,ffl1;:ÉaTliÍllÍiiii
n-clD!3hè n'l re
r,s"ùo,, f -!Bar..

sii3 .u,,",,r,..", :::!",1i'" ".". =rS. *,,.."É,".,

Redeploying and Versioning

Administrator makes it easy to rcdeploy applications if the archived
project has changed or il'thcre was a problem during dcployment.
Deploynrent history is maintained as wcll as versions. so you can
revcrt to a previous deployment configuration if nccossary.

'l'l
Page I 20 BCO Etl ucation Prutgrarrts
 Urtit 5: Dcplu.tnt(nt rut(l Mttrtttg,'tnertl

Manage
. Stafi I stOp
* View detaiis
. Add software

" :,- :jil

Monitor ...,9::r:-Ìm.,:Í:5q1 1 Ji!::l ::ry 1 P.yr9firy13. ,{!rr ! . .. ... .... .

. Perforrn tracìng
. View active processes
. Set access

Managing and Monitoring

Deployments

TIBCO So.ftware lnc. Page l2l

M-BWE: TIBCO Busùter.sWorksrrr 5.,1 F)ssentiuls

Domain Communications

Page 122 T I BCO Education P ro grarn s

 (lnit 5: Deplotment u1d Mctn.ctgemenl

r Users
. Create and rnanage
: .-r***
-
l-l r S- User Man.=':er-FrEnr
f*
. Roles '1
lJser=
. Create and manage
!'--,-r;
. oé, Rales
.:.t*W
Set authorization
. Assign to users ì q, Authoric.rtian

. Authorization
' Grant access to:
* BW projects (reposilo4y data)
- TIBCO Administrator Ul

User Management
In Administrator the User Management module provides security
over domain users.
The Users module enables administrators to create domain user
accounts. The administrator can create and remove users or search
existing users and edit their domain log in credentials (name /
password).

Note that the user specifìed on install of the TIBCO Administrator

Server is assigned root (fìll) administrative privileges.

With TIBCO BusinessWorks, you can create Roles, grant

authorization privileges to those roles and assign roles to users.

TIBCO Sofrware Inc. Page 123

M-llWE:'l'l BCO BusiuessWorksrrvr 5.4 Esserttictls

. TIBCO Administrator access

r For f ull access

w**uar*uabauu
Èìiflft;iiiffi *##i*rl!tt#Éf É@
r:r
-Choose and set "TlBCO ff:
Administrator acccss" TTT
ó!a

,i& !!@r Tf:r

. For limited access E riq tud-ù. M.".""-."r rrr
E ira rd:r tè.re'r trr:r
- Choose and set for each E ;..jttr Mfteoor.Ìrc,": TTT
user you want 10 rl: rr:T
allow access to .; Fur a..r*

Domain Authorization and Access

Users can be granted two levels of access in thc domain:

r U[ Access [s used to specify access to what intbrmation users

-
can see via the Administratclr GUI at runtime

I Data Access Is used to specify access rights to user infbrmation

(kept in local -tìles and not in LDAP) and tbr access ro domain
repositories which are created by the deployments

By default the root administrator has iull access privileges. The root
administrator can grant full access to other users or can authorize
partial access to the Admin UI and Data. New users created by the
administrator must be granted authorization privileges befbre they can
log in to TIBCO Adminisrraror.

Page I 24 TI BCO Education P ro grams

 Unit 5: Deplo'-ment aruL McutagemenÍ

u lnventory 0f installed
software
i*î::i*ffi::=î:ll##
O g r.r.!{(,a,.(-o{*,,":r3

E 4 -r-, "è- -'-ó . 1

'

. Machine status ug -a.!rq.--r'hs:;:

!e?4qq:e'4

r A :rro. :.,",.,,..,,,,"..,",

r f n*jLilnd-.i-ri..É---

r e.ru

Domain Resource Management

Fronr the Resource Managem.enÍ console, authorized users can
monitor and manage don'rain n'rachines:
I Thc Machines module provides infbrmation about machincs in the
domain. including CPU and memory usage, as well as active alerts
r The lnstaLLed Soft-*are modulc provides an inventory of TIBCO
sotiware installed in the domain, including the machines hosting
this sotÌware

As we have already seen, the Applicatbn Managentent console

provides authorized users with the ability to monitor and manage
deployed components.

TIBCO Sof'tware Irtc. Page Ì25

M -BWE:'l'IBCO Businesslvortsl \r 5.I Esserttittls

The TIBCO Domain consists of a set of'machines, the BW

components installed to those machines, and the domain server that
adnrinistcrs the donrain. The TIBCO Domain Utility is used tcr
manage domain machines and the don'rain server tbr such tasks as
adding machines to a domain, creating additional dclmains and
creating backup domain servers.

'f
Page 126 I BC O EtLuccrt io n P ro g rcu n s
 Unit 5: Deplot,ment and Mutagentent

' 3W proJect metadala is . XML Canon provides

strongly lyped XhlL . Design-lime project repository
. XSD schema . SÌandards-based (WebDAV)
* XPath addressing . fievision conlrgl sysiem (RCSI
. XSLT mapping . Differencing engine

Né( sear.h ùèdifr seórch Dodment pUrclìaSeOder.xSd

Ì docunentt fouod,

!s'iÉ;iìi j7
:= rottv ne v r : weu repnd (:NL.-no. iúmeF.!€l
P.f.hdrèù"ner r.d
lt Nattv r,è ?: Éúè |

,lr€e-J
ÍÀ* ùdd r-iiia : i Éq'rirì;ii r*b{r J.-intli at4i lidirlld lit À'tfd iiF+sd !,:iì,: {!';ùdE ; t t:=iii ;

' {,.r D oe\ urÉ'r:\ ino5ll-r033115p'aAld6dla-è<pa_.

' : i .rr!nòiD 1 I tley lrÈ.ril ltl5-11.?2n:ù4:r!PnInùllvertior6irclerr..

-:::::::.::::-:::;:'. :,' :
.gj9j,.-!!:9:::::2:
,o"e j rui*.,*, j s*uu*.. I rlqlt4qtq I qqletq,,I qrreqllrtr, I

Version Control Using TIBCO XML

CanonrM

BusinessWorks project metadata is built in XML. TIBCO XML

Canon stores, versions and analyzes XML instances. scl.remas (XSD,
DTD, SOX, etc.), WSDL files, and BusinessWorks processes and
resources.

XML Canon provides tools fbr storing. versioning and analyzing

XML assets as they exist at any particular stage in the developmcnt
lifècycle.

TIBCO Software Inc Page 127

M - IIW E :'l' I B C O Il us in e.ss Works I Lr 5. 4 E s s e n r ia I s

. XMl-based version control

. Web-based desktop for managing SOA assets

i:.:
-:
Ladch4.d: 'l€. ll. l: lf jÌ:5 u
Clmltr húJ ùpL,ad 'i Dry!!/Cr:Irlh. !kS-,Mr.

Pù Mèr 9Aqrlf ric?rLeùlonJrh! lh.rk

Why Use XML Canon with BW?

XML Canon provides a web-based desktop fbr viewing and managing
all the services, schemas, shared resources, etc. in its repository,
dramatically improving reusability.
Fine-grained data services like database lookups may be independent.
But as higher-level, composite business services such as "Hiring an
employee" or "Processing a Loan" are implemented,
inter-dependencies increase. XML Canon allows users to analyze the
impact of an asset change, process-, project- or enterprise-wide.

Page l2ll TI BCO Educatiott Propram s

 Unit 5: DepLo,vment u'Ld Management

Deploy and manage Credit Check Service

. TIBCO Designer:
* Validate for deployment
- Create enÌerprise archive

. TIBCO Adminìstrator
* Configure deployment
* Deploy and monitor
. TIBCO XML Canon
- Version cOntro,
- View and compare assets

Lab lntroduction
In the lab that fbllows you learn to deploy and manage a
Busi nessWorks orocess.

TIBCO SoJ'tware Inc Page 129

M-BWE: TIBCO BusinessWorks'tM 5.4 EssentiaLs

Notes

Page 130 TI BCO Education P ro prams

 Lab C: Deplot and Manage Credit Check Sewice

Lab C Deploy and Manage Credit Check

Service

Overview
In this lab you configure and deploy your BusinessWorks project and practice fundamental
application managcment and monitoring techniqucs using TIBCO Administretor.

Objectives
t Archive Credit Check Service.for DepLoym.ent, page 132
t Deploy Credit Check Service, page 13,1

t Man.age and Mon.iror Credit Ch.eck Service, page 136

t ImpLentent Pro ject Version ContoL, page 140

Prerequisites
r TIBCO Sofìware pre-installed and configured on your userXX ntachine:
a Runtime Agent (TRA) 5.5.0
I Administrator 5.4.0 (userXX domain created)
a BusinessWorks 5.4.0
a EMS 4.4.0 (added to the trserXX dom.ain')
r Connectivity to the EDUSVR instructor server fbr:
a BWP Home Page ht.Èp z / /edusvrt8080/bw/ index.html
a Oracle Database
a TIBCO XML Canon http: / / edusvr: 9983
r C:\BWEDU lab fìles
r Completion of previous lab exercises

Directions
Comolete the tasks that fbllow.

TIBCO Sofnvare Inc. Page l3l

M-BWE: TIBCO BusinessWorks'tM 5.4 EssentiaLs

Lab C - Exercise 1: Archive Credit

Check Service for Deployment
When you are ready to deploy your project, Designer is used to generate an Enterprise Archive
(EAR) fìle, which contains the infbrmation about the application components (Services, Processes
and Adapters) you want to deploy.

Steps

1. Confìgure the bwpXX project EAR tbr deployment.

r From the Designer menu select Tools > Create Project EAR
a An Enterprise Archive resource named bwpXX is added to the project at the root level
a For organization, drag this resource to the project U)eployments tblder
r Select the \Deployments\bwpXX enterprise archive resource and contìgure it:
O Name: bwpXX (leave as is)
a File Location: C: \bwpXX. ear
a Include all service level elobal variables: checked

Page 132 TIBCO Education Programs

 Lab C: DepLoy and Manage Credit Check Service

2. Contìsure the Process Archive to include the Credit Check Service.

r Double-click the Enterprise Archive resource to open it and display the Process and Shared
Arc hiv e s deployment containers

Analysis: T\e Shared Archive isbuitt by dgfault and auto-populated with all
shared components required by the Process or Adapter archive.

r Rename the Process Archive resource CreditCheckService

I In the Processes tab, click the "Add a process starter to this archive" icon:
a Select the intfPerformCreditCheck-service and click OK

p:';J . :

hwpllE
5-il e-.n,p.,:0..*
li*:*i Ser'rice:i
l'+i cre,iit0heck
*
:l ,r.li lnlprferp
*-
$,dri

,.:Ol4:

3. Build the bwpXX Enterprise Archive deployment package.

I In the Project tree select the /Deployments/bwpXX enterprise archive

r In the enterprise archive resource, click Build Archive (lower left)
I Click OK to confirm the creation of the EAR fìle
r Save your project

TIBCO Sofnvare Inc. Page 133

M - BW E : TI B C O B usine s sWo rks't' M 5.4 E s s entials

Lab C - Exercise 2: Deploy Credit

Check Service
ln this exercise you upload the EAR file to TIBCO Administrator and then deploy it.

Steps

l. Start TIBCO Administrator and log in using your userXX credentials'

I Start > Programs > TIBCO > TIBCO Administrator Enterprise Edition 5.4 > TIBCO
Administrator

2. Create a fblder named bwpXX to contain your deployment application.

r In Administrator select Application Management and click New Folder

I Name: bwpxx (replace XX with your two-digit ID)
r Click Save

3. Upload the EAR fìle to the bwpXX application container.

r Select the bwpXX fblder

I Click New Application
r Browse to and open fìle C:\bwpXX.ear
r In Administrator click OK to upload the EAR tile
r In the New Application Configuration: bwpXX window, confìrm the "Target" tbr the
CreditCheckService'.weerllX - new bwengine 5.4.0.xx
r Save your deployment contìguration settings

Page 134 T I B C O Educatio n P ro grams

 Lab C: Depl.oy and Manage Credit Check Service

4. Deploy the BW service to the target application.

r Select Application Management > bwpXX > bwpXX > Configuration

r In the ConJiguration Builder, click Deploy
r Enter a description, such as "Initial Deployment 01" and leave all other settings as detault
r Click OK to deploy the service agent

Analysis: The EAR file is used only for deployment and can be deleted after
deployment. Changes made to the EAR file after deployment are not
automatically propagated to the deployed project, this requires re-uploading the
updated EAR file and redeploying the applicafion via Administrator.

5. In the Configuration Builder, verity that the process is deployed and troubleshoot as
necessary.

r Ifdeployed successtully, you should see that "Deployability" is synchronized andits

"Deployment Status" is saccess
r If your deployment status does not indicate "Synchronized" and "Success" try these
troubleshooti ng st eps:
a Redeploy:
- Click Deploy and try it again
a Undeploy:
- Select Undeploy then reupload the EAR fìle and deploy it again

TIBCO Sofnuare Inc. Page 135

M-BWE: TIBCO BusinessWorksIM 5.4 EssenticLls

Lab C - Exercise 3: Manage and

Monitor Credit Check Service
In this exercise you use TIBCO Administrator to perfbrm runtime monitoring and mana-gement of
active business processes. You also explore key tìles created during application deployment.

Steps

l. Verify that your deployed CreditCheckService engine is running.

r In Administrator select Application Management > All Service Instances

r You should see that a userXX - CreditCheckService instance is Runninp
a If not, select it so that it is highlighted and ciick Start

Analysis: From this view lhe status all TIBCO service instances can be monitored
and rianased. For examnle. in addition to the process service, vou should also see
that the TIBCO Administrator service appears and is listed as Running. (And. if
you EMS Server is not already running. you can start it from here as well!)

Pnoe I ì6 TI BCO Education P ro grams

 Lab C: DepLoy cLnd Manage Credit Check Service

2. Test your deployed CreditCheckService.

In Designer Load TestCreditCheck into the Tester

Note: Do NOT load any other processes into the Tester. To ensure that you do not, tìrst click
Clear All, then select only the TestCreditCheck process and click Load Selected.
Test for an "Accepted" credit check using:
a Amount:3000.00
a AccountlD: L234L2341234L234
Test for a "Rejected" credit check using:
a Amount:4000.00
a AccountlD: l-1-1-1-1-1-l-1-11111111

I Stop test mode when you are done

TIBCO Sofware Inc Page 137

M - BW E : T I BC O B us ine s sWo rksl' tú 5.4 E s s e ntia I s

3. Monitor and manage process engine instance activity.

r View Administrator service agent tracing:

a Select All Service Instances > userXX - CreditCheckService (click the link)
a In the Tracing tab click Search
a You should see a message indicating that the CreditCheckService started as well as
other details about the service instance
I Stop the CreditCheckService process engine:
it Select A/l Service Instances
a Place a check next to userXX - CreditCheckService so it is highlighted and click Stop
a Afier a fèw moments this engine should be Stopped

Tip: TIBCO Administrator auto-refreshes at 30 second intervals. To refresh on

demand, toggle the meter icon in the upper
ta'
right.

r View machine resources:

. Select Machines in the Resource Management console
a The status is shown fbr your userXX machine
a Select the userXX link for your machine and note the detailed infbrmation, including
disk and CPU usage statistics
r View installed sotiware:
a Select Resource Management > Installed Software
a This view provides summary information about the TIBCO sofiware components
installed in the domain
r When you are done exploring, exit TIBCO Administrator and TIBCO Designer

Page 138 T I B C O Educatio n P ro grams

 Lab C: DepLoy and Manage Credit Check Seruice

4. Explore files created during deployment of BW process engine instance.

r On the domain server machine where TIBCO Administrator Server is running:

C : \ t i b c o \ admi n i s t r a c o r \ doma i n \ oovtA r N_NAME \ da t a \
DOMA,IN NAME-ENTERPRISE A,RCHIVE NAME.dat

Analysis: This file is a rewrite of the ear file as a repository file (*.dat). When
deployed. the domain admin server has a copy oI the deployment delinition in this
Aai nte which is used to initialize the componen, u, ,,urrrp. The name of the
DOMAIN appears here twice. both as a folder and as the first part of rhe file
name. The second part of the dat file name is the name of the EAR.

I On the client machine where the TIBCO application (engine or adapter) is deployed to:
C : \ t ibc o \ t ra \ doma in\ DOMAI N_NAME \ app I i c a t i on \ DE PLOYMENT_FOLDE
R NAME\ENTERPRISE ARCHTVE NAME-PROCESS A,RCHIVE NA,ME.CInd

Analysís: A one linc script to start the BW engine. For initial debugging of a
deployed componcnt this script can be used to start the component. This should
be done in a command window in order to see stderr startup messages even if
it will not start.

On the client machine the TIBCO application (engine or adaprer) is deployed to:
C:\ t ibco\ tra\domain\oOuarN_NAME \appI icat ion\DEPLOYMENT_FOLDE
R NAME\ENTERPRTSE ARCHIVE NA,ME- PROCESS ARCHIVE NAME.TTA

Analysis: A text file containing startup information used by the startup script
(CMb file) to obtain deploy"igW configuration intormation frorn in"
admin server. This file also defines "ngin.
the-working !nvironmenr for this componenr.

TIBCO Software Inc. Page 139

M - BW E : T I B C O B us iness Works r'rvr 5. 4 Es se ntiaLs

Lab G - Exercise 4: lmplement

Project Version Control
In this exercise you use TIBCO XML CanonrM to version control and manage your BW project.

Steps

t. Check yorn bwpXX project into TIBCO XML Canon (running on the instructor server).

I From the Designer menu of your bwpXX project, select Project > Save As
T Select the XML Canon tab and confìgure the connection as fbllows:
a For the XML Canon category, click Browse
a In the "Browse fbr Project Folder" dialog:
- In the http:l/ fìeld enter eduswr: 99 83
- Click Connect
a If prompted, provide your userxX credentials and click OK
You should now have a WebDAV connection to the XML Canon Server tiom Designer
evidenced by the userXX category (and others) to which you have access in Canon:

Analysis: WebDAV (lMeb-based Distributed Authoring and Vcrsioning) is an

e*tension to HTTP that allows document uploads, tocfing und properiy
version.nuT_9.:.ji:l"il. xML Canon is a webDAV server,
"lT.b*::lis-
while TIBCO Designer is a WebDAV client.

Page 140 TIBCO Education Programs

 [,ab C: Depl.o.t' an.d McLnage Cretlir Check Sen*ice

2. Create a new Canon child category named bwpXX and save your prolect t0 lt.

I In the ''Browse For Pro.iect Folder" dialog, double-click the userXX category
r Click the New Folder icon at the upper right of the dialog
r Name the new folder the same as your project: bwpxx (replace XX with your lD)
r Click OK to create the l'older: you should now see fblder /userXX/bwpXX
r Highlight the bw'pXX fbldcr and click Select Folder
r Back at the "Savc Project" dialog, verify that your XML Canon Category is listed as:
http : / / edwswr : 9 983 /userxx/bwpxx/
r Click OK to save the proìect to Canon

3. Your project is now saved to Canon, clr is it? Verify at http://edusvr:9983 as userXX.

r Using Internet E,rpLorer, access the XML Canon desktop using the tbllowing URL:
http: / /edusvr:9983
r Provide your userXX credentials and click Submit to login into Canon
r From the Canon home page select Brow.re > Categories
r Expand the userXX category; you should see that it contains the child category bwpXX
r Select the bwpXX category; you should see that it is...empty; Why'l Because you have not
yet checked the project ì:esources into XML Canon

1. Check in project assets to XML Canon.

r Return to your bwpXX session in Designer

r From the menu bar select Multi-User > Check In Changes
I A list of changes appears in the XML Canon Check-in dialog
r Click Check in all and the entire project is checked into XML Canon
I Close the check in dialos

Analysis: There is required metadata associated with any BW project (e.g.. AE

Schema. folder lìles. global variables). When using XML Canon. you must first
create the project in Designer, generating the metadata, then check it in.

TIBCO Sofnuare Inc Page l4l

M - BW E : TI B C O B us iness l{or&s |M 5. 4 E s s e nt ict Ls

5. Verify that the project is checked into TIBCO XML Canon.

r In Designer you now should see locks on all project fblders and resources

r [n the XML Canon Web interface logged in as userXX:

a Press the <F5> key to retiesh the data in your browser
a In Íhe Home > Recent tab, you should see a listing of all newly uploaded assets

a An asterisk next to each asset indicates that it has been anal,v-zed by Canon

Analysis: Canon analyzes XML documents for version control and differencing.
Non-XML documents can bc stored and versioned by Canon but are not analyzed.

a In Canon select Erowse > Categories

a Expand category \userXX\bwpXX and you should see all project assets checked in

Analyiis: Ot.the client-siae, yóu. p.o;ea resourc.es are làcked, rndicuring.,,.

-BW
that they are checked into a revision control system (RCS) and must be acquired
to be edited. On the XML Canon server-side, your project resources are I!!!!
locked, indicating they cannot be edited until they are checked out (locked).

Page 142 TIBCO Education Programs