In this guide, we will run you through the steps to migrate your data from TestRail to QTM4J. This documentation enlists all the information on migration process like what can be migrated, and what are the assets/data that may not be migrated, features of the migration utility along with System Requirements and Pre-requisites to be taken care before proceeding with migration.
...
- JDK 1.8.0 needs to be installed.
- MySQL services and MYSQL workbench 5.7 or above needs to be installed.
- Operating Systems: Windows 10, Linux - Cent OS 7, RHEL
- CPU: 8 Cores, RAM: 16 GB
- TestRail Professional cloud version 7.5.6, TestRail Professional server version 7.5.3.1000 (Utility is tested on)
- Get your Migration Tool (migrate2qtm.war) and its license (qmetry-license-version-1.0) from Professional Services team.
- Jira and TestRail should be running on your system with valid license.
- Set UTC Time Zone in Jira as all the dates from TestRail will be migrated in to QTM4J as per UTC time zone.
Pre-requisites
Install Certificate in JDK on the machine running the migration utility.
Follow the steps specified here : How to install certificate in JDK ?
- Remove/rename duplicate list values for system/custom fields in TestRail as QTM4J does not support creation of duplicate values.
- All the users using TestRail should be created in Jira before the migration process starts.
Create a Scrum software development template project in Jira. The purpose of template project is to create a project structure that will be used to migrate the actual TestRail project with data into QTM4J.
...
- Base URL: TestRail URL in the format: http://<IP Address/URL>
- Email : TestRail user's login email
- Password: TestRail user's login password
- Type: Choose TestRail instance type from dropdown: Server or Cloud Cloud
...
Step 2: Destination Login
...
- Base URL: Your Jira server URL.
- Email ID: Email id used for Jira login
- API token: Get the API token from: Atlassian Account settings > Security > Create and manage API token > Create API token
- QMetry API Key: Get the API from: QTM4J > Configuration > Others > Open API
...
- Jira template project: Select the Jira software scrum project template to be used to create the project structure. The template project should be empty.
- TestRail project: Select TestRail Project you would like to migrate into QTM4J.
- Project key and Project Lead can be given by selecting the '' If required, Add Project Lead....." checkbox.
Step 5: Entity Mapping
TestRail → QTM4J Entity Mapping:
Under this section, map your TestRail assets which need to be migrated into relevant QTM4J assets.
Step 6: Custom Fields
You can select system fields and user-defined fields that are part of your TestRail project that needs to be migrated to QTM4J.
...