This tutorial takes you through the steps for configuring the environment for runtime analysis of standalone applications. Runtime analysis is the software development practice targeted at understanding software behavior during runtime, including memory profiling, performance profiling, thread debugging, and code coverage analysis. The tutorial also covers the runtime analysis options for identifying JavaTM memory leaks, creating a simple probe and applying it to a Java program, and detecting thread bottlenecks, which are all features that are available in IBM® Rational® Application Developer for WebSphere® Software (IBM Rational Application Developer) as well as IBM Rational Software Architect.
This tutorial is written for those new to Rational Application Developer or anyone in a developer role that would like to learn about runtime analysis. Some knowledge of Java programming is required.
To complete the steps in this tutorial, download the IBM Rational Application Developer for WebSphere Software.
Unzip the resources.zip file to the directory of this tutorial.
Select Rational Application Developer Win-Full. Rational Application Developer v6.0 for Windows FULL includes the IBM WebSphere Portal 5.0 test server and Agent Controller for remote deployment to WebSphere application servers.
For this tutorial, I used a few different sample applications, which you can find in the Resources folder. An explanation of each of the applications is included in Applications used with this tutorial. You will import these resources within their respective sections (Identifying Java memory leaks, Creating a simple probe and applying it to a Java program, and Detecting thread bottlenecks).
To get started on this tutorial, the Windows version of IBM Rational Application Developer (included as part of IBM Software Development Platform) must be installed on your machine. During the installation, select the IBM WebSphere 6.0 test environment option. If you have already installed the IBM Rational Application Developer and did not select this option during installation, you can install this feature with the IBM Software Development Platform installer. You need to install the IBM Rational Agent Controller while performing the installation.
To get the Agent Controller started, search your hard drive
for RAService.exe. Once you find it, you can open a DOS
prompt and move down the path to the RAService.exe
file found in the bin directory.
In this directory, you should have a manageservice.exe file as well.
At your prompt of the DOS command window, type
manageservice add service name
, where service name is what you would like
to call the service and unzip directory is the name of the
directory where you would like to install the Agent
Controller information. If you run into problems
running the manageservice command, see the
Running the Server as a Windows Service section in the
getting_started.html file that is located at the same
level as the bin directory.
To check if the Rational Agent Controller is running, go to your Control Panel and choose Administrative Tools > Services. Look for the name that you just provided when running the manageservice add command.