IBM Support

How to reset the password in tomcat-users.xml

Question & Answer


Question

How do you change the password of a user in the tomcat-users.xml file used on the Web App server for IBM Rational Team Concert?

Cause

You installed Rational Team Concert on Tomcat and forgot the password of a user. When you look at tomcat-users.xml, the password seems encrypted.

Answer

To reset the password

  1. Get the value of digest in the Realm in the server.xml

    <Realm className="org.apache.catalina.realm.UserDatabaseRealm"
    resourceName="UserDatabase"
    digest="SHA-1"

    digestEncoding="UTF-8"/>

    Note: The digest can be SHA or MD5.

  2. Copy the genPassword.bat (for Windows)/genPassword.sh (for UNIX and AIX) to the location where your server.startup.bat /server.startup exists. (Linux/AIX only) change the permissions of genPassword.sh (chmod 755 genPassword).

  3. From the command line, run:

    Microsoft Windows:
    genPassword.bat [SHA|MD5] <the password to be encrypted>

    Linux:
    ./genPassword.sh [SHA|MD5] <the password to be encrypted>

    The script will return: <THE_CLEAR_PASSWORD>:<THE_ENCRYPTED_PASSWORD>

  4. Replace the value of the user's "password" in tomcat-users.xml to <THE_ENCRYPTED_PASSWORD>

  5. Restart Tomcat



Leverage the Jazz Community

Jazz and Rational Team Concert 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.

Disclaimer

All source code and/or binaries attached to this document are referred to here as "the Program". IBM is not providing program services of any kind for the Program. IBM is providing the Program on an "AS IS" basis without warranty of any kind. IBM WILL NOT BE LIABLE FOR ANY ACTUAL, DIRECT, SPECIAL, INCIDENTAL, OR INDIRECT DAMAGES OR FOR ANY ECONOMIC CONSEQUENTIAL DAMAGES (INCLUDING LOST PROFITS OR SAVINGS), EVEN IF IBM, OR ITS RESELLER, HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

genPassword.bat

[{"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":"1.0;1.0.1;2.0;2.0.1","Edition":"","Line of Business":{"code":"LOB59","label":"Sustainability Software"}},{"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":"1.0;1.0.1;1.0.1.1;2.0;2.0.0.1;2.0.0.2","Edition":"","Line of Business":{"code":"LOB59","label":"Sustainability Software"}},{"Product":{"code":"SSN2WR","label":"Rational Project Conductor"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Team Server","Platform":[{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"1.0;1.0.0.1","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}},{"Product":{"code":"SSWMEQ","label":"Rational Requirements Composer"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Component":"Web App Server","Platform":[{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"1.0;2.0","Edition":"","Line of Business":{"code":"LOB59","label":"Sustainability Software"}}]

Product Synonym

Rational Team Concert;Rational Quality Manager

Document Information

Modified date:
16 June 2018

UID

swg21393867