7/31/2019 Solution Deployment Guide for IBM Tivoli Composite Application Manager for WebSphere Sg247293
1/136
ibm.com/redbooks
Solution Deployment Guide forIBM Tivoli Composite ApplicationManager for WebSphere
Budi Darmawan
Quickly start a services engagement
with ITCAM for WebSphere
Statement of work samples and
scope development assistance
Includes sample code and
installation instructions
Front cover
http://www.redbooks.ibm.com/http://www.redbooks.ibm.com/http://www.redbooks.ibm.com/http://www.redbooks.ibm.com/7/31/2019 Solution Deployment Guide for IBM Tivoli Composite Application Manager for WebSphere Sg247293
2/136
7/31/2019 Solution Deployment Guide for IBM Tivoli Composite Application Manager for WebSphere Sg247293
3/136
Solution Deployment Guide for IBM TivoliComposite Application Manager for WebSphere
December 2006
International Technical Support Organization
SG24-7293-00
7/31/2019 Solution Deployment Guide for IBM Tivoli Composite Application Manager for WebSphere Sg247293
4/136
Copyright International Business Machines Corporation 2006. All rights reserved.
Note to U.S. Government Users Restricted Rights -- Use, duplication or disclosure restricted by GSA ADPSchedule Contract with IBM Corp.
First Edition (December 2006)
This edition applies to Version 6, Release 0 of IBM Tivoli Composite Application Manager forWebSphere (product number 5724-L62).
Note: Before using this information and the product it supports, read the information inNotices on page vii.
7/31/2019 Solution Deployment Guide for IBM Tivoli Composite Application Manager for WebSphere Sg247293
5/136
Copyright IBM Corp. 2006. All rights reserved. iii
Contents
Notices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viiTrademarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viii
Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ixThe team that wrote this book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix
Become a published author . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xComments welcome. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . x
Chapter 1. IBM Tivoli Composite Application Manager for WebSphere
solution offering . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11.1 Services solution overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21.2 ITCAM for WebSphere concepts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
1.2.1 Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31.2.2 Supported platform overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
1.3 ITCAM for WebSphere solution. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91.3.1 Solution overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101.3.2 Software components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
1.3.3 Suggested hardware configuration . . . . . . . . . . . . . . . . . . . . . . . . . . 101.4 Document organization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Chapter 2. Planning for customer engagement . . . . . . . . . . . . . . . . . . . . . 132.1 Services engagement preparation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
2.1.1 Implementation skills. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142.1.2 Available resources. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
2.2 Solution scope and components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152.2.1 Basic solution definition. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
2.2.2 Cross-sell and up-sell opportunities . . . . . . . . . . . . . . . . . . . . . . . . . 162.3 Services engagement overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
2.3.1 Executive Assessment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
2.3.2 Demonstration system setup. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182.3.3 Analyze solution tasks. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192.3.4 Creating a contract . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
2.4 Defining solution timing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212.4.1 Environment analysis tasks. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232.4.2 WebSphere application management tasks . . . . . . . . . . . . . . . . . . . 26
2.5 Statement of work . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292.5.1 Environment analysis service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292.5.2 WebSphere application management service. . . . . . . . . . . . . . . . . . 33
7/31/2019 Solution Deployment Guide for IBM Tivoli Composite Application Manager for WebSphere Sg247293
6/136
iv Solution Deployment Guide for IBM Tivoli Composite Application Manager for WebSphere
Chapter 3. Demonstration of ITCAM for WebSphere . . . . . . . . . . . . . . . . . 373.1 Demonstration system setup. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
3.1.1 Installing application environment . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
3.1.2 Installing ITCAM for WebSphere environment . . . . . . . . . . . . . . . . . 41
3.1.3 Setting up management resources . . . . . . . . . . . . . . . . . . . . . . . . . . 423.1.4 Running the application load generator . . . . . . . . . . . . . . . . . . . . . . 433.2 WebSphere Application Server monitoring . . . . . . . . . . . . . . . . . . . . . . . . 443.3 Generating performance report. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
Chapter 4. Implementation of ITCAM for WebSphere service. . . . . . . . . . 474.1 Install the managing server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 484.2 Modify the managing server for the other site. . . . . . . . . . . . . . . . . . . . . . 61
4.3 Install data collectors. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
4.4 Customize the management environment. . . . . . . . . . . . . . . . . . . . . . . . . 714.4.1 IBM Tivoli Composite Application Manager for WebSphere . . . . . . 714.4.2 Activating data collection. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 724.4.3 Defining server groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 784.4.4 Defining operators. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
4.5 Run initial data collection. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 844.6 Collect performance reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 844.7 Run detailed data collection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
4.7.1 Scheduling monitoring level changes . . . . . . . . . . . . . . . . . . . . . . . . 85
4.7.2 Getting transaction trace. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 854.7.3 Performing lock analysis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 894.7.4 Performing memory leak analysis . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
4.8 Develop the finding report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1024.9 Remove the data collector. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
Chapter 5. Complementary solutions for ITCAM for WebSphereengagement. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
5.1 Cross-sell and up-sell . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
5.2 Additional solutions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1065.2.1 Managing and analyzing response time . . . . . . . . . . . . . . . . . . . . . 106
5.2.2 Working with messaging infrastructure . . . . . . . . . . . . . . . . . . . . . . 1075.2.3 Managing Web Services and SOA infrastructure . . . . . . . . . . . . . . 108
5.3 Enhancement solutions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
5.3.1 Enabling a split server for load balancing and reliability . . . . . . . . . 1095.3.2 Security enhancement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1105.3.3 Integrating performance monitoring with the portal solution . . . . . . 110
5.3.4 Collecting performance information in Tivoli Data Warehouse . . . . 110
Appendix A. Additional material . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111Locating the Web material . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111Using the Web material . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
7/31/2019 Solution Deployment Guide for IBM Tivoli Composite Application Manager for WebSphere Sg247293
7/136
Contents v
System requirements for downloading the Web material . . . . . . . . . . . . . 112How to use the Web material . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
Abbreviations and acronyms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
Related publications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115IBM Redbooks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115Other publications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115Online resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116How to get IBM Redbooks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117Help from IBM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
7/31/2019 Solution Deployment Guide for IBM Tivoli Composite Application Manager for WebSphere Sg247293
8/136
vi Solution Deployment Guide for IBM Tivoli Composite Application Manager for WebSphere
7/31/2019 Solution Deployment Guide for IBM Tivoli Composite Application Manager for WebSphere Sg247293
9/136
Copyright IBM Corp. 2006. All rights reserved. vii
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. Consultyour 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 IBMproduct, program, or service may be used. Any functionally equivalent product, program, or service thatdoes not infringe any IBM intellectual property right may be used instead. However, it is the user'sresponsibility 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.
The following paragraph does not apply to the United Kingdom or any other country where suchprovisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATIONPROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS ORIMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT,MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimerof express or implied warranties in certain transactions, therefore, this statement may not apply to you.
This information could include technical inaccuracies or typographical errors. Changes are periodically madeto 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 atany time without notice.
Any references in this information to non-IBM Web sites are provided for convenience only and do not in anymanner serve as an endorsement of those Web sites. The materials at those Web sites are not part of thematerials for this IBM product and use of those Web sites is at your own risk.
IBM may use or distribute any of the information you supply in any way it believes appropriate withoutincurring any obligation to you.
Information concerning non-IBM products was obtained from the suppliers of those products, their publishedannouncements 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 onthe capabilities of non-IBM products should be addressed to the suppliers of those products.
This information contains examples of data and reports used in daily business operations. To illustrate themas 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 businessenterprise is entirely coincidental.
COPYRIGHT LICENSE:
This information contains sample application programs in source language, which illustrate programmingtechniques on various operating platforms. You may copy, modify, and distribute these sample programs in
any form without payment to IBM, for the purposes of developing, using, marketing or distributing applicationprograms conforming to the application programming interface for the operating platform for which thesample programs are written. These examples have not been thoroughly tested under all conditions. IBM,therefore, cannot guarantee or imply reliability, serviceability, or function of these programs.
7/31/2019 Solution Deployment Guide for IBM Tivoli Composite Application Manager for WebSphere Sg247293
10/136
viii Solution Deployment Guide for IBM Tivoli Composite Application Manager for WebSphere
Trademarks
The following terms are trademarks of the International Business Machines Corporation in the United States,other countries, or both:
AIXCICSDatabase 2DB2 Universal DatabaseDB2IBMIMS
Monitoring On DemandMVSOMEGAMONOS/400PartnerWorldRedbooksRedbooks (logo)
Tivoli EnterpriseTivoli Enterprise ConsoleTivoliVTAMWebSpherez/OS
The following terms are trademarks of other companies:
Enterprise JavaBeans, EJB, Java, JavaBeans, JavaServer, JavaServer Pages, JDBC, JMX, JSP, JVM,J2EE, Solaris, Sun, and all Java-based trademarks are trademarks of Sun Microsystems, Inc. in the UnitedStates, other countries, or both.
Microsoft, Windows, and the Windows logo are trademarks of Microsoft Corporation in the United States,other countries, or both.
Intel, Pentium, Intel logo, Intel Inside logo, and Intel Centrino logo are trademarks or registered trademarksof Intel Corporation or its subsidiaries in the United States, other countries, or both.
UNIX is a registered trademark of The Open Group in the United States and other countries.
Linux is a trademark of Linus Torvalds in the United States, other countries, or both.Other company, product, or service names may be trademarks or service marks of others.
7/31/2019 Solution Deployment Guide for IBM Tivoli Composite Application Manager for WebSphere Sg247293
11/136
Copyright IBM Corp. 2006. All rights reserved. ix
Preface
This IBM Redbook is written for services professionals who are responsible fordeveloping, selling, and implementing customer-based service engagements.The book focuses on implementation services for IBM Tivoli CompositeApplication Manager for WebSphere V6.0.
IBM Tivoli Composite Application Manager for WebSphere is a performancemanagement solution for WebSphere Application Server-based applications. Itenables monitoring of various performance aspects of WebSphere ApplicationServers and provides valuable assistance in finding and removing application
bottlenecks. This implementation service for IBM Tivoli Composite ApplicationManager for WebSphere is suitable for customers with multiple mission-criticalapplications deployed on WebSphere Application Server.
This book explains the fundamental aspects of services engagement andStatement of Work creation. We explore in detail how to analyze the effortrequired for implementing the solution. We also provide several additionaladd-ons that you might be able to package in the implementation service.
This book is meant to be used in conjunction with Deployment Guide Series: IBMTivoli Composite Application Manager for WebSphere V6.0, SG24-7252. We willnot cover deployment in detail; we are more focused on building the serviceengagement package.
The team that wrote this book
This book was produced by a team of specialists from around the world workingat the International Technical Support Organization, Poughkeepsie Center.
Budi Darmawan is a Consulting IT Specialist at the International TechnicalSupport Organization, Austin Center. He writes extensively and teaches IBMclasses worldwide about all areas of systems management and Tivoli solutions.Before joining the ITSO in 1999, Budi worked as lead implementer and solutionarchitect in IBM Indonesia Integrated Technology Services, IBM Global Services.His current interests include availability management, z/OS administration, andJava programming.
7/31/2019 Solution Deployment Guide for IBM Tivoli Composite Application Manager for WebSphere Sg247293
12/136
x Solution Deployment Guide for IBM Tivoli Composite Application Manager for WebSphere
Thanks to the following people for their contributions to this project:
Betsy ThaggardInternational Technical Support Organization, Poughkeepsie Center
Elizabeth PurzerIBM Software Group
Become a published author
Join us for a two- to six-week residency program! Help write an IBM Redbookdealing with specific products or solutions, while getting hands-on experiencewith leading-edge technologies. Youll team with IBM technical professionals,Business Partners, and/or customers.
Your efforts will help increase product acceptance and customer satisfaction. Asa bonus, youll develop a network of contacts in IBM development labs, andincrease your productivity and marketability.
Find out more about the residency program, browse the residency index, andapply online at:
ibm.com/redbooks/residencies.html
Comments welcome
Your comments are important to us!
We want our Redbooks to be as helpful as possible. Send us your commentsabout this or other IBM Redbooks in one of the following ways:
Use the online Contact us review redbook form found at:
ibm.com/redbooks
Send your comments in an e-mail to:
Mail your comments to:
IBM Corporation, International Technical Support OrganizationDept. HYTD Mail Station P099
2455 South RoadPoughkeepsie, NY 12601-5400
http://www.redbooks.ibm.com/residencies.htmlhttp://www.redbooks.ibm.com/residencies.htmlhttp://www.redbooks.ibm.com/http://www.redbooks.ibm.com/http://www.redbooks.ibm.com/contacts.htmlhttp://www.redbooks.ibm.com/contacts.htmlhttp://www.redbooks.ibm.com/http://www.redbooks.ibm.com/http://www.redbooks.ibm.com/residencies.htmlhttp://www.redbooks.ibm.com/residencies.html7/31/2019 Solution Deployment Guide for IBM Tivoli Composite Application Manager for WebSphere Sg247293
13/136
Copyright IBM Corp. 2006. All rights reserved. 1
Chapter 1. IBM Tivoli CompositeApplication Manager forWebSphere solution offering
This chapter discusses some initial concepts regarding the ITCAM forWebSphere solution that you will be able to define, sell, and implement for yourcustomer environment. The discussion in this section includes:
1.1, Services solution overview on page 2
1.2, ITCAM for WebSphere concepts on page 2
1.3, ITCAM for WebSphere solution on page 9
1.4, Document organization on page 11
1
7/31/2019 Solution Deployment Guide for IBM Tivoli Composite Application Manager for WebSphere Sg247293
14/136
2 Solution Deployment Guide for IBM Tivoli Composite Application Manager for WebSphere
1.1 Services solution overview
This IBM Redbook provides a comprehensive guide to developing and deployinga services solution offering based on ITCAM for WebSphere. The solution is
targeted for small and mid-market businesses (SMB). Because many of thesebusinesses do not have IT staffs, they rely on trusted advisors like you. Deliveringcomplete and working solutions from the start in a minimal amount of time canhelp you establish long and prosperous relationships with these companies.
This services solution guide is developed specifically for Business Partners. It isdesigned to help you reduce the time and investment that are necessary beforeyou can begin selling and implementing solutions.
Resellers face certain challenges in trying to exploit opportunities. Identifying andassembling all of the relevant pieces that make up a meaningful solutionindividuallyhardware, software, networking installation, and configurationcanbe time-consuming and cumbersome tasks and might not be fully chargeable tothe customer. Solutions can be complex, and many demand high skill levels insales, service, and support.
The additional value-add for you consists of a set of offering-specific scenarios,service offerings, documentation, and templates that enable you to provide ahigh level of services and, therefore, increase the profitability of a solution sale. Atypical SMB relies on value-add resellers or consultants to provide a ready-to-go,affordable, customized Web-based business solution to solve immediatebusiness problems.
Before we proceed into the offering itself, we spend some time defining ITCAMfor WebSphere.
1.2 ITCAM for WebSphereconceptsITCAM for WebSphere is an application management tool that helps maintain theavailability and performance of on demand applications. It helps you quicklypinpoint, in real time, the source of bottlenecks in application code, serverresources, and external system dependencies. This product also providesdetailed reports that you can use to enhance the performance of yourapplications. ITCAM for WebSphere provides in-depth WebSphere-basedapplication performance analysis and tracing facilities.
ITCAM for WebSphere enables multiple levels of analysis in order to achieve acomplete view of the application, depending on the need. From theproduction-level monitoring through detailed heap and method debugging, it digs
7/31/2019 Solution Deployment Guide for IBM Tivoli Composite Application Manager for WebSphere Sg247293
15/136
Chapter 1. IBM Tivoli Composite Application Manager for WebSphere solution offering 3
into SQL performance analysis without the need for database monitors. It canprovide SQL information and calls that were made through Java DatabaseConnectivity (JDBC). ITCAM for WebSphere provides a composite statuscorrelation for transactions that use CICS or IMS as the back-end system.
ITCAM for WebSphere V6.0 evolved from WebSphere Studio Application Monitorand OMEGAMON XE for WebSphere. ITCAM for WebSphere observes andreports on the health of J2EE-based applications. It tracks the progress ofapplications as they traverse through J2EE application servers, middlewareadapters and transports, and database calls, and on to back-end systems suchas CICS or IMS to extract business data or to invoke mainframe businessprocesses. The tracking of applications produces request traces, where theevents in a requests life are recorded and stored in a monitoring repositorydatabase. ITCAM for WebSphere captures the CPU and the elapsed internal
times when events are called and when they are exited, measuring as far downas the CPU times consumed and the elapsed internal times charged to individualmethods in J2EE classes. The methods or events taking the most time aremarked as an applications parts that deserve attention for runtime improvementstudies and code optimizations.
ITCAM for WebSphere does not need modification of any application code. JavaVirtual Machine Tool Interface (JVMTI) interfaces and primitives, along withWebSphere Performance Management Interface (PMI) and z/OS System
Measurement Facility (SMF) 120 records, are ITCAM for WebSpheres principaldata sources. The monitoring data is collected and analyzed to offer a wealth ofinformation about the health of J2EE applications and their servers.
Many system-level performance metrics are collected and reported about J2EEapplication servers. The status of the servers and their resources (particularly atvital checkpoints such as CPU utilization), memory usage, and the status ofinternal components such as database connection pools, JVM thread pools,EJB usage, and request processing statistics can be very useful and important
for locating real-time problems with J2EE applications. ITCAM for WebSpherebrings attention to these critical indicators with real-time, graphical displays oftheir values and their trends over time.
1.2.1 Components
ITCAM for WebSphere is a distributed performance monitoring application forapplication servers. Its components are connected through TCP/IPcommunication. The central component of ITCAM for WebSphere, the managing
server, is its heart and brain. It collects and displays various performanceinformation from application servers. The application servers run a component ofITCAM for WebSphere called the data collector(DC), which is a collecting agent
7/31/2019 Solution Deployment Guide for IBM Tivoli Composite Application Manager for WebSphere Sg247293
16/136
4 Solution Deployment Guide for IBM Tivoli Composite Application Manager for WebSphere
that runs in the application server and sends monitoring information to themanagement server. These data collectors operate independent of each other.
Figure 1-1 shows the overall architecture of ITCAM for WebSphere.
Figure 1-1 ITCAM for WebSphere architecture
ITCAM for WebSphere has the following components:
The managing serverActs as the central component that manages andadministers the data collectors. It stores that data in a relational databaserepository. A Web-based application is provided to show the monitoringresults; this interface is also called the visualization engine. We discuss themanaging server in The managing server on page 5.
Data collectors run on the application servers that are being monitored. Theycollect performance information for the managing server. These datacollectors operate independent of each other. They are discussed inWebSphere data collector on page 6.
Tivoli Enterprise Monitoring Agentcollects information that shows the statusof the WebSphere server and sends this information to the Tivoli EnterpriseMonitoring Server for display via the Tivoli Enterprise Portal. Tivoli Enterprise
Web Server
Application servers with
ITCAM for WebSphere
Data collectors
Browser interface
ITCAM
for WebSphere
Managing Server
Tivoli Enterprise
Management Server
andTivoli Enterprise
Portal Server
I
http://-/?-http://-/?-http://-/?-http://-/?-7/31/2019 Solution Deployment Guide for IBM Tivoli Composite Application Manager for WebSphere Sg247293
17/136
Chapter 1. IBM Tivoli Composite Application Manager for WebSphere solution offering 5
Monitoring Agent is installed on the individual machines where the datacollector resides.
The managing server
ITCAM for WebSphere managing server (MS) controls and coordinates datacollectors for J2EE, CICS or IMS servers that run applications.
The managing server consists of the following software:
The X-Windows Virtual Frame Buffer (Xvfb) graphics package
Managing server database, DB2 UDB, or Oracle (on Sun Solaris) forstoring data relationally
J2EE server to run the ITCAM for WebSphere graphical console application
An optional Apache Web server, such as IBM HTTP Server
ITCAM for WebSphere managing server overseer components, which are aset of Java-based components
The ITCAM for WebSphere overseer components are the controlling logic for themanaging server:
The kernels control the managing server. There are always two copies of thekernels running on an ITCAM for WebSphere managing server for
redundancy and failover. The kernels register components as they join themanaging server, periodically renew connections and registrations withcomponents and data collectors, and collect servers and componentavailability information.
Thepublishing servers receive application and system event data from thedata collectors, gather and compute request-level information aboutperformance metrics such as response times, and implement the trapmonitoring and alerts features.
The archive agents receive monitoring data from the publishing servers, andstore the monitoring data in ITCAM for WebSpheres repository.
Theglobal publishing servercollects information from the publishing servers,and correlates all parts and pieces of multi-server requests, like requests fromJ2EE servers to execute CICS or IMS programs.
The message dispatcheris a conduit for messages from ITCAM forWebSphere using e-mail and SNMP facilities.
Thepolling agents collect data from Web Servers for Apache 2.0 and above.
The visualization engine is a Web-based GUI with access to graphics, ITCAMfor WebSphere performance reports, real-time views of different slices ofmonitoring data, and access to ITCAM for WebSphere internal commands as
7/31/2019 Solution Deployment Guide for IBM Tivoli Composite Application Manager for WebSphere Sg247293
18/136
6 Solution Deployment Guide for IBM Tivoli Composite Application Manager for WebSphere
well as event-driven functions. The visualization engine runs on a J2EEserver, such as WebSphere Application Server.
Figure 1-2 shows the conceptual relationship between the components.
Figure 1-2 Kernel components
When it reaches the managing server, monitoring data is prepared for real-timedisplays within the monitoring console and is inserted into the ITCAM forWebSphere data repository. These are very resource-intensive operations;moving them to a standalone distributed server (or servers) isolates them fromother enterprise activities, thus reducing ITCAM for WebSpheres systemresource footprint in the monitored systems. This design also helps keep ITCAMfor WebSpheres processing overhead at levels low enough for 24x7 productionsystem monitoring.
Data from the distributed data collectors is collected by the publishing server andthen stored in the OCTIGATE database by the archive agent. The VisualizationEngine reads the database in order to present data through the Web console,while snapshot information such as lock analysis and in-flight transaction areretrieved directly from the data collectors.
WebSphere data collectorData collectors run inside the application servers. They use native system
services, and they are tailored for the particular environments where theyexecute. The data collectors for z/OS systems are written to take advantage ofservices on z/OS, such as MVS Cross-Memory Services and address spacefencing, which are not available on distributed systems.
Kernel (KL)Provide services on:
- Lookup
- Registration
- Recovery
- Configuration
Publish Server (PS)
Archive Agent (AA)
Global Publish
Server (SAM)
Polling Agent (PA)
Message Dispatcher
(MD)
Visualization EngineProvide services on:
-Administration
-Availability
-Problem Determination
-Performance Management
OCTIGATEdatabase
Publishtraffic
Snapshottraffic
7/31/2019 Solution Deployment Guide for IBM Tivoli Composite Application Manager for WebSphere Sg247293
19/136
Chapter 1. IBM Tivoli Composite Application Manager for WebSphere solution offering 7
Data collectors have two agents:
Command agent
The command agent collects requests from other components for informationabout EJB invocations, database connection pools, thread pools, stack
traces, memory analyses, and heap dumps. Event agent
The event agent provides data to the publish servers according to pollingfrequencies. This data includes system initialization data, applicationrequest-level data, and application method-level data.
Collectively, these agents and other data collector routines unleash the probes,package the monitoring data into Java formats for the managing server, and
deliver the data to the managing server.
The data collectors send the probes into the application servers to analyze theapplications performance. The probes collect monitoring data and feed it totransport routines that in turn route the data to the managing server. Themanaging server processes this data for appropriate display in the ITCAM forWebSphere console and for storage in the OCTIGATE repository. This relievesthe processing burden of ITCAM for WebSphere from the application servers asmuch as possible. The data collectors and probes are not designed to analyze or
interpret data, but to collect it and route it as quickly as possible to the managingserver where the analysis is performed.
The data sources employed by ITCAM for WebSphere are:
JVMTI garbage collection data, method trace, stack trace, CPU time, andheap dump
JMX system resources
SMF system resources (z/OS only)
PMI system resources
OS services SCC, platform CPU, and its environment
Byte Code Modification (BCM) instrumentation of some classes
The data collector in a J2EE server runs as a custom service called am.Figure 1-3 on page 8 shows the conceptual data collector structure.
http://-/?-http://-/?-7/31/2019 Solution Deployment Guide for IBM Tivoli Composite Application Manager for WebSphere Sg247293
20/136
8 Solution Deployment Guide for IBM Tivoli Composite Application Manager for WebSphere
Figure 1-3 J2EE data collector structure
Tivoli Enterprise Monitoring AgentThe Tivoli Enterprise Monitoring Agent enables WebSphere performanceinformation to be relayed to Tivoli Enterprise Monitoring Server and showed
using Tivoli Enterprise Portal. This facility replaces the data collector mechanismemployed by OMEGAMON for WebSphere Application Server. The TivoliEnterprise Monitoring Agent communicates to the data collector in the localmachine and retrieves performance information. Tivoli Enterprise MonitoringAgent reports the information to Tivoli Enterprise Monitoring Server.
For more information about the Tivoli Enterprise Monitoring Server and IBMTivoli Monitoring V6.1 architecture, read Getting Started with IBM TivoliMonitoring V6.1, SG24-7143.
1.2.2 Supported platform overview
For a complete platform coverage list, refer to the following Web site:
http://publib.boulder.ibm.com/tividd/td/ITCAMWAS/prereq60/en_US/HTML/itcam6.html
Table 1-1 on page 9 shows the supported platform overview for ITCAM forWebSphere V6.
WebSphere
Custom Service
amPublish databcm
JVMTI PMIJMX
Tivoli Enterprise
Monitoring Agent
KYN
To TEMS
http://publib.boulder.ibm.com/tividd/td/ITCAMWAS/prereq60/en_US/HTML/itcam6.htmlhttp://publib.boulder.ibm.com/tividd/td/ITCAMWAS/prereq60/en_US/HTML/itcam6.htmlhttp://publib.boulder.ibm.com/tividd/td/ITCAMWAS/prereq60/en_US/HTML/itcam6.htmlhttp://publib.boulder.ibm.com/tividd/td/ITCAMWAS/prereq60/en_US/HTML/itcam6.html7/31/2019 Solution Deployment Guide for IBM Tivoli Composite Application Manager for WebSphere Sg247293
21/136
Chapter 1. IBM Tivoli Composite Application Manager for WebSphere solution offering 9
Table 1-1 ITCAM for WebSphere supported platform overview
1.3 ITCAM for WebSphere solution
This section discusses the solutions that we present in this book. The discussionis divided into:
1.3.1, Solution overview on page 10 1.3.2, Software components on page 10 1.3.3, Suggested hardware configuration on page 10
Component Software
Managing server operatingsystem
AIX 5.2, 5.3Solaris 9 cluster, 10 cluster
HP-UX 11iv1RHEL 3.0, RHEL 4.0, SLES 8, SLES 9Windows 2000 Server or Advanced Server with SP4Windows 2003 Server SE/EE
Managing server database DB2 7.2 EE/EEE FP11DB2 8.1 ESE FP6DB2 8.2 ESEOracle 9i S/E R2 9.2+Oracle 10g
Managing serverWebSphere
WebSphere Application Server 5.1.1 and above orWebSphere Application Server 6.x
Data collector platform Windows 2000 Pro SP4Windows 2000 Server or Advanced Server with SP4Windows 2003 Server SE/EEAIX 5.2 and 5.3RHEL 3.0 and 4.0SLES 8 and 9Solaris 8, 9, 10, Solaris 9 ClusterHP-UX 11iv1RFAS 4.0 and 4.1OS/400 V5R2 and V5R3z/OS 1.4, 1.5, 1.6, or 1.7
CICS CTG 5.0.1 or 5.1 and 1.3, 2.2, 2.3 or 3.1
IMS 7.1, 8.1 and 9.1
7/31/2019 Solution Deployment Guide for IBM Tivoli Composite Application Manager for WebSphere Sg247293
22/136
10 Solution Deployment Guide for IBM Tivoli Composite Application Manager for WebSphere
1.3.1 Solution overview
The solution provides a proactive monitoring on WebSphere Application ServerJ2EE environment. The solution can be a turnkey solution or a diagnostic servicefor the end user.
The turnkey solution has you, the Business Partner, install and configureITCAM for WebSphere on the customer hardware and leave it for thecustomer to operate later. This solution is typical for an enterprise that has itsown IT personnel and want to manage their own environment.
The diagnostic service solution has you bring your hardware to analyzecustomer environment and provide tuning recommendations for the customer.This solution is typical for an enterprise that wants an occasional diagnosticsolution for its WebSphere environment but does not want to maintain the
management environment.
Both solution types include installation of ITCAM for WebSphere data collectoron the customers production servers. The data collector will feed the managingserver with necessary transaction information.
1.3.2 Software components
The solution consists of implementing ITCAM for WebSphere managing server
and data collector to analyze WebSphere Application Server. The distributedplatform product number for ITCAM for WebSphere is 5724-L62.
Passport advantage media pack part number for ITCAM for WebSphere V6.0Multi Platform is BJ0G3ML, or use the Web download option.
1.3.3 Suggested hardware configuration
The following list is a suggested hardware configuration for use with ITCAM forWebSphere managing server:
Intel Pentium or equivalent processor (733 MHz or higher) 3 GB RAM 20 GB available disk space
The recommended configuration for a production ITCAM for WebSpheremanaging server could vary depending on your customers requirements.
7/31/2019 Solution Deployment Guide for IBM Tivoli Composite Application Manager for WebSphere Sg247293
23/136
Chapter 1. IBM Tivoli Composite Application Manager for WebSphere solution offering 11
1.4 Document organization
Farther into this book, you can find various information to help you build yourservice offering regarding ITCAM for WebSphere solution. This book has thefollowing chapters:
Chapter 1, IBM Tivoli Composite Application Manager for WebSpheresolution offering on page 1
Chapter 2, Planning for customer engagement on page 13
Chapter 3, Demonstration of ITCAM for WebSphere on page 37
Chapter 4, Implementation of ITCAM for WebSphere service on page 47
Chapter 5, Complementary solutions for ITCAM for WebSphere
engagement on page 105
7/31/2019 Solution Deployment Guide for IBM Tivoli Composite Application Manager for WebSphere Sg247293
24/136
12 Solution Deployment Guide for IBM Tivoli Composite Application Manager for WebSphere
7/31/2019 Solution Deployment Guide for IBM Tivoli Composite Application Manager for WebSphere Sg247293
25/136
Copyright IBM Corp. 2006. All rights reserved. 13
Chapter 2. Planning for customerengagement
In this chapter, we discuss services engagement for ITCAM for WebSphere andin general. The topics that we discuss includes:
2.1, Services engagement preparation on page 14
2.2, Solution scope and components on page 15
2.3, Services engagement overview on page 16
2.4, Defining solution timing on page 21
2.5, Statement of work on page 29
2
7/31/2019 Solution Deployment Guide for IBM Tivoli Composite Application Manager for WebSphere Sg247293
26/136
14 Solution Deployment Guide for IBM Tivoli Composite Application Manager for WebSphere
2.1 Services engagement preparation
This section describes resources that are available to help you successfullydeliver a solution. The discussion is divided into:
2.1.1, Implementation skills on page 14 2.1.2, Available resources on page 14
2.1.1 Implementation skills
To be able to successfully develop and deploy an ITCAM for WebSphere-basedsolution, you must acquire some specialized skills. The following skills areneeded to implement and customize the solution:
General skills Operating system administration skills on Windows 2000 and
Linux-based systems
Connectivity and network administration skills on TCP/IP protocol
Understanding of Java and J2EE-based applications
WebSphere Application Server skills
Using WebSphere Application Server administration console
Defining application resources in WebSphere Application Server
ITCAM for WebSphere skills
Understanding of ITCAM for WebSphere components
The ability to perform problem determination related to ITCAM forWebSphere connectivity
Depending on the target environment, you might need additional skill sets to
understand the whole application environment, such as messaging platform,database management, back-end processing server, and so on. You might beable to acquire these skills from the resources listed in the next section.
2.1.2 Available resources
The prerequisite skills listed in the previous section are needed to customize ordevelop the solution. For each of these skills, there is a variety of resourcesavailable to help acquire the necessary skill level. Available educational
resources are as follows:
Online Help: IBM WebSphere Application Server and ITCAM for WebSphereprovide online help and product manuals on the Web.
7/31/2019 Solution Deployment Guide for IBM Tivoli Composite Application Manager for WebSphere Sg247293
27/136
Chapter 2. Planning for customer engagement 15
Classroom Training: IBM PartnerWorld provides current information aboutavailable classes, their dates, locations, and registration. Additionally, checkthe PartnerEducation Web site, which serves as a single point of contact forall Business Partner education and training.
IBM Technical Education Services (ITES): ITES offers a variety of classes at
all knowledge levels to help you achieve any of the offerings prerequisite skills.
IBM Redbooks: You can access various practical and architectural informationregarding IBM hardware and software platforms from these books. They areavailable for download in the PDF format at http://ibm.com/redbooks.
2.2 Solution scope and components
You need to define the scope of the solution. The solution can be one of the twobasic offering types in 2.2.1, Basic solution definition on page 15 or you canadd additional components listed in 2.2.2, Cross-sell and up-sell opportunitieson page 16.
2.2.1 Basic solution definition
The solution enables an enterprise to manage and analyze effective performance
of a J2EE-based application to show a bottleneck and impending problems. Thesolution also enables an enterprise to analyze and improve the performance ofits application.
There are several forms of the solution that can be presented to the customer:
Environment analysis solution: This enables you to perform analysis of anenterprise application using a portable ITCAM for WebSphere managingserver. Typically you would leave the managing server running for a few daysand generate reports. You analyze the report and provide your
recommendations. Some adjustment of the monitoring level may have to beperformed during that time to collect additional information.
WebSphere application management solution: This solution implements thefull function of ITCAM for WebSphere in the customer environment andenables customers to use and manage their own environment.
http://ibm.com/redbookshttp://ibm.com/redbooks7/31/2019 Solution Deployment Guide for IBM Tivoli Composite Application Manager for WebSphere Sg247293
28/136
16 Solution Deployment Guide for IBM Tivoli Composite Application Manager for WebSphere
2.2.2 Cross-sell and up-sell opportunities
Additional solutions can be performed to include:
Integration to IBM Tivoli Monitoring V6.1
Response time management with IBM Tivoli Composite Application Managerfor Response Time Tracking
End-to-end response time management with IBM Tivoli CompositeApplication Manager for CICS Transactions or IBM Tivoli CompositeApplication Manager for IMS Transactions
Enhancement to integrate with IBM Tivoli Enterprise Console or IBM TivoliBusiness Systems Manager
Collection of WebSphere performance information into IBM Tivoli Data
Warehouse
2.3 Services engagement overview
You routinely rely on your skills and previous experience as a guide, but there arealways issues that require some educated guesswork. The goal of this section isto help you minimize the guesswork involved in planning and implementing asolution by providing a framework and time estimates for the major tasks.
A typical services engagement consists of:
Build an executive assessment (see 2.3.1, Executive Assessment onpage 17)
Set up a demonstration system or proof of technology (see 2.3.2,Demonstration system setup on page 18)
Analyze solution tasks (2.3.3, Analyze solution tasks on page 19)
Create a contract or statement of work (see 2.3.4, Creating a contract onpage 20)
The representative tasks and the time involved for custom solution execution are
included in the following section. Each customer has a unique set of needs, so theactual set of tasks to accomplish and the time involved might vary. However, this
list should help you understand implementation details, size the solution moreaccurately for the customer, and ensure a profitable engagement for yourself.
Note:Chapter 5, Complementary solutions for ITCAM for WebSphereengagement on page 105 offers details about additional services opportunities.
7/31/2019 Solution Deployment Guide for IBM Tivoli Composite Application Manager for WebSphere Sg247293
29/136
Chapter 2. Planning for customer engagement 17
It is important to work with your customers to understand their expectations. Afteryou have gathered this data, document the tasks, deliverables, and associatedcosts in astatement of work. The statement of work acts as your contractualagreement with the customer for the duration of the project; therefore, a detailedand well-defined statement of work is advantageous both to you and your
customer.
A good overall understanding of the solution scope is a crucial prerequisite tosuccessfully selling, developing, and implementing it. As a solution provider, youmust understand what is involved in developing such a solution before you candiscuss it with your customer and size it for a cost estimate.
2.3.1 Executive Assessment
TheExecutive Assessmentis a billable service that you can offer to yourprospective clients. It offers a process designed to help you evaluate thebusiness needs of a company that is planning to deploy a solution for Web-basedbusiness. It was created for IBM Business Partners to help you close a higherratio of opportunities. It has been field-tested in markets all over North Americaand Europe and has received enthusiastic feedback.
The benefits of using the Executive Assessment in your sales process include:
Earning additional service fees More effectively qualifying prospective clients Shortening the sales cycle Streamlining the development process Closing a much higher ratio of potential engagements
This toolset helps you ask the right people the right questions so that you get theinformation you need to propose the appropriate solution. This assessment thenhelps you create a compelling business case that will persuade your prospect tobuy the required hardware, software, and services from you in the shortestpossible time.
The complete Executive Assessment process should take approximately 10 to 16hours. Table 2-1 shows the task breakdown.
Table 2-1 Solution task
Task Estimated time
(hours)
Initial fact-finding meeting, asking questions, and gatheringdata
3
Review and analysis of competing solutions 2
7/31/2019 Solution Deployment Guide for IBM Tivoli Composite Application Manager for WebSphere Sg247293
30/136
18 Solution Deployment Guide for IBM Tivoli Composite Application Manager for WebSphere
This is a business-case assessment, not a technical assessment, so youraudience should be business owners, line-of-business executives, marketing andsales managers, and finally, the IT manager. The business owner orline-of-business executive is likely to be the decision maker.
For their initial investment, your clients get:
A business assessment prepared by a professional (you)
A competitive analysis
A prototype solution for their review
A strategic and tactical proposal for justifying and implementing their solutionfor Web-based business
Over the course of the Executive Assessment, you determine who will beinvolved in the project, what they want to accomplish, when they plan to deploy,where the Web plays a mission-critical role in their business, and how the projectwill be funded. Armed with this information, a competitive analysis, and aprototype solution, you will be able to justify their investment, build perceivedvalue, present your recommendations in a way that is almost irresistible, andsuccessfully close the contract.
Having the ability to recommend the correct course of action to your client has
tremendous value. In a market where it is difficult for companies to find qualifiedBusiness Intelligence consultants, the Executive Assessment and resultingpresentation gives you a chance to prove conclusively that you have the righttechnology and the right people to do the job.
2.3.2 Demonstration system setup
A demonstration system is typically set up in advance to show your customers
the attributes of the solution. The demonstration system can typically be set upwith a limited number of systems that are separate from the system that will beused by the production system.
Preparation of a set of strategic recommendations 1
Creation of a demonstration prototype 3 - 9
Presentation of findings and close for a contract 1
Total 10-16
Task Estimated time
(hours)
7/31/2019 Solution Deployment Guide for IBM Tivoli Composite Application Manager for WebSphere Sg247293
31/136
Chapter 2. Planning for customer engagement 19
You can set up ITCAM for WebSphere demonstration system using atwo-machine environment: one running the managing server and the otherrunning the application client with the data collector. This demonstration systemis typically running a test application that you can load onto it so that you can useITCAM for WebSphere to show monitoring processes and collect results.
The demonstration system enables your customers to evaluate whether thesolution suits their particular needs. Table 2-2 shows the tasks and estimatedtime for demonstrating the solution. Chapter 3, Demonstration of ITCAM forWebSphere on page 37 suggests some demonstration ideas.
Table 2-2 Solution demonstration task
2.3.3 Analyze solution tasks
After the customer agrees to use the solution in their environment, you must
decide how to implement it. These estimates would then be collected andimplemented into a contract or statement of work.
We discuss these tasks in detail in 2.4, Defining solution timing on page 21.These are our suggested tasks and order; you may complete the tasks in adifferent order or may omit or add tasks depending on the environment to whichyou implement the solution. Overall solution time might be influenced by theamount of skill and experience that you or your team have with the solution. Theestimate that we present is typically based on the following factors:
Has working knowledge of the operating system
Has good understanding of WebSphere Application Server and J2EE-basedenvironment
Task Estimated time (hours)
Set up hardware 1 - 2
Install and configure operating system 2 - 3
Install sample application 2 - 4
Install ITCAM for WebSphere 3 - 4
Install data collector 1
Run application load 1
Demonstrate to customer 2
Run reports 1
Total 13 - 18
7/31/2019 Solution Deployment Guide for IBM Tivoli Composite Application Manager for WebSphere Sg247293
32/136
20 Solution Deployment Guide for IBM Tivoli Composite Application Manager for WebSphere
Understands J2EE application environment, with its components, such asEnterprise JavaBeans (EJB), Servlets, Java 2 Connector (J2C), JavaDatabase Connectivity (JDBC), and Web Services.
Understands WebSphere security concepts, such as Secure Socket Layer(SSL), LDAP authentication, and certificate usage
Has thorough knowledge of ITCAM for WebSphere
Depending on your skills and experience, the estimates we present might be toohigh or too low. Table 2-3 illustrates one method of approximating more realistictime estimates for your efforts, based on whether you or your team are new toeach skill area or could be considered experts. A novice is someone who hascompleted training in the skill area but has no hands-on experience. An experthas completed training in the skill area and has implemented ITCAM for
WebSphere projects.Table 2-3 Skill adjustment
For the detailed task breakdown, see 2.4, Defining solution timing on page 21.
2.3.4 Creating a contract
A contract or statement of work is a binding contractual agreement between youand your customer that defines the service engagement that you must performand the result that the customer can expect from the engagement. The contractshould leave nothing in doubt.
A statement of work should include:
Executive summary of the solution, which is typically a short (less than apage) summary of the solution and its benefit. You must specify any major
restrictions of the implementation, such as:
The solution is only implemented for finance application servers. The solution will be implemented in phases.
Skill Novice
increase by
Expert
reduce by
Experience with the operating system 25% 10%
Deep understanding of WebSphereApplication Server or J2EE environment
40% 20%
Experience in ITCAM for WebSphereinstallation
10% 20%
Familiarity of ITCAM for WebSphere reports 25% 20%
S l ti d i ti hi h t i th j t d l ti
7/31/2019 Solution Deployment Guide for IBM Tivoli Composite Application Manager for WebSphere Sg247293
33/136
Chapter 2. Planning for customer engagement 21
Solution description, which contains the major components and solutionbuilding blocks that will be implemented. It should cover conceptualarchitecture of the solution and solution scope in general. This description isaimed for technical personnel to understand the implementation scope.
Assumptions, which lists all of the assumptions that are used to prepare the
contract and provide task estimation. Any deviation to the assumptions that isused will definitely affect the scope of engagement and must be managedusing the change management procedure. Typical changes include costchanges or scope changes.
Business partner responsibilities, which lists all of the responsibilities or majortasks that will be performed by you or your team to implement the solution.
Customer responsibilities, which lists all of the responsibilities or items thatthe customer must provide for you or your team to perform the engagement. If
you cannot obtain any item in the customer responsibilities, then a changemanagement procedure may be invoked.
Staffing estimates, which lists the estimated personnel needed to implementthe solution.
Project schedule and milestones, which shows the major steps, schedule,and achievement calendar that can be used to check the project progress.
Testing methodology, which lists the test cases to ensure that the projectimplementation is successful.
Deliverables, which provides tangible items that the customer will get at theend of the service engagement, including:
Machine installation Documentation Training
Completion criteria, which lists the items that, when provided to the customer,indicate that the engagement is successfully completed. For most services
engagements, this is probably the most delicate to define. Completion criteriacan be so general that you will be tied up providing the customer ongoingsupport for life. On the other hand, an inadequate completion criteria is oftenrejected by the customer fearing that you might back away from theengagement in an incomplete state.
See 2.5, Statement of work on page 29 for a sample statement of work.
2.4 Defining solution timingA profitable services engagement has to correctly identify the tasks that you mustperform and to adequately allocate the necessary time to perform them. This
section guides you on the tasks that you might need to perform for an ITCAM for
7/31/2019 Solution Deployment Guide for IBM Tivoli Composite Application Manager for WebSphere Sg247293
34/136
22 Solution Deployment Guide for IBM Tivoli Composite Application Manager for WebSphere
section guides you on the tasks that you might need to perform for an ITCAM forWebSphere solution implementation and the timing estimate. The estimate relieslargely on some basic assumptions:
Managed environment size: the number of data collectors that must beimplemented correspond directly with the load of the managing server and
the time needed for:
Installing the data collectors Designing monitoring server group and assigning operators Analyzing performance information
Application complexity: the number of servlets, EJB resources, andinter-server communication must be considered as they relate to the timeneeded for:
Analyzing performance information Determining performance bottlenecks Providing performance recommendations
Transaction rate of the application server would affect processing overheadon the managing server and have an impact on the collected performancedata size. A higher transaction rate requires a smaller sample percentage, butthis might prevent some of important transaction data from being collected, soyou should lengthen the analysis of performance information.
Table 2-4 lists our sizing assumptions.
Table 2-4 Sizing assumptions
Assumption Simple Moderate Complex
Number of data collectors < 5 5 - 10 10 - 20
Number of J2EE resources < 50 50 - 100 100 - 200
Inter-server communication N/A one to one interconnected
Transaction rate per data collector < 60/min 60 - 300/min 300 - 900/min
Important: You must be aware of any specific application problems or offendingtransactions that the customer is experiencing. It is common for the customer toassume that you can resolve this problem. Any such specific analysis must belisted in the assumption and factored properly for the time estimation. Ourestimate does not cover analyzing existing or specific problems.
2 4 1 Environment analysis tasks
7/31/2019 Solution Deployment Guide for IBM Tivoli Composite Application Manager for WebSphere Sg247293
35/136
Chapter 2. Planning for customer engagement 23
2.4.1 Environment analysis tasks
This section discusses the tasks for environment analysis engagement. Table 2-5shows the timing estimate for the major components of the tasks for theenvironment analysis solution.
Table 2-5 Environment analysis tasks
Plan the solutionPlanning the deployment of the ITCAM for WebSphere solution includes thesubtasks shown in Table 2-6.
Table 2-6 Estimated plan for the solution time
Gather requirements
At the beginning of your engagement, you should meet with your customersto understand their proposed objectives and gather their requirements. First,you have to determine the functional requirements, which define the businessfunctions that the Business Intelligence system is going to provide. Youdetermine your requirements by developing a good understanding of thebusiness needs and of what you hope to achieve. For example, look at issues
such as business goals, purpose, and usage questions, such as who theusers are and how they expect to interact. It is important to gather theserequirements early and discover any challenges that might lay ahead while
Task Estimated time (hours)
Simple Moderate Complex
Plan the solution 5-8 6-9 9-12
Implement the solution 14-21 21-30 31-43
Close the engagement 2 2-3 3-5
Total 21-31 29-42 43-60
Task Estimated time (hours)
Simple Moderate Complex
Gather detailed requirements 2-3 2-3 3-4
Design the solution 2-3 2-3 3-4
Perform gap analysis 1-2 2-3 3-4
Total 5-8 6-9 9-12
they can still be dealt with easily When you have determined the functional
7/31/2019 Solution Deployment Guide for IBM Tivoli Composite Application Manager for WebSphere Sg247293
36/136
24 Solution Deployment Guide for IBM Tivoli Composite Application Manager for WebSphere
they can still be dealt with easily. When you have determined the functionalrequirements, you can clarify the technical or system requirements.
The technical requirement involves spending time at the customer site todetermine and understand the available data sources. These data sourcesmight come in different formats, such as relational databases, spreadsheets,
text files, or even hard copies only. You need to be able to identify the fields ordata elements in these data sources and plan how these data elements willbe used in the target data mart. You also need to identify the schema or datausage changes from the supplied sample scenario, which is based on thenon-customized products.
The system requirement will be determined from the number and size of thedata sources and the expected goals that the business questions will cover.This information dictates the size and performance of the systems that will be
used in the solution. Design the solution
Topics that should be addressed include scalability, functionality, andperformance of this solution.
Design involves understanding the customers environment includinghardware, software, data volumes, special requirements, and operationalprocedures. It is necessary to identify and plan for any additional tuning ofsoftware that might be required because of the customers environment or
special needs. In addition, an analysis of the modifications made to thescenarios and reports must be performed. After you have designed theproposed solution and reviewed it with your customer, you are ready to begindevelopment of the offering.
Perform gap analysis
This task involves performing a gap analysis to give the customer an estimateof the development effort that is required to set up the solution. At its core, theanalysis seeks to determine what customizable components should be
extended, modified, or created. The number and complexity of customizablecomponents drives the size of the project and the required resources.
After you have designed the proposed solution and reviewed it with yourcustomer, you are ready to proceed.
Implement the solutionTable 2-7 on page 25 lists the tasks that are performed in the implementation ofthe solution. Chapter 4, Implementation of ITCAM for WebSphere service on
page 47 offers a detailed implementation guide for the environment analysissolution.
Table 2-7 Implementation tasks
7/31/2019 Solution Deployment Guide for IBM Tivoli Composite Application Manager for WebSphere Sg247293
37/136
Chapter 2. Planning for customer engagement 25
p
Detailed sub-tasks for the solution follow:
Installing managing server on site Installing data collector Run initial data collection Run detailed data collection Collect performance reports Develop finding report Removal of data collector
Close the engagementBecause this service engagement does not provide ITCAM for WebSphere forthe customer to operate, you do not have to provide training, so our next step isto close the engagement. Table 2-8 lists the engagement close tasks.
Table 2-8 Engagement close tasks
Presentation of performance findings and recommendations Closing of service engagement
Task Estimated time (hours)
Simple Moderate Complex
Install managing server on site 1-2 1-2 1-2
Install data collector 2-3 3-4 4-6
Run initial data collection 1-2 2-4 4-7
Run detailed data collection 2-3 3-4 4-5
Collect performance reports 2-3 4-6 8-10
Develop finding report 4-5 5-6 6-7
Removal of data collector 2-3 3-4 4-6
Total 14-21 21-30 31-43
Task Estimated time (hours)
Simple Moderate Complex
Presentation of performance findings 1 1-2 2-4
Closing of services engagement 1 1 1
Total 2 2-3 3-5
2.4.2 WebSphere application management tasks
7/31/2019 Solution Deployment Guide for IBM Tivoli Composite Application Manager for WebSphere Sg247293
38/136
26 Solution Deployment Guide for IBM Tivoli Composite Application Manager for WebSphere
ebSp e e app cat o a age e t tas s
This section discusses the tasks for WebSphere application managementengagement. Table 2-9 shows the timing estimate for the major components ofthe tasks for the WebSphere application management solution.
Table 2-9 WebSphere application management tasks
Plan the solutionPlanning of the deployment of the ITCAM for WebSphere solution includes thesubtasks shown in Table 2-10.
Table 2-10 Estimated task time
Gather requirements
At the beginning of your engagement, you should meet with your customersto understand their proposed objectives and gather their requirements. First,you have to determine the functional requirements. Functional requirementsdefine the business functions that the Business Intelligence system willprovide. You determine your requirements by developing a goodunderstanding of the business needs and of what you hope to achieve. For
example, look at issues such as business goals, purpose, and usagequestions, such as who the users are and how they expect to interact. It isimportant to gather these requirements early to discover any challenges thatmight lie ahead while they can still be dealt with easily. When you have
Task Simple Moderate Complex
Plan the solution 5-8 6-9 9-12
Implement the solution 15-23 22-34 34-50
Provide training 8-14 8-20 12-24
Close the engagement 2 2-3 3-5
Total 30-47 38-66 58-91
Task Estimated time (hours)
Simple Moderate Complex
Gather detailed requirements 2-3 2-3 3-4
Design the solution 2-3 2-3 3-4
Perform gap analysis 1-2 2-3 3-4
Total 5-8 6-9 9-12
determined the functional requirements, you can clarify the technical or
7/31/2019 Solution Deployment Guide for IBM Tivoli Composite Application Manager for WebSphere Sg247293
39/136
Chapter 2. Planning for customer engagement 27
system requirements.
The technical requirement involves spending time at the customer site todetermine and understand the available data sources. These data sourcesmay come in different formats, such as relational databases, spreadsheets,
text files, or even hard copy only. You need to be able to identify the fields ordata elements in these data sources and plan how these data elements willbe used in the target data mart. You also need to identify the schema or datausage changes from the supplied sample scenario, which is based on thenon-customized products.
The system requirement will be determined from the number and size of thedata sources and the expected goals that the business questions will cover.This information dictates the size and performance of the systems that will be
used in the solution. Design the solution
Topics that should be addressed include scalability, functionality, andperformance of this solution.
Design involves understanding the customers environment includinghardware, software, data volumes, special requirements, and operationalprocedures. It is necessary to identify and plan for any additional tuning ofsoftware that might be required because of the customers environment or
special needs. In addition, an analysis of the modifications to be made to thescenarios and reports has be performed. After you have designed theproposed solution and reviewed it with your customer, you can begindevelopment of the offering.
Perform gap analysis
This task involves performing a gap analysis to give the customer an estimateof the development effort that is required to set up the solution. At its core, theanalysis seeks to determine what customizable components need to be
extended, modified, or created. The number and complexity of customizablecomponents drive the size of the project and the required resources.
After you have designed the proposed solution and reviewed it with yourcustomer, you are ready to proceed.
Implement the solutionThe implementation of the solution is performed using the tasks described inTable 2-7 on page 25. Chapter 4, Implementation of ITCAM for WebSphere
service on page 47 offers detailed implementation tasks for the WebSphereapplication management solution.
Table 2-11 Implementation tasks
7/31/2019 Solution Deployment Guide for IBM Tivoli Composite Application Manager for WebSphere Sg247293
40/136
28 Solution Deployment Guide for IBM Tivoli Composite Application Manager for WebSphere
Detailed subtasks for the solution follow:
Install managing server Install data collector
Customize management environment Establish operation procedure Run initial data collection Run detailed data collection Collect performance reports Develop performance observation report
Provide trainingPart of your implementation responsibilities can include training selectedcustomer staff to troubleshoot basic problems and perform other operationaltasks. This could involve some of the following topics:
Solution technical design Problem Determination process Look at application logs Check software status Back up/restore important files and databases Develop a troubleshooting checklist
Establish a Frequently Asked Questions list Administer the application Generate performance reports
Task Estimated time (hours)
Simple Moderate Complex
Install managing server 1-2 1-2 1-2
Install data collector 2-3 3-4 4-6
Customize management environment 1-2 2-4 4-7
Establish operation procedure 2-3 2-4 3-6
Run initial data collection 1-2 2-4 4-7
Run detailed data collection 2-3 4-6 8-10
Collect performance reports 2-3 3-4 4-5
Develop performance observation 4-5 5-6 6-7
Total 15-23 22-34 34-50
Technical training with your customer could take 16 hours or more, depending onthe technical depth of the discussions
7/31/2019 Solution Deployment Guide for IBM Tivoli Composite Application Manager for WebSphere Sg247293
41/136
Chapter 2. Planning for customer engagement 29
the technical depth of the discussions.
Provide trainingTable 2-12 lists the training tasks.
Table 2-12 Training tasks
Close the engagementTable 2-13 lists the engagement closing tasks.
Table 2-13 Close the engagement task
Removal of data collectors Presentation of performance findings and recommendations
Closing of service engagement
2.5 Statement of work
This section provides some sample ideas for items that you can include in yourstatement of work contract. We divide this section for each solution.
2.5.1 Environment analysis serviceThe environment analysis service statement of work can consist of the sectionslisted here.
Task Estimated time (hours)
Simple Moderate Complex
Administrator training 4-8 4-12 8-16
Operator training 4-6 4-8 4-8
Total 8-14 8-20 12-24
Task Estimated time (hours)
Simple Moderate Complex
Presentation of performance findings 1 1-2 2-4
Closing of services engagement 1 1 1
Total 2 2-3 3-5
Executive summaryTh i t l i i id hi h l l t f
7/31/2019 Solution Deployment Guide for IBM Tivoli Composite Application Manager for WebSphere Sg247293
42/136
30 Solution Deployment Guide for IBM Tivoli Composite Application Manager for WebSphere
The environment analysis service provides a high-level assessment of application environment. provide an initial assessment of application on the area of , which consists of thefollowing application servers: .
The monitoring of these application servers will be conducted over the period of for two weeks. At the end of the assessment period, will presentthe assessment finding, including:
Application server performance summary
Application highlight, such as load profile, and transaction rate
Performance highlights such as: potential bottleneck, excessive errors,deadlock
Environment tuning recommendations
Solution descriptionIn the environment analysis service, will provide a managing serverhardware that runs ITCAM for WebSphere managing server. ITCAM forWebSphere data collectors will be installed on s production serversfor assessment. The data collector will mainly run in level 1 monitoring, which willhave limited impact on your servers; lab testing shows a typical increase of
2%-3% of CPU usage for the J2EE application server.
The solution assumes that the managing server connection to the data collectorswould not go through a firewall.
During the assessment period, transaction performance information andapplication server performance information will be collected and stored in theITCAM for WebSphere managing server database.
will analyze the collected performance information and possibly performmonitoring with additional detail as needed. The analysis is performeddynamically and will not need a restart of the application servers.
At the end of the assessment period, will remove the data collectors from application servers and present the performance finding.
AssumptionsThese are possible assumptions that can be used in the environment analysis
7/31/2019 Solution Deployment Guide for IBM Tivoli Composite Application Manager for WebSphere Sg247293
43/136
Chapter 2. Planning for customer engagement 31
These are possible assumptions that can be used in the environment analysisservice:
Number of data collectors to be configured Transaction rate of each application server Transaction mix of each application server
Business partner responsibilitiesIn addition to the solution implementation tasks described in Chapter 4,Implementation of ITCAM for WebSphere service on page 47, you also might
be responsible for tasks such as project management, purchasing software andhardware, general consulting, and negotiating financing options with thecustomer.
Customer responsibilitiesThis section describes the responsibilities the customer has to the BusinessPartner; for example:
Designating a representative who will be the focal point for all communication
with the Business Partner relative to this project and who will have theauthority to act on the customers behalf in matters regarding this project
Designating operations personnel to work with the Business Partner asappropriate
Providing all required Web site content in digital form, as specified by theBusiness Partner
Providing all product data in a format as requested
Providing all data and information required for implementation
Providing suitable workspace with telephone access for the servicesspecialists while working on customer premises
Providing user IDs, passwords, and IP addresses as required, enabling theBusiness Partner to perform the service
Providing information to allow estimates on current and future systemworkload and performance expectations
Note: Insert any additional assumptions about specific performance ortransaction problem that the customer has.
Staffing estimatesThe project will be performed using one ITCAM for WebSphere specialist who
7/31/2019 Solution Deployment Guide for IBM Tivoli Composite Application Manager for WebSphere Sg247293
44/136
32 Solution Deployment Guide for IBM Tivoli Composite Application Manager for WebSphere
The project will be performed using one ITCAM for WebSphere specialist whowill be on site as required by the project schedule. The project is estimated to beperformed within three weeks.
Project schedule and milestonesBecause this is a short project, we would not really need a milestone. Figure 2-1on page 32 shows a sample project schedule.
Figure 2-1 Project schedule
Testing methodologyThe testing of the solution is demonstrated using the reports generated byITCAM for WebSphere in PDF format. will generate the following reportsduring the assessment period:
Top CPU user reports (daily) Top transaction usage (daily) Top response time report (daily) Transaction hourly profile on a day for top five transactions (weekly) Memory analysis report on the application server (once)
DeliverablesThe deliverable of this project can be in the following form:
ITCAM for WebSphere reports that are used for testing the solution Performance assessment and recommendation presentation by you
Completion criteriaThe completion criteria should be listed here. You have to engage with thecustomer to get a proper signoff of the project with an appropriate completioncriteria. Some ideas for the completion criteria are:
Acceptance of the performance finding and recommendations.
Data collectors and managing server have been removed from the customerenvironment.
ID Task Name Start Finish Duration
Jun 18 2006 Jun 25 2006 Jul 2 2006
19 20 21 22 23 24 25 26 27 28 29 30 1 2
1 3d6/21/20066/19/2006Plan the solution
2 8d7/3/20066/22/2006Implement the solution
3 2d7/5/20067/4/2006Close the engagement
3 4 5
Specific performance problems or offending transaction resolutions may beincluded explicitly in the completion criteria. You have to be aware of these
7/31/2019 Solution Deployment Guide for IBM Tivoli Composite Application Manager for WebSphere Sg247293
45/136
Chapter 2. Planning for customer engagement 33
p y padditional specific completion criteria for your customer.
2.5.2 WebSphere application management service
The WebSphere application management service statement of work canconsists of the sections listed here.
Executive summaryThe WebSphere application management service implements ITCAM forWebSphere in environment. ITCAM for WebSphere enablesproactive monitoring of WebSphere Application Server and transactionperformance. The implementation covers the application servers in .
The initial monitoring of these application servers will be conducted over theperiod of for two weeks. At the end of the assessment period, will present the assessment finding, including:
Application server performance summary
Application highlight, such as load profile, and transaction rate
Performance highlights such as: potential bottleneck, excessive errors,
deadlock Environment tuning recommendations
will also train for using ITCAM for WebSphere to manageyour own environment.
Solution descriptionIn the WebSphere application management service, will install ITCAM forWebSphere managing server on your hardware platform. ITCAM for WebSphere
data collectors will be installed on s production servers forassessment. The data collector will mainly run in level 1 monitoring, which willhave limited impact on your servers; lab testing shows a typical increase of2%-3% of CPU usage for the J2EE application server.
The solution assumes that the managing server would not have to connect to thedata collector through a firewall.
During the assessment period, transaction performance information and
application server performance information will be collected and stored in theITCAM for WebSphere managing server database.
will analyze the collected performance information and possibly performmonitoring with additional detail as needed. The analysis is performed
7/31/2019 Solution Deployment Guide for IBM Tivoli Composite Application Manager for WebSphere Sg247293
46/136
34 Solution Deployment Guide for IBM Tivoli Composite Application Manager for WebSphere
dynamically and will not require a restart of the application servers.
will provide training for personnel to use and maintain theITCAM for WebSphere solution that has been implemented.
AssumptionsPossible assumptions that can be used in the environment analysis serviceinclude:
Number of data collectors to be configured Transaction rate of each application server Transaction mix of each application server
Business Partner responsibilitiesBusiness Partner responsibilities are described in Chapter 4, Implementation ofITCAM for WebSphere service on page 47. In addition to the solutiondevelopment tasks described in this chapter, you also might be responsible fortasks such as project management, purchasing software and hardware, general
consulting, and negotiating financing options with the customer.
Customer responsibilitiesThis section describes the responsibilities the customer has to the BusinessPartner, such as:
Designating a representative who will be the focal point for all communicationwith the Business Partner relative to this project and who will have theauthority to act on the customers behalf in matters regarding this project
Designating operations personnel to work with the Business Partner asappropriate
Providing all required Web site content in digital form, as specified by theBusiness Partner
Providing all product data in a format as requested
Providing all data and information required for implementation
Providing suitable workspace with telephone access for the services
specialists while working on customer premises Providing user IDs, passwords, and IP addresses as required, enabling the
Business Partner to perform the service
Note: Insert any additional assumption about specific performance ortransaction problem that the customer has.
Providing information to allow estimates on current and future systemworkload and performance expectations
7/31/2019 Solution Deployment Guide for IBM Tivoli Composite Application Manager for WebSphere Sg247293
47/136
Chapter 2. Planning for customer engagement 35
Staffing estimatesThe project will be performed using one ITCAM for WebSphere specialist who
will be on site as required by the project schedule. The project is estimated to beperformed within three weeks.
Project schedule and milestonesBecause this is a short project, we would not really need a milestone. Figure 2-2shows a sample project schedule.
Figure 2-2 Project schedule
Testing methodologyThe testing of the solution is demonstrated using the reports generated by
ITCAM for WebSphere in PDF format. will generate the following reportsduring the assessment period:
Top CPU user reports (daily) Top transaction usage (daily) Top response time report (daily) Transaction hourly profile on a day for top five transactions (weekly) Memory analysis report on the application server (once)
DeliverablesThe deliverable of this project can be in the following form:
ITCAM for WebSphere managing server installed and running ITCAM for WebSphere reports that are used for testing the solution Performance assessment and recommendation presentation by you Operational procedure for ITCAM for WebSphere operation Training material and presentation
ID Task Name Start Finish Duration
Jun 18 2006 Jun 25 2006 Jul 2 2006
19 20 21 22 23 24 25 26 27 28 29 30 1 2
1 3d6/21/20066/19/2006Plan the solution
2 8d7/3/20066/22/2006Implement the solution
3 2d7/5/20067/4/2006Close the engagement
3 4 5
Completion criteriaThe completion criteria should be listed here. You have to engage with the
7/31/2019 Solution Deployment Guide for IBM Tivoli Composite Application Manager for WebSphere Sg247293
48/136
36 Solution Deployment Guide for IBM Tivoli Composite Application Manager for WebSphere
customer to get a proper signoff of the project with an appropriate completioncriteria. Some ideas for the completion criteria are:
Acceptance of the performance finding and recommendation
Data collectors and managing server have been removed from the customerenvironment
Specific performance problems or offending transaction resolutions may beincluded explicitly in the completion criteria. You have to be aware of theseadditional specific completion criteria for your customer.
3
7/31/2019 Solution Deployment Guide for IBM Tivoli Composite Application Manager for WebSphere Sg247293
49/136
Copyright IBM Corp. 2006. All rights reserved. 37
Chapter 3. Demonstration of ITCAM forWebSphere
This chapter describes the tasks for demonstrating ITCAM for WebSphere. Itinclu
Top Related