Versions Compared

Key

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

Points to Know

  • The following are two ways for migrating the projects:

    • Using Project Migration Utility: The Project Migration utility is used for migrating 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.

Recommendations for Project Migration

  • Latest versions of test cases and tasks must be available in the Project path

  • The Qualitia database is accessible

  • Migration process might take extended time based on the project size. Therefore, plan to initiate migration accordingly.

  • Perform the project migration on a machine with at least below configurations for better turn-around time.

    • RAM - 16 GB

    • Quad-Core Processor

    • Free Disk Space - 5GB

Also, the migration process completes faster if other programs are not running on the machine.

Launching the Project Migration Utility

The Project Migration Utility is available with Qualitia Client folder.

...

  • Extract the DataMigration ZIP folder.

  • Open the extracted folder.

  • Execute the CommonEditorDataMigrationUtility.exe.

Migrating Projects

Info

Project Migration using Qualitia Client

If you are migrating a single project from a Qualitia client, there is no need to enter database or version control details. If some project artifacts do not match with version control, Qualitia directly opens the details of artifacts missing screen, as described in step 5.

Else, it directly displays the Project Health Checkup screen as described in step 6..

...

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 projects to migrate from the Projects Selection screen.

...

Step 11: Click Finish to exit the Migration Utility.

Post Migration Considerations

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

...