Confluence Docs 3.0 : Connecting Confluence with IIS 5.1 or 6 This page last changed on Nov 04, 2009 by rhartono. This documentation is part of the Setting up Confluence with IIS documentation. On this page: Connecting Confluence with IIS Other Configuration IIS 6.0 Troubleshooting ## Connecting Confluence with IIS
| The configuration with IIS web-server is not supported by Atlassian support. The instructions below are for information only, and have been tested in this specific setup.
1. Using the IIS management console (Internet Information Services in Administrative Tools), add a new Virtual Directory to your IIS web site. The name of the `virtual directory` must be jakarta, as it must correspond with the first part of the extension_uri setting specified in the isapi_redirect.properties file. Its physical path should be the directory where you placed isapi_redirect.dll (in the example it is `C:\ajp_iis` ). When creating this new virtual directory, give it execute access as well.
Using the IIS management console, add isapi_redirect.dll as a filter to your IIS web site. To do this, right click on the Web Sites icon from the left hand pane of the Internet Services Manager (or IIS management console), select Properties and then the `ISAPI Filters` tab. The name of the filter should reflect its task, for example confluence, and its executable must be the full path to the ajp isapi redirector DLL, that is `c:\iis_ajp\isapi_redirect.dll` Restart IIS (stop and start the IIS service - not just the web server -- do this by right-clicking on 'Local Computer' in the IIS Manager and choosing All Tasks, Restart IIS...). Ensure that the confluence filter is marked with a green up arrow verifying that it is loaded and initialized correctly. If the ajp redirector did not initialize properly, check the log file for errors messages (`C:\ajp_iis\ajp_plugin.log`). You can now go to http://localhost and see the Confluence Dashboard. ## Other Configuration If you want to run Confluence on a named context, rather than the root context (i.e. access it via http://host/confluence/ instead of just http://host) you need to: Change the path attribute of the Context tag in server.xml from "" to "/confluence". Change the line `/*=ajp13w` in `uriworkermap.properties` to `/confluence/*=ajp13w`. Note that 'http://host/confluence' gives a 404 error, but 'http://host/confluence/' works. You need to create a virtual directory so that requests without the trailing slash still work. If you are using Confluence you would want to name the alias as confluence (if you are using JIRA, name it as jira). The physical directory can be anywhere and does not need to contain anything. ## IIS 6.0 If using IIS 6.0 you will also need to add the Jakarta Isapi Redirector to the Web Service Extension's . Right-click on Web Service Extensions and choose Add a new Web Service Extension... Enter tomcat for the Extension Name and then add the `isapi_redirect.dll` file to the required files. Check the Set extension status to Allowed and then click on OK. Also add the Jakarta Isapi Redirector to the ISAPI Filters for the website ## Troubleshooting If you have problems, look in the System Event Log, the c:\iis_ajp\ajp_plugin.log and your confluence logs. When requesting support for IIS configuration problems, please include: A zip of your logs directory A zip of your `c:\iis_ajp` directory Your `conf/server.xml` file A screen shot of the Virtual Directory tab of the Properties window for your 'jakarta' virtual directory. A screen shot of the ISAPI Filters tab of the Properties window of your 'Web Sites' icon. ##### RELATED TOPICS 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. Connecting Confluence with IIS 7 List Of Supported Application Servers Take me back to Setting up Confluence with IIS Attachments: iss_setup_4.png (image/png) access_permission.png (image/png) iss_setup_1.png (image/png) iss_setup_3.png (image/png)

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