...
- 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.
- See sample screen below:
- 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.
- 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. See sample screen: <TODO>
- 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.
Mapping users of source and target database.
- The usersMap.properties can be used to map the users of two different instance if the users in both the instance are different.
- The usersMap.properties file will contain the list of active RMsis users of source instance.
- See sample screen:
- At present, it is assumed that the users in source and target database are same.
- If they are different, please map each user to some other user of target database.
- You will have to edit the above file and add the corresponding users against each entry.
- For example, if username of administrator in source database is admin and administrator in target database. You will have to replace the admin with administrator in right hand side.
- After the change, the entry 11-admin=admin will change to 11-admin=administrator
- Similarly, map other users to some other active/inactive users of target database.
- A special note for the entry defaultUser=admin. This will be used to map the inactive users of source database to the user provided username in target database.
- This entry must be updated to a valid user in target database. This user will be used as a fallback if no mapping is available for a user which exists in source but not in target.
- See screen of updated file:
...