RMsis requires it's own independent database. This section contains instructions for setting up all the supported versions of Databases.
...
- Specify Database Connection : External
- Database Type : MS-SQL
- Hostname : <Hostname or the IP address of the database>
- Port : 1433 <TCP port number of the database server>
- Database : <RMsis_Database_Name>;instance=<Instance_name>
- Username : <Username to access the database>
- Password : <Password to access the database>
- The above settings can also be used when using named instances in SQL Server on dynamic port. Please make sure that SQL Server Browser Service is running if you are using dynamic port.
Securely connect RMsis to a SQL Server database (Connecting to SQL Server database using SSL)
- You can follow the steps mentioned below to securely connect RMsis to a SQL Server database :
- Switch to the database configuration page RMsis Menu > RMsis Configuration > Database Configuration
- Select MS-SQL (Microsoft Driver) from the drop down menu while selecting Database Type.
- Fill appropriate values for other fields in the database configuration page and click on TEST AND SAVE CONFIGURATION page.
- Once the configuration is saved, stop JIRA. This will stop RMsis as well.
Kill all processes related to JIRA / RMsis (they are typically named as Tomcat*, java).
This is important because sometimes stopping JIRA does not terminate all the processes.
Detailed description about killing RMsis is available at: https://docs.optimizory.com/x/iA_7
Locate <JIRA_HOME>/rmsis/conf/jdbc.properties file.
The contents of the file will be similar to:
db.name=rmsisDbName
jdbc.driverClassName=com.microsoft.sqlserver.jdbc.SQLServerDriver
jdbc.url=jdbc:sqlserver://10.0.1.15:1433;databaseName=${db.name};
jdbc.username=sa
jdbc.password=sa123
hibernate.dialect=org.hibernate.dialect.SQLServerDialect
jdbc.dataSourceClassName=com.microsoft.sqlserver.jdbc.SQLServerDataSource
Add the desired additional parameters to the jdbc.url. For example, in order to add HTTPS/ SSL, append encrypt=true;trustServerCertificate=true; to the existing URL.
The updated file will be
db.name=rmsisDbName
jdbc.driverClassName=com.microsoft.sqlserver.jdbc.SQLServerDriver
jdbc.url=jdbc:sqlserver://10.0.1.15:1433;databaseName=${db.name};encrypt=true;trustServerCertificate=true;
jdbc.username=sa
jdbc.password=sa123
hibernate.dialect=org.hibernate.dialect.SQLServerDialect
jdbc.dataSourceClassName=com.microsoft.sqlserver.jdbc.SQLServerDataSource
Save the contents of <JIRA_HOME>/rmsis/conf/jdbc.properties file.
- Restart JIRA. This will automatically start RMsis with the updated configuration.
Connecting RMsis to Oracle
...
Currently, RMsis supports Oracle 11G and later versions.
Database Setup using Oracle
- Ensure that you have a database instance available for RMsis (either create a new one or use an existing one).
- Within that database instance, create a user which RMsis will connect as (e.g. rmsisuser).
- create user <rmsisuser> identified by <user_password> default tablespace <tablespace_name> quota unlimited on <tablespace_name>;
- Notes :
- When you create a user in Oracle, Oracle will create a 'schema' automatically.
- When you create a user, the tablespace for the table objects must be specified.
- Ensure that the user has the following permissions:
- grant connect to <rmsisuser>;
- grant create table to <rmsisuser>;
- grant create sequence to <rmsisuser>;
- grant create trigger to <rmsisuser>;
Database Configuration for Oracle
Attribute | Value |
---|---|
Database Type | select "Oracle" |
Hostname | Enter hostname or the IP address of the database |
Port | TCP port number of the database server (by default 1521 for Oracle) |
Database | Enter the name of the database/SID to connect (The Oracle "System Identifier". The default value for most Oracle servers is 'ORCL'. If you are using the Oracle Express Edition, this will be 'XE'.) |
Username | Enter username to access the database |
Password | Password to access the database. |
...