Upgrading Existing RMsis

RMsis version upgrade is essentially in three steps

Save the base configuration and prepare for installation.
Install RMsis
1. RMsis plugin can be installed through JIRA Universal Plugin Manager.
Upgrade RMsis
1. Login as administrator in JIRA and then click on RMsis menu.
2. You will be automatically redirected to Upgrade RMsis screen.

The entire sequence of upgrade process is elaborated below for different base (existing) versions.

Preconditions for automatic upgrade

The RMsis version number should be either equal to or higher than the existing version.
The Build Number should be higher than the existing version.

In order to upgrade existing RMsis with new version, please follow the steps mentioned below:

Take backup of existing database.
- MySQL
```
$ mysqldump -uroot -ppassword rmsis_database_name > backup_file.sql
```
  Note : For Microsoft SQL server 2005/2008 please refer http://msdn.microsoft.com/en-us/library/ms187048.aspx

Login as JIRA administrator and select Add-ons > Manage add-ons
Get the URL for the desired version of RMsis from http://products.optimizory.com/rmsis/download
Click on Upload add-on and enter the URL when prompted.

After clicking on RMsis menu, the upgrade screen will appear.
click on UPGRADE to proceed. You will be redirected to RMsis deployment step.

In this step, RMsis plugin will install RMsis application with an embedded Tomcat Server.

Please wait for some time (It will take one to two minutes). After RMsis server startup, the screen will show :

In order to upgrade existing RMsis with new version, please follow the steps mentioned below:

Stop JIRA and Tomcat.
Undeploy your rm.war from Tomcat Server
Take backup of existing database.
- MySQL
```
$ mysqldump -uroot -ppassword rmsis_database_name > backup_file.sql
```
  Note : For Microsoft SQL server 2005/2008 please refer http://msdn.microsoft.com/en-us/library/ms187048.aspx
Save your rm.war and jira-rmsis-x.x.x.jar, just in case you need to revert back to the old setup.

Login as JIRA administrator and select Add-ons > Manage add-ons
Get the URL for the desired version of RMsis from http://products.optimizory.com/rmsis/download
Click on Upload add-on and enter the URL when prompted.

Please note
- For versions 1.2.1 and older, RMsis home directory can be configured at any arbitrary location,
- For versions 1.3.0 and later, RMsis will create home directory inside JIRA home directory.
- So, an upgrade will require migration of Old RMsis home directory to New RMsis home directory.
After clicking on RMsis Menu, following screen will appear.

Enter your old RMsis home directory path in the above screen and then click on UPDATE RMSIS HOME button.
After clicking, RMsis will configure RMsis home directory inside JIRA home directory with using previous RMsis database and mail configuration.
The following screen will appear:

Now, if you have taken the backup of RMsis, then click on UPGRADE to proceed.
You will be redirected to RMsis deployment step.

In this step, RMsis plugin will install RMsis application with an embedded Tomcat Server.

Please wait for some time (It will take one to two minutes). After RMsis server startup, the following screen will show up :

Congratulations !!! Now RMsis server is running successfully,
Click on FINISH button to complete upgrade process.
Please Note
- By default, RMsis server will run on port 3060.
- This will change the base url of RMsis and you will need to regenerate the license.
- You can also change the port number of RMsis server by clicking on RMsis Configuration under the RMsis tab in JIRA menu bar. This port number must be different from JIRA Server port number.
Subsequently, you will be automatically redirected to license page.

In the upgrade process, your system code for RMsis has changed.
So RMsis will show your previous license as invalid license and you will need to re-generate your license.
Your license re-generation would be activated by Optimizory. In case of any issues, please send a request to support@optimizory.com
On the following screen, click on Update License Key link to update the license.