Versions Compared

Old Version 35

changes.mady.by.user ravi.chandran

Saved on

compared with

New Version 36

changes.mady.by.user ravi.chandran

Saved on

Key

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

The Project artefacts created in Qualitia for desktop must be compatible with Qualitia Automation Studio v8.0.0. Qualitia has provided a QFD Project Migration Utility to lets you migrate the your QFD projects to Qualitia Automation Studio v88.0.0.

Rules and Recommendations for Project Migration

  • QAS v8.0.0 x must be installed with the same database management system that QFD is using.

  • Upgrade your QFD to v4You must upgrade to QFD version 4.3.11 before migrating your QFD projects.

  • Ensure that you must have access to:

    • QFD database

    • SVN (if it is integrated with QFD)

    • QAS 8.0.0 database

  • The Update the project path must be updated with to the latest versions of test cases and tasks.

  • Plan the migration as the process as it might may take more time for large projects.

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

    RAM - 16 GB

    for the migration process, Qualitia recommends using a computer with the following configuration:

    • 16 GB RAM or more

    • Quad-Core Processor

    • 5GB Free Disk Space - 5GBor more

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

Launching the Project Migration Utility

To launch the Project Migration Utility:

  1. Open the Qualitia InstallableInstallation Package.

  2. Under the QualitiaProjectMigrationUtility folder, extract .

  3. Extract the QualitiaProjectMigrationUtility.exe through 7-Zip file archiver only.Execute the QualitiaProjectMigrationUtility.exe

Performing the Project Migration Process

The Utility performs the project migration in the following three phases:

  1. Finding the missing projects project artifacts for the selected projects

  2. Conducting Health Check on the selected projects

  3. Starting the Project Migration for the selected projects

To migrate the projects:

Step 1: The Open the Qualitia Project Migration Utility.

On the Welcome to Qualitia Project Migration screen opens showing , review the recommendations and migrations.
From the first screen, , and click Next.

...

Step 2: The On the Qualitia for Desktop (QFD) Database/Version Control Information screen opens.Enter , enter the following details to connect to the QFD database, and click Next.

  • Type: Select the database type of QFD database, MySQL or SQL Server.

  • Server: Port: Specify the QFD database server address along with its Port Id. The default Port Id for MySQL is 3306 and for SQL Server is 1433.

  • Database Name: Specify the Master Database name of the QFD database.

  • Authentication: To authenticate If you have selectedSQL Server database, select this option to authenticate to the SQL Server using Windows credentials. 

  • User Name: Specify the username to connect with to the QFD database.

  • Password: Specify the password for authentication.

  • Version Tool: Select as SVN or None. If you select SVN, enter your SVN username and password to connect to authenticate SVN connectionserver.

  • Project Path: Specify the location of the path folder where QFD saves the project artifacts (test cases and tasks).

  • Backup database before migration: To take the backup of Select this option to back up the selected QFD projects while migrating the projects startbefore starting the migration. You can skip this option if you have already taken the backup for backed up the selected project.

...


Step 3: The On the QFD Project Selection screen opens.Perform , do the following steps:

  1. Select the QFD projects that you want to migrate.

  2. Click Next.

Step 4: The On the Missing Artifacts Validation screen opens, review the information, and click Next.

For every project it shows the results for the following three types of validation:

  • Tasks with missing XML files: Shows Displays the missing tasks that are missing .

  • Test Cases with missing XML files: Shows Displays the test cases that are missing tasks.

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

  • Remarks: Shows the missing data other than tasks and test cases in every QFD projectDisplays if all the necessary artifacts are available. Click Next if all the artifacts are available.
    Perform the following steps :

    Do one

    if any of the

    following

    artifacts are missing:

    1. Find and add the missing test case/task XML files in their

    respective

    1. associated project folders, and click the Refresh button.


    1. The Utility screen updates the missing tasks and test cases.

    Click NextSkip the missing test case and task files, and click

    2. Click Next.

Noteinfo

If you You can skip the missing artifacts for a project , after the project migratesif you are unable to find some missing tasks and test cases. After the project is migrated, you need to re-create the missing tasks and test cases.

...

​Step 5: The On the Conducting Project Health Check screen opens.You can see that Project Health Check has started , the project health check starts for the selected projects. The utility QFD Migration Utility verifies whether any data is missing from the database, and test cases and tasks in Project Path are correctall the project artifacts for each project are correct and then generates a Health Check report as an HTML file.

Info

The project health checkup may fail due to the following reasonsif:

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

  • Some Any of the test cases of the in project are locked.

  • If the The connection to DB the database is interrupted.

If Click Next, if the health check verification is successful for all the projects, click Next.If

Perform the following steps, if the verification fails for a project, perform the following steps:

...

any project due to incorrect or missing project artifacts.

  1. Click Download Report to view the verification status of each test case, tasks, and custom action VB files along with their IDs. Also, you can view the reason for a test case or task verification failure.

  2. Click Corrective Actions to know the problems of each test case and tasks for which verifications failed.
    You can update the test case and tasks manually by opening through the Project directory. Also, if you see some artifacts that do not have much impact, you can delete them.

  3. Click download the Migration Health Check report.

  4. In the Migration Health Check report, click Test Cases and Tasks sections to know the test cases and tasks that are incorrect.

    1. To resolve the validation issues, fix the incorrect test cases and tasks manually.

    2. In the QFD Migration utility, click Corrective Actions to delete incorrect test cases and tasks if you are unable to resolve them.
      Note: Unless the incorrect test case or tasks are resolved or deleted, you cannot migrate the project.

  1. In the Migration Health Check report, click the Custom Action section to view the missing and duplicate custom actions.
    Do the following in the order listed;

    1. Remove the duplicate custom actions.

    2. For the missing custom actions, find and add them to the Project Path.

    3. On the QFD Migration Utility, click Custom Actions to work around the

    custom actions for which verifications failed, and then click

    1. missing actions if you are unable to resolve them.

    2. Click Create Script to

    add dummy VB files for the missing VB files

    1. create dummy custom actions with empty methods for each missing custom action.

  2. After updating the project artifacts, click Retry to re-verify the project artifacts.

Info

You can migrate only those projects which were successfully verified.
If no project is verified successfully, a message is displayed, which shows that the migration process cannot proceed.

  1. Click Next to start the Project Migration processperform the health check on the projects again.

  2. Do one of the following:

    1. If the health check verification fails for a project, then download the Health Check report to resolve the issues as explained in the steps above.

    2. If the health check verification is successful for all the projects, click Next to start the project migration.

Info

If you click Next, you go ahead only with those projects that were successfully verified.

...

Step 86: TheOnthe Qualitia 8.0 Database Details screen opens to configure the database details.

...

, enter the following

...

details,and click Next.

  • Type: Select the database type for QAS v8.0.x, MySQL or SQL Server.

  • Server: Port: Specify the QAS v8.0.x database server address along with its Port Id. The default Port Id for MySQL is 3306 and for SQL Server is 1433.

  • Database Name: Specify the Master Database name of QAS v8.0.x.

  • Authentication: 

...

  • If you have selected SQL Server database, select this option to authenticate to the SQL Server using Windows credentials.

...

  • User Name: Specify the username to connect with the QAS v8.0.x database.

  • Password: Specify the password for authentication.

  • Project Path: Specify the folder where

...

  • Qualtia 8.0 saves the project artifacts (test cases, tasks, and custom actions)

...

  • .

...

  •  

    Image Modified

Step 97: The On the Generating Database Scripts for Migration screen opens to generate , the the progress of generation of database scripts that are required for migration is displayed. Also, if If you have selected opted to take back up the database backup, it takes the in step 2, then a backup of the selected projects present is created in the QFD database.

After project backup completes, click Next.
A The following confirmation message displays, which indicates that if you cannot revert and interrupt the migration process, the migrated project in Qualitia Automation Studio is unusable. Do one of the following:appears:

The process cannot be reverted and should not be interrupted, interrupting the process leaves the project in the unusable state.

Click Yes to start the

...

project migration, or click No if you want to migrate the project later

...

.

...

Step 98: The On the Updating Database to Qualitia 8.0 screen opens and shows that Utility is applying , the progress of updating the new XML schema in to the Qualitia Automation Studio database is displayed.

After project restore the database updation completes, click Next.

...

Step 109: The On the Finalizing Migration screen opens to shows , the project migration progress is displayed.

After project migration completes, click Next.

...

Step 1110: The On the Project Migration Summary screen opens, the confirmation message displays that project migration is completed.

For every project, if all test cases and tasks are migrated successfully, it shows as “All tasks are Migrated Successfully” and “ All test cases are migrated successfully”Migrated Successfully”.

Click Finish to exit the project migration utilityProject Migration Utility.

Post Migration

...

Steps

  • While the project migration, if you have skipped any missing artifact, you need to recreate them in Qualitia Automation Studio 8.0.0x.

  • While the project migration, if you have added a dummy custom action VBS file, you need to do the required coding in the migrated VBS filedevelop the custom action.

  • You need to recreate the offline suites using the offline package. For more information, refer to Offline Package

...