Edit
Attach
P
rintable
r9 - 2013-11-19 - 19:52:39 - Main.sbagot
You are here:
TWiki
>
Deployment Web
>
DeploymentTroubleshooting
>
UpgradeTroubleshooting
>
CLMUpgradeTroubleshooting
>
AfterTheUpgrade
<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"/> Common issues that occur after an upgrade Authors: [[UpgradeTroubleshootingTeam][UpgradeTroubleshootingTeam]] <br> Build basis: CLM 4.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> This page will discuss some troubleshooting steps to take when issues are incurred after the upgrade. ---++ Known issues (application non-specific) This section will discuss some known issues which occur after the upgrade. ---+++ Unable to create an LPA project *Symptom:* When creating a new project, you may see errors such as the following: <verbatim>Error instantiating the template: CRJCA0003E </verbatim> <verbatim> CRJCA0003E The Lifecycle Project Administration (LPA) application made a request that was answered by an unexpected response code. The request was: https://.../ccm/clmSampleProject. The response was: HTTP/1.1 400 Bad Request. </verbatim> <br> *Cause:* Process templates need to be redeployed <br>*Resolution:* See [[RedeployingPredefinedTemplates][Redeploying Predefined Templates]] for instructions on how to redeploy the templates. ---+++ Failing integrations *Symptom:* After upgrading your CLM install, the previously configured integrations (OSLC links, synchronization, connectors) are not functioning as they did prior to the upgrade. <br> *Cause:* * Versions are no longer supported * Configuration is incorrect * New connector version must be downloaded *Resolution:* Before upgrading, ensure that the new versions of the product are supported. Once the upgrade has occured, ensure that the configuration is still accurate. For more information on troubleshooting integrations, see the [[https://jazz.net/wiki/bin/view/Deployment/IntegrationsTroubleshooting][Integrations Troubleshooting]] section of the wiki. ---+++ Failing Queries or Dashboard query issues If you are unable to run a query, or see dashboards failing to load, you may need to [[ReindexingAfterUpgrade][Reindex the applications]]. ---+++ Failing Reports or Dashboard reports issues *Symptom:* After upgrading your CLM install, reports or dashboard reports fail, or show incorrect information. *Environment:* Apache Derby Database for Data Warehouse <br> *Cause:* The Apache Derby Database for Data Warehouse was not moved from the pre-upgrade directory into the new directory. Therefore, the current Data Warehouse database is empty. <br>*Resolution:* Copy the Apache Derby Data Warehouse location in the pre-upgrade directory (../server/conf/jts/derby/DataWarehouse) to the new directory. Afterwards, complete the Data Warehouse upgrade again by running [[https://jazz.net/help-dev/clm/index.jsp?re=1&topic=/com.ibm.jazz.install.doc/topics/r_repotools_upgradewarehouse.html][repotools-jts -upgradeWarehouse]]. ---+++ Users unable to login *Symptom:* After upgrading your CLM install, users are unable to login to CLM. The following error may occur <verbatim> This user was not found in the directory service. This user will not be able to login unless they have an account in the directory service.ID CRJAZ1532I </verbatim> *Environment:* CLM deployed on Apache Tomcat, using local file based authentication (tomcat-users.xml) <br> *Cause:* The file write behaviour for the tomcat-users.xml file was changed between Tomcat 5.5 (RTC 3.x) and Tomcat 7 (RTC 4.x) <br>*Resolution:* See [[http://www-01.ibm.com/support/docview.wss?uid=swg21614661][Technote 1614661: Tomcat-users.xml is file not updated after Upgrade]] ---+++ Unable to load or create work items *Symptom:* After upgrade, work items cannot be viewed or created. <br>*Environment*: CLM versions 4.0.4 and below <br>*Cause:* This is a known defect in 4.0.4 <br>*Resolution:* See [[http://www-01.ibm.com/support/docview.wss?uid=swg21652067][Creating or viewing a work item results in a blank page and not an object error with RTC 4.0.4]] ---++ Known Issues (application specific) The symptoms, causes and resolution will be product specific. Navigate to the following pages for information on: * Rational Team Concert * [[AfterTheUpgradeRRC][Rational Requirements Composer]] * Rational Quality Manager ---++ Where do I go from here? If you are unable to resolve your issue using the available online resources, please open a service request with IBM Rational Support. Refer to [[DataCollectionandSupportResources][Additional Troubleshooting Resources]] for further details.<br> ---++ Recommended data gathering and subsequent analysis steps When investigating problems that occur *after* the upgrade, collect the following information: * [[https://jazz.net/help-dev/clm/index.jsp?re=1&topic=/com.ibm.team.concert.doc/topics/t_using_the_isal.html][ISALite Log collection]] * All upgrade repotools log files located in the following directory: <verbatim> <Install Directory>/server </verbatim> * screenshots or relevant errors It will also be helpful to gather the following information: * What was the behaviour like before the upgrade? * Besides the upgrade, did any other configuration change occur? ---+++++!! Related topics: * For more troubleshooting topics, refer to [[UpgradeTroubleshooting][Upgrade Troubleshooting]]. ---+++++!! External links: * None ---+++++!! Additional contributors: MainTwiki.StephanieBagot ---+++++!! Questions and comments: %COMMENT{type="below" target="AfterTheUpgradeComments" button="Submit"}% %INCLUDE{"AfterTheUpgradeComments"}% <sticky></div></sticky>
Edit
|
Attach
|
P
rintable
|
V
iew topic
|
Backlinks:
We
b
,
A
l
l Webs
|
H
istory
:
r13
|
r11
<
r10
<
r9
<
r8
|
More topic actions...
Deployment
Deployment web
Planning and design
Installing and upgrading
Migrating and evolving
Integrating
Administering
Monitoring
Troubleshooting
Community information and contribution guidelines
Create new topic
Topic list
Search
Advanced search
Notify
RSS
Atom
Changes
Statistics
Web preferences
NOTE: Please use the Sandbox web for testing
Status icon key:
To do
Under construction
New
Updated
Constant change
None - stable page
Smaller versions of status icons for inline text:
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
.