Deploying RMsis on JIRA Data Center

Deploying RMsis on JIRA Data Center

RMsis 3.x DC installation is essentially in two parts

• Install RMsis 3.x DC

  • RMsis plugin can be installed through JIRA Universal Plugin Manager.

• Configure RMsis 3.x DC

  • After installation of RMsis 3.x DC, RMsis tab will appear in Jira menu bar.

  • Login as administrator in JIRA and then click on RMsis menu to configure RMsis.

Please note that RMsis 3.x DC server will be deployed on the JIRA DC node from which you are performing the installation. However, it can be accessed from any node after the installation.

The entire sequence of the installation process is elaborated below:

Step 1: Install using JIRA Universal Plugin Manager

• Login as JIRA administrator on the node on which you want to install RMsis 3.x DC and select Settings > Manage apps

  • Search for “rmsis” inside the Find new apps section

  • Open

    

    Searching RMsis in UPM

  • Click on the Free Trial or Buy Now button to begin the installation of RMsis.

  • Click on Accept & Install button to proceed further.

  • Open

    

    Accept & Install RMsis

  • If you don't have access to the internet, you can use the below-mentioned option to download/upload RMsis

    • Download the desired version of RMsis 3.x DC from https://optimizory.com/rmsis-downloads.html and copy it to the server where Jira is installed.

    • Click on the Upload app and enter the URL when prompted.

  • Click on the Upload button.

• RMsis will be installed and you will get a prompt to generate a license. Click on Get license button

  • Open

    

    Get a License for RMsis

• You will be redirected to https://my.atlassian.com 

  • Generate the license at https://my.atlassian.com using your Atlassian account

• Update the license key for RMsis.

• Refresh/Reload the page once RMsis 3.x DC is installed successfully.

Step 2: Configure RMsis Home Page

• Click on the RMsis button which appears on JIRA Menu bar.

• Click on RMsis Home, you will be redirected to the installation welcome page, as shown below:

Open

• Once you choose an option to Begin Installation, you will be redirected to RMsis Home Settings page.

• In this step, RMsis will create RMsis Home directory to store backups, configurations (jdbc, mail etc.), logs etc.

• Take note of the information provided and click on next to move to the next step.

Open

Step 3 : Configure RMsis Database

• At present, RMsis DC 3.x supports MySQL, Postgres, MSSQL and Oracle databases

• Create a database in either MySQL / Postgres / MSSQL/ Oracle and specify database connection details, as shown below

Open

Step 3.2 : Test Database Configuration

• After filling the database details, you can check the database connection by clicking on TEST CONNECTION button.

• Clcik on TEST AND SAVE button to save the database details.

Step 4 : Configure Mail

• You can either disable OR configure your mail settings in this step.

Step 4.1 : Enter Mail Configuration

• The details are shown in the following screens

Open

Step 4.2 : Test Mail Configuration

Once the Mail Configuration is entered, user has an option to test

• Connection to Mail Server

• Send a Test Mail to ensure that the mail has been correctly configured

CLick on Test AND SAVE to save the mail configuration details.

Step 5 :Server Settings

• By default RMsis 3.x DC Server will be configured with http on port 3060 without any proxy settings. In order to deploy RMsis 3.x DC on JIRA DC, you will have to configure and enable Reverse Proxy.  

  • A detailed description for configuring RMsis 3.x DC with JIRA DC using reverse proxy is available here: Running RMsis on Reverse Proxy with JIRA Data Center

  • Please configure your reverse proxy and apply the changes before proceeding further.

• User has an option to specify the Minimum and Maximum memory used by the JVM. 256 MB and 512 MB are the minimum acceptable limits here.

Open

• Specify server scheme:

  • This should be similar to your JIRA setup.

  • If you are running JIRA on http, choose http for RMsis as well.

  • If you are running JIRA on https, choose https for RMsis and configure certificate details:

• To run RMsis Server on https, select the option https from "Specify RMsis Server scheme". 

• After selecting https, RMsis will ask for "Key Alias", "Keystore File" and "Keystore Password", where

• Configure reverse proxy for RMsis 3.x DC Server by checking the Enable Reverse Proxy Settings.

• RMsis will ask for "Proxy Scheme", "Proxy Host Name" and "Proxy Port", where

  • Proxy Scheme: The scheme on which the proxy server is running, can be either http or https.

  • Proxy Host Name: The host name or IP address of the proxy server. 

  • Proxy Port: The port number, on which the proxy server is running.

• Click on Save button.