Edit
Attach
P
rintable
r6 - 2014-02-21 - 18:46:10 - Main.sbagot
You are here:
TWiki
>
Deployment Web
>
DeploymentTroubleshooting
>
UpgradeTroubleshooting
>
CLMUpgradeTroubleshooting
<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"/> CLM upgrade troubleshooting %DKGRAY% Authors: Main.StephanieBagot, [[UpgradeTroubleshootingTeam][UpgradeTroubleshootingTeam]]<br> Build basis: CLM 3.x and later %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 is the starting point for information and techniques to help diagnose and troubleshoot upgrade issues when upgrading the Rational Collaborative Lifecycle Management (CLM) family of products (Rational Team Concert, Rational Requirements Composer, and Rational Quality Manager). ---++ Before upgrading * Check the [[KnownIssues][Known issues]] for awareness of issues in the current version as a prerequisite for the upgrade * Ensure that your current environment meets all the requirements by checking the [[EnvironmentCheckList][Environment checklist]] * Perform the upgrade in a test environment prior to upgrading your production environment * [[BackupBeforeUpgrade][Backup the necessary configurations and files prior to your upgrade]] * Go through the [[https://jazz.net/wiki/bin/view/Deployment/UpgradeInsider][Upgrade Insider]] page of the deployment wiki for further information about your upgrade * Contact IBM Support and open up a proactive PMR with your upgrade plan and environment specifics. This will ensure Support is aware of the upgrade and can plan accordingly to become familiar with your environment and plan, resulting in faster response times. ---++ Performing the upgrade Below are the steps necessary to complete a successful upgrade. Each item below discusses common issues seen at that particular step within the upgrade process. * [[CLMUpgradeScripts][Run the upgrade script]] or alternatively [[RunningTheUpgradeManually][Running the upgrade manually]] * [[UpdateConfigurationFiles][Update configuration files (CCM, Quality Management, Jazz Team Server)]] * [[AddDatabaseTables][Add database tables (CCM, Quality Management, Jazz Team Server)]] * [[UpgradeDwSchema][Upgrade the data warehouse schema (Jazz Team Server)]] * [[StartTheApplications][Start the applications]] * [[Licenses][Licenses]] * [[MigratingRequirementsManagementApplication][Migrating the Requirements Management application]] * [[RedeployingPredefinedTemplates][Redeploying predefined templates]] ---++ Upgrade Verification The following are some items to consider while completing a verification of data after an upgrade: ---+++Admin Verification * Verify there are no errors in the upgrade logs * [[https://jazz.net/help-dev/clm/index.jsp?re=1&topic=/com.ibm.jazz.install.doc/topics/t_update_prepare_config.html&scope=null][Verify the configuration files]]</li> * [[https://jazz.net/help-dev/clm/index.jsp?re=1&topic=/com.ibm.jazz.install.doc/topics/t_update_prepare_config.html&scope=null][Verify server logs and URLs]] </li> * [[https://jazz.net/help-dev/clm/index.jsp?re=1&topic=/com.ibm.jazz.install.doc/topics/c_verify_users_licenses_links.html&scope=null][Verify users, licenses and link artifacts]] </li> * Verify there are no diagnostic errors on any application </li> * Verify you are able to navigate between linked project areas </li> * Verify there are no errors in process configuration (particularly for customized project areas) </li> Consider you or your users completing an [[https://jazz.net/wiki/bin/view/Deployment/UpgradeVerification][Upgrade Verification]] to ensure the upgrade was successful (not all steps may apply in each environment). Consider running an [[https://jazz.net/wiki/bin/view/Main/L3DevTool][Online Verify]] which will check the consistency of the data. ---+++ User Validation: * Access work items, saving, creating new work items (verify no information is missing) </li> * View plans (verify no information is missing) </li> * View Dashboards; ensure all are working with no errors</li> * Load Reports </li> * Access Source Control (checkin, checkout, deliver) </li> ---++ Issues during user verification testing after upgrade If your upgrade was successful, but your users report the following: * Various functions are not working as expected, or not working the same as the pre-upgrade version * Some data, such as item statuses, are corrupted after the upgrade * Full text queries fail * Dashboard issues Navigate to [[AfterTheUpgrade][Common issues that occur after the upgrade]] for information on troubleshooting and debugging. ---++ Where do I go from here? If you are unable to resolve your issue using the available online resources, open a service request with IBM Rational Support. Refer to [[DataCollectionandSupportResources][Additional troubleshooting resources]] for further details.<br> ---+++++!! Related topics: None ---+++++!! External links: * None ---+++++!! Additional contributors: Main.StephanieBagot, Main.SusanWu, Main.MichaelAfshar, Main.WilliamChen, Main.BrettBohnn <sticky></div></sticky>
Edit
|
Attach
|
P
rintable
|
V
iew topic
|
Backlinks:
We
b
,
A
l
l Webs
|
H
istory
:
r9
<
r8
<
r7
<
r6
<
r5
|
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
.