(r30) RTCPlanLoading < Deployment

Engineering Lifecycle Management Wiki - Deployment
Community information and contribution guidelines
~~EditAttach~~Printable
TWiki > Deployment Web > DeploymentTroubleshooting > PerformanceTroubleshooting > RTCPlanLoading
Revision 30 - 2013-10-07 - 18:33:48 - Main.sbagot
<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%">
---+!! <img src="https://jazz.net/wiki/pub/Deployment/WebPreferences/new.png" alt="new.png" width="50" height="50" align="right"/> Why does my RTC plan take so long to load?
Authors: PerformanceTroubleshootingTeam <br>
Build basis: Rational Team Concert 4.0.3
%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>
Depending on the size and complexity of the plan in IBM Rational Team Concert (RTC), plans may take some time to load.
---++ Initial assessment

---+++ Symptoms
Accessing large plans in Rational Team Concert results in a long loading time.

---++ Impact/scope

   * On which type of client does it happen (Web UI, Eclipse, Microsoft Visual Studio)?
   * Does it happen for all or multiple plans?

---++ Recommended data gathering and subsequent analysis steps
 
   * You can use [[https://jazz.net/wiki/bin/view/Deployment/HowToHTTPWatch][HTTPWatch]] to determine exactly how long the plan takes to load. HTTPWatch will also gather and export information about the calls being made when loading the plan. 
   * Browser efficiency with relation to the CLM applications is directly related to the !JavaScript engine. Try to load the plan in a different browser and see if the performance increases. For information about different browsers, see [[https://jazz.net/wiki/bin/view/Deployment/BrowserPerformance][Browser Performance]].
   * Establish and document a baseline with HTTPWatch to measure any further progress against (document the poor behavior).

---++ Possible causes and solutions
---+++ When using the Eclipse client
   * If you are experiencing performance issues when loading plans in the Eclipse client, consider testing the same behavior in the Web UI. Plans are best viewed in the Web UI because the Eclipse based plan editor does not have all the latest features.
   * In case you observe that the RTC Client runs out of memory while loading plans, you can attempt to increase heap size. If the RTC Client is installed standalone, you can make the changes in the file: <verbatim>
 <RTC_HOME>/client/eclipse/eclipse.ini file</verbatim> For example, to increase the maximum heap size to 1GB, you can add or modify the parameter -xmx after the parameter -vmargs.<verbatim>
-Xms256m
-Xmx1024m </verbatim> If the RTC Client (Extension install) is installed in the same shell with other Eclipse-based IDEs, the eclipse.ini file will be located in the installation directory of the other IDE.
   * You may increase the Maximum thread pool for RTC client operations. Follow these steps:
      1 Open the RTC Client and select *Window > Preferences > Team > Jazz Source Control > Content Transfer*
      1 Increase the value of *Maximum number of Threads*  (the default is 10); increasing the thread count in increments of 5 or less. 
           View performance statistics on each incremental change to find a balance between system resources and server availability. 
      1 Select *Show traffic statistics in status bar*
      1 You can now open the Jazz Metronome UI found in the lower right corner of the RTC Client. 
      1 Metronome will collect statistics allowing you to tune the threads and heap to optimal performance. See: [[https://jazz.net/wiki/bin/view/Deployment/RTCClientPerformance#RTC_Client_for_Eclipse_IDE_slow][RTC Client for Eclipse IDE: slow response]]

---+++ When using the Visual Studio client
The Rational Team Concert Client for Microsoft Visual Studio lets you create new plans and edit existing ones from an embedded web browser based plan editor.  See: When using the Web UI.
---+++ When using the Web UI
When using the Web UI, you can improve performance by tuning your plans and by upgrading to version 4.0.1 or higher.
---++ Tuning your plans for increased loading performance
The size and the complexity of the data contained in the plan influences performance and overall loading time. Tuning the plans for overall size, top level work items, grouping and sorting will all affect how the plan loads.
You can reduce this size and complexity as described in technote [[http://www.ibm.com/support/docview.wss?uid=swg21612656][How to Improve Performance while loading large plans in the Web UI]].

There are also some product level enhancements in 4.0.3 which will change the layout of your plan and thus, load it much faster. For information on this tuning, see [[https://jazz.net/wiki/bin/view/Main/FineTuningParameters#Parameters][Fine Tuning Parameters]] for plans.

---++ Plan improvements in Rational Team Concert
   * In *Rational Team Concert 4.0.1*, significant improvements have been made to both loading work items in batch, as well as compressing the work item data which results in a [[https://jazz.net/products/rational-team-concert/whatsnew/][performance increase of up to 25% faster in the web UI]], especially in low bandwidth networks.
   * In *Rational Team Concert 4.0.2*, there were no additional improvements to the planning component, so you can expect typically the same performance with plan loading as observed in 4.0.1 if you upgrade.
   * In *Rational Team Concert 4.0.3*, you can expect to see an additional 40% improvement in plan loading due to the changes described in the article: [[https://jazz.net/wiki/bin/view/Main/PlanLoading][Plan performance improvements in Rational Team Concert, Version 4.0.3]]

---+++++!! Related topics: 

   * [[BrowserPerformance][Browser performance]]
   * [[https://jazz.net/wiki/bin/view/Deployment/HowToHTTPWatch][How to use HTTPWatch]]
   * [[https://jazz.net/wiki/bin/view/Deployment/RTCClientPerformance][Why is the Rational Team Concert client slow?]]
   * [[https://jazz.net/wiki/bin/view/Deployment/PerformanceTroubleshooting][Performance troubleshooting]]

---+++++!! External links:

   * How to Improve Performance while loading large plans in the Web UI: [[http://www.ibm.com/support/docview.wss?uid=swg21612656][http://www.ibm.com/support/docview.wss?uid=swg21612656]]
   * Getting Started with Planning in Rational Team Concert 4.0: [[https://jazz.net/library/article/593/][https://jazz.net/library/article/593/]]
   * Effective Planning with Rational Team Concert 4.0: [[https://jazz.net/library/article/594/][https://jazz.net/library/article/594/]]
   * Customizing the Agile Planning tools in Rational Team Concert 4.0: [[https://jazz.net/library/article/587/][https://jazz.net/library/article/587/]]
   * What's new in Rational Team Concert: [[https://jazz.net/products/rational-team-concert/whatsnew/][https://jazz.net/products/rational-team-concert/whatsnew/]]

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

---+++++!! Questions and comments:

%COMMENT{type="below" target="RTCPlanLoadingComments" button="Submit"}%

%INCLUDE{"RTCPlanLoadingComments"}%

<sticky></div></sticky>
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.