How To: Recover if the DMC Admin Password is Lost

You can reset the DMC password by following these steps.                             

Step 1:

Create a new Keycloak admin user from the command line.

1. Log in to your DMC server.

2. Run the following command, substituting the appropriate values for your system.

   sudo -u <owner_of_DMC_software> /<path/to>/keycloak/bin/add-user-keycloak.sh --user <new_keycloak_user> --password <user_password> --realm master

   
   Example

   sudo -u datical /opt/datical/keycloak/bin/add-user-keycloak.sh --user rescue-admin --password mySecret --realm master

    

3. Restart the DMC services:

   sudo datical-control service stop all    #Ignore the error about the datical-postgresql.service. sudo datical-control start keycloak sudo datical-control start datical-service sudo datical-control start proxy

    

Step 2:

Log in to the Keycloak Admin Console as the user you just created.  See https://dmc.datical.com/administer/administer.htm

1. Browse to https://<dmchostname>/auth

2. Select Administration Console

3. Log in with the new username/password created in Step 1.

Step 3:

Reset the password for the DMC Admin user.  See https://dmc.datical.com/administer/create-password-keycloak.htm

1. In the Keycloak Admin console, select Users on the left pane.

2. Search for “View all uses” to find the Username support@datical.com.

3. Under the Actions column, click Edit.

4. Navigate to the Credentials tab.

5. Under the Actions column, click Delete.

6. When prompted, click Delete credentials.

7. Enter a new password and confirm.

8. Disable the temporary password setting.

9. Click Set Password.

Step 4:

Log out of Keycloak and log in to DMC as support@datical.com.

1. In the upper right corner of the Keycloak console, select the user dropdown and sign out.

2. Browse to https://<dmchostname>

3. Log in as support@datical.com