(r11) ProfileRationalTeamConcertClientForEclipse < Deployment

Engineering Lifecycle Management Wiki - Deployment
Community information and contribution guidelines
~~EditAttach~~Printable
TWiki > Deployment Web > DeploymentTroubleshooting > PerformanceTroubleshooting > RTCClientPerformance > ProfileRationalTeamConcertClientForEclipse
Revision 11 - 2013-04-23 - 15:06:28 - Main.sbeard
<sticky><div id="container" >
<div id="header-title" style="padding: 10px 15px; border-width:1px; border-style:solid; border-color:#FFD28C; background-image: url(<nop>https://jazz.net/wiki/pub/Deployment/WebPreferences/TLASE.jpg); background-size: cover; font-size:120%">
---+!! How to profile the Rational Team Concert client for Eclipse IDE
%DKGRAY% Authors: Main.LaraZiosi <br>
Build basis: RTC, 4.0.1
%ENDCOLOR%</div></sticky>

<!-- Page contents top of page on right hand side in box -->
<sticky><div style="float:right; border-width:1px; border-style:solid; border-color:#DFDFDF; background-color:#F6F6F6; margin:0 0 15px 15px; padding: 0 15px 0 15px;">
%TOC{title="Page contents"}%
</div></sticky>

<sticky><div style="margin:15px;"></sticky>

Profiling allows you to get very detailed timing information about individual method calls in the Rational Team Concert Client for Eclipse IDE. Profiling is only recommended if you are trying to address a very specific performance concern, and typically you will want to supply the gathered information to IBM support for more investigation. In general, Profiling produces a very large amount of trace data. It is best to keep the profiling session as short as possible, and perform only the steps that are strictly required to reproduce the observed performance issue.

If you are using a standalone installation of the Rational Team Concert Client for Eclipse IDE, you can use the Eclipse Test & Performance Tools Platform Project (TPTP) profiling capabilities, which are freely available. 

|If the Rational Team Concert Client for Eclipse IDE is installed in the same Installation Manager Package Group with Rational Application Developer or Rational Software Architect (for <noautolink>WebSphere</noautolink>), you have the additional option of using a built-in profiling agent.  See the technote [[http://www-01.ibm.com/support/docview.wss?uid=swg21627067][How can you tell what is the exact cause of the slow response of the product?]].|

---++ Eclipse Test & Performance Tools Platform Project (TPTP) installation prerequisites

   * The required TPTP software is included in the following products:
      * Rational Application Developer 
      * Rational Software Architect 
      * Rational Software Architect for <noautolink>WebSphere </noautolink>

   * Alternatively, you can install a standalone [[http://www.eclipse.org/downloads/packages/release/helios/sr2][Eclipse 3.6.2 (Helios)]]. You will have to add TPTP 7.2.4 as described in: [[http://wiki.eclipse.org/Install_TPTP_with_Update_Manager][Install TPTP with Update Manager]]. Note that Eclipse 3.6.2 is the highest version of Eclipse that includes TPTP.

---++ Launching the Rational Team Concert Client for Eclipse IDE in profiling mode

---+++ Prepare the Rational Team Concert Client for Eclipse IDE for profiling

Prepare the Rational Team Concert Client for Eclipse IDE for profiling as follows:

   1 Open the file _eclipse.ini_, located in the RTC Client for Eclipse IDE installation directory. 
   1 Determine what is the location of the JVM used (found after the -vm argument)
   1 Determine the version and the bitness of the JVM, by launching the command: <verbatim>java -version</verbatim> from the directory where the JVM is located
   1 If the RTC Client JVM version is 32bits, then you will need to use the 32bits profiler agent, if the RTC Client JVM is 64bits, you will need to use the 64bits profiler agent. 
   1 The location of the Java profiler agents (referred to as *Java profilers absolute path* in the following sections) is as follows:%BR% For Windows:<verbatim><<Eclipse Home>>\plugins\org.eclipse.tptp.platform.jvmti.runtime_<version>\agent_files\<os_platform></verbatim>For Linux: <verbatim><<Eclipse Home>>/plugins/org.eclipse.tptp.platform.jvmti.runtime_<version>/agent_files/<os_platform> </verbatim>
   1 To profile the RTC Client for Eclipse IDE with the CPU Profiler in standalone mode, with filters contained in _filters.txt_ and writing the results into _log.trcxml_, add the following line at the very end of the _eclipse.ini_ file (after the _-vmargs_ argument) %BR% For Windows: <verbatim>-agentpath:<Java profilers absolute path>\JPIBootLoader=JPIAgent:server=standalone,file=log.trcxml,filters=filters.txt;CGProf </verbatim> For Linux the entire library file name must be used. So _libJPIBootLoader.so_ should be used instead of _JPIBootLoader_ or _libJPIBootLoader_: <verbatim>-agentpath:<Java profilers absolute path>/libJPIBootLoader.so=JPIAgent:server=standalone,file=log.trcxml,filters=filters.txt;CGProf </verbatim>
   1 For example, for a Windows installation of RTC Client for Eclipse 64 bits, you would use: <verbatim>
-agentpath:C:\eclipse-java-helios-SR2-win32-x86_64\eclipse\plugins\org.eclipse.tptp.platform.jvmti.runtime_4.6.3.v201102041710\agent_files\win_em64t\JPIBootLoader=JPIAgent:server=standalone,file=log.trcxml,filters=filters.txt;CGProf</verbatim>
   1 Save the _eclipse.ini_ file.

---+++ Prepare the filters

Filtering is mandatory in this case: if you do not filter anything the RTC Client for Eclipse IDE will be unacceptably slow and the resulting _log.trcxml_ file will be multiple Gigabytes just to complete the startup phase.

   1 Create a file called _filters.txt_ in the same directory where _eclipse.ini_ is located.
   1 Use the following contents to start with: <verbatim> 
com.ibm.team.* * INCLUDE
* * EXCLUDE
</verbatim> This means that all the methods of all the classes in packages that start with _com.ibm.team_ are included, and all other methods are excluded. You might be able to restrict the filters further based on your knowledge of the problem area, or you might want to include some of the Eclipse packages if they are relevant to the problem at hand. For the full syntax of the filters, see [[http://publib.boulder.ibm.com/infocenter/radhelp/v8r5/index.jsp?topic=%2Forg.eclipse.tptp.platform.doc.user%2Ftasks%2Fteprofsa.htm][Profiling an application in stand-alone mode]].

---+++ Launch the RTC Client for Eclipse and reproduce the issue
   1 Open a command prompt.
   1 Change directory to the installation directory of the Rational Team Concert Client for Eclipse, so that the file filters.txt is found in the current directory.
   1 Launch the RTC Client for Eclipse from that directory.
   1 Reproduce the problem (note that the execution time will be significantly slower than normal, depending on how many methods you included in the filters). Make sure to keep the session as short as possible (do not include unnecessary operations, or reading the resulting data will be more difficult).
   1 Collect the file _log.trcxml_
   1 Remember to remove the additional line from the _eclipse.ini_ file.

---+++ Read the profiling data

To read the profiling data, you need to launch one of the products listed in the Installation prerequisites section above. Then proceed as follows:

   1 Open the Profiling and Logging Perspective: *Window &gt; Open Perspective &gt; Other &gt; Profiling and Logging*
   1 Right click on the Profiling Monitor view and select: *Import &gt; Profiling and Logging &gt; Profiling file*, as follows: <br /><img alt="ImportProfilingFile.jpg" src="%ATTACHURL%/ImportProfilingFile.jpg" />
   1 Wait for the file to be imported, then right-click on it and choose: *Open with &gt; Execution statistics*. You will see results like the following: <br /><img alt="ProfilingResults1.jpg" src="%ATTACHURL%/ProfilingResults1.jpg" />
   1 You can drill down to the individual method level. You can see how many times a method was called and how much time it took.<img alt="ProfilingResults2.jpg" src="%ATTACHURL%/ProfilingResults2.jpg" />
   1 This data helps in identifying which specific methods contribute to the performance bottleneck. For the interpretation of the data, you might want to contact IBM support and supply the generated file.


---+++++!! Related topics:  
   * [[RTCClientPerformance][Why is the Rational Team Concert Client slow? ]]
   * [[PerformanceTroubleshooting][Performance Troubleshooting]]

---+++++!! External links:
   * Eclipse 3.6.2: [[http://www.eclipse.org/downloads/packages/release/helios/sr2][http://www.eclipse.org/downloads/packages/release/helios/sr2]]
   * Install TPTP with Update Manager: [[http://wiki.eclipse.org/Install_TPTP_with_Update_Manager][http://wiki.eclipse.org/Install_TPTP_with_Update_Manager]]
   * Profiling an application in stand-alone mode using Rational Application Developer or Rational Software Architect for WebSphere: [[http://publib.boulder.ibm.com/infocenter/radhelp/v8r5/index.jsp?topic=%2Forg.eclipse.tptp.platform.doc.user%2Ftasks%2Fteprofsa.htm][http://publib.boulder.ibm.com/infocenter/radhelp/v8r5/index.jsp?topic=%2Forg.eclipse.tptp.platform.doc.user%2Ftasks%2Fteprofsa.htm]]
   * Java Application profiling with TPTP: [[http://www.eclipse.org/articles/Article-TPTP-Profiling-Tool/tptpProfilingArticle.html][http://www.eclipse.org/articles/Article-TPTP-Profiling-Tool/tptpProfilingArticle.html]]
   * How can you tell what is the exact cause of the slow response of the product?: [[http://www-01.ibm.com/support/docview.wss?uid=swg21627067][http://www-01.ibm.com/support/docview.wss?uid=swg21627067]]
   * How to contact IBM support: [[http://www-01.ibm.com/software/rational/support/contact.html][http://www-01.ibm.com/software/rational/support/contact.html]]
   * How to send data to IBM support: [[http://www.ecurep.ibm.com/app/upload][http://www.ecurep.ibm.com/app/upload]]

---+++++!! Additional contributors:

---++ Comments

%COMMENT{type="below"}%

<sticky></div></div></sticky>
Attachments
Topic attachments
I	Attachment	Action	Size	Date	Who
jpg	ImportProfilingFile.jpg	manage	83.0 K	2013-02-27 - 16:03	UnknownUser
jpg	ProfilingResults1.jpg	manage	180.2 K	2013-02-27 - 16:03	UnknownUser
jpg	ProfilingResults2.jpg	manage	141.4 K	2013-02-27 - 16:03	UnknownUser
Copyright © by IBM and non-IBM contributing authors. All material on this collaboration platform is the property of the contributing authors.
Contributions are governed by our Terms of Use. Please read the following disclaimer.
Dashboards and work items are no longer publicly available, so some links may be invalid. We now provide similar information through other means. Learn more here.