Configuring Tomcat

Edit the configuration/oslc-connect-jira.xml file and replace the placeholder values with your actual configuration:

Parameter Description
logback.configurationFile Path to the logback.xml logging configuration file (e.g., $CATALINA_BASE/conf/logback.xml)
oslc.broker.host Your Broker public URL (e.g., https://your-server:your-port/)
jira-cloud.host Your Jira Cloud site URL (e.g., https://company.atlassian.net/)
jira-cloud.oauth.client.id OAuth 2.0 Client ID generated during OAuth Integration App creation
jira-cloud.oauth.client.secret OAuth 2.0 Client Secret generated during OAuth Integration App creation
jakarta.persistence.jdbc.url JDBC URL for the PostgreSQL database (e.g., jdbc:postgresql://your_database_server:5432/broker)
jakarta.persistence.jdbc.user Database username
jakarta.persistence.jdbc.password Database password

Copy the configuration file to Tomcat: $CATALINA_BASE/conf/Catalina/localhost/oslc-connect-jira.xml

Configure Tomcat Environment

The broker requires a minimum of 512M of initial memory (Xms) and 2Gb of runtime memory (Xmx). These can be configured in the setenv.sh (Linux/macOS) or setenv.bat (Windows) files.

If $CATALINA_BASE/bin/setenv.sh (or setenv.bat) does not exist, copy it to $CATALINA_BASE/bin/

If the setenv file already exists: Merge the content from the provided file to your existing one.

Configure HTTPS

HTTPS is required for communication with Jira Cloud. See Tomcat documentation to configure HTTPS.

Your $CATALINA_BASE/conf/server.xml will somehow look like:

<Connector port="8443" protocol="org.apache.coyote.http11.Http11NioProtocol"
           maxThreads="150" SSLEnabled="true">
    <SSLHostConfig>
        <Certificate certificateKeystoreFile="conf/keystore.jks"
                     certificateKeystorePassword="your_password"
                     type="RSA" />
    </SSLHostConfig>
</Connector>