Overview

Documentum stores the database schema password in an encrypted form inside the file dbpasswd.txt, located under the repository’s configuration directory. When the database password changes, this file must be updated and re‑encrypted so the repository can authenticate correctly.

This document outlines the required steps to update and encrypt the database password for a Documentum repository.

File Location

The encrypted password is stored in:

$DOCUMENTUM/dba/config/<docbase_name>/dbpasswd.txt

Where:

• $DOCUMENTUM — Documentum installation directory

• <docbase_name> — Name of the repository

Procedure to Update the Database Password

1. Stop the Repository

Shut down the Documentum repository to ensure no active processes are using the existing password.

2. Update dbpasswd.txt

Open the following file:

$DOCUMENTUM/dba/config/<docbase_name>/dbpasswd.txt

Replace the existing encrypted password with the new database schema password in plain text.

This plain text will be encrypted in the next step.

3. Encrypt the Password

Navigate to the Documentum binaries directory:

cd $DM_HOME/bin

Run the encryption command:

dm_encrypt_password -docbase <docbase_name> -rdbms -encrypt <database_password>

Where:

• <docbase_name> — Your repository name

• <database_password> — The new schema password you entered in dbpasswd.txt

This command encrypts the password and updates dbpasswd.txt automatically.

4. Start the Repository

Restart the Documentum repository. It will now authenticate using the newly encrypted password.

Notes

• The updated password must match the value stored in the database configuration tables.

• The encryption process ensures Documentum can resume normal operation without authentication failures.

• Always secure dbpasswd.txt, as it temporarily contains a plain‑text password before encryption.