Upgrading from Qualitia Automation Studio (QAS) for Web and Mobile 5.x, 6.x, or 7.x version to Qualitia Automation Studio v8.3.x includes the following steps:

...

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

...

Prerequisites

• Qualitia WebDriver 5.x or above

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

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

Upgrading the Qualitia Server

...

To update the Qualitia Server:

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

2. Log on to the machine where Qualitia Server is installed and copy the QualitiaWDServer.exe to this machine.

3. Right-click QualitiaWDServer.exe and select Run as administrator.
   The Welcome to the Qualitia Setup Wizard screen appears.
   

...

1. Image Added

2. Do one of the following:

   • To upgrade the Qualitia Server, click Next.

   • To cancel the upgrade process, click Cancel.

3. It is recommended to use the updated product versions applying available product updates for seamless user experience.
   All the database server details appear. All these fields are displayed in non-editable mode, click Next.
   

...

1. Image Added

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

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

4. Enter the desired Dashboard Database name and click Next.
   
   Image Modified

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

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

   Info
   Note: The projects for which the specified database user credentials lack some database privileges are highlighted in the red color as shown in the following figure: Image Modified Click Save Report. The report shows the missing privileges that you must assign to the database user. Else, you cannot proceed to upgrade the QAS projects.

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

...

1. Image Added

2. Click Upgrade as shown in the following figure:
   

...

1. Image Added

2. The Upgrade screen shows the upgrade progress for each project as shown below:
   

...

1. Image Added

2. You can do the following actions:

   1. Click Save Report to save the upgrade status of every project as an HTML file. After the report is saved, it opens automatically.

   2. Click Show Logs to view the logs.

3. If some projects fail to upgrade, restore their backup, and then restart the upgrade process for them.

4. After all the projects are upgraded successfully, click Finish to exit the setup.

Upgrading the Qualitia Client

...

To update Qualitia Client:

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

2. Copy the QualitiaWDClient.exe from the update package to the machine

...

1. .

2. Double click the QualitiaWDClient.exe to start the Qualitia Client update process.

3. After the upgrade process is completed successfully, click Finish.

Migration Process for Web/Mobile Projects

...

Launching the Project Migration Utility

To launch the Project Migration Utility:

1. Open the Qualitia Installable.

2. Under the QualitiaProjectMigrationUtility folder, unzip the QualitiaProjectMigrationUtility.exe through 7-Zip file archiver only.

3. Execute the QualitiaProjectMigrationUtility.exe

Migrating Projects

...

• Tasks with missing XML files: Displays the missing tasks.

• Test Cases with missing XML files: Displays the missing tasks.

• Test Cases Impacted due to the deletion of tasks: Displays the test cases that are associated with the missing tasks.

• Remarks: Displays if all the necessary artifacts are available. Click Next if all the artifacts are available.
  Perform the following steps if any of the artifacts are missing:

  1. Find and add the missing test case/task XML files in their associated project folders, and click the Refresh button.The Utility screen updates the missing tasks and test cases.

  2. Click Next.

...

Click Finish to exit the Project Migration Utility.

...

Post Migration Considerations

...