Before you start
Learn what to expect from this tutorial, and how to get the most out of it.
This is Part 3 of the "Managing pureQuery-enabled applications efficiently" series. Part 1 introduced the concept of using a repository with client optimization. Also, you learned how to use Ant scripts to facilitate the process of creating a repository. Now you will build upon these concepts so you can develop a fully automated client optimization system to help analyze and improve your applications.
Editor's note: Part 2 of this series is scheduled for publication in June 2011.
The primary goal of this tutorial is to provide you with an Ant script framework that incorporates the pureQuery ManageRepository utility to automate maintaining a repository. The ManageRepository functions include creating a runtime group inside the repository, uploading and extracting repository artifacts, merging and configuring repository artifacts, and reporting repository information. These tasks will be performed to analyze a web application deployed inside WebSphere® Application Server.
Figure 1 illustrates the architecture of the framework.
Figure 1. Architecture framework showing automated process
Most importantly, once you have a good grasp of this framework, you can customize it to suit your needs. For instance, if you are experiencing performance issues, you can modify the framework to simulate heavy workloads or long execution time. Or if you want to provide a quick demo, you can modify it to showcase all of client optimization's functionality.
Before diving in too deep, you must have a good understanding of the previous tutorials. If you do not know how to create a repository with Ant scripts, then begin with Part 1.
The objective of this tutorial is to provide a skeleton automation system you can customize to suit your application analysis needs. You will learn to:
- Deploy your application inside WebSphere Application Server.
- Configure the environment and property files that will be used by the Ant scripts.
- Customize your Ant XML file (repository.xml file) to suit the needs of your application.
- Analyze reports regarding your application.
The following software components must be available:
- WebSphere Application Server 6.0+
- pureQuery Runtime 2.18+
- JCC 3.57+
- Apache Ant 1.7+
- Database for Transactions and Repository
- Eclipse 3.4+ or Optim Development Studio (ODS) 2.2.0.3+
You will need to have either ODS 2.2.0.3 installed or Eclipse 3.4 installed on your machine. Also, you must have access to WebSphere Application Server 6.0 or higher, where you can deploy your application. WebSphere must be configured with a data source that connects to a transactional database. This will allow your application to execute against the database as client optimization captures the executed SQL. Also, Apache ANT must be on the classpath of your Eclipse and Optim Development Studio environment so that you execute Ant scripts. You should know this procedure from the previous tutorials.

