Tivoli IBM Tivoli Monitoring for Transaction Performance

Evaluation

Guide

Evaluation

Guide

Note

Beforeusingthisinformationandtheproductitsupports,readtheinformationin“Notices,”onpage39.

FirstEdition(September2004)

ThiseditionappliestoVersion5.3.0ofIBMTivoliMonitoringforTransactionPerformanceandtoallsubsequent releasesandmodificationsuntilotherwiseindicatedinneweditions.

Contents

About

this

guide

.

.

.

.

.

.

.

.

.

.

. v

Performing

an

evaluation

installation

.

. 1

Step1:Checkingtheprerequisites . . . 1

Step2:Installingthemonitoringsoftware. . . 2 Step3:InstallingtheSyntheticTransaction

Investigator . . . 13

Step4.DeployingtheSyntheticTransaction

Investigator . . . 17

Step5.RegisteringtheSyntheticTransaction

Investigator . . . 18

Step6:Recordingandplayingbackatransaction. . 26 Step7:LookingattheresultsoftheSTIplayback. . 35

Appendix.

Notices

.

.

.

.

.

.

.

.

.

. 39

About

this

guide

IBM TivoliMonitoringforTransactionPerformancemanagestheavailabilityand performance ofyourWeband enterpriseapplication environment.Thisguide describes howtoinstall anddeployanevaluationcopyof thesoftwaresothatyou canseeitsperformance andfeatures.

Version5.3succeedsVersion5.2ofIBMTivoliMonitoringforTransaction Performance.

Who

should

read

this

guide

ThisguideisforusersofIBMTivoliMonitoringforTransactionPerformance software whowanttoquickly deployanevaluationcopyof thesoftwarefor proof-of-concept inanon-production environment.

IBM

Tivoli

Monitoring

for

Transaction

Performance

Thefollowingdocuments provideinformationabouttheIBMTivoliMonitoringfor TransactionPerformanceproduct:

v IBMTivoliMonitoringforTransactionPerformanceInstallationandConfiguration

Guide,SC32-9107–00

v IBMTivoliMonitoringforTransactionPerformanceAdministrator’sGuide,

GC32-9189-00

v IBMTivoliMonitoringforTransactionPerformanceProblemDeterminationGuide,

SC32-9108-00

v IBMTivoliMonitoringforTransactionPerformanceEvaluationGuideGC32-9190-00

v IBMTivoliMonitoringforTransactionPerformanceCheckingPerformanceand

Availability,SC32-1385 v

IBM

®_Tivoli® _{MonitoringforTransactionPerformance:WarehouseEnablementPack}

ImplementationGuide, SC32-1388

Accessing

and

ordering

publications

For informationaboutaccessingpublicationsonline andorderingTivoli publications, seetheIBMTivoliMonitoringforTransactionPerformance Administrator’s Guide.

Accessibility

Accessibilityfeatureshelpuserswitha physicaldisability,suchasrestricted mobilityorlimited vision,tousesoftwareproductssuccessfully.For accessibility information,seetheAccessibilityAppendixintheIBMTivoliMonitoringfor TransactionPerformanceAdministrator’s Guide.

Contacting

software

support

Performing

an

evaluation

installation

Thisguidedescribeshow todeployanevaluationcopyoftheIBMTivoli

MonitoringforTransactionPerformancesoftwareina non-productionenvironment ona computerrunningMicrosoft®Windows®.Itprovides theprocedurefor installingthemanagementserverand themanagement agentona singlecomputer withoutimplementingHTTPScommunication.Theevaluationalso includes installingand usingtheSyntheticTransactionInvestigator(STI)torecordand play backa Webtransactionsothatyoucanviewa report.

Note: Whileit ispossibleforthemanagementserverand managementagentto

bothoperateonasinglecomputer,thisconfigurationisnotsupportedfor productionuse.

Whenever possible,this guideshowsanimageof thescreenexactlyasyouneedto fillit in.Whenthatisnotpossible,theinstructionsusethefollowingtypeface conventions:

1. Bold denotesinformationthatyouenterinresponsetoscreenprompts.Check

boxes, pushbuttons,radiobuttons,spinbuttons,fields,folders,icons,list boxes, itemsinside listboxes, multicolumnlists,containers,menuchoices, menunames,tabs,andpropertysheetsalsoappearinbold.

2. Monospaceisusedforcodeexamples,filenames,programmingkeywords,

messagetext, textyoumusttypeat acommandprompt,and prompts. 3. Italicsindicatesemphasisorvariablesyoumustprovide.

Step

1:

Checking

the

prerequisites

Thissectionlists thepermissions,hardwarerequirements,andsoftware prerequisites neededforthis installation.

v Permissions:Membership intheWindowsAdministratorsgroup.

v

Youmust nothaveinstallations ofthefollowing:

– IBM DB2

®

– IBM WebSphereApplicationServer

– AnyTivolisoftware,includingpreviousversionsoftheIBMTivoliMonitoring

forTransactionPerformanceproduct.

v Operatingsystem: Windows2000ServerorAdvancedServer withServicepack

4orWindows2003Server EnterpriseEdition/Server Editionwith Servicepack 1 v Processor:ix86,1.2GHz v Memory:atleast1 GB v DiskSpace:2 GB v Swapspace:400 ® _MB

Step

2:

Installing

the

monitoring

software

Note: Ifyoureceiveanerrormessageduring installation,usethemessage

identifier,suchasBWMIS0103E,tofindadditionalinformationintheIBM TivoliMonitoringforTransactionPerformanceProblemDeterminationGuide.

1. Logontothecomputeryouwanttousefortheevaluationinstallation.

2. Createa directoryondriveCcalledtmtp.

Note: ThisproceduredesignatesC:\astheinstallationdrive;youcan

substituteanotherdrive.

3. Copy theinstallationsoftware toC:\tmtp.

4. Closeanyapplicationsrunningonthecomputer.

5. LaunchC:\tmtp\setup_MS_w32.exetostart theinstallation.

thatyouarenotinstallingfromCD-ROM.

7. Click NexttodisplaytheSoftwareLicenseAgreementwindow.

9. Click Nexttoacceptthedefaultinstallationpath.

10. The systemdisplaystheManagementServer Communicationwindow.Fillin

thefields asshown, acceptthedefaultfortheLicenseKey field,andclick

Next.

11. Thesystem displaystheconfigurationwindow fortheWebSphere

®

passwordyouenteristhepasswordusedbytheWindows administrator.

12. Thesoftware displaystheDatabaseOptions window.SelectInstallDB2and

click Next.

13. The softwaredisplaystheDatabaseUserAccountwindow.Fill inthefieldsas

shown, usingdb2passasthepassword,andclick Next.

14. The softwaredisplaystheDB2InstanceUserscreen.Fill inthefieldsas

shown, usingdb2passasthepassword,andclick Next.

15. Browsetothedirectoryinwhichyoudownloadedtheinstallationimagesof

IBM WebSphereApplicationServer andDB2and clickNext.

16. Click Nexttoaccepttheembeddedproductinstallationdirectories.

17. Click Nextontheconfirmationpanelforthemanagementserver.

The installationbegins.The statusbarshowstheprogressoftheinstallation.

The softwareasksifyouwanttorestarttheWebSphereApplicationServer.

19. Whentheinstallationprogramcompletes,click Finish.

Youare nowreadytosetupthemanagementagent. 20. LaunchC:\tmtp\setup_MA_w32.exe.

21. Click NextintheWelcomewindow todisplaytheSoftwareLicense

Agreementwindow.

22. Select theradiobuttontoacceptthetermsofthelicenseagreementandclick Next.

23. Click Nexttoacceptthedefaultinstallationdirectorypathforthe

management agent.

24. The systemdisplaystheCommunicationwith ManagementServer window.

Fill inthewindowasshown,but:

v UsethepasswordfortheWindowsAdministratorthatyouenteredinStep

11onpage4.

v Useyourcomputer’sfullyqualifiedhostnameorIPaddressatHost Name (fullyqualified).Donotinclude aprotocolinthehostname;type

myserver.ibm.tivoli.com,nothttps://myserver.ibm.tivoli.com

Note: Ifyoudonotknowthehostname, enterhostnameattheDOS

commandprompttodisplayit.YoualsocanuseSettings→Control PanelontheWindowsStart menu;selectSystemandclick the

25. Thesoftware displaystheSpecifyUserAccountwindow.Fillit inasshown,

usingchangeitasthepassword,and clickNext.

26. Click Nexttobegininstallation.

27. Click onFinishtocompletetheinstallation.

The IBMTivoliMonitoringforTransactionPerformance iconisdisplayedonyour desktop.

Youarereadytoinstall theSyntheticTransactionInvestigator.

Step

3:

Installing

the

Synthetic

Transaction

Investigator

ThisprocedureinstallstheSyntheticTransactionInvestigatorsoftwarethatrecords transactionsrepresentingtypicaluser experiencesona Website.Youplayback these recordedtransactionsat scheduledintervalstotestapplication performance. For moreinformationabouttheSyntheticTransactionInvestigator(STI),seethe

IBM TivoliMonitoringforTransactionPerformanceAdministrator’sGuide.

1. Click the

icontostartthesoftware.

2. Thesoftware displaystheLogOn window.EntertheWindowsAdministrator

user nameand passwordand clickLogOn.

The softwaredisplaystheWelcomewindow.

3. From theMyWorkpane,selectDownloads→DownloadSTIRecorder.

4. Click thesetup_sti_recorder.exedownloadlink.

5. Click SaveintheFileDownloadwindow.

6. Select theC:\tempdirectoryandclick Save.

7. AccessC:\tempanddouble-click onsetup_sti_recorder.exetostart the

8. Click NextontheWelcomewindowtodisplaythelicenseagreementwindow.

9. Click NexttoacceptthedefaultdirectoryfortheSTIinstallation.

10. Fill inthewindowasshown,usingthehost namethatyouenteredforStep24

onpage10and clickNext.

11. Click Nexttostart theinstallation.

Youare nowreadytodeploytheSyntheticTransactionInvestigatortothe management agent..

Step

4.

Deploying

the

Synthetic

Transaction

Investigator

AfterinstallingtheSTIrecorder,youmust deploythecomponenttothe management agent.

1. IfyouexitedtheIBMTivoliMonitoringforTransactionPerformance software,

clickthe

iconandlogon.

2. FromtheMyWork pane,selectSystemAdministration→WorkwithAgents.

Thesoftwaredisplays theWorkwithAgentswindow withtheagentthatyou set up.

followingone,clickGo.

4. ClickOK todeploytheSTI component.

5. ClickOK intheAreyousure?box.

Note: Thesystemrebootstocompletetheoperation.

The softwaredeploystheSTIcomponenttothemanagement agentand returnsto theWorkwithAgentswindow.Youare nowreadytoregistertheSynthetic TransactionInvestigator.

Step

5.

Registering

the

Synthetic

Transaction

Investigator

1. AccessthedirectorywheretheWindowssystem isinstalled.

2. Double-clicktheDCOMCNFG.EXEfiletoopentheDistributedCOM

ConfigurationPropertieswindow.

3. Click theDefaultSecuritytab.

4. IntheDefaultAccessPermissionspane,click theEditDefault buttonto

displaytheRegistryValue Permissionswindow.

5. Click AddtodisplaytheAddUsersandGroupswindow.Thecomputeron

InvestigatorshouldbeintheListNamesfrom field.Ifitisnot,selectit.

6. Click ShowUsersandhighlightTMTPAgent.

7. Click AddtoputTMTPAgentintheAddNamesbox.Usethedefaultaccess, Allow Launch.

8. Click OKontheAddUsersand Groupswindow.

9. Click OKontheRegistry ValuePermissionswindow.

10. Click ApplyontheDistributedCOMConfigurationPropertieswindow.

11. Click theEdit DefaultbuttonintheDefaultLaunchPermissionsgroup.

12. RepeatSteps5 through9.

13. Click theEditDefaultbuttonintheDefaultConfigurationPermissions

group.

15. ChangeTypeofAccesstoFullControl.

16. Click OKontheAddUsersand Groupswindow.

17. Click OKontheRegistry KeyPermissionswindow.

18. Click OKontheDistributedCOMConfigurationPropertieswindow.

19. Rebootyour computer.

20. AfteryoulogbackintoWindows,restart theWebSphereApplicationServer

with theStarttheServeroption.

c. From a commandprompt,accessC:\ProgramFiles\internet

explorer\connection wizard.

d. Enterinetwiz.exeand followthewizarddirections.

e. LogoffasTMTPAgentfromWindows.

f. LogonasAdministrator.

Step

6:

Recording

and

playing

back

a

transaction

Thisprocedurerecordsand playsbackanSTItransactionthatgeneratesdatayou canview withtheSTIChartreport.

1. Click Start→ Programs→ Tivoli→SyntheticTransactionInvestigator Recorder.

The STIRecorderwindow opens.

2. Type http://pathname_name_to_your_management_server:9082/tmtpUI/LogOn.jsp

at theLocationfield.

3. Click theLocationbutton.

Note: TheDoneindicatorintheProgressfieldshowswhena pagefinishes

4. Enteryour logonnameandpasswordasshownandclick LogOn

.

The STIrecorderlogsontoIBMTivoli MonitoringforTransaction

Performance andrecordsthesteps.Waituntil theDoneindicatorisdisplayed in theProgressfield.

5. WhentheDoneindicatorisdisplayed, clickSaveTransactiontodisplaythe

CreateSTITransactionRecordingwindow.

6. Type TivoliSTIexampleintheTransactionNamefield.

7. Click OK.Thesoftwaredisplaysa messagetellingyouthetransactionwas

successfullysaved.

8. ClosetheSTIRecorderwindowbyclickingon

. Youare nowreadytocreatetheplaybackpolicy. 9. Ifyouexitedthemonitoringsoftware,clickonthe

iconandlogon. 10. From theMyWorkpane,clickConfiguration →WorkwithPlaybackPolicies.

11. Click onCreateNew.

12. Make surethewindowisfilledinexactlyasyouseeit inthefollowing

example andclickNext.

13. Thesoftware displaystheConfigureSTISettingswindow.ClickCreate.

14. Fill intheCreateSTIThresholdwindowasshown andclickApplytosave

your settings.

15. Click NexttodisplaytotheWorkwithSchedules window.

16. Click CreateNewtodisplaytheConfigureSchedule(PlaybackPolicy)

window.

17. Fill intheConfigureSchedule(PlaybackPolicy)window exactlyasshown and

click Apply.

18. Click NexttodisplaytheWorkwithAgentGroupswindow.

19. Click CreateNewtoopentheConfigureAgentGroupwindow.

20. Fill inthefieldsasshownand clickApply.

21. Click NexttodisplaytheworkwithPolicyGroupswindow.

22. Click CreateNewtodisplayConfigurePolicyGroupwindow.

23. Fill inthefieldsexactlyasshown andclickApply.

The softwaredisplaysamessage tellingyoutheinformationwassuccessfully saved.

25. Fill inthefieldsasshownand clickFinish.

Thesoftware displaysthefollowingwindow.

Afterapproximately30minutes,go to“Step7:Lookingat theresultsoftheSTI playback.”

Step

7:

Looking

at

the

results

of

the

STI

playback

theAltkeyonthekeyboardandusingthemousetomovearound inthechart. Additionally,youcanright-clickonthechartto choosefromotherSVGViewer optionssuchasZoom.

1. From theMy Workpanel,selectReports→ViewBigBoard.

Thesoftwaredisplays theBigBoardwitha warningfortheTivoliPolicypolicy.

ToseeallthecolumnsoftheBigBoard,usethescrollbarstoscrollacrossthe screen.

Status Showstheperformance statusbasedonthresholdsdefinedforthe policy,inthiscaseawarning.

Policy Identifiesthepolicythatisinviolation.

ManagementAgent

Identifiesthenameof themanagement agentrunningthepolicywhen thereportedeventwas generated.

Component

EventTime

Showsthedateandtimewhenthereportedeventoccurred.

Duration

Showsthelengthof timeinsecondsthatthetransactionlasted.

Threshold

Identifiesthenumberofsecondsoftheconditionthattriggeredthe event,asdefinedbythethreshold.Itcontainsadescriptionofthe thresholdthatcausedthestatustochange.Status changesarebased on thresholdviolationsorrecoveries.Ifthis columnisblank,thereareno thresholdviolations.

Avg(Min/Max)

Showsaverageaggregateperformance timecollectedduringtheupload period,followed(inparentheses)bytheminimumand maximum aggregateperformancetimes.Thiscolumn populatesfromthedata uploadedto themanagement server.Ifnodatauploadoccurred,this fieldisblank.

Time Showsthetimeoftheuploadduringwhichtheaverage,minimum,and maximumaggregatedatawascollected. Thistimemightbe laterthan thetimeoftheevent shownintheEventTimecolumn.Average, minimum,andmaximumaggregatedataupdatesat eachnew upload. Thiscolumnpopulatesfromthedatauploadedtothemanagement server.Ifnodataupload occurred,thisfieldisblank.

EventTransaction

Displaysthetransactionorsubtransactionthattriggereda violationor recoveryevent.

2. Clickonthe

icon.

Thesystemdisplays theSTIBarChart.

v Yellowbarsindicatethattherewasaperformance thresholdviolation.

v Adashedbar

meansatransactionwasinviolation,andthereisno timingdatatoreport.Inthis case,noneofthetoolbariconswork,but clickingonthedashedbardisplays atopologyview.

v

Green barsindicatethatthetransactionperformedasexpectedwithno

violations.

v Red barsindicateanavailabilityviolation;thetransactionfailedtoexecute

successfully.

3. Clickanywhereinthetransactionbartodisplaythesubtransactions.

Appendix.

Notices

Thisinformationwasdevelopedforproductsandservices offeredintheU.S.A. IBM maynotoffertheproducts,services,orfeaturesdiscussedinthisdocumentin othercountries.Consultyour localIBMrepresentativeforinformationonthe productsand servicescurrentlyavailableinyourarea.Anyreferencetoan IBM product, program,orserviceisnotintendedtostateorimplythatonlythatIBM product, program,orservicemaybe used.Anyfunctionallyequivalentproduct, program, orservicethatdoesnotinfringeanyIBMintellectualpropertyrightmay be usedinstead.However, itistheuser’sresponsibility toevaluateandverifythe operationofanynon-IBMproduct,program, orservice.

IBM mayhavepatentsorpendingpatent applicationscoveringsubjectmatter described inthisdocument.Thefurnishingofthisdocumentdoesnotgiveyou anylicensetothesepatents.Youcansend licenseinquiries,inwriting,to: IBM Director of Licensing

IBM Corporation North Castle Drive

Armonk, NY 10504-1785 U.S.A.

For licenseinquiriesregardingdouble-byte(DBCS)information,contacttheIBM IntellectualProperty Departmentinyourcountryorsendinquiries,in writing,to: IBM World Trade Asia Corporation

Licensing

2-31 Roppongi 3-chome, Minato-ku Tokyo 106, Japan

Thefollowingparagraphdoesnotapplyto theUnited Kingdomor anyother country wheresuchprovisionsareinconsistentwithlocallaw:

INTERNATIONALBUSINESSMACHINESCORPORATIONPROVIDES THIS PUBLICATION″ASIS″WITHOUTWARRANTYOFANYKIND,EITHER EXPRESSORIMPLIED,INCLUDING,BUTNOTLIMITED TO,THEIMPLIED WARRANTIESOFNON-INFRINGEMENT,MERCHANTABILITYORFITNESS FORAPARTICULARPURPOSE.

Some statesdonotallowdisclaimerofexpressorimpliedwarrantiesincertain transactions,therefore,this statementmight notapplytoyou.

Thisinformationcouldinclude technicalinaccuraciesortypographicalerrors. Changes areperiodicallymadetotheinformationherein;these changeswillbe incorporatedinneweditionsof thepublication.IBM maymakeimprovements and/or changesintheproduct(s)and/ortheprogram(s)describedinthis publication atanytimewithoutnotice.

Anyreferencesinthisinformationtonon-IBMWebsitesareprovidedfor

IBM mayuseordistribute anyoftheinformationyousupplyinanywayit believes appropriatewithoutincurringanyobligationtoyou.

Licensees ofthisprogramwhowishtohaveinformationaboutit forthepurpose of enabling:(i)theexchangeofinformationbetweenindependentlycreated programs andotherprograms(includingthis one)and(ii)themutualuseofthe informationwhichhasbeenexchanged,shouldcontact:

IBM Corporation 2Z4A/101

11400 Burnet Road

Austin, TX 78758 U.S.A.

Such informationmaybeavailable,subjecttoappropriatetermsandconditions, includinginsomecasespaymentofafee.

The licensedprogramdescribedinthis documentandalllicensedmaterial

available foritareprovidedbyIBMundertermsoftheIBMCustomerAgreement, IBM InternationalProgramLicenseAgreementoranyequivalentagreement betweenus.

Anyperformancedatacontained hereinwas determinedinacontrolled

environment.Therefore,theresultsobtained inotheroperatingenvironmentsmay vary significantly.Somemeasurementsmayhavebeenmadeondevelopment-level systemsandthereisnoguaranteethatthesemeasurementswillbethesameon generallyavailable systems.Furthermore,somemeasurementmayhavebeen estimatedthrough extrapolation.Actualresultsmayvary.Usersof thisdocument shouldverifytheapplicabledatafortheirspecific environment.

Informationconcerningnon-IBMproductswasobtained fromthesuppliers of those products,theirpublished announcementsorotherpubliclyavailablesources. IBM hasnottestedthoseproductsandcannotconfirmtheaccuracy of

performance, compatibilityoranyotherclaims relatedtonon-IBMproducts. Questionsonthecapabilitiesofnon-IBMproductsshouldbe addressedtothe suppliers ofthoseproducts.

All statementsregardingIBM’sfuturedirectionorintentaresubjecttochangeor withdrawal withoutnotice,andrepresentgoalsandobjectivesonly.

All IBMprices shownareIBM’ssuggestedretailprices,arecurrentandare subject tochange withoutnotice.Dealerprices mayvary.

Thisinformationisforplanningpurposesonly.Theinformationhereinissubjectto changebefore theproductsdescribed becomeavailable.

Thisinformationcontainsexamples ofdataandreportsusedindailybusiness operations.Toillustratethemascompletelyaspossible,theexamples includethe namesof individuals,companies,brands,and products.Allofthesenamesare fictitiousand anysimilaritytothenamesandaddressesusedbyanactualbusiness enterpriseisentirelycoincidental.

Trademarks

IBM DB2,IBM,theIBMlogo,Tivoli,theTivolilogo,TivoliEnterpriseConsole®_,

and WebSphereare trademarksor registeredtrademarksofInternationalBusiness MachinesCorporationintheUnitedStates,othercountries,orboth.

Microsoft andWindowsNT®_{are registeredtrademarksof MicrosoftCorporationin}

theUnitedStates,othercountries,orboth.

Java™andallJava-basedtrademarksandlogos aretrademarksor registeredtrademarksofSunMicrosystems,Inc.intheUnited States, othercountries,or both.



PrintedinUSA