(8.5.X) Upgrade from 3.14 to 4.1.0

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 (8.5.X) 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.

 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.
  

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.

   Executing Setup.exe from file server may take longer time. Therefore, it is recommended to copy Setup.exe in the local temporary 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.

   Fields	Description
   Database Type	Select the database type (MySQL or MSSQL) from the drop-down list.
   Server	Enter the Host Name or IP Address of the Qualitia data store server.
   Port	Enter the Port number of the Qualitia database server. Default is 3306 for MySQL and 1433 for SQLServer.
   Database Name	Enter the master database name.
   Authentication (for SQLServer only)	Select authentication mode. SqlServer Authentication: Login with SQL Server user account (Enter User ID and Password) Windows Authentication: Login with Windows account.
   User ID	Enter the database server user ID.
   Password	Enter the database server password.

   
   

   In MySQL this database user ID should have Grant All privileges on the database.

   In SQL Server this database user ID should have DBO privileges on the database.

   
   

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

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

    Qualitia update location is the shared location where Qualitia will look for update packages. For more details, refer to the (8.5.X) Qualitia Update Location section.

    
    

11. Enter the details as follows:

    
    

    Fields	Description
    Server	Enter the location where Qualitia will check for server updates.
    Client	Enter the location where Qualitia will check for client updates.

    
    

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.

   Executing Setup.exe from file server may take longer time. Therefore, it is recommended to copy Setup.exe in the local temporary folder.

   
   

6. Double-click Setup.exe.

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

   If you have not uninstalled the previous version of Qualitia, system will uninstall it with prior notification.

   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.