Installing JIRA server

Perform the following steps to install the JIRA server on your machine configuration.

Procedure

  1. Follow the below links and install the JIRA server based on your machine configuration.
  2. Once the JIRA server is installed, JIRA must be accessible from a URL in the format http://<YOUR_JIRA_SERVER_IP>:<port>. For example, http://172.20.176.17:9080.
  3. Using the Administrator login, you can add the users and invite your team members. To create a new user, go to Setting > User Management > Create New User.
    Note: Create the user with the role as necessary. You can perform the steps without an SMTP server.

SSL certificate insertion in JIRA

JIRA runs on HTTP protocol and Maximo IT runs on HTTPS protocol. When the two are integrated, certificate error is produced when we try to call Maximo IT from JIRA because of the security protocol difference. The error records itself in the Audit logs in Automation rules on JIRA. SSL certificate configuration must be done to ensure that JIRA recognizes the SSL certificate from Maximo IT without producing any error.

Follow the steps below to first fetch the SSL certificate from Maximo IT and then add it to JIRA for successful integration dialog.

Fetching Maximo IT certificate

  1. Log in to Maximo IT using Chrome web browser.
  2. In the browser's address bar, click on the Not secure in the beginning of the address.
  3. Click on Certificate is not valid.
  4. Open the Details tab.
  5. Click Export.
  6. Save the certificate on the required location.

Configuring certificate in JIRA

The Maximo IT certificate fetched in the previous section must be inserted at a particular path where JIRA is installed and then a command should be run to invoke that certificate in JIRA. For example, if you have JIRA installed on Linux, then follow the procedure below in a Linux console:

  1. Insert SSL certificate at JIRA location: /etc/ssl/certs/java
  2. Go to path: /usr/bin.
  3. Run this command: keytool -import -alias aliasname -keystore /etc/ssl/certs/java/cacerts -file /etc/ssl/certs/java/certificate.

    For example, if manage.inst1.apps.ocsnodev.miticdlab.com is the Maximo IT certificate, then the command to be run will look like:

    keytool -import -alias ocsnodev -keystore /etc/ssl/certs/java/cacerts -file /etc/ssl/certs/java/manage.inst1.apps.ocsnodev.miticdlab.com

For example, if manage.inst1.apps.ocsnodev.miticdlab.com is the Maximo IT certificate, then the command to be run will look like:

keytool -import -alias ocsnodev -keystore /etc/ssl/certs/java/cacerts -file /etc/ssl/certs/java/manage.inst1.apps.ocsnodev.miticdlab.com