Single Project Migration

Pre-Requisites

1. A project with previously existing project key must exist in JIRA.
2. JIRA project data are already imported into JIRA using single project restore.
   • All the JIRA issues and Releases must have been imported prior to migration.
   • Please ensure that no addition or deletion have been performed after the import. 
3. RMsis is already installed and synced with JIRA so that the project exists in RMsis.
   • Open RMsis and select the above mentioned project.
   • This will sync the project with JIRA and import JIRA issues and releases inside RMsis.
4. RMsis should not contain any pre-existing data before the data import.
   • Do not insert any data within this project before the migration.
5. Workflow of source and destination RMsis must be same.
   • This is necessary if advanced workflow is enabled in the source RMsis.
6. All the users of source instance must be mapped with new users in destination instance.
   • If the users are different in target instance, please map all the users to pre-existing users of target instance.
7. Data importer will create Global custom fields in target instance.
   • Please run the migration validator to ensure that same name custom fields have same data type.

Migration Validator

This is a java based utility which is used to validate the above mentioned Pre-Requisites. Please follow the steps mentioned below to perform the validation.

1. Download the migration validator and store it on the JIRA+RMsis server. (Please send a mail to support@optimizory.com to get the link to download the utility)

2. Bring up shell/command line and execute the utility using the command: java -jar migration-validator.jar

   • Please ensure that Java 1.8 is installed and PATH system variable is set so that you are able to execute java programs. 

   • See sample screenshot below.

     

3. You will be prompted to enter the path to <JIRA_HOME> directory.

   • Please contact your Jira Administrator to identify the location of Jira Home directory. 

   • Steps to locate Jira Home directory is available at: https://confluence.atlassian.com/jirakb/how-to-locate-jira-home-directory-313466063.html

   • Enter the absolute path of the JIRA_HOME folder.

   • See sample screen below.
     
4. You will be prompted to choose an option. Select option 1 to gather information from source database. 
5. You will be prompted to enter the project key of the project you want to backup/restore. Enter the project key of the project.
   
   • Here, FIR is the project key.
   • See sample screen below.
     
6. Above operation will create two files in the directory where migration-validator.jar is stored.
   • projectDetails.properties : This file consists of database settings which will be used to validate settings on target database.
   • usersMap.properties : This file consists of usernames of active users in RMsis. These users must be mapped to pre-existing users in target database.
7. It is possible that the target database has different set of users, if this is the case, please open the usersMap.properties file and map the users to existing users of target database.
8. Backup and restore JIRA project into target JIRA instance.
9. Copy the migration-validator.jar, projectDetails.properties and usersMap.properties to target JIRA+RMsis server and execute step 2 & 3.
10. You will be prompted to choose an option. Select option 2 to validate the target RMsis database before restoration.
11. The utility will validate the pre-requisites and report errors, if any.
12. Please take the corrective measures reported by the utility before performing the data restoration.