This topic provides information on how to resolve the common issues you may encounter while installing or upgrading Qualitia Automation Studio.

How to Verify Digital Signature Manually?

Qualitia digitally signs all the executable files shared with Qualitia Setup or installable. In case system fails to verify this Digital signature, it is recommended to verify the signature using few simple steps before continuing the operation. 

To verify the Digital Signature manually:

1. Right-click Setup.exe and select Properties from the context-menu.
2. In the Digital Signatures section, click Details.
3. Ensure you see appropriate Signer Information as mentioned in the screenshot below:
   This ensures that the setup.exe is safe to run in the environment.
   
     

In case you find Signer Information missing, inform Qualitia Support immediately and abort the execution of such files.

"Installation is forbidden" Error While Installing the Qualitia Client

Problem: This error occurs when you try to install\update the Qualitia client as a normal user instead of running it as an administrator.

Following is the Qualitia log error:

*MSI (s) (04:4C) [17:19:18:925]: Rejecting product '{4F8DBD40-67A6-4AEE-B0CE-A66C8C39E6C9}': Non-assigned apps are disabled for non-admin users.
Info 1625. This installation is forbidden by system policy. Contact your system administrator.

C:\Users\poc\AppData\Roaming\Qualitia Software Pvt. Ltd\Qualitia Automation Studio - Client 8.4.0 8.4.0.366\install\QualitiaWDClient.msi
MSI (s) (04:4C) [17:19:47:824]: MainEngineThread is returning 1625*

Root Cause: Default Windows Installer Settings on Server OS restricts any msi file to install application on LocalAppData of the machine.

Solution: To resolve this issue, grant the Windows installation group policy by performing the following steps.

1. In the Group Policy Editor, navigate to Console Root > Local Computer Policy > Computer Configuration > Administrative Templates > Windows Components and locate Windows Installer.

2. Double-click Windows Installer.

3. Double-click Turn off Windows Installer. The Turn Off Windows Installer window opens.

4. Select Enabled.

5. In the Disable Windows Installer dialog box, select Never.

6. Finally, click OK.

Installation Has Failed or The application Could not be started.

This error occurs when multiple installation processes get started or some Windows features are not enabled.

Sometimes, unzipping Setup.exe takes more than usual time due to the system specifications or some other technical problems. Users are requested to wait for some time once they double-clicked Setup.exe.

Solution: If you face the error mentioned above, close the dialogue box. 

Ensure you have Enabled .Net Framework under Windows Features.

You can confirm whether this feature is enabled using these simple steps mentioned below: 

If the server machine has Windows Server OS, navigate to Server Manager > Right-click Features and select Add Features.

If the server machine has Windows 7 and above, navigate to Control Panel > Programs and Features > In the right pane, click Turn Windows features on or off.

You may have to reboot the system to get the changes effective. After rebooting system, run the setup.exe again.

Case Sensitive Issues in Project Name

Description: If in the source control system (GIT and SVN), the letters of a project name change their case, then Qualitia does not allow to open the project

Solution: You need to change the project name in source control that matches with the Project directory in such a way that the case of every letter of the displayed project matches.

Incompatible Client Server Version

This next-generation installer handles all server and client related updates easily. Users are requested to apply updates whenever made available by team Qualitia to maintain server-client compatibility.

Solution: If you face this error, please apply the latest update available for Qualitia Server.

Change Communication Port for Qualitia Server

By default, Qualitia Server is configured to use communication port 8889. In case this port is being used by some another application, you may change this communication port to any other available port. 

To change the communication port for Qualitia Server:

1. Navigate to %localappdata%\QualitiaWDServer\app-5.2.0\Server.
2. Open the application.properties file.
3. Update value for server.port.
4. Save and close the file.
5. Restart the Qualitia Server service from the Services console and continue installation. 

Exception in UpgradeProjectDatabase : <Project_Name>: Too many connections

This error occurs when the number of projects is more than 50. In order to proceed with the upgrade process, you must then increase the limit of maximum connections allowed in the MySQL database settings. By default, 151 is the maximum permitted number of simultaneous client connections.  

You can set this limit from where the MySQL server maintains system variables that configure its operation. System variables can be set at server startup using an option file.

Increasing Limit using Option File (Windows)

You can increase this max_connections limit Using Options File (sometimes called Configurations File).  

1. Navigate to C:\ProgramData\MySQL\MySQL Server 5.7 on the machine where MySQL is installed.  
2. Edit the my.ini file using any text editor.  
3. Update the value for max_connections.  
4. Save and Close the file. 
5. Restart MySQL service to get the changes affected.  

Increasing Limit using Option File (Linux) 

If the MySQL is installed on the Linux machine, you will find my.cnf file in the MySQL installation directory. You can update the value for max_connections in my.cnf file using any text editor.  

For more information, refer to the MySQL documentation. 

Installation Has Failed

This error occurs when multiple installation processes are started. Sometimes, unzipping Setup.exe takes more than usual time due to the system specifications or some other technical problems. Users are requested to wait for some time once they double-clicked Setup.exe.

Solution: If you face the error mentioned above, close the dialogue box and double-click Setup.exe again.

Incompatible Client Server Version

This next-generation installer handles all server and client related updates easily. Users are requested to apply updates whenever made available by team Qualitia to maintain server-client compatibility.

Solution: If you face this error, please apply the latest update available for Qualitia Server.