Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents

This topic provides information on how to resolve the common issues you may encounter while working on web and mobile applications automation.

General Issues

This topic provides information about the general issues that you may see while working with Qualitia Studio.

...

Qualitia License Key Not Found. (H0007)

Image Modified

Solution:

In case you come across this error:

...

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

Image Modified

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.

...

Unable to Switch to Mobile Web-View


Problem: In the Qualitia Mobile Recorder, you might not be able to open a web application or web-view context of a hybrid application if chrome has more than 20 open tabs. Unable to switch to Mobile Web View and Loader keeps on Loading the screen.

...

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.

...

This topic provides information about the issues that you may face while working on iOS Platform and Macintosh.


Test Case

execution

Execution on iOS platforms or a Macintosh

computer fails

Computer Fails

Problem:

Test

 Test case execution on iOS platforms or a Macintosh computer fails with the following error:

“Execution is failing due to incorrect URL formation. Getting an error Original error: Failed to connect to /

<ip

<VPN_ip_address_of_macintosh_computer>:<port>”

Summary:

This

 This issue occurs when the Endpoint Security Firewall settings on the Macintosh computer restricts communication from the Windows computer where the QAS client is installed.

Solution: To resolve this issue you must enable communication between the

Macintosh and the Windows computer.

To enable communication between the Windows and the Macintosh machine:

Open the following UDP and TCP ports:

Computers as follows:

  • All Computers (in this case 2) should be connected over the same network.

  • Use VPN to connect all the Computer on same network

  • Whitelist the following ports in the VPN.

    • 4723 or the port number where the Appium server is running on the Macintosh

Machine
    • Computer

    • 21000

    • 8887

    • 8889

    • 4001

  • Add rules to open TCP and UDP ports from the Endpoint Security Product.

  • Ensure that both the incoming and the outgoing traffic is allowed.

Note:
  • Ensure that

the VPN is
  • you are connected to the

network
  • VPN while creating rules using the Endpoint Security products.

As an example, steps for McAfee Endpoint Security are provided below.
    • Qualitia recommends using VPN generated IP address for secure communication. For example, to execute a test suite on a different Computer, specify the VPN generated IP address of that Computer in the execution profile.

You must refer to the documentation

for

of your Endpoint Security product for instructions to allow communication between Windows and Macintosh

machines

Computers.

  1. Perform the following steps to create a custom rule for TCP ports:

    1. Open McAfee Endpoint Security for Mac.

    2. Click the Firewall tab.

    3. Unlock settings by entering the system password.

    4. Click the + (plus button) to add a custom rule.

    5. Add a rule with Name as “Allow custom port for TCP”.

    6. Status must be Enabled.

    7. Action must be Allow.

    8. Direction must be Either.
      Note: This setting ensures that both the incoming and outgoing traffic is allowed.

    9. Logging must be Enabled.

    10. Protocol Settings to Local and Single.

    11. In “Transport Protocol”, select TCP from the drop-down list.

    12. Select Local Port(s).

    13. Enter the port numbers that you want to enable.

    14. Click Ok.

  2. Perform the following steps to create a custom rule for UDP ports:

    1. Open McAfee Endpoint Security for Mac.

    2. Click the Firewall tab.

    3. Unlock settings by entering the system password.

    4. Click the + (plus button) to add a custom rule.

    5. Add a rule with Name “Allow custom port for UDP”.

    6. Status must be Enabled.

    7. Action must be Allow.

    8. Direction must be Either.
      Note: This setting ensures that both the incoming and outgoing traffic is allowed.

    9. Logging must be Enabled.

    10. Protocol Settings to Local and Single.

    11. In “Transport Protocol”, select UDP from the drop-down list.

    12. Select Local Port(s).

    13. Enter the port numbers that you want to enable.

    14. Click Ok.

Unable to connect to MOS Agent of a Macintosh Machine

Problem: Unable to connect to the MOS agent on a Macintosh computer from the QAS client on a Windows computer. The following error occurs when you try to connect to the MOS agent on a Macintosh computer:

Cannot connect to Qualitia MOS server, there might be following error:

  1. Port might not be accessible
  2. Server URL might be wrong

Please ensure that MOS server is installed and the MOS service is running on the specified port.

Summary: This issue occurs when the Endpoint Security Firewall settings restrict communication from the Windows computer where the QAS client is installed.

Solution: To resolve this issue you must enable communication between the Macintosh and the Windows computer. to enable communication between the Windows and the Macintosh machine:

  • Open the following UDP and TCP ports:
  • 4723 or the port number where the Appium server is running on the Macintosh Machine
  • 21000
  • 8887
  • 8889
  • 4001
  • Ensure that both the incoming and the outgoing traffic is allowed.

Note: Ensure that the VPN is connected to the network while creating rules using the Endpoint Security products.

As an example, steps for McAfee Endpoint Security are provided below. You must refer to the documentation for your Endpoint Security product to allow communication between Windows and Macintosh machines.

  • Perform the following steps to create a custom rule for TCP ports:

    1. Open McAfee Endpoint Security for Mac.

    2. Click the Firewall tab.

    3. Unlock settings by entering the system password.

    4. Click the + (plus button) to add a custom rule.

    5. Add a rule with Name as “Allow custom port for TCP”.

    6. Status must be Enabled.

    7. Action must be Allow.
    8. Direction must be Either.
      Note: This setting ensures that both incoming and outgoing traffics are allowed.

    9. Logging must be Enabled.

    10. Protocol Settings to Local and Single.

    11. In “Transport Protocol”, select protocol “TCP” from the drop-down list.

    12. Select Local Port(s).

    13. Enter the port numbers that you want to enable.

    14. Click Ok.

  • Perform the following steps to create a custom rule for UDP ports:

  • Open McAfee Endpoint Security for Mac.

  • Click the Firewall tab.

  • Unlock settings by entering the system password.

  • Click the + (plus button) to add a custom rule.

  • Add a rule with Name “Allow custom port for UDP”.

  • Status must be Enabled.

  • Action must be Allow.

  • Direction must be Either.
    Note: This setting ensures that both incoming and outgoing traffics are allowed.

  • Logging must be Enabled.

  • Protocol Settings to Local and Single.

  • In “Transport Protocol”, select protocol “UDP” from the drop-down list.

  • Select Local Port(s).

  • Enter the port numbers that you want to enable.

  • Click Ok

    Unable to connect to MOS Server Running on a Macintosh Computer from the QAS client Running on a Windows Computer

    Problem: Unable to connect to the MOS server on a Macintosh computer from the QAS client on a Windows computer. The following error occurs when you try to connect to the MOS agent on a Macintosh computer:

    Cannot connect to Qualitia MOS server, there might be the following reason:

    1. Port might not be accessible

    2. Server URL might be wrong

    3. Qualitia Server might not be running

    Please ensure that MOS server is installed and the MOS service is running on the specified port.

    Summary: This issue occurs when the Endpoint Security Firewall settings restrict communication from the Windows computer where the QAS client is installed.

    Solution: To resolve this issue you must enable communication between the Computers as follows:

    • All Computers must be connected over the same network.

    • Use VPN to connect all the Computer on same network

    • Whitelist the following ports in the VPN.

      • 4723 or the port number where the Appium server is running on the Macintosh Computer

      • 21000

      • 8887

      • 8889

      • 4001

    • Add rules to open TCP and UDP ports from the Endpoint Security Product.

    • Ensure that both the incoming and the outgoing traffic is allowed.

    • Ensure that you are connected to the VPN while creating rules using the Endpoint Security products.

    • Qualitia recommends using VPN generated IP address for secure communication. For example, To connect to the MOS server present on Macintosh Computer, specify the VPN generated IP address of the Computer on which MOS sever is running.

    You must refer to the documentation of your Endpoint Security product for instructions to allow communication between Windows and Macintosh Computers.

    TFS/Azure DevOps Issues

    This topic provides information about the issues that you may face while working with TFS/Azure DevOps.

    ...

    • 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 updates list, select Allow.
        Refer to the following screenshot.



    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 Agent Running Headless Execution on Window Server System

    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:

    ...