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

When you configure HCL DevOps Test Virtualization Control Panel (Test Virtualization Control Panel) in GUI mode, the security settings are saved to the security.config file in the security folder in the Test Virtualization Control Panel 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

Test Virtualization Control Panel 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 Installation Manager GUI or edit the security.config file.

Procedure

  1. Stop the server, if it is running.
    • On Windows systems, stop the HCLQS 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:
    Important: You can use EncryptPassword.exe to encrypt passwords in Test Integrations and APIs or Test Virtualization Control Panel to achieve simple encryption such as to hide plain text passwords. The encryption might not be suitable to use when encryption is required for a higher security requirement.
    • Test Integrations and APIs installation folder (C:\Program Files\HCL\DevOpsTestAPI in Windows and /opt/HCL/DevOpsTestAPI in Linux)
    • Test Integrations and APIs Agent installation folder (C:\Program Files\HCL\DevOpsTestAPIAgent in Windows and /opt/HCL/DevOpsTestAPIAgent in Linux).
    For example:
    EncryptPassword.exe myPassword 
    #com.ghc.1!b2b312954AC84469E34BA2E5
    Escape the special characters using the \ character as shown in the following example:
    \#com.ghc.1\!b2b312954AC84469E34BA2E5
    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.