KnownIssues < Deployment

Engineering Lifecycle Management Wiki - Deployment
Community information and contribution guidelines
TWiki > Deployment Web > DeploymentTroubleshooting > UpgradeTroubleshooting > CLMUpgradeTroubleshooting > KnownIssues
Revision 29 - 2015-07-24 - 17:56:49 - Main.d3v3r1tt
<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="" alt="" width="50" height="50" align="right"/> Items to consider before upgrading
Authors: [[UpgradeTroubleshootingTeam][UpgradeTroubleshootingTeam]] <br>
Build basis: CLM 4.x, CLM 5.x
%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>

Before upgrading, it is important to consider known issues on each version to validate if this will cause any issues.

---+ Items to consider before upgrading
It is important to understand the defects associated with your deployment that might not be resolved or included in the version you are upgrading to. Ensure that this will not affect your users after you upgrade.

---++ Defects fixed in specific product release
Below is a list of queries you can run on Jazz.net to validate which defects were resolved in the latest releases.
|   | *Rational Team Concert* | *Rational Quality Manager* | *Rational DOORS NG* | *Rational Jazz Foundation* |  
| APAR related Defects resolved in the release | <ul><li>[[https://jazz.net/jazz/web/projects/Jazz%20Collaborative%20ALM#action=com.ibm.team.workitem.runSavedQuery&id=_3OWRrgd4EeScusBHOj7kTg][RTC 4.0.7]]</li><li>[[https://jazz.net/jazz/web/projects/Rational%20Team%20Concert#action=com.ibm.team.workitem.runSavedQuery&id=_72kPoC3oEeSv1PLrFzJHAg&tq][RTC 5.0.2]]</li><li>[[https://jazz.net/jazz/web/projects/Rational%20Team%20Concert#action=com.ibm.team.workitem.runSavedQuery&id=_zm2XUXDzEeSXbqAAJhWI1g][RTC 6.0]]</li></ul> | <ul><li>[[https://jazz.net/jazz02/web/projects/Rational%20Quality%20Manager#action=com.ibm.team.workitem.runSavedQuery&id=_HIVN4KUoEeOv35RHgfafDw][RQM 4.0.7]]</li><li>[[https://jazz.net/jazz02/web/projects/Rational%20Quality%20Manager#action=com.ibm.team.workitem.runSavedQuery&id=_CVd8JTPQEeSp3ZV9kbQyqg][RQM 5.0.2]]</li><li>[[https://jazz.net/jazz02/web/projects/Rational%20Quality%20Manager#action=com.ibm.team.workitem.runSavedQuery&id=_3ASJsEhhEeSxz--A8sIA7g][RQM 6.0]]</li></ul> | <ul><li>[[https://jazz.net/jazz03/web/projects/Requirements%20Management#action=com.ibm.team.workitem.runSavedQuery&id=_6zcgsP4PEeO8_eJPOih81Q][RRC 4.0.7]]</li><li>[[https://jazz.net/jazz03/web/projects/Requirements%20Management#action=com.ibm.team.workitem.runSavedQuery&id=_hFVqoTdxEeSuD-k_WiY3-A][RDNG 5.0.2]]</li><li>[[https://jazz.net/jazz03/web/projects/Requirements%20Management#action=com.ibm.team.workitem.runSavedQuery&id=_Yy-AkXp0EeShILBQkrF6Hw][RDNG 6.0]]</li></ul>| <ul><li>[[https://jazz.net/jazz/web/projects/Jazz%20Foundation#action=com.ibm.team.workitem.runSavedQuery&id=_BUqgrghFEeScusBHOj7kTg][JFS 4.0.7]]</li><li>[[https://jazz.net/jazz/web/projects/Jazz%20Foundation#action=com.ibm.team.workitem.runSavedQuery&id=_6dirK2anEeSXbqAAJhWI1g][JFS 5.0.2]]</li><li>[[https://jazz.net/jazz/web/projects/Jazz%20Foundation#action=com.ibm.team.workitem.runSavedQuery&id=_2y-9kALqEeWFGcjYk3ZxAA][JFS 6.0]]</li></ul> | 

| Non-APAR related Defects resolved in the release | <ul><li>[[https://jazz.net/jazz/web/projects/Jazz%20Collaborative%20ALM#action=com.ibm.team.workitem.runSavedQuery&id=_sSytkgd5EeScusBHOj7kTg][RTC 4.0.7]]</li><li>[[https://jazz.net/jazz/web/projects/Rational%20Team%20Concert#action=com.ibm.team.workitem.runSavedQuery&id=_P8ZVcC3pEeSv1PLrFzJHAg][RTC 5.0.2]]</li><li>[[https://jazz.net/jazz/web/projects/Rational%20Team%20Concert#action=com.ibm.team.workitem.runSavedQuery&id=_KSGAMnD0EeSXbqAAJhWI1g][RTC 6.0]]</li></ul>| <ul><li>[[https://jazz.net/jazz02/web/projects/Rational%20Quality%20Manager#action=com.ibm.team.workitem.runSavedQuery&id=_iCtxNggDEeS0ddSSMadJWA][RQM 4.0.7]]</li><li>[[https://jazz.net/jazz02/web/projects/Rational%20Quality%20Manager#action=com.ibm.team.workitem.runSavedQuery&id=_QRm_wDgWEeSSFt3nsbDiuQ][RQM 5.0.2]]</li><li>[[https://jazz.net/jazz02/web/projects/Rational%20Quality%20Manager#action=com.ibm.team.workitem.runSavedQuery&id=_ITWM8UhiEeSxz--A8sIA7g][RQM 6.0]]</li></ul>| <ul><li>[[https://jazz.net/jazz03/web/projects/Requirements%20Management#action=com.ibm.team.workitem.runSavedQuery&id=_UTzVgP4QEeO8_eJPOih81Q][RRC 4.0.7]]</li><li>[[https://jazz.net/jazz03/web/projects/Requirements%20Management#action=com.ibm.team.workitem.runSavedQuery&id=_OehEATdyEeSuD-k_WiY3-A][RDNG 5.0.2]]</li><li>[[https://jazz.net/jazz03/web/projects/Requirements%20Management#action=com.ibm.team.workitem.runSavedQuery&id=_uXiVRXp0EeShILBQkrF6Hw][RDNG 6.0]]</li></ul>| <ul><li>[[https://jazz.net/jazz/resource/itemOid/com.ibm.team.workitem.query.QueryDescriptor/_d4PZcAeCEeScusBHOj7kTg][JFS 4.0.7]]</li><li>[[https://jazz.net/jazz/web/projects/Jazz%20Foundation#action=com.ibm.team.workitem.runSavedQuery&id=_m0TlQGaoEeSXbqAAJhWI1g][JFS 5.0.2]]</li><li>[[https://jazz.net/jazz/web/projects/Jazz%20Foundation#action=com.ibm.team.workitem.runSavedQuery&id=_M5Ob8ALrEeWFGcjYk3ZxAA][JFS 6.0]]</li></ul> |

<br>For defects resolved in other versions, check the release notes for that particular release.
|[[https://jazz.net/downloads/rational-team-concert/releases/][Rational Team Concert]] | [[https://jazz.net/downloads/rational-quality-manager/releases/][Rational Quality Manager]] | [[https://jazz.net/downloads/rational-requirements-composer/releases/][Rational Requirements Composer/ Rational DOORS NG]] |

---++ Known issues

---+++ Known issues when upgrading to 4.0.1 or later
---++++ Incorrect indexes in 4.0.1 (resolved in 4.0.2)
There is a known defect with indexes upon upgrading to *4.0.1* as identified in [[http://www-01.ibm.com/support/docview.wss?uid=swg21620879][Technote 1620879: Upgrades to 4.0.1 create a significantly larger, incorrect index]]. A Testfix is required before upgrading, but this defect has been resolved in [[https://jazz.net/downloads/rational-team-concert/releases/4.0.2][version 4.0.2]]. Upgrade to the latest release of the Rational solution for Collaborative Lifecycle Management (CLM) to ensure that defects to all known issues have been resolved.
---++++ Upgrade Scripts fail with Microsoft SQL Server and CLM Upgrade to 4.0.4 (resolved in 4.0.5)
There is a known issue where the upgrade scripts will fail during an upgrade to CLM *4.0.4*. This is documented in [[http://www-01.ibm.com/support/docview.wss?uid=swg21649768][Technote 1649768: Upgrading CLM products to version 4.0.4 fails when using Microsoft SQL Server]]. This defect has been resolved in [[https://jazz.net/downloads/rational-team-concert/releases/4.0.5][version 4.0.5]].
---++++ Work Items can not be loaded in RTC web client after upgrade to CLM *4.0.5* and above (resolved in 5.0.2)
After upgrading to CLM 4.0.5 or above, some Work Items can not be loaded in RTC web client. This problem only occurs in the web client and is caused by too many attributes in the Work Item type. This is due to the change made to the way to batch value sets starting in version 4.0.5. This defect has been resolved in [[https://jazz.net/downloads/rational-team-concert/releases/5.0.2][version 5.0.2]].
<br>

---+++ Known issues when upgrading to 5.0 or later
---++++ All Project Areas are deleted after upgrade from RRC or RDNG release 4.0.x
There is a known defect that all project areas are deleted upon upgrading RRC or RDNG 4.0.x to *5.0.x*. Refer to [[http://www.ibm.com/support/docview.wss?uid=swg21695623][Technote 1695623: All Project Areas are deleted after upgrade from RRC or RDNG release 4.0.x]] for more information.
---++++ LPA templates may not be retrieved after an upgrade to 5.0.2 (fixed in 5.0.2 iFix002)
There is a known defect affecting sites where a server rename was performed on the upgrade server before being upgraded to CLM *5.0.2* as described in [[http://www.ibm.com/support/docview.wss?uid=swg21693288][Technote 1693288: CLM LPA templates may not be retrieved after a migration from older release to 5.0.2]]. The defect has been resolved in [[http://www.ibm.com/support/docview.wss?uid=swg21695923][version 5.0.2 iFix002]].

---++ Known Workarounds
Known workarounds when upgrading to 4.0.7 or later are discussed below.
|   | *Rational Team Concert* | *Rational Quality Manager* | *Rational Requirements Composer* | *Rational Jazz Foundation* | 
| Documented Workarounds | <ul><li> [[https://jazz.net/library/#q=&tag=workaround,4.0.7&project=rational-team-concert][RTC 4.0.7]]</li><li>[[https://jazz.net/library/#q=&tag=workaround%2C5.0.2&project=rational-team-concert&sort=pubDate][RTC 5.0.2]]</li><li>[[https://jazz.net/library/#q=&tag=workaround%2C6.0&project=rational-team-concert&sort=pubDate][RTC 6.0]]</li> | <ul><li>[[https://jazz.net/library/#q=&tag=workaround,4.0.7&project=rational-quality-manager][RQM 4.0.7]]</li><li>[[https://jazz.net/library/#q=&tag=workaround%2C5.0.2&project=rational-quality-manager&sort=pubDate][RQM 5.0.2]]</li><li>[[https://jazz.net/library/article/1509][RQM 6.0]]</li> | <ul><li>[[https://jazz.net/library/#q=&tag=workaround,4.0.7&project=rational-requirements-composer][RRC 4.0.7]]</li><li>[[https://jazz.net/library/#q=&tag=workaround%2C5.0.2&project=rational-doors-next-generation&sort=pubDate][RDNG 5.0.2]]</li><li>[[https://jazz.net/library/article/1516][RDNG 6.0]]</li> | <ul><li>[[https://jazz.net/library/#q=&tag=workaround,4.0.7&project=jazz-foundation][JFS 4.0.7]]</li><li>[[https://jazz.net/library/#q=&tag=workaround%2C5.0.2&project=jazz-foundation&sort=pubDate][JFS 5.0.2]]</li><li>[[https://jazz.net/library/#q=&tag=workaround%2C6.0&project=jazz-foundation&sort=pubDate][JFS 6.0]]</li> | 


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

   * For more upgrading troubleshooting topics, refer to [[UpgradeTroubleshooting][Upgrade troubleshooting]].
     
---+++++!! External links:  
        
   * IBM: None

---+++++!! Additional contributors: Main.StephanieBagot, Main.DianeEveritt


<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.