IBM Support

How to reset the password in tomcat-users.xml

Technote (FAQ)


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?


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.


To reset the password

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

    <Realm className="org.apache.catalina.realm.UserDatabaseRealm"


    Note: The digest can be SHA or MD5.

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

  3. From the command line, run:

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

    ./ [SHA|MD5] <the password to be encrypted>


  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.

Related information

A Japanese translation is available


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.


Cross reference information
Segment Product Component Platform Version Edition
Software Development Rational Project Conductor Team Server Linux, Windows 1.0,
Software Development Rational Quality Manager Web App Server Linux, Windows 1.0, 1.0.1, 2.0, 2.0.1
Software Development Rational Requirements Composer Web App Server Linux, Windows 1.0, 2.0

Document information

More support for: Rational Team Concert
Web App Server

Software version: 1.0, 1.0.1,, 2.0,,

Operating system(s): Linux, Windows

Reference #: 1393867

Modified date: 14 June 2011

Translate this page: