(8.6.X) Execution on Sauce Labs

Introduction

Sauce Labs is a cloud environment which allows users to run tests in the cloud using different combinations of operating systems, browsers, and browser versions. In this environment all tests are executed on Sauce Labs VM. You can view the ongoing suite execution on Sauce Lab's Dashboard.

To know more about Sauce Labs click here.

Also, before uploading an iOS native or hybrid application, ensure that you build the application by following the below Saucelabs guidelines:

• To build the application for simulators, refer to https://support.saucelabs.com/hc/en-us/articles/360046918034

• To build the application for real devices, refer to https://wiki.saucelabs.com/display/DOCS/Creating+an+ipa+File

Prior to starting offline execution on Sauce Labs, ensure that you have:

• An active account with valid user name / password 

• Sufficient balance of execution hours.

Execution Guidelines

To execute tests on Sauce Labs, follow these steps:

1. Open Qualitia Automation Studio and login.

2. Go to the Execute tab.

3. Click Execution Profile.

4. Click the plus icon to add new Execution Profile.

5. Provide a name for the Execution Profile.

6. Under Execution Configuration > Web Environment select Sauce Labs

7. Under Web Execution Platform select Sauce Labs.

8. In the Desired Capabilities window, enter all the following mandatory fields by selecting the checkbox: 

   • url

   • username 

   • accesskey
     
     

     Open

     

     
     You can find the URL in the User Settings option present under the Account menu.

     Open

     

      

     Username and Access key are present under the Username & Access key menu.

      

9. Select the browser under Browser and enter the version in the Desired Capabilities section.

    

10. Navigate to the Suite Execution tab.

11. Create a test suite and test case.

12. Select the Execution Profile you created.

     

13. Go to Sauce Labs.

14. From the left navigation panel, select Automated > Test Results and verify the execution.

     

15. You can also see the video recording as shown in the following screenshot:

Execution of Tests Running Behind Firewall (on Private Networks)

Few applications are configured to be accessed using private networks. Such applications deny access when they are being accessed from other than local networks and so from Sauce Lab. Executing test cases on Sauce for such applications needs special configurations.

You need to execute the sc.exe file some machine in the private network to allow Sauce executing tests flawlessly.

Executing this sc.exe will create a tunnel allowing sauce to execute test cases in the private network. 

To execute applications of private network on Sauce:

1. Open the associated execution profile.

2. Under Edit Additional Capabilities, set the desired value for slw.tunnelIdentifier.
   The value set here for this key will be required when executing sc.exe in step 6. For more information on configuring this property, refer Sauce Labs documentation.

3. Download the Sauce Connect Proxy on any machine in the network using following url: 
   https://wiki.saucelabs.com/display/DOCS/Sauce+Connect+Proxy

4. Extract the folder at the suitable location.
   You will find the sc.exe file in the bin folder.

5. Open Command Prompt and navigate to the folder where sc.exe file exists. 

6. Enter the following command.

   sc -u <sauce_username> -k <accesskey> -i <tunnelID> For example: sc -u john.doe -k 8becc95c-4559-4582-a617-7d38544797a2 -i tunnel-1232

7. Press Enter.

Once the SC.exe file is executed successfully, you can execute your offline tests on Sauce environment using the same method mentioned above.

Execution using Browser Capabilities

You can also execute test cases on remote environment using selenium supported Browser Capabilities.

For more information on this, please refer to the Execution using Browser Capabilities section.

Executing Test Cases on iOS Devices

If you are executing test cases on iOS mobile devices using Sauce Labs, you need to configure settings in the iosdc.properties file accordingly.

• If iOS device is 9.3.x and below, automationname should be Appium or

• If iOS device is 10.0.x and above, automationname should be XCUITest.

Execution using W3C Protocols

W3C-compliant Selenium capabilities and protocol is supported for test case executions in the Sauce Labs environment with selenium v3.11.0 and above.

This W3C protocol is supported while executing test cases using following browser versions:

• Internet Explorer v11 and above,

• Mozilla Firefox v53 and above, and

• Google Chrome v 61 and above.

Here is the list of capabilities which you need to modify when you want to execute test cases using W3C protocol. 

For more information about executing test cases using W3C-Protocols and Capabilities, refer to the Sauce Labs documentation.