Embed Size (px)
Citation preview
IJnit 1: GenercLting Senices
' Generate SOAP Service for the Perform Credit Checkoperation
. Design SOAP client process
' Test Credit Check Service implementation
Lab lmplementation
TIBCO So.ftware Inc.
Complete the lab exercises that tbllow to implement the Credit CheckWeb Service.
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
OverviewIn this lab you generate a Web Service fiom an existing business process.
Objectivest Generate Credit Check Service, page 104
t Test Credit Check Service, page 107
Prerequisitesr 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.htmla Oracle Database
r C:\BWEDU lab files
r Completion of previous lab exercises
DirectionsComplete the exercises that fbllow.
TIBCO Software Inc. Page 103
M - B W E : T I B C O B us iness Worts'r'vr 5. 4 E s s e nt icLLs
Lab B - Exercise 1: Generate CreditGheck Service
In this exercise you expose PerformCreditCheck as a Web Service and available fbr clients whowould want to call it.
Steps
1 . In your bwpXX project, add and confìgure new resource /BWP.Core/Connections/HTTPConnection.
Analysis: This connection provides the transport for the Web Service. BWsupports HTTP and JMS for transporting SOAP messages.
r Name: SOAPSeTveTHTTP
r Host: VoVobwplhost.NameTo Vo (delete the detault value localhost and replace with thisglobal 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,
From the Project tree select process PerformCreditCheck
Right-click and select TooLs or MuLti-User > Generate Web Service > From Process
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
I
I
I
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 B C O B us irrc.r.t Work.sTrlr 5. 4 E s s e r t t i a I s
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 cndpointbinding and transport URL, indicating that this is the concrete WSDL:
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
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>
ktb B: Implement Credit Cher:k Sen,ice
Lab B - Exercise 2: Test CreditCheck Service
OverviewTe.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
M-BWE:'l'IBCO Busine.sslVoi*s] Nr 5.4 Essenrials
3. Call the CreditCheckSe rvlce process by configuring the SOAP Request Reply activity.
Configuration tab:
a Name: Invoke Credit,CheckServicea 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.
Pttge 108 T I B CO Education P ro gratn s
G*nu*-WStart truote End
CreditCheckService
ktb B: lmplemertt Credit Check Senice
6. Tesr, CreditCheckService and debus anv errors.
Validate the projcct and dcbug any errors (Project > Validate Project For Deployment')
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 1 1 1 1
I
I
r Verify the
a In the
a Select
a In the
expected results:
Ie.r/e r "Jobs" tblder select and expand the crlmpletedTestCreditClreck proccss
the complcted job's End activity
Inpltt Data tab verify the Status
Page 109TIBCO Sofnuare [nc.
Stack ì* Efi iF!!F LlnÌÈiSpiire!/trÈlrúnÈLrrrnillest(estcfÉdtaherknfrrÈ!!l
confqùralíùnlhputEditorlrnsutirnorscle*ae!proeesiDak lnpdDrhlErnorlput
' . enus ! Co ilenl jl SourP
-ns0.Cred lCner€esu l.'' ?nsÙcreddchE r:::'::'
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
This unit introduces you to the BusinessWorks deploymentenvironment 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.
Unit 5: Deployment and Management
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
Objectives
Page I l2
Afier completing this unit you will know:
r Key f'eatures and requirements of the BusinessWorks deploymentenvironment
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 tocustomize monitoring
r How to manage domain users and resources using the
Administrator interfàce
T I BCO Education P rograms
. 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
Unit 5: Deplotment cutd Managemenl
Designerr \l: lidrta nr^ia.t. Configure deployrnenl and build archivs
Administrator. Upload archive .configure application. Deploy and run. Manage and monitor
Deployment Steps
TIBCO Sofnuare Inc.
Deployment is a two step process: first you design and test yourpro.ject using Designer. and then. still usin_e Designer, you create theproject archive deployment package.
The deployment package is then uploaded to the BW runtimeenvironment using Administrator, and you use this tool to confìgurethe application(s) fbr deployment and then deploy.
TIBCO BusinessWorks process engines and TIBCO Adapter Agentsare the components you can deploy.
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 r t t i a I s
Validating Project for Deployment
l'age I Ì4
Thc f irst thin_e to do when preparing a pro.ject lbr deployment (atiertesting and dcbu_gging), is to use the Designcr validator utility toverity that the prolect is ready fbr deployment.
'f I B CO Etl ucctt irnt P ro g ram s
. Designer utility for validating project deployment
" Provides error. Details. Go to resource. Sorting and saving. Revalìdating
rr=JlT .eJ-?JFovid 4 Èrofs and 1 0 wamìnqs
: r: ?i SatesDrde€ubscrpljor:l: dl orderPro.eGsing Èar
-:, :-ri shaf ed('onneclDns:r -web,lrderHfrPBerure
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
Unit 5: Deplot'ment cutcl Marngement
" Build using Designer or thrCIugh command line
. tAn Contents. Pnocess archives. Shared archives- A/"1-^+^r -r^1^'. Audprer drur ltVgS
. Designer options. Tools > Create Project EAR for quick archiving* Confisure nranually using deployment palettes
Building Enterprise Archives
TIBCO Sofnuare lttc.
Once validated you then create the project archive file that containsproccss, adapter services and shared resourccs. You can build thcpackage manually or use the "Create Project EAR" option to quicklycreate a project deployment packa-9e.
Clicking "Build Archive" creates the deployrnent package 'k.ear. Thisarchive can then be given to the administrator fbr deployment.
Page l15
ll4-BWE: TIBCO BusirrcssWorÀ.ir Nt 5.4 E.ssenricLls
Process, Adapter and SharedArchives
Page ll6
TIBCO Administrator. BW Process Engine(s). and. optionally.TIBCO Adapter sof tware, provide the runtime environment tbrdeploycd BusinessWorks applications.
The deployment package pro.ject archive can potentially include threesub-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.
Tl BCO Etlucation P rograns
. Containers for processes.servtces and adapters fo bedonlnrrod
. Shared archives contain sharedTCSOUTCCS
. Resources can be manuallv addediremoved
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:
('trit 5 : Deplotnrettt LttrLl Muttttgerttettl
. Create new deployment application and upload EAR
. Use folders to organize applications
4
-u é
Application Deployment inAdministrator
TIBCO Sofnt,cLre [nc
TIBCO Administrator is a browser-based GUI fbr managing theTIBCO domain. You can use the interface to add, modify or deleteuser authorization entries tbr the domain. You can also monitor andmanage domain services such as the Administrator Server and ProjectRepository Server. In addition. you can monitor and ntanage any
deployments registered with the domain. Deployment componentsthat 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. Youcan examine and search fbr specitìc entries in the trace files fbr any ofthe services in the domain. TIBCO Adrninistrator also providesrunning statistics of the number of jobs in the BusinessWorks engine,throughput and.lob-level tracing.
Page I l7
ùl-BWE: TI BCO BusirtessWo,'ksr rr 5.4 Esserttials
Config uring Deployment Details
Page I I8
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 scrviceinstances can also be contigured, and you can choosc on what
machine(s) to deploy components.
T I BCO Education P rogranr s
. Basic. Applicationparameters. Service settings. Target machines
. Advanced
' Global and environment variables. Cuslom monitoring
E ? ordùph.è:;io'
E S s! ererdÈfilbJíot,o. 3r,
q,l: + ù,de,F'oièi;rnoEno,ne !rr
f eous, ":e -
Deploying
[]rùt 5: Depl.ovment antl Managentent
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 TIBCOAdministrator fblders.
Before deployment Administrator indicates the "deployability" oiarchivcd components.
There are various options during deploynrent, including a quickdeploy option as well as the option to automatically start deployed
components.
After deployment Administrator displays the deployment status.
Page I 19TIBCO So.t'twctre lnc
' Sefore Options during. Quìck deploy ("on save"). Aillo-slarl d-onloved Servlces-w*"'*. / *., *\dd.'"..*s
IÍÍ*íÈìfif" E
. After
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
Redeploying and Versioning
Page I 20
Administrator makes it easy to rcdeploy applications if the archivedproject has changed or il'thcre was a problem during dcployment.Deploynrent history is maintained as wcll as versions. so you canrevcrt to a previous deployment configuration if nccossary.
'l'l BCO Etl ucation Prutgrarrts
lf project changes
" Validate and archive
" Upload new EAR. fiedeploy
. Deployment configurationis versioned and revertible
. 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Íiiiir,s"ùo,,
n-clD!3hè n'l re f -!Bar..
sii3 .u,,",,r,..", :::!",1i'" ".". =rS. *,,.."É,".,
Managing and MonitoringDeployments
Urtit 5: Dcplu.tnt(nt rut(l Mttrtttg,'tnertl
Page l2lTIBCO So.ftware lnc.
Manage. Stafi I stOp
* View detaiis. Add software
Monitor. Perforrn tracìng. View active processes
. Set access
" :,- :jil...,9::r:-Ìm.,:Í:5q1 1 Ji!::l ::ry 1 P.yr9firy13. ,{!rr ! . .. ... .... .
M-BWE: TIBCO Busùter.sWorksrrr 5.,1 F)ssentiuls
Domain Communications
Page 122 T I BCO Education P ro grarn s
User Management
(lnit 5: Deplotment u1d Mctn.ctgemenl
In Administrator the User Management module provides securityover 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 AdministratorServer is assigned root (fìll) administrative privileges.
With TIBCO BusinessWorks, you can create Roles, grantauthorization privileges to those roles and assign roles to users.
Page 123TIBCO Sofrware Inc.
r Users. Create and rnanage
. Roles. Create and manage. Set authorization. Assign to users
. Authorization
' Grant access to:* BW projects (reposilo4y data)
- TIBCO Administrator Ul
- : .-r***
l-l r S- User Man.=':er-FrEnrf*'1
; lJser=!'--,-r
. oé, Rales:.t*W
ì q, Authoric.rtian
M-llWE:'l'l BCO BusiuessWorksrrvr 5.4 Esserttictls
Domain Authorization and Access
Page I 24
Users can be granted two levels of access in thc domain:
r U[ Access - [s used to specify access to what intbrmation userscan 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 domainrepositories which are created by the deployments
By default the root administrator has iull access privileges. The rootadministrator can grant full access to other users or can authorizepartial access to the Admin UI and Data. New users created by theadministrator must be granted authorization privileges befbre they canlog in to TIBCO Adminisrraror.
TI BCO Education P ro grams
. TIBCO Administrator access
r For f ull access
- Choose and set "TlBCOAdministrator acccss"
. For limited access
- Choose and set for eachuser you want 10
allow access to
w**uar*uabauuÈìiflft;iiiffi *##i*rl!tt#Éf É@
ó!a
,i& !!@r
E riq tud-ù. M.".""-."r
E ira rd:r tè.re'r
E ;..jttr Mfteoor.Ìrc,":
rl:.; Fur a..r*
r:rff:TTTTf:rrrrtrr:rTTTrr:T
Unit 5: Deplo'-ment aruL McutagemenÍ
u lnventory 0f installedsoftware
. Machine status
i*î::i*ffi::=î:ll##O g r.r.!{(,a,.(-o{*,,":r3
E 4 -r-, "è- -'-ó . ' 1
ug -a.!rq.--r'hs:;:
!e?4qq:e'4
r A :rro. :.,",.,,..,,,,"..,",
r f n*jLilnd-.i-ri..É---
r e.ru
Domain Resource Management
TIBCO Sof'tware Irtc.
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 TIBCOsotiware installed in the domain, including the machines hostingthis sotÌware
As we have already seen, the Applicatbn Managentent consoleprovides authorized users with the ability to monitor and manage
deployed components.
Page Ì25
M -BWE:'l'IBCO Businesslvortsl \r 5.I Esserttittls
Page 126
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 I B C O EtLuccrt i o n P ro g rcu n s
Version ControlCanonrM
Unit 5: Deplot,ment and Mutagentent
Using TIBCO XML
BusinessWorks project metadata is built in XML. TIBCO XMLCanon 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 analyzingXML assets as they exist at any particular stage in the developmcntlifècycle.
Page 127TIBCO Software Inc
' 3W proJect metadala is . XML Canon providesstrongly 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.!€lP.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
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
Why Use XML Canon with BW?
Page l2ll
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.
TI BCO Educatiott Propram s
. XMl-based version control
. Web-based desktop for managing SOA assets
i:.:-:
Lad ch4.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
Lab lntroduction
In the lab that fbllows you learn to deploy and manage aBusi nessWorks orocess.
Unit 5: DepLo,vment u'Ld Management
Page 129TIBCO SoJ'tware Inc
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
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 CheckService
OverviewIn this lab you configure and deploy your BusinessWorks project and practice fundamentalapplication managcment and monitoring techniqucs using TIBCO Administretor.
Objectivest 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
Prerequisitesr 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.htmla Oracle Database
a TIBCO XML Canon http: / / edusvr: 9983r C:\BWEDU lab fìles
r Completion of previous lab exercises
DirectionsComolete the tasks that fbllow.
TIBCO Sofnvare Inc. Page l3l
M-BWE: TIBCO BusinessWorks'tM 5.4 EssentiaLs
Lab C - Exercise 1: Archive CreditCheck 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. eara 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 allshared components required by the Process or Adapter archive.
r Rename the Process Archive resource CreditCheckServiceI In the Processes tab, click the "Add a process starter to this archive" icon:
a Select the intfPerformCreditCheck-service and click OK
p:';J . :
hwpllE5-il e-.n,p.,:0..*
li*:*i Ser'rice:il'+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 : T I B C O B usine s sWo rks't' M 5.4 E s s entials
Lab C - Exercise 2: Deploy CreditCheck 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 > TIBCOAdministrator
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.xxr 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 afterdeployment. Changes made to the EAR file after deployment are notautomatically propagated to the deployed project, this requires re-uploading theupdated 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 andMonitor Credit Check Service
In this exercise you use TIBCO Administrator to perfbrm runtime monitoring and mana-gement ofactive 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 monitoredand 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. ifyou 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 clickClear All, then select only the TestCreditCheck process and click Load Selected.
Test for an "Accepted" credit check using:
a Amount:3000.00a AccountlD: L234L2341234L234Test for a "Rejected" credit check using:
a Amount:4000.00a 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 ondemand, toggle the meter icon in the upper right.
ta'
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, includingdisk and CPU usage statistics
r View installed sotiware:
a Select Resource Management > Installed Software
a This view provides summary information about the TIBCO sofiware componentsinstalled 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). Whendeployed. the domain admin server has a copy oI the deployment delinition in thisAai nte which is used to initialize the componen, u, ,,urrrp. The name of theDOMAIN appears here twice. both as a folder and as the first part of rhe filename. 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_FOLDER 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 adeployed componcnt this script can be used to start the component. This shouldbe done in a command window in order to see stderr startup messages even ifit will not start.
Analysis: A text file containing startup information used by the startup script(CMb file) to obtain deploy"igW
"ngin. configuration intormation frorn in"
admin server. This file also defines the-working !nvironmenr for this componenr.
On the client machine the TIBCO application (engine or adaprer) is deployed to:
C : \ t ibco\ tra\domain\oOuarN_NAME \appI icat ion\DEPLOYMENT_FOLDER NAME\ENTERPRTSE ARCHIVE NA,ME- PROCESS ARCHIVE NAME.TTA
TIBCO Software Inc. Page 139
M - BW E : T I B C O B us iness Works r'rvr 5. 4 Es s e ntiaLs
Lab G - Exercise 4: lmplementProject 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).
From the Designer menu of your bwpXX project, select Project > Save As
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: 9 9 83
- Click Connect
a If prompted, provide your userxX credentials and click OKYou should now have a WebDAV connection to the XML Canon Server tiom Designerevidenced by the userXX category (and others) to which you have access in Canon:
I
T
Analysis: WebDAV (lMeb-based Distributed Authoring and Vcrsioning) is an
e*tension to HTTP that allows document uploads, tocfing und properiy
"lT.b*::lis- version.nuT_9.:.ji:l"il. xML Canon is a webDAV server,
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:9983r 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 notyet 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.. AESchema. folder lìles. global variables). When using XML Canon. you must firstcreate 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 -BW client-siae, yóu. p.o;ea resourc.es are làcked, rndicuring.,,.that they are checked into a revision control system (RCS) and must be acquiredto 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).
TIBCO Education ProgramsPage 142
