How to reset the password in tomcat-users.xml

Technote (FAQ)


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.

Related information

A Japanese translation is available

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


Cross reference information
Segment Product Component Platform Version Edition
Software Development Rational Project Conductor Team Server Linux, Windows 1.0, 1.0.0.1
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

Rate this page:

(0 users)Average rating

Add comments

Document information


More support for:

Rational Team Concert
Web App Server

Software version:

1.0, 1.0.1, 1.0.1.1, 2.0, 2.0.0.1, 2.0.0.2

Operating system(s):

Linux, Windows

Reference #:

1393867

Modified date:

2011-06-14

Translate my page

Machine Translation

Content navigation