Profiling portlets on local servers

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:

  1. Define a local portal test environment server.
  2. Start the Agent Controller.

    For Windows
    1. Open Control Panel > Administrative Tools > Services
    2. Highlight the IBM Rational Agent Controller service. Right-click and select Start.


    For
Linux

    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.
  3. Define profiling options.
  4. Switch to the Web perspective (Windows > Open Perspective > Other > Web > OK).
  5. From the Project Explorer view, expand Dynamic Web Projects. Select a portlet project, right-click and select Profile > Profile on Server .
  6. 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.
  7. 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.
  8. You can use the Profiling tab to override your default profiling settings.
  9. Click Finish.
  10. If the Profiling Tips dialog box opens, click OK.
  11. If the Confirm Enablement dialog box appears, click OK.
  12. The Profiling and Logging perspective opens.
  13. In the Profiling Monitor view of the Profiling and Logging perspective, right-click unknown at host name > <attached> Profiling (date time) and select Start Monitoring.
  14. Switch back to the Web perspective and use your portlet application.
  15. Switch back to the Profiling and Logging perspective.
  16. Right-click unknown at host name > <attached> Profiling (date time) and select Pause Monitoring.
  17. 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.
  18. Right-click unknown at host name > <attached> Profiling (date time) and select Detach from Agent.

    Warning: Do not use the Terminate option. This stops the server that is being monitored.

Related concepts
Getting started with runtime problem determination
Related tasks
Profiling portlets on remote servers
Installing Agent Controller
Defining profiling options
Profiling an application
Related reference
WebSphere Studio Application Developer Version 5 Programming Guide Redbook
Feedback
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.