Installation and Upgrade Process Issues

...

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.  

...

1. Workaround 1: Update the Git version to the latest one.

2. Workaround 2: Change Git settings by executing this command:

   
   

   git config --system core.longpaths true

   
   

3. Workaround 3:
   Update the registry key (in Windows 10, version 1607, and later)
   HKLM\\SYSTEM\\CurrentControlSet\\Control\\FileSystem LongPathsEnabled (Type: REG_DWORD) should be set to 1.

    view image

   

   If any of the workaround mentioned above does not work or you are unable to follow these workarounds due to any permission-related issues, you can move the Qualitia project to some local drive with relatively shorter path. Moving the project to the local drive or shorter path saves some character space and may resolve the issue.

...

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

Image Modified

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.

...

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.

Image Modified

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.

...

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).  

    View image

   
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.

...

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)

Image Modified

Solution:

...

Execute Tab and Database Restore Due to Less Packet Size

Problem: Upon clicking the Execute tab or when restoring Qualitia database, the following message is displayed: “throws error packets larger than max_allowed-packet are not allowed”.

Solution: Increase the max_allowed_packet size in the Qualitia Database Server.

Unable to Link Qualitia Test Cases with TFS/Azure DevOps Test Cases

Problem: Unable to link Qualitia Test Cases with TFS/Azure DevOps Test Cases.
Description: The message as “Error in linking  the Test Case” is displayed. The reason is the user is missing certain access permissions in TFS/Azure DevOps.

Solution:

Qualitia integration with TFS/Azure DevOps expects that you have “Update Work Items” access that is used to generate the PAT (Personal Access Token).

The PAT with required access can be procured in one of the following ways:

• Generate the PAT with a user that is part of the Project Administrators group.
  Qualitia recommends this option for generating a PAT.

• Allow Bypass Rules on Work Items Updates
  Perform the following steps:

  • In TFS/Azure DevOps project, ensure that the user that is used to generate PAT is member Contributors group / Project Team members group.

  • Click Project Settings > Permissions.

  • Select the user group that has the user to whom you want to provide access (Contributors/Project Team members).

  • From the Bypass rules on work items list, select Allow.
    Refer to the following screenshot.

...

Note: Please connect with your Azure DevOps Admin team to discuss the PAT generation and access level management.

Teamcity

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:

• Install or upgrade Java to JRE 8.0 at the default location. (C:\Program Files\Java\jre1.8.0_101\bin\java.exe)
• Update java path to this new location in the Environment Variables section (either under JAVA_HOME or Path).

Task Iterations Not Getting Executed

Problem: Some task iterations are skipped.

Summary: In task iterations, some iterations execute, but the remaining task iterations do not execute or none of them were executed.

Solution:

You need to delete the blank cells associated with task iterations.

Perform the following steps:

1. Open the test case in which task iterations did not execute.

2. Open its Test Data explorer.

3. Select the blank cells of the following columns, and press Delete from your keyboard.

   1. TCIteration

   2. Selection

   3. DataSetTag
      Note: All the cells can be deleted in a single go except for the first cell immediate below to DataSetTag. You need to delete this cell separately.

Unable to Start a Session on MOS or Mobile Recorder on Xcode version 11.6 or higher.

Problem: Unable to start session after selecting an application in MOS or Mobile recorder on Xcode version 11.6 or higher.

Summary: The WDA bundled along with the agent does not work on Xcode version 11.6 and higher.

Solution:

Perform the following steps:

1. Stop the agent.

2. Go to Applications > MOSAgent > Right click >Show package content > Contents > MacOS.

3. Double-click RunAgent.
   A terminal opens to start the agent.

4. In the logs, find the following message using the WDA path:
   /var/folders/vt/f2c8mcz536x6d9_vbgs7dh740000gn/T/QualitiaMOSAgent/WDATemp
   Note: This path differs for every user.

5. Copy that path and open in finder.

6. Delete all the content inside the WDATemp folder.

7. Download WDA v2.20.0 for your Xcode version from the following location:
   https://github.com/appium/WebDriverAgent/releases
   Note: Download the WDA version that best matches to your Xcode Version.

8. Extract the downloaded file, copy all the contents, and paste
   them in the WDATemp folder in the following location: /var/folders/vt/f2c8mcz536x6d9_vbgs7dh740000gn/T/QualitiaMOSAgent/WDATemp
   Note: This path differs for every user, you must find the WDATemp folder path as explained in step. 4.

9. Open WebDriverAgent.xcodeproj in Xcode and make sure you set proper Team and check Automatically manage signing in the Signing and Capabilitiessection for WebDriverAgentLib, WebDriverAgentRunner and IntegrationApptargets.

10. Click Product > Build for >Testing.
11. After the build is succeeded, click Product > Build.
12. Close Xcode.

13. In the agent, connect to a device and select an application.
    Note: You might have to perform this step every time you restart the machine as the temp folders are deleted and recreated whenever the machine restarts. 

Offline Suite Execution Fails on a Macintosh Machine

Problem: Offline package execution fails on a Macintosh machine and displays the following message:

"Failed to create WDA session:[WD Proxy] Error: timeout of 240000ms exceeded"

Solution: Restart your computer or restart the Appium server help to resolve this issue.

Perform the following steps:

...

Copy offline package and offline suite to mac machine

...

Update offline suite xml path in /Users/localadmin/Downloads/7.3.9_QDEV-21147/Qualitia Offline/config/qualitia.properties

...

Go to /Users/localadmin/Downloads/7.3.9_QDEV-21147/Qualitia Offline

...

Hit command java -jar qualitiaoffline-7.3.9.jar

...

Observe execution

...

Execute Tab and Database Restore Due to Less Packet Size

Problem: Upon clicking the Execute tab or when restoring Qualitia database, the following message is displayed: “throws error packets larger than max_allowed-packet are not allowed”.

Solution: Increase the max_allowed_packet size in the Qualitia Database Server.

Unable to Link Qualitia Test Cases with TFS/Azure DevOps Test Cases

Problem: Unable to link Qualitia Test Cases with TFS/Azure DevOps Test Cases.
Description: The message as “Error in linking  the Test Case” is displayed. The reason is the user is missing certain access permissions in TFS/Azure DevOps.

Solution:

Qualitia integration with TFS/Azure DevOps expects that you have “Update Work Items” access that is used to generate the PAT (Personal Access Token).

The PAT with required access can be procured in one of the following ways:

• Generate the PAT with a user that is part of the Project Administrators group.
  Qualitia recommends this option for generating a PAT.

• Allow Bypass Rules on Work Items Updates
  Perform the following steps:

  • In TFS/Azure DevOps project, ensure that the user that is used to generate PAT is member Contributors group / Project Team members group.

  • Click Project Settings > Permissions.

  • Select the user group that has the user to whom you want to provide access (Contributors/Project Team members).

  • From the Bypass rules on work items list, select Allow.
    Refer to the following screenshot.

Image Added

Qualitia does not recommend this option for PAT generation as it changes the access levels for all the users in the group.

Note: Please connect with your Azure DevOps Admin team to discuss the PAT generation and access level management.

Teamcity

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:

• Install or upgrade Java to JRE 8.0 at the default location. (C:\Program Files\Java\jre1.8.0_101\bin\java.exe)
• Update java path to this new location in the Environment Variables section (either under JAVA_HOME or Path).

Task Iterations Not Getting Executed

Problem: Some task iterations are skipped.

Summary: In task iterations, some iterations execute, but the remaining task iterations do not execute or none of them were executed.

Solution:

You need to delete the blank cells associated with task iterations.

Perform the following steps:

1. Open the test case in which task iterations did not execute.

2. Open its Test Data explorer.

3. Select the blank cells of the following columns, and press Delete from your keyboard.

   1. TCIteration

   2. Selection

   3. DataSetTag
      Note: All the cells can be deleted in a single go except for the first cell immediate below to DataSetTag. You need to delete this cell separately.

Unable to Start a Session on MOS or Mobile Recorder on Xcode version 11.6 or higher.

Problem: Unable to start session after selecting an application in MOS or Mobile recorder on Xcode version 11.6 or higher.

Summary: The WDA bundled along with the agent does not work on Xcode version 11.6 and higher.

Solution:

Perform the following steps:

1. Stop the agent.

2. Go to Applications > MOSAgent > Right click >Show package content > Contents > MacOS.

3. Double-click RunAgent.
   A terminal opens to start the agent.

4. In the logs, find the following message using the WDA path:
   /var/folders/vt/f2c8mcz536x6d9_vbgs7dh740000gn/T/QualitiaMOSAgent/WDATemp
   Note: This path differs for every user.

5. Copy that path and open in finder.

6. Delete all the content inside the WDATemp folder.

7. Download WDA v2.20.0 for your Xcode version from the following location:
   https://github.com/appium/WebDriverAgent/releases
   Note: Download the WDA version that best matches to your Xcode Version.

8. Extract the downloaded file, copy all the contents, and paste
   them in the WDATemp folder in the following location: /var/folders/vt/f2c8mcz536x6d9_vbgs7dh740000gn/T/QualitiaMOSAgent/WDATemp
   Note: This path differs for every user, you must find the WDATemp folder path as explained in step. 4.

9. Open WebDriverAgent.xcodeproj in Xcode and make sure you set proper Team and check Automatically manage signing in the Signing and Capabilitiessection for WebDriverAgentLib, WebDriverAgentRunner and IntegrationApptargets.

10. Click Product > Build for >Testing.
11. After the build is succeeded, click Product > Build.
12. Close Xcode.

13. In the agent, connect to a device and select an application.
    Note: You might have to perform this step every time you restart the machine as the temp folders are deleted and recreated whenever the machine restarts.