...
- 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)
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.
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.
- You will be prompted to choose an option. Select option 1 to gather information from source database.
- 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 inserted by the user.
- See sample screen below.
- 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 of target database.
- 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.
- Backup and restore JIRA project into target JIRA instance.
- Copy the migration-validator.jar, projectDetails.properties and usersMap.properties to target JIRA+RMsis server and execute .
- If the users in target database are different, open usersMap.properties in a text editor and map users to some existing users of the database.
- Details regarding user mapping is listed at the bottom of this page under the heading Mapping users of source and target database.
- Execute step 2 & 3. You will be prompted to choose an option. Select option 2 to validate the target RMsis database before restoration.
- The utility will validate the pre-requisites and report errors, if any.
- Please take the corrective measures reported by the utility before performing the data restoration.
- You can also contact support@optimizory.com for further assistance. If this is required, please send the RMsisDataValidator.log created by the utility along-with your request.
...