Profiling tools allow you to gather runtime statistics and analyze
the performance of your portlets.
To use profiling tools to analyze the performance of a portlet running
in the portal test environment, you must first
install the Agent Controller on the same system as the Rational
® Software
Development Platform.
To profile a portlet project in the portal test environment:
- Define a local
portal test environment server.
- Start the Agent Controller.

- Open
- Highlight the IBM Rational Agent Controller service.
Right-click and select Start.

Type the following from a command window:
cd Agent_Controller_installation_root/bin
./RAStart.sh
where Agent_Controller_installation_root is
the directory where you installed Agent Controller.
- Define profiling
options.
- Switch to the Web perspective ().
- From the Project Explorer view, expand Dynamic Web Projects.
Select a portlet project, right-click and select .
- When the Server Selection wizard opens,
select a portal test environment server from the list. Click Finish. The test environment starts in profiling mode, the portlet is
published, and the Profile on server wizard opens.
- On the Agents tab, highlight the unknown agent
in the left pane. Click > to move the agent to the Selected
Agents list in the right pane.
- You can use the Profiling tab to override
your default profiling settings.
- Click Finish.
- If the Profiling Tips dialog box opens,
click OK.
- If the Confirm Enablement dialog box appears,
click OK.
- The Profiling and Logging perspective opens.
- In the Profiling Monitor view of the Profiling
and Logging perspective, right-click
and select Start Monitoring.
- Switch back to the Web perspective and use
your portlet application.
- Switch back to the Profiling and Logging perspective.
- Right-click and select Pause Monitoring.
- From the Profiling Monitor view, double-click
one of the entries, such as Execution Time Analysis. The statistics that you collected appear on the right. If the
statistics do not display correctly, right-click in the right pane and select Refresh
Views.
- Right-click and select Detach from Agent.
Warning: Do not use the Terminate option.
This stops the server that is being monitored.