Configuring the security settings after installation by updating the security.config file

When you configure HCL Quality Server in GUI mode, the security settings are saved to the security.config file in the security folder in the HCL Quality Server workspace. To add or modify the security settings after installing the server in GUI mode use these instructions.

Modifying security settings manually after installing in GUI mode

Before you begin

HCL Quality Server must be installed on the target computer.

About this task

When you install in GUI mode, you can configure Active Directory or LDAP authentication during the installation. To make changes to the security configuration after installation, you can either use the Modify option in the IBM Installation Manager GUI or edit the security.config file.


  1. Stop the server, if it is running.
    • On Windows systems, stop the HCL HCL Quality Server service.
    • On Unix-like systems, run the stop script. For assistance, contact your system administrator.
  2. Go to the security folder in the server workspace.
    • On Windows systems, the folder is typically at C:\HCL\HQS-Workspace\security.
    • On Unix-like systems, the folder is typically at /var/hqs/security.
  3. Update the security.config file with Active Directory or Local Directory Access Protocol (LDAP) settings as necessary. For information about various properties associated with Active Directory and LDAP configuration, see Configuring the Active Directory settings and Configuring the Lightweight Directory Access Protocol (LDAP) settings.
  4. Run EncryptPassword.exe available at either of the following locations to encode your administrator password:
    • HCL OneTest™ API installation folder (C:\Program Files\HCL\HCLProducts\Agent\ in Windows and /opt/HCL/HCLProducts/Agent/ in Linux)
    • HCL OneTest API Agent installation folder (C:\Program Files\HCL\HCLProducts\Agent\ in Windows and /opt/HCL/HCLProducts/Agent/ in Linux).
    For example:
    EncryptPassword.exe myPassword 
    Escape the special characters using the "\" character as shown in the following example:
    Update the adminpassword property in the security.config file with the resulting value.
  5. For the changes to take effect, start the server and test your login credentials by using a web browser.