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

...

...

Prerequisites

• Qualitia WebDriver 4.1.6 or 5.x.

• It is strongly recommended to backup 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.

• Ensure port 8887 and 8889 are open and accessible from the machine where you are installing Qualitia Server.

• 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.
  For detailed list of prerequisites, refer to the Prerequisites and Configurations section.

• If you are upgrading from Qualitia v7.2.x and you have projects integrated with TFS/Azure DevOps, you must republish the test cases after you complete the upgrade process. Also, ensure that you reinstall the latest Qualitia Remote Agents v7.2.3.

Upgrade Qualitia Server

Automatic Process

If you have installed Qualitia client on the same machine where Qualitia Server is installed, Qualitia intelligently picks up the upgrade packages, when available. Qualitia administrator has to log in to Qualitia client to initiate the automatic upgrade process.

To update Qualitia Server:

1. /wiki/spaces/TEST1/pages/1718944196Ensure you have the valid product license activated for Qualitia.

2. Open the Qualitia Update Location defined when Installing Qualitia Server.

3. Replace the content with Qualitia Product Update.
    Once the Qualitia Update Package is placed on the designated location, Qualitia intelligently picks it up when logging on as an administrator user.

4. Log on to the machine where you have installed Qualitia Server and log on to Qualitia Client as Qualitia Administrator user.

5. Once you enter user credentials and click Log On, Qualitia informs the user that the next update is available.Image Removed

   Image Added

6. Do one of the following:

   • If you want to update Qualitia Server, click Yes.

   • If you want to ignore the update and continue working on the previous version, click No.

7. It is recommended to use the updated product versions applying available product updates for seamless user experience.

8. Once you click Yes, Welcome to the Qualitia Setup Wizard screen appears.Image Removed

   Image Added

9. Click Next.
   All the database server details appear.

10. All these fields are displayed in non-editable mode, click Next.

    

11. Click Next and you will see the master database name.

12. Select the Enable Dashboard option, if you want to enable Dashboard functionality.
    For more information about the dashboards functionality, click here.

    Info
    Enabling this option, Qualitia consumes an additional database (except master and project databases) for managing data related to the dashboard functionality. Kindly make a note of it.

13. Enter the desired DashboardDatabasename and click Next.Image Removed

    Image Added

    The Project Details screen appears.Image Removed

    Image Added

14. Specify the Result Path to store results of the test cases executed outside Qualitia and click Next.

    Tip
    Qualitia uses this folder to store results of test cases executed through CI Tools (Jenkins, TeamCity, Bamboo), Build / Release Cycles from TFS/Azure DevOps, and offline package. All the Qualitia clients should have read access to this directory.

    

15. Click Next.
    The Confirm Installation screen appears.Image Removed

    Image Added

16. Click Install.

17. Once installed successfully, click Finish to exit the setup.

18. Install / Upgrade Qualitia Client on this machine.

Manual Process

If Qualitia client is not installed on the machine where Qualitia server is installed, you must run Setup.exe manually to upgrade server.  

To update Qualitia Server:

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

2. Open the Qualitia Update Location defined when Installing Qualitia Server.

3. Replace the content with Qualitia Product Update.

4. Log on to the machine where Qualitia Server is installed and navigate to the Qualitia Update Location where you have kept the product update.

5. Open Server folder.

6. Right-click Setup.exe and select Run as administrator.
   The Welcome to the Qualitia Setup Wizard screen appears.Image Removed

   Image Added

7. Click Next.
   All the database server details appear.

8. All these fields are displayed in non-editable mode, click Next.

   

9. Click Next and you will see the master database name.

10. Select the Enable Dashboard option, if you want to enable Dashboard functionality.
    For more information about Web Dashboards, click here.

    Info

    Note: Enabling this option, Qualitia consumes an additional database (except master and project databases) for managing data related to the dashboard functionality.

    You may choose to enable dashboard after the upgrade process is completed. For more information about enabling dashboard functionality later, click here.

     

11. Enter the desired DashboardDatabasename and click Next.Image Removed

    Image Added

    The Project Details screen appears.Image Removed

    Image Added

12. Specify the Result Path to store results of the test cases executed outside Qualitia and click Next.

    Tip
    Qualitia uses this folder to store results of test cases executed through CI Tools (Jenkins, TeamCity, Bamboo), Build / Release Cycles from TFS/Azure DevOps, and offline package. All the Qualitia clients should have read access to this directory.

    

13. Click Next.
    The Confirm Installation screen appears.Image Removed

    Image Added

14. Click Install.

15. Once installed successfully, click Finish to exit the setup.

16. Install / Upgrade Qualitia Client on this machine.  

Upgrading Qualitia Client

To update Qualitia Client:

1. Log on to the machine where you want to upgrade Qualitia client. 

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

3. Double-click the Qualitia icon.
   If the server is updated, Qualitia users (other than the Qualitia administrator) will get a notification about updating Qualitia Client.
    Qualitia users will not get this notification if Qualitia Server is not updated.Image Removed

   Image Added

4. Once the installation process is completed, click Finish.