Tivoli IBM Tivoli Monitoring for Transaction Performance Version 5.3.0 Evaluation Guide GC32-9190-00
Tivoli IBM Tivoli Monitoring for Transaction Performance Version 5.3.0 Evaluation Guide GC32-9190-00
Note Before using this information and the product it supports, read the information in Notices, on page 39. First Edition (September 2004) This edition applies to Version 5.3.0 of IBM Tivoli Monitoring for Transaction Performance and to all subsequent releases and modifications until otherwise indicated in new editions. Copyright International Business Machines Corporation 2004. All rights reserved. US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
Contents About this guide........... v Performing an evaluation installation.. 1 Step 1: Checking the prerequisites.......1 Step 2: Installing the monitoring software.....2 Step 3: Installing the Synthetic Transaction Investigator..............13 Step 4. Deploying the Synthetic Transaction Investigator..............17 Step 5. Registering the Synthetic Transaction Investigator..............18 Step 6: Recording and playing back a transaction..26 Step 7: Looking at the results of the STI playback..35 Appendix. Notices.......... 39 Trademarks..............41 iii
iv IBM Tivoli Monitoring for Transaction Performance: Evaluation Guide
About this guide Who should read this guide IBM Tivoli Monitoring for Transaction Performance manages the availability and performance of your Web and enterprise application environment. This guide describes how to install and deploy an evaluation copy of the software so that you can see its performance and features. Version 5.3 succeeds Version 5.2 of IBM Tivoli Monitoring for Transaction Performance. This guide is for users of IBM Tivoli Monitoring for Transaction Performance software who want to quickly deploy an evaluation copy of the software for proof-of-concept in a non-production environment. IBM Tivoli Monitoring for Transaction Performance The following documents provide information about the IBM Tivoli Monitoring for Transaction Performance product: v IBM Tivoli Monitoring for Transaction Performance Installation and Configuration Guide, SC32-9107 00 v IBM Tivoli Monitoring for Transaction Performance Administrator s Guide, GC32-9189-00 v IBM Tivoli Monitoring for Transaction Performance Problem Determination Guide, SC32-9108-00 v IBM Tivoli Monitoring for Transaction Performance Evaluation Guide GC32-9190-00 v IBM Tivoli Monitoring for Transaction Performance Checking Performance and Availability, SC32-1385 v IBM Tivoli Monitoring for Transaction Performance: Warehouse Enablement Pack Implementation Guide, SC32-1388 Accessing and ordering publications For information about accessing publications online and ordering Tivoli publications, see the IBM Tivoli Monitoring for Transaction Performance Administrator s Guide. Accessibility Accessibility features help users with a physical disability, such as restricted mobility or limited vision, to use software products successfully. For accessibility information, see the Accessibility Appendix in the IBM Tivoli Monitoring for Transaction Performance Administrator s Guide. Contacting software support For information about how to contact customer support, see the IBM Tivoli Monitoring for Transaction Performance Problem Determination Guide. v
vi IBM Tivoli Monitoring for Transaction Performance: Evaluation Guide
Performing an evaluation installation This guide describes how to deploy an evaluation copy of the IBM Tivoli Monitoring for Transaction Performance software in a non-production environment on a computer running Microsoft Windows. It provides the procedure for installing the management server and the management agent on a single computer without implementing HTTPS communication. The evaluation also includes installing and using the Synthetic Transaction Investigator (STI) to record and play back a Web transaction so that you can view a report. Note: While it is possible for the management server and management agent to both operate on a single computer, this configuration is not supported for production use. Whenever possible, this guide shows an image of the screen exactly as you need to fill it in. When that is not possible, the instructions use the following typeface conventions: 1. Bold denotes information that you enter in response to screen prompts. Check boxes, push buttons, radio buttons, spin buttons, fields, folders, icons, list boxes, items inside list boxes, multicolumn lists, containers, menu choices, menu names, tabs, and property sheets also appear in bold. 2. Monospace is used for code examples, file names, programming keywords, message text, text you must type at a command prompt, and prompts. 3. Italics indicates emphasis or variables you must provide. Step 1: Checking the prerequisites This section lists the permissions, hardware requirements, and software prerequisites needed for this installation. v Permissions: Membership in the Windows Administrators group. v You must not have installations of the following: IBM DB2 IBM WebSphere Application Server Any Tivoli software, including previous versions of the IBM Tivoli Monitoring for Transaction Performance product. v Operating system: Windows 2000 Server or Advanced Server with Service pack 4 or Windows 2003 Server Enterprise Edition/Server Edition with Service pack 1 v Processor: ix86, 1.2GHz v Memory: at least 1 GB v Disk Space: 2 GB v Swap space: 400 MB v Ports: Make sure the following ports are available: 8880, 9081, 9082, 9090 1
Step 2: Installing the monitoring software Note: If you receive an error message during installation, use the message identifier, such as BWMIS0103E, to find additional information in the IBM Tivoli Monitoring for Transaction Performance Problem Determination Guide. 1. Log on to the computer you want to use for the evaluation installation. 2. Create a directory on drive C called tmtp. Note: This procedure designates C:\ as the installation drive; you can substitute another drive. 3. Copy the installation software to C:\tmtp. 4. Close any applications running on the computer. 5. Launch C:\tmtp\setup_MS_w32.exe to start the installation. 6. Click Next to display the embedded installation screen. Click Perform Embedded Installation Using CD-ROMS to clear the check box to indicate 2 IBM Tivoli Monitoring for Transaction Performance: Evaluation Guide
that you are not installing from CD-ROM. 7. Click Next to display the Software License Agreement window. 8. Select the radio button to accept the terms of the license agreement and click Next. Performing an evaluation installation 3
9. Click Next to accept the default installation path. 10. The system displays the Management Server Communication window. Fill in the fields as shown, accept the default for the License Key field, and click Next. 11. The system displays the configuration window for the WebSphere Application Server installation. Fill in the fields as shown and click Next. The 4 IBM Tivoli Monitoring for Transaction Performance: Evaluation Guide
password you enter is the password used by the Windows administrator. 12. The software displays the Database Options window. Select Install DB2 and click Next. Performing an evaluation installation 5
13. The software displays the Database User Account window. Fill in the fields as shown, using db2pass as the password, and click Next. 14. The software displays the DB2 Instance User screen. Fill in the fields as shown, using db2pass as the password, and click Next. 6 IBM Tivoli Monitoring for Transaction Performance: Evaluation Guide
15. Browse to the directory in which you downloaded the installation images of IBM WebSphere Application Server and DB2 and click Next. 16. Click Next to accept the embedded product installation directories. Performing an evaluation installation 7
17. Click Next on the confirmation panel for the management server. The installation begins. The status bar shows the progress of the installation. The software asks if you want to restart the WebSphere Application Server. 18. Click Yes to restart the WebSphere Application Server. 8 IBM Tivoli Monitoring for Transaction Performance: Evaluation Guide
19. When the installation program completes, click Finish. You are now ready to set up the management agent. 20. Launch C:\tmtp\setup_MA_w32.exe. 21. Click Next in the Welcome window to display the Software License Agreement window. 22. Select the radio button to accept the terms of the license agreement and click Next. Performing an evaluation installation 9
23. Click Next to accept the default installation directory path for the management agent. 24. The system displays the Communication with Management Server window. Fill in the window as shown, but: v Use the password for the Windows Administrator that you entered in Step 11 on page 4. v Use your computer s fully qualified host name or IP address at Host Name (fully qualified). Do not include a protocol in the host name; type myserver.ibm.tivoli.com, not https://myserver.ibm.tivoli.com Note: If you do not know the host name, enter hostname at the DOS command prompt to display it. You also can use Settings Control Panel on the Windows Start menu; select System and click the Network Identification tab. 10 IBM Tivoli Monitoring for Transaction Performance: Evaluation Guide
25. The software displays the Specify User Account window. Fill it in as shown, using changeit as the password, and click Next. Performing an evaluation installation 11
26. Click Next to begin installation. 27. Click on Finish to complete the installation. The IBM Tivoli Monitoring for Transaction Performance icon is displayed on your desktop. 12 IBM Tivoli Monitoring for Transaction Performance: Evaluation Guide
You are ready to install the Synthetic Transaction Investigator. Step 3: Installing the Synthetic Transaction Investigator This procedure installs the Synthetic Transaction Investigator software that records transactions representing typical user experiences on a Web site. You play back these recorded transactions at scheduled intervals to test application performance. For more information about the Synthetic Transaction Investigator (STI), see the IBM Tivoli Monitoring for Transaction Performance Administrator s Guide. 1. Click the icon to start the software. 2. The software displays the Log On window. Enter the Windows Administrator user name and password and click Log On. Performing an evaluation installation 13
The software displays the Welcome window. 3. From the My Work pane, select Downloads Download STI Recorder. 4. Click the setup_sti_recorder.exe download link. 5. Click Save in the File Download window. 6. Select the C:\temp directory and click Save. 7. Access C:\temp and double-click on setup_sti_recorder.exe to start the installation wizard. 14 IBM Tivoli Monitoring for Transaction Performance: Evaluation Guide
8. Click Next on the Welcome window to display the license agreement window. 9. Click Next to accept the default directory for the STI installation. The software displays the Management Server Information window. Performing an evaluation installation 15
10. Fill in the window as shown, using the host name that you entered for Step 24 on page 10 and click Next. 11. Click Next to start the installation. 12. Click Finish to complete the installation. 16 IBM Tivoli Monitoring for Transaction Performance: Evaluation Guide
You are now ready to deploy the Synthetic Transaction Investigator to the management agent.. Step 4. Deploying the Synthetic Transaction Investigator After installing the STI recorder, you must deploy the component to the management agent. 1. If you exited the IBM Tivoli Monitoring for Transaction Performance software, click the icon and log on. 2. From the My Work pane, select System Administration Work with Agents. The software displays the Work with Agents window with the agent that you set up. 3. Select your management agent and choose Deploy Synthetic Transaction Investigator from the drop-down list. When the window looks like the Performing an evaluation installation 17
following one, click Go. 4. Click OK to deploy the STI component. 5. Click OK in the Are you sure? box. Note: The system reboots to complete the operation. The software deploys the STI component to the management agent and returns to the Work with Agents window. You are now ready to register the Synthetic Transaction Investigator. Step 5. Registering the Synthetic Transaction Investigator The distributed component object model (DCOM) enables communication across the network on Windows. This procedure adds the STI Player account to the DCOM launch and access permissions. 18 IBM Tivoli Monitoring for Transaction Performance: Evaluation Guide
1. Access the directory where the Windows system is installed. 2. Double-click the DCOMCNFG.EXE file to open the Distributed COM Configuration Properties window. Performing an evaluation installation 19
3. Click the Default Security tab. 20 IBM Tivoli Monitoring for Transaction Performance: Evaluation Guide
4. In thedefault Access Permissions pane, click the Edit Default button to display the Registry Value Permissions window. 5. Click Add to display the Add Users and Groups window. The computer on which you installed the management agent and the Synthetic Transaction Performing an evaluation installation 21
Investigator should be in the List Names from field. If it is not, select it. 22 IBM Tivoli Monitoring for Transaction Performance: Evaluation Guide
6. Click Show Users and highlight TMTPAgent. Performing an evaluation installation 23
7. Click Add to put TMTPAgent in the Add Names box. Use the default access, Allow Launch. 8. Click OK on the Add Users and Groups window. 9. Click OK on the Registry Value Permissions window. 10. Click Apply on the Distributed COM Configuration Properties window. 11. Click the Edit Default button in the Default Launch Permissions group. 12. Repeat Steps 5 through 9. 13. Click the Edit Default button in the Default Configuration Permissions group. 14. Repeat Steps 5 through 9. 24 IBM Tivoli Monitoring for Transaction Performance: Evaluation Guide
15. Change Type of Access to Full Control. 16. Click OK on the Add Users and Groups window. 17. Click OK on the Registry Key Permissions window. 18. Click OK on the Distributed COM Configuration Properties window. 19. Reboot your computer. 20. After you log back into Windows, restart the WebSphere Application Server with the Start the Server option. 21. Set the permission for Internet Explorer to use TMTPAgent. a. Log off as Administrator from Windows. b. Log on Windows as TMTPAgent with changeit as the password, Performing an evaluation installation 25
c. From a command prompt, access C:\Program Files\internet explorer\connection wizard. d. Enter inetwiz.exe and follow the wizard directions. e. Log off as TMTPAgent from Windows. f. Log on as Administrator. Step 6: Recording and playing back a transaction This procedure records and plays back an STI transaction that generates data you can view with the STI Chart report. 1. Click Start Programs Tivoli Synthetic Transaction Investigator Recorder. The STI Recorder window opens. 26 IBM Tivoli Monitoring for Transaction Performance: Evaluation Guide
2. Type http://pathname_name_to_your_management_server:9082/tmtpui/logon.jsp at the Location field. 3. Click the Location button. Note: The Done indicator in the Progress field shows when a page finishes loading. Do not do anything until the Done indicator is displayed. The software displays the IBM Tivoli Monitoring for Transaction Performance Log On screen. Performing an evaluation installation 27
4. Enter your logon name and password as shown and click Log On. The STI recorder logs on to IBM Tivoli Monitoring for Transaction Performance and records the steps. Wait until the Done indicator is displayed in the Progress field. 28 IBM Tivoli Monitoring for Transaction Performance: Evaluation Guide
5. When the Done indicator is displayed, click Save Transaction to display the Create STI Transaction Recording window. 6. Type TivoliSTIexample in the Transaction Name field. 7. Click OK. The software displays a message telling you the transaction was successfully saved. 8. Close the STI Recorder window by clicking on. You are now ready to create the playback policy. 9. If you exited the monitoring software, click on the icon and log on. 10. From the My Work pane, click Configuration Work with Playback Policies. The software displays the Work with Playback Policies window. STI is the default. Performing an evaluation installation 29
11. Click on Create New. 12. Make sure the window is filled in exactly as you see it in the following example and click Next. 30 IBM Tivoli Monitoring for Transaction Performance: Evaluation Guide
13. The software displays the Configure STI Settings window. Click Create. 14. Fill in the Create STI Threshold window as shown and click Apply to save your settings. Performing an evaluation installation 31
15. Click Next to display to the Work with Schedules window. 16. Click Create New to display the Configure Schedule (Playback Policy) window. 17. Fill in the Configure Schedule (Playback Policy) window exactly as shown and click Apply. The system displays a message telling you the settings were successfully applied. 32 IBM Tivoli Monitoring for Transaction Performance: Evaluation Guide
18. Click Next to display the Work with Agent Groups window. 19. Click Create New to open the Configure Agent Group window. 20. Fill in the fields as shown and click Apply. The software displays a message telling you the information was successfully saved. Performing an evaluation installation 33
21. Click Next to display the work with Policy Groups window. 22. Click Create New to display Configure Policy Group window. 23. Fill in the fields exactly as shown and click Apply. The software displays a message telling you the information was successfully saved. 24. Click Next to display the Assign Name window. 34 IBM Tivoli Monitoring for Transaction Performance: Evaluation Guide
25. Fill in the fields as shown and click Finish. The software displays the following window. After approximately 30 minutes, go to Step 7: Looking at the results of the STI playback. Step 7: Looking at the results of the STI playback You can use the STI bar chart to investigate the performance and availability of a transaction and its subtransactions played back by the Synthetic Transaction Investigator (STI) over a specified period of time. The STI bar chart displays aggregate data, not instance data. Aggregate is a composite representation of all transactions monitored by the policy during a specified time. The charts use the Adobe SVG Viewer. If you have several (more than 10) subtransactions, you can use the SVG Viewer s built-in pan functions to navigate the chart and view all transactions including data that is off the page by holding Performing an evaluation installation 35
the Alt key on the keyboard and using the mouse to move around in the chart. Additionally, you can right-click on the chart to choose from other SVG Viewer options such as Zoom. 1. From the My Work panel, select Reports View Big Board. The software displays the Big Board with a warning for the Tivoli Policy policy. To see all the columns of the Big Board, use the scroll bars to scroll across the screen. Status Shows the performance status based on thresholds defined for the policy, in this case a warning. Policy Identifies the policy that is in violation. Management Agent Identifies the name of the management agent running the policy when the reported event was generated. Component Tells you that an STI playback policy discovered the violation. 36 IBM Tivoli Monitoring for Transaction Performance: Evaluation Guide
Event Time Shows the date and time when the reported event occurred. Duration Shows the length of time in seconds that the transaction lasted. Threshold Identifies the number of seconds of the condition that triggered the event, as defined by the threshold. It contains a description of the threshold that caused the status to change. Status changes are based on threshold violations or recoveries. If this column is blank, there are no threshold violations. Avg (Min/Max) Shows average aggregate performance time collected during the upload period, followed (in parentheses) by the minimum and maximum aggregate performance times. This column populates from the data uploaded to the management server. If no data upload occurred, this field is blank. Time Shows the time of the upload during which the average, minimum, and maximum aggregate data was collected. This time might be later than the time of the event shown in the Event Time column. Average, minimum, and maximum aggregate data updates at each new upload. This column populates from the data uploaded to the management server. If no data upload occurred, this field is blank. Event Transaction Displays the transaction or subtransaction that triggered a violation or recovery event. 2. Click on the icon. The system displays the STI Bar Chart. Each color-coded bar represents a transaction playback aggregate hour that occurred. The bar height corresponds to the number of seconds in the performance time of that playback. The bar color indicates whether a threshold or availability violation occurred. Performing an evaluation installation 37
v Yellow bars indicate that there was a performance threshold violation. v A dashed bar means a transaction was in violation, and there is no timing data to report. In this case, none of the toolbar icons work, but clicking on the dashed bar displays a topology view. v Green bars indicate that the transaction performed as expected with no violations. v Red bars indicate an availability violation; the transaction failed to execute successfully. 3. Click anywhere in the transaction bar to display the subtransactions. 38 IBM Tivoli Monitoring for Transaction Performance: Evaluation Guide
Appendix. Notices This information was developed for products and services offered in the U.S.A. IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user s responsibility to evaluate and verify the operation of any non-ibm product, program, or service. IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not give you any license to these patents. You can send license inquiries, in writing, to: IBM Director of Licensing IBM Corporation North Castle Drive Armonk, NY 10504-1785 U.S.A. For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to: IBM World Trade Asia Corporation Licensing 2-31 Roppongi 3-chome, Minato-ku Tokyo 106, Japan The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION AS IS WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement might not apply to you. This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice. Any references in this information to non-ibm Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk. 39
IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you. Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact: IBM Corporation 2Z4A/101 11400 Burnet Road Austin, TX 78758 U.S.A. Such information may be available, subject to appropriate terms and conditions, including in some cases payment of a fee. The licensed program described in this document and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement or any equivalent agreement between us. Any performance data contained herein was determined in a controlled environment. Therefore, the results obtained in other operating environments may vary significantly. Some measurements may have been made on development-level systems and there is no guarantee that these measurements will be the same on generally available systems. Furthermore, some measurement may have been estimated through extrapolation. Actual results may vary. Users of this document should verify the applicable data for their specific environment. Information concerning non-ibm products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-ibm products. Questions on the capabilities of non-ibm products should be addressed to the suppliers of those products. All statements regarding IBM s future direction or intent are subject to change or withdrawal without notice, and represent goals and objectives only. All IBM prices shown are IBM s suggested retail prices, are current and are subject to change without notice. Dealer prices may vary. This information is for planning purposes only. The information herein is subject to change before the products described become available. This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental. If you are viewing this information in softcopy form, the photographs and color illustrations might not display. 40 IBM Tivoli Monitoring for Transaction Performance: Evaluation Guide
Trademarks IBM DB2, IBM, the IBM logo, Tivoli, the Tivoli logo, Tivoli Enterprise Console, and WebSphere are trademarks or registered trademarks of International Business Machines Corporation in the United States, other countries, or both. Microsoft and Windows NT are registered trademarks of Microsoft Corporation in the United States, other countries, or both. Java and all Java-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States, other countries, or both. Other company, product, and service names may be trademarks or service marks of others. Appendix. Notices 41
42 IBM Tivoli Monitoring for Transaction Performance: Evaluation Guide
Printed in USA GC32-9190-00