Installation and Upgrade Process Issues

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 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. To verify, go 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.

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.  

For other related information, refer to the MySQL documentation. 

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. 

Other Issues

Suite Execution Fail Error: com.mysql.jdbc.Connection.isValid(I)Z

This error occurs due to incompatible driver version of MySQL. To resolve this error, you must download and place the compatible version of MySQL driver at the specified location.

To resolve this error:

  1. Download the compatible version of MySQL Driver.
  2. Unzip the file.
  3. Copy mysql-connector-java-8.0.11.jar and place it to %localappdata%\QualitiaWDClient\app-5.x.x\WebDriver\lib location on the machine where you have installed Qualitia.
  4. Navigate to %localappdata%\QualitiaWDClient\app-5.x.x\WebDriver.
  5. Edit build.xml and replace mysql-connector-java-x.x.x-bin with the new file name (i.e. mysql-connector-java-8.0.11.jar).
  6. Save and close the file.
  7. Restart Qualitia Automation Studio. 

TC Out of Sync (Reports)

This error usually occurs when the execution of suite is started but the corresponding test case is edited or being updated by one or other users.

In case you face this issue, you open the corresponding test case from the Develop section, click Save and continue execution from Suite or Scheduler.

If you are getting this error after test case execution using Qualitia Bot, you need to create the test case execution XMLs again.

To create test case execution XMLs again:

  1. Navigate to the Execute section.
  2. Select suite from which you want to execute test cases.
  3. Mark the test cases which you want to execute.
  4. Click Save As XML.

In case the issue persists, please connect to Qualitia Support.

Version Control Error: Object Reference not set to an instance of an object.

This error occurs when SharpSVN is used as version control tool for the Qualitia test assets. Few SharpSVN components require Microsoft Visual C++ 2010 SP1 Redistributable package.

To resolve this error, you must install Microsoft Visual C++ 2010 SP1 Redistributable package.


Root Cause: java.lang.Exception: C:\Users\<Username>\AppData\Local\QualitiaWDClient/WebDriver\Config/android.properties file does not exist.

Solution:

This error occurs when Qualitia is launched using the incorrect shortcut and user tries to execute the test case for Mobile web or native application.

To resolve this error; create a new shortcut of Qualitia.

To create new shortcut:

  1. Remove an existing shortcut of Qualitia from Desktop.  
  2. Go to %localappdata%\QualitiaWDClient\app-4.1.0.
  3. Right-click Qualitia.exe.
  4. Click Send to and select Desktop (create shortcut).

(warning) User will get this error when executing test case for Desktop Web as well but Qualitia ignores this error and continues execution of test case.

Unable to Add Objects using Objects Spy on Google Chrome

Starting Qualitia Automation Studio v5.6, you can add objects using Object Spy for Google Chrome. In case you face any difficulties while adding objects using Google Chrome extension, uninstall the Qualitia Object Spy extension and reinstall it.

This driver is not configured for integrated authentication.

This error occurs when using Qualitia with SQL server 2016 developer edition and the Authentication Mode is set as Windows Authentication. 

Solution:

  1. Download Microsoft JDBC Driver 6.0 for SQL Server.
  2. Unzip the file at some temporary location.
  3. Go to enu > Auth.
  4. Copy the dll depending on your OS (32 or 64-bit) version.
    (info) If you are using 32-bit, then copy sqljdbc_auth.dll from x86 folder and if you are using 64-bit, then copy sqljdbc_auth.dll from x64 folder.
  5. Open the Java directory that is set under Configuration Settings > Execution > Java Install Path.
  6. Add the dll file to lib and bin folders.
  7. If you are using jre7:
    1. Go to enu > jre7.
    2. Copy sqljdbc41 and add it to Qualitia installed location [C:\Program Files (x86)\Qualitia\Qualitia 3.14\WebDriver\lib].
  8. If you are using jre8:
    1. Go to enu > jre8.
    2. Copy sqljdbc42 and add it to Qualitia installed location [C:\Program Files (x86)\Qualitia\Qualitia 3.14\WebDriver\lib].

Teamcity Agent Running Headless Execution on Window Server System

Qualitia seamlessly integrates with TeamCity, Bamboo, Jenkins continuous integration tools. Sometimes users are unable to view the test case execution on the designated TeamCity build agent. 

It is observed that setting the right Java path resolves this problem. You can try below:

Qualitia Configuration File does not exist, can you please save Qualitia Configuration.

This issue occurs when the configuration file is missing. The file is created when you save the configuration settings for the first time.

This issue may occur when creating offline package (from File > Offline Package) as well.

Solution:

  1. Log on to Qualitia Automation Studio.
  2. On the Setting menu, click Configuration Setting.
  3. Click OK.
  4. Now create an offline package from File > Offline Package.

Unable to Select Project Using Project Drop Down 

This issue occurs when .Net framework installed is not compatible.

Qualitia Automation Studio requires minimum .Net Framework 4.6.2 installed on the system where client is being installed.

Solution:

If are not able to select the projects from the drop down list, you must upgrade the .Net Framework to 4.6.2. Refer to the Prerequisites and Configurations section for more information.

Incompatible .Net Framework: Method not found: '!!0[] System.Array.Empty()'

This issue occurs when .Net framework installed is not compatible.

Qualitia Automation Studio requires minimum .Net Framework 4.6.2 installed on the system where client is being installed.

Solution:

If you face the error mentioned above, close the dialogue box and upgrade the .Net Framework to 4.6.2. Refer to the Prerequisites and Configurations section for more information.

To determine which .Net Framework version is installed, refer to the Microsoft documentation.

Cloning Machines with Qualitia Installation is Not Supported

Some organizations follow a practice of creating Virtual Machines (VM) with standard configurations and then clone it for different users to use. If they install Qualitia on the base image, Qualitia licensing manager may get duplicate installation id for the cloned VM. In all likelihood, the end user may receive a licensing error. It is, therefore, recommended to install Qualitia separately on the VMs after they are cloned.

When trying to log in into Qualitia, the user may get the following error [when the machine is cloned with Qualitia Installation].

Solution:

  1. On the Qualitia License Server, open the url: http://localhost:1947/_int_/products.html
  2. If you see following error “Disabled due to Cloning”, take the screenshot and open a support ticket.
  3. If no such error is displayed in the Qualitia License Server, restart the “Sentinal LDK License Manager” service on the server system.
  4. If the issue persist for a particular Qualitia Client system only, re-validate the settings documented here. 

Sentinel HASP Run-time Installation

Sometimes, antivirus or firewall may block the Sentinel HASP. In order to continue the installation, please follow some steps mentioned below.

Solution:

  1. Launch the Command Prompt as an administrator.
  2. Navigate to the folder where haspdinst.exe exists.
  3. Execute haspdinst.exe.
  4. Continue the Installation Process.

Android Chrome Version - Chrome Driver Compatibility Issue

You may come across following types of errors when the chrome driver and browser versions are not compatible. 

Qualitia depends on the web drivers for mobile Web application testing. In case the chrome driver is not compatible with the browser version, it is recommended to update the driver as well as chrome browser to the latest version.

For more information about latest driver version and detailed change logs, click here.

Object Spy Not Working

Qualitia Object Spy is an Internet Explorer (IE) plug-in embedded within IE window at the bottom of the page. It allows you adding objects in the repository while developing test cases or tasks. You can edit the objects in case of any changes to document structure and at the same time validate changes to objects. 

In order to use this Object Spy tool seamlessly, user has to enable some options in Internet Explorer.

Unable to Launch Object Spy

If your Object Spy is not getting launched:

  1. Ensure you launch Object Spy from Qualitia (Develop > Objects > Spy.)
    Also, 
  2. Launch the Internet Explorer browser.
    IE zoom should be set at 100%.
  3. Click the Tools button from the top right corner and select Internet Options.
  4. Ensure that the Enable Protected Mode option is deselected and Security level is Medium for all the sections (i.e. Internet, Local Intranet, Trusted Sites, and Restricted Sites).  
  5. Click OK.
  6. Click the Tools button from the top right corner and select Manage add-ons.
  7. Enable ObjectSpy and ObjectSpy Toolbar add-ons.
  8. Click Close.

Also, you must ensure you have set few settings under registry.

This is required when Object spy requires some permissions to be accessed or launched for adding objects in the object repository. 

  1. Press Win+R to launch the Run dialog box.
  2. Type regedit and press Enter.
  3. In Windows 7 and Windows Vista, click the Yes or Continue button or type the administrator's password.
  4. Go to HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Lsa\Fipsalgorithmpolicy registry.
  5. Set the value as 0 as mentioned in the screenshot below.
  6. Close Registry.


Resetting Password for Qualitia Client.
The admin user can reset the password for other users using Qualitia client.
To reset password:
  1. Log on to Qualitia as an admin user.
  2. On the Users screen, select the user for whom you want to reset the password.
  3. Click Reset Password button. 
The password is then reset to the default Qualitia password.

Resetting Password for System Users.

For system users, Qualitia uses the password of the machine where Qualitia client is installed. This password would only be changed if the user updates machine / AD / LDAP password.

Qualitia License Key Not Found. (H0007)

Solution:

In case you come across this error:
If the issue still persists, follow the steps mentioned below:
  1. Create a file with its name in the following format - hasp_108764.ini
  2. Open this file using notepad and add the following setting in it:
    SERVERADDR = IP address of the license manager system. 
    For Example: If your license manager system’s IP address is 192.168.1.1 then setting will be: SERVERADDR = 192.168.1.1
  3. For Windows 7 and later versions, copy the hasp_108764.ini file to the following location: %localAppData%/SafeNet Sentinel/Sentinel LDK/
    Note: If not present, manually create folders SafeNet Sentinel/Sentinel LDK.
  4. Open the url http://localhost:1947 and go to Configuration > Access to Remote License Manager, select all check boxes, add required information and then click Submit.
  5. Go to Windows services console (Press Windows R and enter services.msc to open Windows Services console). 
  6. Select the service Sentinel LDK License Manager and restart it.
    You should be able to launch Qualitia with license being acquired from the remote license manager.
  7. For Verification if the license has been recognized by the license server, open the Sentinel ACC portal (http://localhost:1947) and click session to view the licenses acquired by various systems.
​You can now log on to Qualitia Client without any error.

How to work with HTML form element?

In order to perform action against the form element, Qualitia user need not select/switch control in WebDriver. Selection/switching of control in WebDriver is ONLY required for frames/iframes and browser windows.

Form can be identified using regular identifiers such as Name, ID, and other relevant locators.

AttachFile Action Not Working/Failing

Failed to Connect JIRA. Verify Username/Password

If you are unable to connect to JIRA from Qualitia Automation Studio (Configuration Settings), try logging in manually using browser.

Atlassian applies CAPTCHA policy in case of failing login attempts due user name or password mismatch.