Administrator Passwords

You should be careful not to lock out or lose the Administrator password. If this password is locked out, or is lost and needs to be reset, you can either unlock the password or reset it:

Unlocking the Administrator Password

If the administrator is locked out:

1. Create a file in the rhapsody/data/users directory called EnableAdministratorUser.action.
2. Rhapsody detects this file after about 30 seconds, and re-enables the administrator user. A log entry at the WARN level is generated when this occurs.

Resetting the Administrator Password

To reset the administrator password, you can either:

• Inform the user management service to reset the password:

  The Administrator password can only be reset if administrator resets have been explicitly allowed, which is the default setting. This is controlled by the following line in the rhapsody.properties file:
  UserManagementService.allowAdminPasswordReset=false.

  1. With Rhapsody running, create a file called ResetAdministratorPassword.action and save it in the /rhapsody/data/users folder.
  2. Rhapsody detects this file after about 30 seconds, and resets the password for a user called Administrator to its default value: rhapsody. A log entry at the WARN level is generated when this occurs.

• Delete the users directory:

  If you delete the users directory, all user accounts will be lost.

  1. Stop the Rhapsody engine.
  2. Delete the users directory in /rhapsody/data.
  3. Start the Rhapsody engine.

During startup Rhapsody will recreate the user store including creating a user called Administrator with administrative access and a password of rhapsody. This is a convenient way of resetting the administrator password and all user details as part of cleaning your engine, but is not recommended for most situations.