Confluence Docs 3.0 : Setting up Confluence with IIS This page last changed on Jul 26, 2009 by ggaskell. This page describes how to install Confluence Standalone with IIS using the Apache jk connector.
| IIS is not a supported application server, 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 with IIS, please bear in mind that our expertise with IIS is limited and that 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 IIS 6 IIS 7 Step 2. Install Confluence Standalone Step 3. Configure Tomcat Step 4. Configure the Tomcat Connector Step 5. Connect Confluence with IIS ## 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. Start your `Server Manager`. Click 'Roles'. In the right hand panel, click "Add Roles". A new window will pop up. Select the 'Web Server (IIS)' option. Click 'Next' until you see another set of checkbox options to install the required 'Roles Services' for the web server (IIS). Scroll down to 'Application Development' and tick the following: CGI ISAPI Extensions ISAPI Filters Click 'Next'. 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. Download the isapi_redirect.dll from the apache tomcat download page - click 'browse download area' to search for the file. For example, you will find the win32 binaries here: http://apache.wildit.net.au/tomcat/tomcat-connectors/jk/binaries/win32/ and if the current version is 1.2.27, you will download this file: http://apache.wildit.net.au/tomcat/tomcat-connectors/jk/binaries/win32/jk-1.2.27/isapi_redirect-1.2.27.dll. Make sure you rename the file to `isapi_redirect.dll` before using it otherwise it will not work. 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) 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. Create workers.properties and uriworkermap.properties files. You can use the sample workers.properties file and the sample uriworkermap.properties file. 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: To connect Confluence with IIS 5.1 or 6 please refer to Connecting Confluence with IIS 5.1 or 6. For IIS 7 please refer to Connecting Confluence with IIS 7. ##### RELATED TOPICS Connecting Confluence with IIS 5.1 or 6 Connecting Confluence with IIS 7 JIRA's documentation on Configuring IIS with Tomcat, including how to integrate both Confluence and JIRA with the same IIS instance. The Troubleshooting section there is relevant to Confluence as well as JIRA. List Of Supported Application Servers Attachments: uriworkermap.properties (application/octet-stream) workers.properties (application/octet-stream) isapi_redirect.properties (application/octet-stream) add_roles_wizard.png (image/png)

Document generated by Confluence on Nov 05, 2009 23:34