Migrating RMsis from H2 to MySQL (RMsis 1.7.8)
Introduction
There have been some requests, where RMsis users entered some critical data in the embedded database during the evaluation period and at a later date wish to migrate to a production ready DataBase.
The process is not straightforward and we have worked out a solution, which is presented below.Â
However, specific installations may have some unique issues. If you face any such issue, please contact support@optimizory.com. Also see the notes at the end of this article.
This document is applicable only for migrating RMsis 1.7.8 data from H2 to MySQL. If you are using any other version of RMsis, please contact support@optimizory.com for the appropriate migration guide.
Supported Platforms
- Linux OS has been used in the procedure described below.
- For migration on MS Windows platform, please use windows versions of all the listed tools. One of our customers has migrated on Windows 7 Platform and shared the following additional points:
- When we installed SQuirrel SQL on our Windows 7 machine, some plugins where not correctly installed although they were selected for installation in the installer.
- Especially "Copy Table" did not show up in the context menu.
- After manually installing the plugins in the right place and restarting the tool the context menu was there.
Resources / Tools Required
- You must have JAVA installed on your machine.
- SQuirrel SQL (http://squirrel-sql.sourceforge.net/)
- VIM
- JDBC database drivers
- Blank RMsis database
- rmsis_178_r206_blank.sql for RMsis-1.7.8-r206
Perquisite
- Jira admin access
- MySQL root access
Procedure
- Installing SQuirrel SQL
- Download SQuirrel SQL from link given above
- Follow installation instructions given on http://www.squirrelsql.org/#installation
- Make sure, you enable all the plugins, specially H2 and MySQL database support
- Copy provided H2 and MySQL driver file in <SQuirrel Installation directory>/Contents/Resources/Java/lib directory
- Stop your JIRA instance
- Take RMsis database backup
- Go to <Jira Home>/rmsis/db/h2/1.7.8/rmsis.h2.db
- Copy this file and put in your <Work Folder>
- we will use this folder for most of our activities, so make sure it doesn't contain any other file
- creating a new folder is good idea
- Create two MySQL databases
- Only one will be used by RMsis, and you can drop other one later
- we will assume "rmsis_db_1" and "rmsis_db_2" as two database with user name "rmsis" and password "rmsis"
- You can choose different parameters, if you wish
- Start SQuirrel SQL (follow instructions given on installation page)
- Connecting to your H2 database file, placed in your work folder
- Go to Alias > New Alias
- Put rmsis-h2 as alias name
- From driver select "H2 Embedded"
- In URL replace <db-name> with path to <path to work folder>/rmsis
- User Name - "sa"
- Leave other password blank
- Click "Test" for testing your connection, if it fine, press save alias by clicking "OK".
7. Preparing H2 database for migration
- In alias section click on rmsis-h2 (connect to it)
- On left hand pane select rmsis-h2 > RMSIS > PUBLIC
- Go to SQL pane and write following queries, one per line
- ALTER TABLE PROJECT ALTER COLUMN VERSION RENAME TO VERSION_NEW;
- ALTER TABLE TEST_CASE ALTER COLUMN VERSION RENAME TO VERSION_NEW;
- ALTER TABLE REPORTING ALTER COLUMN DOMAIN RENAME TO DOMAIN_NEW;
- ALTER TABLE TEST_STEP ALTER COLUMN ACTION RENAME TO ACTION_NEW;
- Run queries (CTRL + ENTER)
- Now your H2 database is ready for migration
8. Connecting to MySQL database
- Go to Alias > New Alias
- Put rmsis-mysql as alias name
- Select "MySQL Driver" for driver
- In URL put jdbc:mysql://<hostname>:<port>/<dbname>
- replace <hostname> with MySQL host name, localhost if it is running on localhost,
- replace <port> with MySQL port, 3306 is default
- replace <dbname> with rmsis_db_1 (created in step 4)
- Put user name and password, that you can created in step 4
- Test connection and save it once it is done.
9. Copying database
- Go to Alias pane
- Connect to "rmsis-h2"
- Go to rmsis-h2 > RMSIS > PUBLIC > TABLE
- Right click on TABLE and select "Copy Table" from context menu
10. Pasting database
- Go to Alias pane
- Connect to "rmsis-mysql"
- Go to "rmsis-mysql > rmsis_db_1 > TABLE
- Right click on TABLE and select "Paste Table" from context menu
- it will take some time according to size of your database
- once it is done successfully, close SQuirrel SQL Client
11. Preparing MySQL database from step 10
- Open terminal and connect to rmsis_db_1 using MySQL
- mysql -u<username> -p<password> rmsis_db_1
- Run following queries
- ALTER TABLEÂ `PROJECT` CHANGEÂ `VERSION_NEW`Â `VERSION` INT( 11 ) NULL DEFAULT NULL;
- ALTER TABLEÂ `TEST_CASE` CHANGEÂ `VERSION_NEW`Â `VERSION` INT( 11 ) NULL DEFAULT NULL;
- ALTER TABLEÂ `REPORTING` CHANGEÂ `DOMAIN_NEW`Â `DOMAIN` VARCHAR( 255 ) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT NULL;
- ALTER TABLE `TEST_STEP` CHANGE `ACTION_NEW` `ACTION` LONGTEXTÂ CHARACTER SET utf8 COLLATE utf8_general_ci;
- Now close MySQL connection
- Go to your work folder (created in step 3), and dump your RMsis database MySQL file (rmsis_db_1)
- mysqldump -u<username> -p<password> --no-create-info --skip-add-drop-table rmsis_db_1 > rmsis_db_1.sql
- Open this SQL file in VIM
- Run command
- :%s/`\(\w\+\)`/\L&/g  (it is to change case of table and column name)
- Save and exit editor
- :wq
- Run command
- Open terminal and connect to rmsis_db_1 using MySQL
12. Loading blank RMsis database to second RMsis database (created in step 4, rmsis_db_2)
- Copy RMsis blank database (rmsis_178_r206_blank.sql) attached to work folder
- Run command
- mysql -u<username> -p<password> rmsis_db_2 < rmsis_178_r206_blank.sql
- replace <username>, <password> as required
13. Loading data to second MySQL database (using sql file created in step 11)
- Run command
- mysql -u<username> -p<password> rmsis_db_2 < rmsis_db_1.sql
- replace <username>, <password> as required
- Run command
14. You are almost ready now ...
15. Replacing database pointer in RMsis
- Start your Jira Server (switched off in step 2)
- Login using Administration
- Go to RMsis > RMsis Configuration (click on down arrow near RMsis tab for RMsis configuration)
- Open "Database Configuration" tab
- Change "Database Connection" to External
- Database Type, "MySQL"
- Hostname, your MySQL server host name (localhost if it runs local)
- Port, your MySQL server port (3306 is default for MySQL)
- Database, rmsis_db_2 (replace it, if you used different name for second database in step 4)
- Username, database username
- Password, database password
- Save configuration
16. It will take some time to start RMsis server again, once it is done press "Finish"
17. Go to RMsis, and test if everything is fine.
Have Issues ?
- If the process breaks down in between or if you have any issues, do not proceed and contact support@optimizory.com.
- looking at the complexity of migration, it may not be practical to exchange information on mails. At the minimum, we will need mechanism to view your screen, either through WebEx or Skype. Please ensure that this is possible, before contacting support.
Â