The configuration of the catWorkX OTRS Integration for JIRA add-on is done via the otrsintegration.properties configuration file. This file has to be created manually in a directory named conf in the JIRA home directory.

If JIRA was installed using the automated Windows or Linux installers, the default location of the JIRA home directory is:

To identify your home directory from within JIRA:

  1. Go to Administration > System Info.
  2. Find "Location of JIRA Local Home" in the "File Paths" section.

Examples:

  • If your JIRA home directory on a Linux system is under /opt/jira_data/ the folder to place the otrsintegration.properties file is /opt/jira_data/conf/.
  • If your JIRA home directory on a Windows system is under C:\jira\home/ the folder to place the otrsintegration.properties file is C:\jira\home\conf\.

When the add-on is installed and no configuration file is found, there will be an error in the log file stating the exact path where the file is to be expected.

An example otrsintegration.properties configuration file is included in the .jar file inside the .obr file. The same example is also listed here: Configure otrsintegration.properties

In the otrsintegration.properties configuration file, you have to configure e.g., the URL of OTRS, the login information and the mapping of JIRA fields to OTRS fields.

After changing configurations in the otrsintegration.properties configuration file, the catWorkX OTRS Integration for JIRA add-on has to be disabled and than enabled again to reload the configuration file.