Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • The following are two ways for migrating the projects:

    • Using Project Migration Utility: The Project Migration utility is used for migrating Qualitia provides a Utility to migrate multiple projects in a single instance.

    • Using Qualitia Client: From Qualitia v7.3.0, if you select a non-migrated project, an error message is displayed in Qualitia that prompts you to migrate the selected project only. Upon clicking Migrate Now on this message, Qualitia guides you for migration of the selected project only.

  • In each screen of the migration process, you have an option to go to the previous screen or cancel the migration process at any time.

  • Any user having database credentials and version control tool credentials can run the Project Migration Utility.

...

  1. Open the Qualitia Installable.

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

  3. Execute the QualitiaProjectMigrationUtility.exe

...

Step 1: Launch the Project Migration Utility,.
From the first screen opens as shown in the following figure:, click Next.

...

Click Next.

Step 2: Enter

Do the following database details.in the order listed:

Field

Description

Database Type

Select the Server from the drop-down list: SQL Server and MySQL.

Server Port

Enter the Server and the Port IDs.
The default port is 3306 for MySQL and 1433 for SQL.

Authentication

Select the authentication type: Windows Authentication or SQL Server Authentication 
This field is applicable for SQL server only.

User Name

Enter the database server username

Password

Enter the database server password.

Database Name

Enter the database name which contains metadata of all the projects.

Qualitia Server URL

Enter the URL where Qualitia Server is installed. 

The Qualitia Server URL is a combination of the hostname/IP and port 8887 where you have installed Qualitia server. 
For example, http://192.112.33.123:8887.
By default, Qualitia uses port 8887. You may change it while installing Qualitia Server component.

...

Click Next.

Step 3: Select Under Project Selection, select projects to migrate from the Projects Selection screen.

...

Click Next.

Step 4: Enter the Version Control details for the selected project.

...

Info

In the case of multiple projects, the version control details are entered for every project one-by-one.

Click Next.

Step 5: If some test cases or tasks are missing for some projects, then the following are three types of validation errors highlighted for those projects:

  • Tasks with missing XML files: Shows the total number of tasks and name of each task that is missing.

  • Test Cases with missing XML files: Shows the total number of test cases and name of each test case that is missing.

  • Test Cases Impacted due to deletion of tasks: Shows number and name of test cases which are affected due to missing tasks.

...

In case you are able to find the missing test case/task XML files are available, replace the files in the , then add them in their respective project folders. Click Refresh to get the revised status of the missing files.

If files are not availablefound, click Next to delete them.

Info

The impacted tasks and test cases listed will not be available in the migrated project.

Step 6: The Project Migration Utility takes backup of the validated project artifacts, as shown in the following figure:

...

Click Next.

Step 7: The Project Health Check screen starts for each selected project as shown in the following figure:

...

Info

Verification for a project can may fail due to the following reasons:

  • The number of Test cases in the Project Database and Project path are not equal.

  • Some test cases of a the project are locked by users.

  • The DB connection was If connection to DB is interrupted.

Step 87: If verification fails for a project, click Corrective Actions to delete any test case or task file.

...

From the Project Health Check screen, click Retry to start the verification of that project.

Step 8:

Click the Download Report to download the Project Health Check report. The report shows the status of verification for each test case and task along with their IDs and statuses. Also, the reason for a test case or task verification failure.

...

Post Migration Considerations

After migrating a project, you must perform the following operations:

  • Recreate all the offline packages created using old Qualitia versions

  • If the project is integrated with TFS/Azure DevOps, then re-publish the test cases associated with TFS/Azure DevOps test casesYou need to recreate offline suites using the offline package. For more information, refer to Offline Package

  • The old offline suites cannot be executed through Qualitia Offline Jar file.