This documentation relates to the latest version of Confluence.
If you are using an earlier version, please go to the documentation home page and select the relevant version.

Setting up Confluence with IIS

All Versions

Confluence 3.0 Documentation

Index

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

IIS is not a supported platform, as we do not test releases against it. The instructions below are for information only, and are published with the intention of sharing the knowledge we've acquired.

If you encounter problems, please bear in mind that our expertise with IIS is limited - you should contact Microsoft for support.

If you are using JIRA as well as Confluence, please see this document 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 Standalone

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

Step 3. Configure Tomcat

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

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

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

INFO: Starting Coyote HTTP/1.1 on http-8080
7/09/2006 14:40:04 org.apache.jk.common.ChannelSocket init
INFO: JK: ajp13 listening on /0.0.0.0:8009
7/09/2006 14:40:04 org.apache.jk.server.JkMain start
INFO: Jk running ID=0 time=0/31&nbsp; config=null

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_iis as 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
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.

Comments (6)

 

  1. May 04, 2008

    Nick Muldoon [Atlassian] says:

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

    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

  2. Aug 21, 2008

    mohamed elwedany says:

    when i used the connector from iis to tomcat using the dll and instruction provi...

    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 says:

      Hi Mohamed, To my understanding, in order for IIS to be able to resolve the rem...

      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

    Liam Jones says:

    Step 3 says to add: <Connector port="8009" enableLookups="false" redirectPor...

    Step 3 says to add:

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

    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. Feb 26

      Komathi Krishnan [Atlassian] says:

      Hi Liam, You do not need to worry about the "redirectPort" for both the standar...

      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

        Liam Jones says:

        Ah, okay. Thanks Komathi!

        Ah, okay. Thanks Komathi!

Add Comment


Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 2.5 Australia License.