Manage Credentials

Overview

How Credentials Work

There are two important credentials for Enterprise-on-Premises (EOP) customers managing an instance of the Contrast application:

There is only one Hub account per customer. When the Hub account is activated, the user is issued an activation link via email, which takes the user directly to a change password feature. (This password change is required to finish activating the account). It's crucial that the user saves this password, as it's necessary for logging in to Hub to obtain license and product updates; it's also the initial password for the default administrator account after installation. The user's Hub password is encrypted inside the license file.

After installation the following login screen should be displayed.

https://contrastserver/Contrast

Note: The hostname contrastserver shown in the above URL should be either the IP address or hostname set up during Contrast installation.

At this login screen, the default administrator enters their Hub account credentials (email address and password) to access the application as the default administrator account provisioned automatically during installation.

SuperAdmin access

There is a separate credential for managing the application installation, called SuperAdmin.

  • Username: If the Hub user account is "john.doe@mycompany.com", the SuperAdmin convention is "contrast_superadmin@mycompany.com".

  • Password: Contact Support. This password is automatically provisioned in Contrast when the license file is downloaded from Hub.

For more information about roles in Contrast, such as SuperAdmin, see the article on User Roles & Permissions.

Reset SuperAdmin

Windows

Users on Windows should complete the following steps to reset the SuperAdmin password in the Contrast application.

  • Stop the Contrast Server service.
  • Launch a command prompt (cmd.exe) as an Administrator by right-clicking on cmd.exe and selecting Run As Administrator.
  • Go to the Contrast\bin directory. (On most systems, this is C:\Program Files\Contrast\bin.)
  • Enter the following command to edit the JVM options.

      notepad contrast-server.vmoptions
    
  • Add the following options to the file. (Replace your.email.domain.com with your email domain.)*

      -Dreset.superadmin=true
      -Dsuperadmin.username=contrast_superadmin@<your.email.domain.com>
      -Dsuperadmin.password=<password>
    
  • Save the file and exit Notepad.

  • Enter the following command to start the Contrast service.

      net start "Contrast Server"
    
  • Verify you are able to log in with the new password.

  • Enter the following command to stop the Contrast service.

      net stop "Contrast Server"
    
  • Enter the following command to edit the JVM options.

      notepad contrast-server.vmoptions
    
  • Remove the options added in the * fifth step.

  • Save the file and exit Notepad.
  • Exit the command prompt.
  • Start the Contrast Server service as normal (i.e., from the Services control panel applet).

Linux

Users on Linux should complete the following steps to reset the SuperAdmin password in the Contrast application.

  • Shut down Contrast Server.
  • Open a command prompt as root (or open a normal terminal/shell and use sudo or su to become root).
  • Go to the $CONTRAST_INSTALLATION directory. (On most systems, this is /opt/Contrast.)
  • Type the following command.

      export INSTALL4J_ADD_VM_PARAMS="$INSTALL4J_ADD_VM_PARAMS -Dreset.superadmin=true -Dsuperadmin.username=contrast_superadmin@<your.email.domain.com> -Dsuperadmin.password=<new password>”
    
  • Start the contrast server by running:

      bin/contrast-server start
    

When the server comes up, you should be able to use the password you specified in the command line. At this point, Contrast recommends that you stop the server (bin/contrast-server stop), start it up as you normally would, and then exit the shell to clear the password from the INSTALL4J_ADD_VM_PARAMS environment variable.