Configuring Apache Reverse Proxy Using the AJP Protocol

Step 1: Configure JIRA's application server

Enable the AJP Connector on the Tomcat container hosting JIRA by uncommenting the following element in $JIRA_HOME/conf/server.xml:

<Connector port="8009" URIEncoding="UTF-8" enableLookups="false" redirectPort="8443" protocol="AJP/1.3" />

Step 2: Configure the Apache server

Using Apache 2.0.x

1. Apache 2.0.x users must install mod_jk and configure it by adding the following to httpd.conf or included files:

   LoadModule jk_module modules/mod_jk.so
   JkWorkersFile conf/workers.properties
   JkLogFile logs/mod_jk.log
   JkLogLevel info
   

2. Add the following lines inside the VirtualHost tag, presenting JIRA to the userbase:

   JkMount /jira jira_worker
   JkMount /jira/* jira_worker
   

3. Define the connections to the JIRA application in the conf/workers.properties file:

   worker.jira_worker.host=JIRA_HOST_NAME
   worker.jira_worker.port=AJP_CONNECTOR_PORT (usually 8009)
   worker.jira_worker.type=ajp13
   

Using Apache 2.2.x

Apache 2.2.x users can opt for native protocol support using mod_proxy_ajp.

1. Enable mod_proxy and mod_proxy_ajp submodule for protocol support in httpd.conf:

   LoadModule proxy_module modules/mod_proxy.so
   LoadModule proxy_ajp_module modules/mod_proxy_ajp.so
   

2. Add the following in the VirtuaHost presenting JIRA:

   ProxyRequests Off
   
   <Proxy *>
   Order deny,allow
   Allow from all
   </Proxy>
   
   ProxyPass / ajp://JIRA_HOST_NAME:AJP_CONNECTOR_PORT/
   ProxyPassReverse / ajp://JIRA_HOST_NAME:AJP_CONNECTOR_PORT/
   

See Also

• Integrating JIRA with Apache
• Integrating JIRA with Apache using SSL