IBM Support

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

Question & Answer


Question

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)?

Answer

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: apache-tomcat-7.0.56-windows-x64.zip)

  3. Backup the entire Tomcat directory under: 
    ..\JazzTeamServerInstall\server\tomcat
    to a temporary location.

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

    bin
    conf
    lib
    logs

  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:
     ..\JazzTeamServerInstall\server\tomcat

  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
    ..\JazzTeamServerInstall\server\tomcat\conf

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

    to something like
    tomcat-usersdefaulttomcatxxx.xml

  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

    au.com.bytecode.opencsv_xxxx.jar
    com.ibm.team.repository.localgroups.realm_xxxx.jar
    com.ibm.team.repository.localgroups_xxxx.jar


    To:
    JazzTeamServerInstall\server\tomcat\lib

  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:

    https://<hostname>:<port>/jts/admin


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.

[{"Product":{"code":"SSUVV6","label":"IBM Engineering Test Management"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Component":"Web App Server","Platform":[{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"3.0.1.6;4.0.7;5.0;5.0.1;5.0.2","Edition":"","Line of Business":{"code":"LOB02","label":"AI Applications"}},{"Product":{"code":"SSUC3U","label":"IBM Engineering Workflow Management"},"Business Unit":{"code":"BU055","label":"Cognitive Applications"},"Component":"Web App Server","Platform":[{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"3.0.1.6;4.0.7;5.0;5.0.1;5.0.2","Edition":"","Line of Business":{"code":"LOB02","label":"AI Applications"}},{"Product":{"code":"SSUVLZ","label":"IBM Engineering Requirements Management DOORS Next"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Component":" ","Platform":[{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"4.0.7;5.0;5.0.1;5.0.2","Edition":"","Line of Business":{"code":"LOB02","label":"AI Applications"}},{"Product":{"code":"SSWMEQ","label":"Rational Requirements Composer"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Component":"Web App Server","Platform":[{"code":"PF033","label":"Windows"},{"code":"PF016","label":"Linux"}],"Version":"3.0.1.6;4.0.7","Edition":"","Line of Business":{"code":"LOB02","label":"AI Applications"}},{"Product":{"code":"SSRNEV","label":"Rational Rhapsody Design Manager"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Component":" ","Platform":[{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"4.0.7;5.0;5.0.1;5.0.2","Edition":"","Line of Business":{"code":"","label":""}},{"Product":{"code":"SSRMY8","label":"Rational Software Architect Design Manager"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":" ","Platform":[{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"4.0.7;5.0;5.0.1;5.0.2","Edition":"","Line of Business":{"code":"LOB36","label":"IBM Automation"}}]

Product Synonym

Rational DOORS Next Generation;Rational Team Concert;Rational Quality Manager

Document Information

Modified date:
16 June 2018

UID

swg21687641