IBM Support

How to update Apache Tomcat server for IBM Rational products based on versions, 4.0.7, or later of IBM's Jazz technology

Technote (FAQ)


How do you update the Apache Tomcat server for existing IBM Rational Collaborative Lifecycle Management (CLM): Rational Requirements Composer (RRC), Rational DOORS Next Generation (RDNG), Rational Quality Manager (RQM), Rational Team Concert (RTC), Rational Software Architect Design Manager (RSA DM), and Rational Rhapsody Design Manager (Rhapsody DM)?


To upgrade the Apache Tomcat server, follow these steps:

  1. Stop the CLM Servers

  2. Download Apache Tomcat 7.0.56 or later core zip file from Apache Tomcat 7 Archive download site (for instance:

  3. Backup the entire Tomcat directory under: 
    to a temporary location.

  4. Delete the following folders from ..\JazzTeamServerInstall\server\tomcat directory after backing them up as instructed in step #3:


  5. Extract the downloaded Tomcat core compressed file to a temporary location.

  6. There will be a list of folders with the same name as the deleted folders from Step #4. Copy them to:

  7. Rename the server.xml under ..\JazzTeamServerInstall\server\tomcat\conf to something like serverdefaulttomcat.xml

  8. Copy the server.xml from the backup location at step #3 to

  9. Rename the existing tomcat-users.xml file under the directoryJazzTeamServerInstall\server\tomcat\conf

    to something like

  10. Copy the tomcat-users.xml file in the backup location at step #3 to JazzTeamServerInstall\server\tomcat\conf

    NOTE: If you are using the default Tomcat UserDatabaseRealm for user authentication, you may need to reset the password for each user by editing the tomcat-users.xml file, if they are unable to sign in. To do this, type in the same password as the original one then save the changes. This is caused by the password encryption in the Tomcat instance before the upgrade, and might not be recognized after the Tomcat upgrade.

  11. Copy the following jar files from the \lib directory in the backup location


  12. Start Jazz team server by running server.startup.bat under ..\JazzTeamServerInstall\server,
    or by means of starting the tomcat service

  13. Check tomcat catalina.log, and ensure tomcat is upgraded to the targeted version. For example, if you are upgrading to 7.0.56, you should see the following line:

    Starting Servlet Engine: Apache Tomcat/7.0.56

  14. Ensure you can login to the JTS Server from the following URL:


Leverage the Jazz Community

The Jazz based products have an active community that can provide you with additional resources. Browse and contribute to the User forums, contribute to the Team Blog and review the Team wiki.
Refer to technote 1319600 for details and links.

Cross reference information
Segment Product Component Platform Version Edition
Software Development Rational Quality Manager Web App Server Linux, Windows, 4.0.7, 5.0, 5.0.1, 5.0.2
Software Development Rational Requirements Composer Web App Server Windows, Linux, 4.0.7
Software Development Rational DOORS Next Generation Linux, Windows 4.0.7, 5.0, 5.0.1, 5.0.2
Software Development Rational Rhapsody Design Manager Linux, Windows 4.0.7, 5.0, 5.0.1, 5.0.2
Software Development Rational Software Architect Design Manager Linux, Windows 4.0.7, 5.0, 5.0.1, 5.0.2

Document information

More support for: Rational Team Concert
Web App Server

Software version:, 4.0.7, 5.0, 5.0.1, 5.0.2

Operating system(s): Linux, Windows

Reference #: 1687641

Modified date: 23 March 2015