Document toolboxDocument toolbox

Header

(8.6.X) Upgrade from 3.14 to 4.1.0

Owned by Dhiraj Chandanshive (Unlicensed)
Last updated: Aug 17, 2022Version comment
4 min read

Applying product updates will give you an enhanced experience of working with Qualitia Automation Studio for Web and Mobile.

For more information about new features released in the newer version of Qualitia, please refer to the Release Notes section.

If you are using Qualitia Automation Studio for Web and Mobile 3.14, you need to upgrade it to the v4.1.0 before you upgrade to the latest version.

Qualitia supports upgrade from v3.14. In case you are using prior version of Qualitia WebDriver, please contact support team for the detailed upgrade procedure.



In order to optimize test execution performance for non-browser test cases, Qualitia now launches the browser only on the OpenURL action. This might cause failing test cases with any browser-based actions used before OpenURL in Qualitia for Web and Mobile 4.1.x and above.
Qualitia users must use the browser-based actions such as MaximizeBrowser and so on after the OpenURL action.

 Prerequisites

In order to upgrade to the latest version, you need to set up an environment.  

  • Qualitia WebDriver v3.14.

  • It is strongly recommended to backup up Qualitia server databases (Master, Project and Result Databases).

  • If your MySQL database server is installed on Linux machine, you must ensure that the values of column ProjectName and ProjectDBName names are in the lowercase under Master Project database in the table tblprojects. Entering project names in uppercase may cause failing upgrade process.

  • Identify a File Server and create a folder to keep all the Qualitia Installables. This File Share will be used by Qualitia to apply any future upgrades / update packages. It is mandatory that all the Qualitia users should have Read Access to this folder. For more information about Qualitia Update Location, click here.

  • If the number of projects to be upgraded is more than 50, you must increase the max_connections limit from MySQL database configuration settings. For more information about increasing the limit, refer to Qualitia Troubleshooting section. 

  • Ensure you close all the instances of Qualitia Automation Studio and Internet Explorer before you start the upgrade process.
     If Qualitia Automation Studio is open, the upgrade process closes all the active Qualitia instances. If you have multiple Qualitia instances open, ensure you save the changes and close all the Qualitia instances before you start the upgrade process.

Make sure you are pointing to the correct database server when upgrading to the higher version of Qualitia. Pointing to an incorrect database may result in data loss.

Upgrading Qualitia Server

When upgrading from 3.14 to a newer version, you must first ensure that you have taken a back up of your Qualitia databases. Upgrading Qualitia includes upgrading the Qualitia server and client.

To upgrade Qualitia Server:

  1. Ensure you have the valid product license activated for Qualitia. 

  2. Log on to the machine where you have installed Qualitia Server 3.14.

  3. Navigate to the File Share where you have stored Qualitia Installable.

  4. Open the Server folder.



  5. Double-click Setup.exe.
    The Welcome screen appears.

  6. Click Next.

  7. As you are already using previous version of Qualitia, system will notify to upgrade to the latest version. Click OK.

  8. Enter Database server details.





  9. Click Next.
    A Project Details screen appears with all the existing list of projects. 

  10. Click Next.
    The Qualitia Update Location screen appears.



  11. Enter the details as follows:





  12. Click Next.
    The Confirm Installation screen appears.

  13. Click Install.
    The installation will get started and after a successful installation, the Installation Complete screen appears.

  14. Click Finish to exit the setup wizard.


Upgrading Qualitia Client

After the Qualitia Server is updated to 4.1.0, you can upgrade Qualitia Client.

To upgrade Qualitia client:

  1. Refer to the prerequisites section for Qualitia Client before upgrading Qualitia Client.

  2. Log on to the machine from where you want to upgrade Qualitia Client.

  3. Close all the instances of Internet Explorer and do not open it during the installation process.

  4. Navigate to the File Share/ folder where you have kept Qualitia Installable.

  5. Open the Client folder.



  6. Double-click Setup.exe.

  7. System will ask for permission to run the application, click Yes.

    The Qualitia Installer screen appears.

  8. Once you have reviewed Qualitia License Agreement, select Yes, I accept the terms…, and then click Next.

  9. Once installed successfully, click Finish.
    You can now start working with Qualitia.

  10. To launch Qualitia, double-click the Qualitia icon on your desktop.




Footer