<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"/> Starting the applications 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> Use this topic for common issues that arise after the upgrade steps are performed and when the applications are started for the first time. ---++ Starting the applications The following issues are some of the errors that are most commonly identified. ---++ Recommended data gathering * If you are engaging IBM Support with regards to these issues, ensure that you run [[http://pic.dhe.ibm.com/infocenter/clmhelp/v4r0m1/index.jsp?topic=%2Fcom.ibm.team.concert.doc%2Ftopics%2Ft_using_the_isal.html][ISALITE]] to gather the system information and pertinent log files. * In addition, including screenshots and upgrade steps are helpful in quick problem determination and resolution. ---++ Common issues when starting the applications after an upgrade After the upgrade occurs, ensure that the following is completed: * Browser cache is cleared * Temporary directories and cache are deleted The following sections identify some known issues which occur after the upgrade, with information on the cause and solution. ---+++DBLock *Symptom:* <br>The following error might occur related to DBLock: <verbatim> CRJAZ1770E The configured database lock id does not match the lock id in the database. This can happen if 2 applications or Jazz Team Servers are trying to access the same set of tables, or if the lock id was overwritten or lost in the teamserver.properties configuration file. Check the server configuration and the database connection spec and ensure they are correct. </verbatim> <br> *Cause:* <br>The application will set a database lock ID on the DB to ensure that only that application can access the database. This prevents two applications from writing to the same database, and possibly overwritting or corrupting the data. This error can occur after the upgrade because of the following reasons: * The teamserver.properties file merged incorrectly * The upgraded application is trying to set a new Lock ID <br> *Resolution:* <br>Before resetting the Lock ID, ensure that each of your teamserver.properties files for the applications point to *seperate* databases. Once this is confirmed, you can run <verbatim> repotools- <app> resetRepoLockID </verbatim> Further information can be found on the Information Center topic for the command [[http://pic.dhe.ibm.com/infocenter/clmhelp/v4r0m1/index.jsp?topic=%2Fcom.ibm.jazz.install.doc%2Ftopics%2Fr_repotools_reindexrepolockid.html][resetRepoLockID]]. ---+++ Hanging 'Loading' screen *Symptom:* <br> When attempting to login to the CLM applications, the splash screen never fully loads and appears to be hung at the 'Loading' page. <br> *Cause:* <br> The Loading is often related to a mis-configuration in the teamserver.properties file, or within the application server. <br> *Resolution:* <br> The following technotes provide a resolution to this behaviour: * [[http://www-01.ibm.com/support/docview.wss?uid=swg21470574][Completion of Setup hangs on Loading Screen]] * [[http://www-01.ibm.com/support/docview.wss?uid=swg21474026][Configuring the Public URI in Rational Team Concert setup menu hangs with the Loading configuration settings message]] * Validate in your JVM arguments: ensure that any custom variables are correct and the paths are not missing or incorrect, specially JAZZ_HOME value must be updated to point to the new version. In addition, check your heap configuration is accurate. For more information see the Information Center topic on [[http://pic.dhe.ibm.com/infocenter/clmhelp/v4r0m1/index.jsp?topic=%2Fcom.ibm.jazz.install.doc%2Ftopics%2Ft_s_server_installation_setup_WAS.html][Setting up WebSphere]]. ---+++ Users unable to login *Symptom:* <br> After the upgrade, users are unable to login. If a user is able to login, they may not obtain the correct repository permissions similar as prior to the upgrade. <br> *Cause:* <br> The authentication and authorization is controlled by the Application Server (Tomcat or WebSphere). There may be a configuration setting which is incorrect, or the LDAP configuration needs to be updated. <br> *Resolution:* Validate your LDAP configuration by referencing the following articles: * [[https://jazz.net/wiki/bin/view/Main/LDAP4Newbies][LDAP Configuration for Newbies]] * [[https://jazz.net/help-dev/clm/index.jsp?topic=%2Fcom.ibm.jazz.install.doc%2Ftopics%2Fc_plan_identity_management.html][Managing Users by using LDAP]] <br> If you are using *Tomcat*, by default, the tomcat-users.xml file it set to read-only in later versions. Follow [[http://www-01.ibm.com/support/docview.wss?uid=swg21474527][Technote 1474527: Tomcat-users.xml is file not updated after Upgrade]] ---++ Symptoms when trying to use the product After the final steps of the upgrade have been completed, such as the [[MigratingRequirementsManagementApplication][Online migration of RM]] and [[RedeployingPredefinedTemplates][Redeploying the process templates]], you may incur issues when trying to use the product functionality. For information on troubleshooting and debugging common issues which occur after the upgrade, navigate to [[AfterTheUpgrade][Known issues which occur after the upgrade]]. ---+++++!! Related topics: * For more troubleshooting topics, refer to [[UpgradeTroubleshooting][Upgrade Troubleshooting]] ---+++++!! External links: * None ---+++++!! Additional contributors: Main.StephanieBagot ---+++++!! Questions and comments: %COMMENT{type="below" target="StartTheApplicationsComments" button="Submit"}% %INCLUDE{"StartTheApplicationsComments"}% <sticky></div></sticky>
This topic: Deployment
>
WebHome
>
DeploymentTroubleshooting
>
UpgradeTroubleshooting
>
StartTheApplications
History: r11 - 2013-06-27 - 19:30:05 - Main.sbagot
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
.