Documentation for Confluence 4.1.x. Documentation for earlier versions of Confluence is available too.

Skip to end of metadata
Comment: Corrected links that should have been relative instead of absolute.
Go to start of metadata

The content on this page relates to platforms which are not supported for Confluence. Consequently, Atlassian can not guarantee providing any support for the steps described on this page. Please be aware that this material is provided for your information only and that you use it at your own risk.

This page describes how to install Confluence with IIS using the Apache jk connector.

(info) If you are using JIRA as well as Confluence, please refer to this page in the JIRA documentation instead.

On this page:

Step 1. Install IIS

If you are running Windows Server 2003, you will only be able to use IIS 5.1 or 6. If you are using Windows Server 2008, you might like to install IIS 7.

IIS 6

If you are using Windows Server 2003 or XP professional, follow these instructions for installing IIS 6.

After installation is complete you should be able to go to http://localhost/iishelp/iis/misc/default.asp in your browser and see the IIS Getting Started page.

IIS 7

Similar to the previous Windows versions, IIS is not installed by default in Windows Server 2008 so you need to install it manually.

  1. Start your Server Manager.
  2. Click 'Roles'.
  3. In the right hand panel, click "Add Roles".
  4. A new window will pop up. Select the 'Web Server (IIS)' option.
  5. Click 'Next' until you see another set of checkbox options to install the required 'Roles Services' for the web server (IIS).
  6. Scroll down to 'Application Development' and tick the following:
    • CGI
    • ISAPI Extensions
    • ISAPI Filters
  7. Click 'Next'.
  8. And lastly, click 'Install'.

To check that IIS has been installed successfully, you can direct your browser to http://localhost/ and see the IIS 7 logo.

You can learn more about IIS 7 from this website.

Step 2. Install Confluence

Do a normal Confluence installation, after which you should be able to use confluence as usual through the URL http://localhost:8090.

Step 3. Configure Tomcat

Add another connector to your server.xml file, directly after the existing <Connector ... /> tag:

Restart Confluence.
In the logs/catalina.YYYY-MM-DD.log file you should see the Jk is running:

Step 4. Configure the Tomcat Connector

These instructions are based on the Tomcat Connector, IIS Configuration documentation.

  1. Download the isapi_redirect.dll from the apache tomcat download page - click 'browse download area' to search for the file.
  2. Place the isapi_redirect.dll file in a directory c:\ajp_iis (the name of the directory isn't important, but if you use a different one make sure to take account of this in the instructions which follow)
  3. Create a isapi_redirect.properties file in the same directory as you put the DLL. You can use this sample isapi_redirect.properties file if you have used ajp_iisas the directory name.
    • Note that this sample properties file assumes that the dll is named isapi_redirect.dll. If you want to name your DLL something else, you must edit this file.
  4. Create workers.properties and uriworkermap.properties files. You can use the sample workers.properties file and the sample uriworkermap.properties file.
  5. Create an empty file named rewrites.properties in c:\ajp_iis.

Step 5. Connect Confluence with IIS

Connect Confluence with IIS, depending on your version of IIS:

RELATED TOPICS
Labels:
None
Edit Labels

12 Comments

Hide/Show Comments

  1. May 04, 2008

    Nicholas Muldoon [Atlassian]

    Dylan Beattie has posted of how he got Confluence up and running on IIS6 here:

    http://dylanbeattie.blogspot.com/2008/05/getting-started-with-confluence.html

    1. Feb 07, 2011

      Dylan Beattie

      Not quite. What I did was to get Confluence running alongside IIS on a single server - I was still using Tomcat to host the Confluence engine itself, but this configuration meant I could run IIS and ASP.NET websites on the same server as the Confluence wiki.

  2. Aug 21, 2008

    mohamed elwedany

    when i used the connector from iis to tomcat using the dll and instruction provided in http://confluence.atlassian.com/display/DOC/Setting+up+Confluence+with+IIS

    the iis is set on port 80 and the tomcat set on 8080

    i faced a problem that the pages in subfolders doesn't apear asexample  the http://localhost/loginconfluence/display/~admin

    and after debuging i found that the the url cann't be redirected to http://localhost:8080/loginconfluence/display/~admin

    so i added in the uriworkermap.properties

    # uriworkermap.properties - IIS

    /loginconfluence/*=ajp13w

    /loginconfluence//=ajp13w

    but still the connector reidirect the /loginconfluence/* and not the /loginconfluence/display/*

    so please tell me what is teh solution?

    mohamed

    1. Sep 03, 2008

      Tony Cheah Tong Nyee

      Hi Mohamed,

      To my understanding, in order for IIS to be able to resolve the remaining host path, the following configuration should take place in the uriworkermap.properties file:

      /iisconfluence/*=ajp13w

      However, the you may need to check and confirm if the worker.list value in the workers.properties file is correctly named and ensure that the correct worker is pointing to the correct application server.

      Cheers,
      Tony

  3. Feb 19, 2009

    Liam Jones

    Step 3 says to add:

    On 2.8.1 (the version we're currently running) the standard Confluence connector had a redirectPort of 8444 and the added AJP connector a redirectPort of 8443 (as stated above).

    However, with 2.10.2 (which I'm getting ready to test an upgrade to) the standard Confluence connector redirectPort has been changed to 8443. I assume I'm going to need to change one or the other in 2.10.2 so the redirectPorts are different?

    1. Dec 03, 2010

      Komathi Krishnan [Atlassian]

      Hi Liam,

      You do not need to worry about the "redirectPort" for both the standard Confluence connector and AJP connector for your 2.10.2, unless you are setting up a secured connection for Confluence.

      Hope that helps!

      Cheers,
      Komathi

      1. Feb 26, 2009

        Liam Jones

        Ah, okay. Thanks Komathi! (smile)

  4. May 28, 2010

    jason kim

    Hi, I have a question about step 3. Before I found this article, I set tomcat to run on port 80.  However, I'd like to use port 80 in IIS as well.  My question is, do I change the original connector port back to 8080 and another another identical connector with port 80 (in addition to 8080)?  Also, the IIS setup instruction refers to jakarta.  What is that in reference to setting up IIS?  Sorry, I am new to this and anything would be helpful.

     

    Jason

  5. Aug 09, 2010

    san

    Hi, do you see any problem in the long-run by running Confluence on IIS.  Like any customizations done to pre-IIS Confluence , future upgrades of Confluence ?

    Thanks,

    San.

  6. Apr 04, 2011

    Anonymous

    Has anyone tried to connect confluence with the new connector published on riaforge. It is supposed to connect IIS and Tomcat etc.

    http://tomcatiis.riaforge.org

  7. Aug 18, 2011

    Anonymous

    I have the redirector working but it is REALLY slow - around 10-15 second to display each page. Connecting to the tomcat server directly via :8080 is quick.

    Ideas?

  8. Nov 30, 2011

    Anonymous

    I have used the BonCode connector same as above (tomcatiis.riaforge.org). I ran several million hits as baseline test, and it was stable with good performance. 

    If you are using tomcat directly as webserver, you can probably turn off IIS.