Top Banner
Get started with DB2 Performance Expert Extended Insight Feature Uncover the mysteries of complex Java technology and database interactions Skill Level: Intermediate Alice Ma Architect IM Solutions, Warehousing IBM 25 Jun 2009 IBM® DB2® Performance Expert Extended Insight Feature extends the capabilities provided in DB2 Performance Expert by providing end-to-end database monitoring for Java™ technology applications, with even more capabilities for those running in IBM WebSphere® Application Server. This feature gives you the capability to address performance issues, regardless of where they occur in the software stack. This tutorial will help you get started with DB2 Performance Expert Extended Insight Feature. Learn how to install, configure, and validate DB2 Performance Expert Extended Insight Feature. Section 1. Introduction DBAs today must deal with complex performance problems that often require insights beyond those provided by monitoring tools that focus solely on database interactions. Java technology database applications are often part of complex, multi-tiered environments in which it can take hours, days, or more to solve a problem and require the input of IT staff in other areas, such as networking and applications. DBAs need a way to gain insight into database performance as it relates to other layers in the software stack so they have the information they need to find and fix problems quickly, whether the problem is in the database or Get started with DB2 Performance Expert Extended Insight Feature © Copyright IBM Corporation 2009. All rights reserved. Page 1 of 45
45

Get started with DB2 Performance Expert Extended Insight Feature

Oct 19, 2014

Download

Documents

 
Welcome message from author
This document is posted to help you gain knowledge. Please leave a comment to let me know what you think about it! Share it to your friends and learn new things together.
Transcript
Page 1: Get started with DB2 Performance Expert Extended Insight Feature

Get started with DB2 Performance ExpertExtended Insight FeatureUncover the mysteries of complex Java technology anddatabase interactions

Skill Level: Intermediate

Alice MaArchitect IM Solutions, WarehousingIBM

25 Jun 2009

IBM® DB2® Performance Expert Extended Insight Feature extends the capabilitiesprovided in DB2 Performance Expert by providing end-to-end database monitoringfor Java™ technology applications, with even more capabilities for those running inIBM WebSphere® Application Server. This feature gives you the capability toaddress performance issues, regardless of where they occur in the software stack.This tutorial will help you get started with DB2 Performance Expert Extended InsightFeature. Learn how to install, configure, and validate DB2 Performance ExpertExtended Insight Feature.

Section 1. Introduction

DBAs today must deal with complex performance problems that often requireinsights beyond those provided by monitoring tools that focus solely on databaseinteractions. Java technology database applications are often part of complex,multi-tiered environments in which it can take hours, days, or more to solve aproblem and require the input of IT staff in other areas, such as networking andapplications. DBAs need a way to gain insight into database performance as itrelates to other layers in the software stack so they have the information they needto find and fix problems quickly, whether the problem is in the database or

Get started with DB2 Performance Expert Extended Insight Feature© Copyright IBM Corporation 2009. All rights reserved. Page 1 of 45

Page 2: Get started with DB2 Performance Expert Extended Insight Feature

somewhere else.

DB2 Performance Expert Extended Insight Feature extends the capabilities providedin DB2 Performance Expert by providing end-to-end database monitoring for Javatechnology applications, with even more capabilities for those running in WebSphereApplication Server. It can provide insight into any stop along the software stack, fromwhen the SQL is issued from the application, through the application server,database server, and operating system. It provides insight into response times thatare closer to what end users are experiencing, and it provides valuable informationto pass on to network and applications administrators when their help is required tofix a problem.

For more information on the power of Performance Expert Extended Insight Feature,see Resources.

About this tutorial

After a discussion of sample configurations, this tutorial walks you through installing,configuring, and validating the DB2 Performance Expert Extended Insight Feature.The main steps include the following:

• Verify you have the right prerequisites

• Install the software on the necessary servers

• Activate the Performance Expert Extended Insight Feature

• Optional: Enable Performance Expert Extended Insight with WebSphereApplication Server

• Configure the Performance Expert client to recognize the ExtendedInsight Feature

• Run a workload to validate that data is being collected

Prerequisites

This tutorial assumes you have a Java technology database application you want tomonitor. To install Performance Expert Extended Insight Feature 3.2, you need thefollowing installed on Microsoft® Windows® or UNIX®:

• DB2 9.1 or later

• If using WebSphere Application Server, you need Version 6 with Fixpack21 or Version 7

developerWorks® ibm.com/developerWorks

Get started with DB2 Performance Expert Extended Insight FeaturePage 2 of 45 © Copyright IBM Corporation 2009. All rights reserved.

Page 3: Get started with DB2 Performance Expert Extended Insight Feature

• If using Java Application, you need a particular JCC and SQL driver,which is documented in the "Verify you have the right prerequisites: JavaClient Driver (IBM Driver for JDBC and SQLJ)" section

• Performance Expert V3.2 or later (installed and configured) to monitoryour target database

The differences between Windows and UNIX are highlighted throughout the tutorial.

Section 2. Performance Expert Extended Insight Featurearchitecture: A sample configuration

The Performance Expert Extended Insight Feature has two components that mustbe installed:

• Performance Expert Extended Insight Feature Activation

• Performance Expert Extended Insight Feature Client

You must install the Performance Expert Extended Insight Feature Activation Kit onyour Performance Expert Server, which licenses your Performance Expert Server touse the extended insight capabilities.

You must install the Performance Expert Extended Insight Feature Client on thefollowing units:

• On all database client machines that are to be monitored

• On all machines with the IBM Data Server Driver for JDBC and SQLJ thatare collecting monitoring data

Figure 1 illustrates a configuration using DB2 Performance Expert Extended InsightFeature to monitor Java applications that access DB2 on Linux®, UNIX, andWindows. The Performance Expert Extended Insight Feature Client is installed onthe box where your Java application is located, which uses the IBM Data ServerDriver for JDBC and SQLJ for database access.

Figure 1. Configuration without WebSphere Application Server

ibm.com/developerWorks developerWorks®

Get started with DB2 Performance Expert Extended Insight Feature© Copyright IBM Corporation 2009. All rights reserved. Page 3 of 45

Page 4: Get started with DB2 Performance Expert Extended Insight Feature

Figure 2 shows a typical sample configuration that includes WebSphere ApplicationServer. The Performance Expert Extended Insight Feature Client is installed on theWebSphere Application Server.

Performance Expert Extended Insight Feature Activation (License) is installed on thePerformance Expert V3.2 Server. By using DB2 Performance Expert end-to-endmonitor, the DBA now has insight into the WebSphere Application Serverconfiguration, number of connection pool size max, connection pool size high watermark, max allowed in connection pool size, client time, network time, and more.

Figure 2. Typical configuration using WebSphere Application Server

developerWorks® ibm.com/developerWorks

Get started with DB2 Performance Expert Extended Insight FeaturePage 4 of 45 © Copyright IBM Corporation 2009. All rights reserved.

Page 5: Get started with DB2 Performance Expert Extended Insight Feature

Mixing your UNIX platforms

With DB2 Performance Expert Extended Insight, you can use different UNIXplatforms (IBM AIX®, Sun Solaris, Linux 32-bit, Linux 64-bit, and HPU-UX). Forexample, DB2 Performance Expert Server could be on AIX, and WebSphereApplication Server, the Java technology application, or both could be on Linux. Forthis tutorial, the DB2 Performance Expert Sever is on AIX, and the WebSphereApplication Server is on Linux 64-bit.

Section 3. Verify you have the right prerequisites

You need to verify that DB2, Performance Expert V3.2, and the optional WebSphereApplication Server are at the minimum-required levels to run Performance ExpertExtended Insight feature, as described in the "Prerequisites" section. For moredetails, see "IBM DB2 Performance Expert for Linux, UNIX, and WindowsInstallation and Configuration" document (see Resources).

Verify DB2 level

Performance Expert Extended Insight Feature requires a minimum of DB2 9 for themonitored DB2. It's recommended to have DB2 9, Fix Pack 5 or DB2 9.5 (base). Tovalidate what level you have, open a DB2 command window. Enter the commanddb2level, then press the Enter key. Figure 3 shows an example of db2level

ibm.com/developerWorks developerWorks®

Get started with DB2 Performance Expert Extended Insight Feature© Copyright IBM Corporation 2009. All rights reserved. Page 5 of 45

Page 6: Get started with DB2 Performance Expert Extended Insight Feature

output that indicates the running of DB2 9.5, Fix Pack 3.

Verify DB2 Performance Expert server level

The minimum required version of DB2 Performance Expert is 3.2. It's stronglyrecommended that you also install DB2 Performance Expert V3.2 Fix Pack 2 (seeResources for a link). To validate what level you have on Windows, open a DB2command window and enter pelevel. Figure 3 shows an example of peleveloutput:

Figure 3. Verifying your Performance Expert server level in your Windowsenvironment

On UNIX, log in as the PE DB2 instance owner. Then from the <Performance ExpertInstallation>/bin directory, enter pelevel. Figure 4 shows an example of peleveloutput in UNIX:

Figure 4. Verifying Performance Expert Server level in UNIX

developerWorks® ibm.com/developerWorks

Get started with DB2 Performance Expert Extended Insight FeaturePage 6 of 45 © Copyright IBM Corporation 2009. All rights reserved.

Page 7: Get started with DB2 Performance Expert Extended Insight Feature

Verify WebSphere Application Server level (optional)

Performance Expert Extended Insight requires WebSphere Application Server V6.1,Fix Pack 21 or WebSphere Application Server V7. WebSphere Application ServerV6 and WebSphere Application Server V7 both require additional ifix APARPK74962. To obtain the ifix, contact WebSphere Support. If you're runningWebSphere Application Server V6.1.0.25, V7.0.0.5, or later, then you do not need toapply any additional fixes to your WebSphere Application Server.

To find your WebSphere Application Server version, enter versioninfo.bat foryour Windows environment and versionInfo.sh for your UNIX environment. Thedefault WebSphere Application Server install directory for Windows is<app_server_root>\bin; for UNIX, it is <app_server_root>/bin. (app_server_rootdenotes the default install directory for WebSphere Application Server.)

The following list shows the default installation root directories for WebSphereApplication Server for each platfom:

• AIX: /usr/IBM/WebSphere/AppServer

• HP-UX: /opt/IBM/WebSphere/AppServer

• Linux: /opt/IBM/WebSphere/AppServer

• Solaris: /opt/IBM/WebSphere/AppServer

• Windows: C:\Program Files\IBM\WebSphere\AppServer

If you are installing this on a different system that does not meet theminimum prerequisite for WebSphere Application Server, visit theMaintenance Download Wizard for WebSphere Application Server

ibm.com/developerWorks developerWorks®

Get started with DB2 Performance Expert Extended Insight Feature© Copyright IBM Corporation 2009. All rights reserved. Page 7 of 45

Page 8: Get started with DB2 Performance Expert Extended Insight Feature

V6.1 Web site (see Resources).

By default, WebSphere Application Server is installed in system-owned directories.Root user or administrator user (on a Windows system) may be required to accessthese default directories.

WebSphere Application Server can be installed in any directory where you havewrite access. Profiles can be created in any valid directory where you have writeaccess.

As shown in Figure 5 and Figure 6, the Installation Status Reports (for Windows andUNIX, respectively) indicate that WebSphere Application Server is at V6.1 Fix Pack21, which is the minimum support level. Even if you run the versionInfocommand using any of the additional parameters, the ifix APAR PK74962 will not beincluded in the report.

Figure 5. Verifying your WebSphere Application Server level in Windowsenvironment

developerWorks® ibm.com/developerWorks

Get started with DB2 Performance Expert Extended Insight FeaturePage 8 of 45 © Copyright IBM Corporation 2009. All rights reserved.

Page 9: Get started with DB2 Performance Expert Extended Insight Feature

Figure 6. Verifying your WebSphere Application Server level in UNIX

ibm.com/developerWorks developerWorks®

Get started with DB2 Performance Expert Extended Insight Feature© Copyright IBM Corporation 2009. All rights reserved. Page 9 of 45

Page 10: Get started with DB2 Performance Expert Extended Insight Feature

To start WebSphere Application Server from the Windows desktop, click on Start >Programs > IBM WebSphere Application Servers Network Deployment V6.1 >Profiles > <profile_name> > Start the server, as shown in Figure 7:

Figure 7. Start WebSphere Application Server from your Windows desktop

If you prefer to use the command line, enter <profile_root>\bin\startServer.bat <server>.

developerWorks® ibm.com/developerWorks

Get started with DB2 Performance Expert Extended Insight FeaturePage 10 of 45 © Copyright IBM Corporation 2009. All rights reserved.

Page 11: Get started with DB2 Performance Expert Extended Insight Feature

For UNIX, enter <profile_root>/bin/startServer.sh <server>.

<profile_root> denotes the following default directories for a profile <profile_name>for each platform:

• AIX: /usr/IBM/WebSphere/AppServer/profiles/<profile_name>

• HP-UX: /opt/IBM/WebSphere/AppServer/profiles/<profile_name>

• Linux: /opt/IBM/WebSphere/AppServer/profiles/<profile_name>

• Solaris: /opt/IBM/WebSphere/AppServer/profiles/<profile_name>

• Windows: C:\ProgramFiles\IBM\WebSphere\AppServer\profiles\<profile_name>

<profile_name> denotes the profile you assigned to your WebSphere ApplicationServer, and <server> denotes the name of the application server to start.

Figure 8. Start WebSphere Application Server from your Linux environment

To verify your WebSphere Application Server is running, from a Windows commandline enter <profile_root>\bin serverstatus.bat <server>–profileName <profile_name>.

Let's take a look at an example. Notice in Figure 9 that the <profile_name> isAppSrv02 and the <server> is server1:

1. C:\ProgramFiles\IBM\WebSphere\AppServer\profiles\AppSrv02\binserverstatus.bat server1 –profileName AppSrv01

2. Enter serverstatus.bat server1 –profileName AppSrv01.

Figure 9. Verifying WebSphere Server is running in Windows

ibm.com/developerWorks developerWorks®

Get started with DB2 Performance Expert Extended Insight Feature© Copyright IBM Corporation 2009. All rights reserved. Page 11 of 45

Page 12: Get started with DB2 Performance Expert Extended Insight Feature

From UNIX, from the command prompt, enter<profile_root>/bin/serverStatus.sh <server> –profileName<profile_name>.

Let's take a look at an example. Notice in Figure 10 that the <profile_name> isAppSrv01 and the <server> is server1:

1. /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/bin

2. Enter ./serverStatus.sh server1.

Figure 10. Verifying WebSphere Server is running in UNIX (Linux)

Java Client Driver (IBM Driver for JDBC and SQLJ)

To verify your Java client driver, go to the jcc driver directory, then enter thefollowing command (as shown in Figures 11 and 12):

java –cp "<Path for your jcc driver>\db2jcc.jar" com.ibm.db2.jcc.DB2Jcc –version

Performance Expert Extended Insight Feature requires a JDBC Type 4 driver to

developerWorks® ibm.com/developerWorks

Get started with DB2 Performance Expert Extended Insight FeaturePage 12 of 45 © Copyright IBM Corporation 2009. All rights reserved.

Page 13: Get started with DB2 Performance Expert Extended Insight Feature

connect to the Data Server. The following JCC drivers are supported:

• JCC 3.53 with APAR IZ43011 for JDBC 3 clients or later

• JCC 4.3 with APAR IZ43011 for JDBC 4 clients or later

Figure 11. Verifying your Java Client driver on Windows

Figure 12. Verifying your Java Client driver on UNIX

Note: To use Performance Expert Extended Insight, you must have at the minimumJCC version. 3.53.72. Refer to "How to find IBM DB2 Driver for JDBC and SQLJversion and environment information" in the DB2 9 for Linux, UNIX, and WindowsInformation Center for more information (see Resources for a link).

Section 4. Install the DB2 Performance Expert ExtendedInsight Feature Client on the necessary servers

Now that you have verified the DB2 Performance Expert Extended Insightprerequisites, the next step is to install the Performance Expert Extended InsightFeature Client.

As mentioned previously, you must install Performance Expert Extended InsightFeature on the following units:

• All database client machines that are to be monitored

• All machines with IBM Data Server Driver for JDBC and SQLJ that arecollecting monitoring data

ibm.com/developerWorks developerWorks®

Get started with DB2 Performance Expert Extended Insight Feature© Copyright IBM Corporation 2009. All rights reserved. Page 13 of 45

Page 14: Get started with DB2 Performance Expert Extended Insight Feature

Note: A common mistake is to install the Performance Expert Extended InsightFeature Client component on the Performance Expert Server or on the PerformanceExpert Client system. Performance Expert Extended Insight Feature Client needs tobe installed on all your WebSphere Server machines, all machines with IBM DataServer Driver for JDBC and SQLJ, or both.

The Performance Expert Extended Insight Feature Client collects valuableperformance data then transfers the performance data back to the PerformanceExpert Server where you have enabled the Performance Expert Extended InsightFeature. Later on in this tutorial, you will see how to enable (activate) yourPerformance Expert Extended Insight Feature.

1. Run the Performance Expert Extended Insight Feature Client executable.Here is a list of executables for each platform:

• AIX: IBM_PE_EI_V3_2_AIX.bin

• HP-UX: IBM_PE_EI_V3_2_HPUX_ia64.bin

• Linux: IBM_PE_EI_V3_2_Linux_x86.bin

• Solaris: IBM_PE_EI_V3_2_Solaris_Sparc.bin

• Windows: IBM_PE_EI_V3_2_Windows.exe

2. Go through the install screens. (You will need to do this on each of theservers listed above.)Figure 13. Installation screen: Choose installation directory

developerWorks® ibm.com/developerWorks

Get started with DB2 Performance Expert Extended Insight FeaturePage 14 of 45 © Copyright IBM Corporation 2009. All rights reserved.

Page 15: Get started with DB2 Performance Expert Extended Insight Feature

3. After you have installed the client, you need to apply the PerformanceExpert Extended Insight Feature Fix Pack. (See Resources for a link todownload the Fix Pack for Performance Expert Extended Insight.)

Section 5. Activate the Performance Expert ExtendedInsight Feature

1. To license Performance Expert Extended Insight Feature, run thePerformance Expert Extended Insight activation executable.Here is a list of executables for each platform:

• AIX: activateEI.sh

• HP-UX: activateEI.sh

• Linux: activateEI.sh

ibm.com/developerWorks developerWorks®

Get started with DB2 Performance Expert Extended Insight Feature© Copyright IBM Corporation 2009. All rights reserved. Page 15 of 45

Page 16: Get started with DB2 Performance Expert Extended Insight Feature

• Solaris: activateEI.sh

• Windows: activateEI.bat

2. Go through the necessary screens.

3. Click on the Activate the priced feature radio button to specify aninstallation where you would like to activate pureQuery priced feature,then click on Next, as shown in Figure 14:Figure 14. Installation screen: Activate your Performance ExpertExtended Insight Feature

4. Enter the installation directory for Performance Expert, then click on Nextto proceed.Here is a list of default Performance Expert installation directories foreach platform:

• AIX: /opt/IBM/db2pesrv/v3

• HP-UX: /opt/IBM/db2pesrv/v3

• Linux: /opt/IBM/db2pesrv/v3

developerWorks® ibm.com/developerWorks

Get started with DB2 Performance Expert Extended Insight FeaturePage 16 of 45 © Copyright IBM Corporation 2009. All rights reserved.

Page 17: Get started with DB2 Performance Expert Extended Insight Feature

• Solaris: /opt/IBM/db2pesrv/v3

• Windows: C:\Program Files\IBM\IBM DB2 Performance Expert ServerV3

Figure 15. Installation screen: Choose installation directory

5. Select the I accept the terms in the license agreement radio button,then click on Next:Figure 16. Installation screen: Accept license agreement

ibm.com/developerWorks developerWorks®

Get started with DB2 Performance Expert Extended Insight Feature© Copyright IBM Corporation 2009. All rights reserved. Page 17 of 45

Page 18: Get started with DB2 Performance Expert Extended Insight Feature

6. Review the installation information prior to executing installation, thenclick on activate:Figure 17. Installation screen: Review install process prior toexecuting installation

developerWorks® ibm.com/developerWorks

Get started with DB2 Performance Expert Extended Insight FeaturePage 18 of 45 © Copyright IBM Corporation 2009. All rights reserved.

Page 19: Get started with DB2 Performance Expert Extended Insight Feature

7. Once you verify the installation was successful, click on Done:Figure 18. Installation screen: Verify installation was successful

ibm.com/developerWorks developerWorks®

Get started with DB2 Performance Expert Extended Insight Feature© Copyright IBM Corporation 2009. All rights reserved. Page 19 of 45

Page 20: Get started with DB2 Performance Expert Extended Insight Feature

Section 6. (Optional) Enable DB2 Performance ExpertExtended Insight on your WebSphere V6.1 Fix Pack 21+ ifix

1. Start the WebSphere Application Server.

2. Open a Web browser, then enter the URL for your WebSphereApplication Server Integrated Solutions Console. For example,https://localhost:9043/ibm/console/logon.jsp.In Windows, you can start the WebSphere Application Sever forAppSrv01 profile by either entering the above URL or by clicking on Start> All Programs > IBM WebSphere > Application Server NetworkDeployment V6.1 > Profiles > AppSrv01 > Administration Console.

From the command line in UNIX, enter<profile_root>/bin/startServer.sh <server>; or for Windows,

developerWorks® ibm.com/developerWorks

Get started with DB2 Performance Expert Extended Insight FeaturePage 20 of 45 © Copyright IBM Corporation 2009. All rights reserved.

Page 21: Get started with DB2 Performance Expert Extended Insight Feature

enter <profile_root>\bin\ startServer.bat <server>.

<profile_root> denotes the following default directories for a profile<profile_name> for each platform:

• AIX: /usr/IBM/WebSphere/AppServer/profiles/<profile_name>

• HP-UX: /opt/IBM/WebSphere/AppServer/profiles/<profile_name>

• Linux: /opt/IBM/WebSphere/AppServer/profiles/<profile_name>

• Solaris: /opt/IBM/WebSphere/AppServer/profiles/<profile_name>

• Windows: C:\ProgramFiles\IBM\WebSphere\AppServer\profiles\<profile_name>

<profile_name> denotes the profile you assigned to your WebSphereApplication Server, and <server> denotes the name of the applicationserver to start.

3. Enter the user ID and password, then click on the Log in button:Figure 19. WebSphere Application Server Administration Consolelogin

4. Click on Resources > JDBC > JDBC Providers:Figure 20. WebSphere Application Server, configure JDBC driver

ibm.com/developerWorks developerWorks®

Get started with DB2 Performance Expert Extended Insight Feature© Copyright IBM Corporation 2009. All rights reserved. Page 21 of 45

Page 22: Get started with DB2 Performance Expert Extended Insight Feature

5. Double-click on Derby JDBC Provider:Figure 21. WebSphere Application Server, configure JDBC driver:Select Derby JDBC provider

6. Scroll down the page, and click on the Class path text box.

developerWorks® ibm.com/developerWorks

Get started with DB2 Performance Expert Extended Insight FeaturePage 22 of 45 © Copyright IBM Corporation 2009. All rights reserved.

Page 23: Get started with DB2 Performance Expert Extended Insight Feature

7. Scroll to the end of the line and hit the Enter key to create a new line:Figure 22. WebSphere Application Server, configure JDBC driver:Create a new line

8. Enter the Performance Expert Extended Insight Feature pdq.jar file, thenhit the Enter key to create a new line.Here is a list of default locations of the Performance Expert ExtendedInsight Feature pdq.jar file for each platform:

• AIX: /opt/IBM/DB2 Performance Expert Extended InsightFeature/pureQuery/ pdq.jar

• HP-UX: /opt/IBM/DB2 Performance Expert Extended InsightFeature/pureQuery/ pdq.jar

• Linux: /opt/IBM/DB2 Performance Expert Extended InsightFeature/pureQuery/ pdq.jar

• Solaris: /opt/IBM/DB2 Performance Expert Extended InsightFeature/pureQuery/ pdq.jar

ibm.com/developerWorks developerWorks®

Get started with DB2 Performance Expert Extended Insight Feature© Copyright IBM Corporation 2009. All rights reserved. Page 23 of 45

Page 24: Get started with DB2 Performance Expert Extended Insight Feature

• Windows: C:\Program Files\IBM\DB2 Performance Expert ExtendedInsight Feature\pureQuery\pdq.jar

9. Enter the Performance Expert Extended Insight pdqmgmt.jar file:Here is a list of default location of the Performance Expert ExtendedInsight Feature pdqmgmt.jar file for each platform:

• AIX: /opt/IBM/DB2 Performance Expert Extended InsightFeature/pureQuery/ pdqmgmt.jar

• HP-UX: /opt/IBM/DB2 Performance Expert Extended InsightFeature/pureQuery/ pdqmgmt.jar

• Linux: /opt/IBM/DB2 Performance Expert Extended InsightFeature/pureQuery/ pdqmgmt.jar

• Solaris: /opt/IBM/DB2 Performance Expert Extended InsightFeature/pureQuery/ pdqmgmt.jar

• Windows: C:\Program Files\IBM\DB2 Performance Expert ExtendedInsight Feature\pureQuery\pdqmgmt.jar

Figure 23. WebSphere Application Server, configure JDBC driver:Add Performance Expert Extended Insight Feature to your classpath

developerWorks® ibm.com/developerWorks

Get started with DB2 Performance Expert Extended Insight FeaturePage 24 of 45 © Copyright IBM Corporation 2009. All rights reserved.

Page 25: Get started with DB2 Performance Expert Extended Insight Feature

10. Scroll down the page, then click on the Apply button:Figure 24. WebSphere Application Server, configure JDBC driver:Apply changes

ibm.com/developerWorks developerWorks®

Get started with DB2 Performance Expert Extended Insight Feature© Copyright IBM Corporation 2009. All rights reserved. Page 25 of 45

Page 26: Get started with DB2 Performance Expert Extended Insight Feature

11. Click on Save:Figure 25. WebSphere Application Server, configure JDBC driver:Save changes

developerWorks® ibm.com/developerWorks

Get started with DB2 Performance Expert Extended Insight FeaturePage 26 of 45 © Copyright IBM Corporation 2009. All rights reserved.

Page 27: Get started with DB2 Performance Expert Extended Insight Feature

12. If you are running WebSphere Application Server V7, then you are done.Click on Logout.If you're running WebSphere Application Server V6, then you will need tocreate and specify customer properties for your enterprise informationsystem (EIS) data source to access DB2. Note: You only need to do thisfor WebSphere Application Server V6.

a. From the main menu on the left side of the screen, selectResources > JDBC > Data Sources.

b. Select the name of your data source. In this example, the name ofthe data source is "Trade Data Source":Figure 26. WebSphere Application Server, configure datasources

ibm.com/developerWorks developerWorks®

Get started with DB2 Performance Expert Extended Insight Feature© Copyright IBM Corporation 2009. All rights reserved. Page 27 of 45

Page 28: Get started with DB2 Performance Expert Extended Insight Feature

c. Click on Custom properties:Figure 27. WebSphere Application Server, configure datasources: Click on Custom properties

d. Click on New:Figure 28. WebSphere Application Server, configure datasources: Creating new custom properties for your enterpriseinformation system

developerWorks® ibm.com/developerWorks

Get started with DB2 Performance Expert Extended Insight FeaturePage 28 of 45 © Copyright IBM Corporation 2009. All rights reserved.

Page 29: Get started with DB2 Performance Expert Extended Insight Feature

e. Enter the following field information, then click on Apply:

• Name: enableEndToEndMonitoringFeature

• Value: trueFigure 29. WebSphere Application Server, configure datasources: Applying your new custom properties for yourenterprise information system

ibm.com/developerWorks developerWorks®

Get started with DB2 Performance Expert Extended Insight Feature© Copyright IBM Corporation 2009. All rights reserved. Page 29 of 45

Page 30: Get started with DB2 Performance Expert Extended Insight Feature

f. Click on Save:Figure 30. WebSphere Application Server, configure datasources: Save your new custom properties for your enterpriseinformation system

developerWorks® ibm.com/developerWorks

Get started with DB2 Performance Expert Extended Insight FeaturePage 30 of 45 © Copyright IBM Corporation 2009. All rights reserved.

Page 31: Get started with DB2 Performance Expert Extended Insight Feature

g. Scroll down to verify the entry has been added. You may have toclick on the "Next" button (right arrow) to view the next page:

h. Click on Logout:Figure 31. Logout

13. Close the browser.

14. After you make changes to the WebSphere Application Server, you needto stop and restart it.

a. To stop the WebSphere Applications Server from the Windowsdesktop, click on Start > All Programs > IBM WebSphere >Application Server Network Deployment V6.1 > Profiles >

ibm.com/developerWorks developerWorks®

Get started with DB2 Performance Expert Extended Insight Feature© Copyright IBM Corporation 2009. All rights reserved. Page 31 of 45

Page 32: Get started with DB2 Performance Expert Extended Insight Feature

AppSrv01 > Stop the server:Figure 32. Stop WebSphere Application Server from Windowsdesktop

If you prefer to use the command line, enter the following:<profile_root>\bin\ stopServer.bat <server>

For UNIX, enter the following, as shown in Figure 33:<profile_root>/bin/stopServer.sh <server>

<profile_root> denotes the following default directories for a profile<profile_name> for each platform:

• AIX: /usr/IBM/WebSphere/AppServer/profiles/<profile_name>

• HP-UX:/opt/IBM/WebSphere/AppServer/profiles/<profile_name>

• Linux: /opt/IBM/WebSphere/AppServer/profiles/<profile_name>

• Solaris:/opt/IBM/WebSphere/AppServer/profiles/<profile_name>

• Windows: C:\ProgramFiles\IBM\WebSphere\AppServer\profiles\<profile_name>

<profile_name> denotes the profile you assigned to yourWebSphere Application Server, and <server> denotes the name ofthe application server to stop.

Figure 33. Stop WebSphere Application Server from UNIX(Linux)

developerWorks® ibm.com/developerWorks

Get started with DB2 Performance Expert Extended Insight FeaturePage 32 of 45 © Copyright IBM Corporation 2009. All rights reserved.

Page 33: Get started with DB2 Performance Expert Extended Insight Feature

b. To start WebSphere Application Server, from the Windowsdesktop, click on Start > Programs > IBM WebSphereApplication Servers Network Deployment V6.1 > Profiles ><profile_name> > Start the serverLFigure 34. Start WebSphere Application Server from yourWindows desktop

If you prefer to use the command line, enter the following:<profile_root>\bin\ startServer.bat <server>

For UNIX, enter the following:<profile_root>/bin/startServer.sh <server>

<profile_root> denotes the following default directories for a profile<profile_name> for each platform:

• AIX: /usr/IBM/WebSphere/AppServer/profiles/<profile_name>

• HP-UX:/opt/IBM/WebSphere/AppServer/profiles/<profile_name>

• Linux: /opt/IBM/WebSphere/AppServer/profiles/<profile_name>

• Solaris:/opt/IBM/WebSphere/AppServer/profiles/<profile_name>

• Windows: C:\ProgramFiles\IBM\WebSphere\AppServer\profiles\<profile_name>

<profile_name> denotes the profile you assigned to your

ibm.com/developerWorks developerWorks®

Get started with DB2 Performance Expert Extended Insight Feature© Copyright IBM Corporation 2009. All rights reserved. Page 33 of 45

Page 34: Get started with DB2 Performance Expert Extended Insight Feature

WebSphere Application Server, and <server> denotes the name ofthe application server to start.

Figure 35. Start WebSphere Application Server from yourLinux environment

Section 7. Configure the Performance Expert Client torecognize Performance Expert Extended Insight Feature

1. Make sure the Performance Expert Server is running. On Windows, toverify the Performance Expert Server is running, open the WindowsServices, then scroll down until you see the service name "DB2Performance Expert Server V3 on <your DB2 instance name>":Figure 36. Verify Performance Expert server is running on Windows

From UNIX, enter <Performance Expert Installationdirectory>/bin/pestatus to verify the Performance Expert Server is

developerWorks® ibm.com/developerWorks

Get started with DB2 Performance Expert Extended Insight FeaturePage 34 of 45 © Copyright IBM Corporation 2009. All rights reserved.

Page 35: Get started with DB2 Performance Expert Extended Insight Feature

running:Figure 37. Verify Performance Expert Server is running on UNIX

2. Start your Performance Expert Client by clicking on the IBM DB2Performance Expert Client V3 desktop icon:

3. After opening the Performance Expert client, you need to log in and thenedit the monitored DB2 instance to enable the Performance ExpertExtended Insight Feature.

4. Click on the instance you wish to enable for Performance ExpertExtended Insight Feature on the left side of the window under Allinstances:Figure 38. Performance Expert Extended Insight Dashboard: Clickon DB2 Instance you want to monitor

ibm.com/developerWorks developerWorks®

Get started with DB2 Performance Expert Extended Insight Feature© Copyright IBM Corporation 2009. All rights reserved. Page 35 of 45

Page 36: Get started with DB2 Performance Expert Extended Insight Feature

5. Double-click on DB2 to log in to the Performance Expert Server for thisDB2 monitored instance.

6. Enter your DB2 Performance Expert user ID and password:Figure 39. Performance Expert Logon: Enter your PerformanceExpert user ID and password

7. After you have logged in, right-click on DB2 and select Properties fromthe drop-down menu:Figure 40. Performance Expert properties: Configuration settings

developerWorks® ibm.com/developerWorks

Get started with DB2 Performance Expert Extended Insight FeaturePage 36 of 45 © Copyright IBM Corporation 2009. All rights reserved.

Page 37: Get started with DB2 Performance Expert Extended Insight Feature

8. Select the End-to-End Data tab:Figure 41. Performance Expert Extended Insight: End-to-End tab

9. Select the check box next to Collect end-to-end data. After you selectthe check box, notice the end-to-dnd configuration parameters becomeactive:Figure 42. Performance Expert Extended Insight: End-to-End tabcheck box

ibm.com/developerWorks developerWorks®

Get started with DB2 Performance Expert Extended Insight Feature© Copyright IBM Corporation 2009. All rights reserved. Page 37 of 45

Page 38: Get started with DB2 Performance Expert Extended Insight Feature

10. Click on OK to accept the changes:Figure 43. Performance Expert Extended Insight: Click on OK

developerWorks® ibm.com/developerWorks

Get started with DB2 Performance Expert Extended Insight FeaturePage 38 of 45 © Copyright IBM Corporation 2009. All rights reserved.

Page 39: Get started with DB2 Performance Expert Extended Insight Feature

Section 8. Run a workload to validate data is beingcollected

Now that you have started the Performance Expert Client and enabled theend-to-end configuration:

1. Press the F5 key to refresh the screen.

ibm.com/developerWorks developerWorks®

Get started with DB2 Performance Expert Extended Insight Feature© Copyright IBM Corporation 2009. All rights reserved. Page 39 of 45

Page 40: Get started with DB2 Performance Expert Extended Insight Feature

2. Click on the monitored database under your WebSphere Application inthe left side of the System Overview window.

3. Click on the End-to-End tab to change the focus of the System Overview:Figure 44. Performance Expert Extended Insight tab

Notice the screen has NP for the different counters. NP stands for notpresent. Since you haven’t started a workload yet, nothing is beingcollected.

Figure 45. Performance Expert Extended Insight Key PerformanceIndicators (KPI) dashboard

developerWorks® ibm.com/developerWorks

Get started with DB2 Performance Expert Extended Insight FeaturePage 40 of 45 © Copyright IBM Corporation 2009. All rights reserved.

Page 41: Get started with DB2 Performance Expert Extended Insight Feature

4. Start your Java technology application or WebSphere Application tocreate a workload against the DB2 database that Performance Expert isconfigured to run against:Figure 46. Start your Java technology application or WebSphereApplication

5. Let your application run for about 5-20 minutes.

6. From the System Overview window, click on Refresh Off, then selectAutomatic. This enables current history mode (that is, data is beingcollected and displayed in real time):Figure 47. Enable refresh rate for Performance Expert ExtendedInsight: System Overview window

7. Enter 45 in the refresh rate box, and click on the green check mark toaccept the changes:Figure 48. Set Performance Expert Extended Insight refresh rate

8. Change the monitoring period to 5 minutes by clicking on the drop-downmenu next to Monitoring period: Last. This will allow you to view the last5 minutes of history on the System Overview window.Figure 49. Change monitoring period

ibm.com/developerWorks developerWorks®

Get started with DB2 Performance Expert Extended Insight Feature© Copyright IBM Corporation 2009. All rights reserved. Page 41 of 45

Page 42: Get started with DB2 Performance Expert Extended Insight Feature

You will begin to see data in the End-to-End Data base Monitoring tab:

Figure 50. Start to see end-to-end data

Section 9. Conclusion

Now that you have gone through the Performance Expert Extended Insight Featureinstallation and configuration of the Performance Expert Extended Insight Client, youcan see how easy it is to get started.

The Performance Expert Extended Insight Feature can help you:

• Improve availability of mission-critical Java database applications.You can detect negative trends sooner, including eroding response timesfor database APIs, network congestion between the application and thedatabase, or other factors key to sustaining service level agreements.

• Manage applications to meet service level agreements more easilyand effectively. Now DBAs can see the response time for single SQLrequests or complete database transactions from the applications point of

developerWorks® ibm.com/developerWorks

Get started with DB2 Performance Expert Extended Insight FeaturePage 42 of 45 © Copyright IBM Corporation 2009. All rights reserved.

Page 43: Get started with DB2 Performance Expert Extended Insight Feature

view, enabling creation of performance indicators that more directly relateto the user's experience.

• Reduce the time needed to isolate performance issues from days tominutes. Use graphical displays to see where workloads, transactions,and SQL requests originate in the application, and how the time spent isspread across the database client, the application server, the databaseserver, and the network between them. Filter by application, database,user, or other criteria.

• Improve collaboration and resolution of performance problemsacross the software stack by providing additional performanceindicators such as connection pool wait times and other vitaldatabase-related performance statistics when used with WebSphereApplication Server.

To see the Performance Expert Extended Insight in action, view an introduction toIBM DB2 Performance Expert Extended Insight Feature (see Resources for a link tothe video).

ibm.com/developerWorks developerWorks®

Get started with DB2 Performance Expert Extended Insight Feature© Copyright IBM Corporation 2009. All rights reserved. Page 43 of 45

Page 44: Get started with DB2 Performance Expert Extended Insight Feature

Resources

Learn

• DB2 Performance Expert for Linux, UNIX, and Windows: Learn more about DB2Performance Expert for Linux, UNIX, and Windows.

• IBM DB2 Performance Expert for Linux, UNIX, and Windows Installation andConfiguration documentation (IBM, 2009): Install and configure DB2Performance Expert for Linux, UNIX, and Windows.

• Maintenance Download Wizard for WebSphere Application Server V6.1: Stepthrough a series of selection panels to identify the recommended maintenancepackages for your IBM WebSphere Application Server V6.1 environment.

• "How to find IBM DB2 Driver for JDBC and SQLJ version and environmentinformation" (DB2 9 for Linux, UNIX, and Windows Information Center):Determine the version of the IBM DB2 Driver for JDBC and SQLJ, as well asinformation about the environment in which the driver is running.

• "Enabling DB2 Performance Expert Extended Insight" (WebSphere ApplicationServer Information Center): Enable DB2 Performance Expert Extended Insight(PEEI) to employ an end-to-end monitoring system for your environment.

• IBM DB2 and IMS Tools publications: Browse the DB2 Tools publications forhelp with your DB2 tools.

• Video: DB2 Performance Expert Extended Insight Feature (ChannelDB2,December 2008): See the Performance Expert Extended Insight in action. Viewan introduction to IBM DB2 Performance Expert Extended Insight Feature.

• "The top 6 tips for a successful DB2 Performance Expert deployment for DB2for Linux, UNIX, and Windows, Part 1: Modifying settings, setting up alerts, andusing System Health data views" (developerWorks, April 2009): Discover thetop 6 things you can do to get the most out of DB2 Performance Expert.

• "The top 6 tips for a successful DB2 Performance Expert deployment for DB2for Linux, UNIX, and Windows, Part 2: Taking performance baselines, usingDB2 Workload Manager, and monitoring in a partitioned environment"(developerWorks, May 2009): Discover the top 6 things you can do to get themost out of DB2 Performance Expert.

• "DB2 Performance Expert Extended Insight Feature Version 3.2" (IBM, January2009): Follow instructions to download DB2 Performance Expert ExtendedInsight Feature Version 3.2.

• "It's here! End-to-End Database Monitoring using IBM DB2 Performance ExpertExtended Insight Feature" (developerWorks, December 2008): Get familiar withthe end-to-end database monitoring capability in the new Extended InsightFeature for IBM DB2 Performance Expert.

developerWorks® ibm.com/developerWorks

Get started with DB2 Performance Expert Extended Insight FeaturePage 44 of 45 © Copyright IBM Corporation 2009. All rights reserved.

Page 45: Get started with DB2 Performance Expert Extended Insight Feature

• developerWorks Information Management zone: Learn more about InformationManagement. Find technical documentation, how-to articles, education,downloads, product information, and more.

• Stay current with developerWorks technical events and webcasts.

Get products and technologies

• Fix Packs for IBM DB2 and IMS Tools: Download the fix pack you need,including the DB2 Performance Expert V3.2 Fix Pack 2.

• Update Installer for WebSphere Application Server V6.1 and V6.0.2.21(onward): Install maintenance and updates for both IBM WebSphere ApplicationServer V6.1 and V6.0.2.21 onwards.

• Build your next development project with IBM trial software, available fordownload directly from developerWorks.

Discuss

• Participate in developerWorks blogs and get involved in the developerWorkscommunity.

About the author

Alice MaAlice Ma has over 15 years of experience in the IT industry, working with customersand IBM's Business Partners to architect solutions, develop, test, provide advancedsupport, and more. Currently she works in IBM's development at IBM Silicon ValleyLab, where she is an architect building Solutions for Warehousing while working withcustomers. Her areas of expertise include problem determination,performance/tuning, recovery, data governance, auditing, encryption, and so on forDB2. Alice has contributed her technical knowledge to the development of IBMContent Management and DB2 V9.7 Certification. She has authored a Performanceand Tuning Redbooks publication, guides, technotes, and white papers.

ibm.com/developerWorks developerWorks®

Get started with DB2 Performance Expert Extended Insight Feature© Copyright IBM Corporation 2009. All rights reserved. Page 45 of 45