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

Prerequisites

• Qualitia WebDriver 5.x or above.

• Before upgrading to Qualitia Automation Studio v7.3.x, take a backup for all the projects and follow all the best practices recommended for backing and restoring the projects. For more information on best practices for project backup, refer to Best Practices for Project Backup and Restore .

• If MySQL database server is installed on Linux machine, 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, increase the max_connections limit from MySQL database configuration settings. For more information about increasing the limit, refer to Qualitia Troubleshooting section.

• Close all the instances of Qualitia Automation Studio and Internet Explorer before starting 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 to save the changes and close all the Qualitia instances before starting the upgrade process. For a detailed list of prerequisites, refer to the Prerequisites and Configurations section.

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

    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. 

    1. Enter the desired Dashboard Database name and click Next.
       
       
       

       If you are upgrading from a previous QAS version where some projects are integrated with TFS/Azure DevOps and their Test Case template file in the latest version of Qualitia have changed, the associated test cases are automatically upgraded to their latest versions. You can view the TFS integrated projects that are upgraded, and click Next.

       
       

13. The Project Details screen appears. You can view the projects selected for upgrade. Click Next.
    
    
    
    

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

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

    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.
    
    
    
    

    The Project Details screen appears.
    
    
    

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

    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.
    
    
    
    
14. Click Install.
15. Once installed successfully, click Finish to exit the setup.
16. Install / Upgrade Qualitia Client on this machine.  

Upgrading Qualitia Client

Once the administrator has updated Qualitia Server, other Qualitia users can update respective clients.

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.
   
   
   
   
4. Once the installation process is completed, click Finish.