How to Change Password

This document will instruct how an admin user can change his password.

Introduction

If an Admin user forgets his password he cannot retrieve it using the Management Console due to security concerns. You may change your password by running the chpasswd script on the machine which is hosting the WSO2-Tungsten server.

This chpasswd script is located in TUNGSTEN_HOME/bin

IMPORTANT: Before executing this script, you should shutdown the Tungsten Server.

What You Need to Know

Inorder to change the admin password, you need to have the following information

  1. The Tungsten database URL

    Tungsten by default ships with the Apache derby database and hence the default URL would be jdbc:derby:/home/[user name]/tungsten/database/TUNGSTEN_DB (For Windows jdbc:derby:C:\Documents and Settings\[user name]\.tungsten\database\TUNGSTEN_DB) . This may differ if a different database was specified during the installation process.

  2. The Database driver class

    For the default Apache Derby database, the driver will be automatically picked up by the system. If a diffrent database is used, the driver class needs to be specified

  3. The Database username and password

    Again for the default Apache Derby database, the defualt username and password will be used by the system. However if a different username/password is used they are needed to reset the admin password.

Resetting the Password

This script is located in TUNGSTEN_HOME/bin. Usually this is the directory you've installed the tungsten server in the standalone case or the user home .tungsten directory in the web app case.

The full commandline options for the chpasswd is as follows

Command Value
-url The database URL Mandatory
-dr The databse driver class Optional
-un The username for the database Optional
-pw The passwrod for the database Optional

Example (in Windows)

chpasswd -url "jdbc:derby:C:\Documents and Settings\user\.tungsten\database\TUNGSTEN_DB"

Example (in Linux)

chpasswd -url jdbc:derby:home/user/tungsten/database/TUNGSTEN_DB

The system will ask for the username and the new password and that is all to it!

Things to Remember