![]() | 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 documentation is part of the Setting up Confluence with IIS documentation.
On this page:
Setting up Confluence with IIS 7
After you have installed IIS 7, you need to configure the Tomcat Connector. Then follow these steps:
- Open IIS 7 Manager
- Navigate to your host. In the picture below, your host would be the one highlighted in blue just below "Start Page".
- Double click on the
ISAPI and CGI Restrictions
icon - On the right hand panel, click on Add.... Click here for picture
- Point the path to your
isapi_redirect.dll
file and give it a description eg. tomcat. Give it an execute permission by clicking on theAllow extension path to execute
tick box. - Now, click on the
Default Website
and double clickISAPI Filter
. - On the right hand panel, click on Add... and point to your
isapi_redirect.dll
file, give the filter a name (eg. tomcat) - Navigate to your Default Website again.
- Right click on
Default Website
to create a virtual directory and name itjakarta
, point this to yourc:\ajp_iis
directory. - Click on the newly created virtual directory jakarta and double click
Handler Mappings
. - Click on
Edit Feature Permissions
and tick the execute permission.
- Add another virtual directory and name it
confluence
. Point the physical path toc:\confluence
. Set a context path in Confluence's xml configuration. For example, if you are using Confluence distribution you need to edit
<confluence install directory>/conf/server.xml
and edit your context path to this:<Context path="/confluence" docBase="../confluence" debug="0" reloadable="false">
The reason for creating this virtual directory is so that requests without the trailing slash still work. For example, if you are deploying Confluence under http://www.example.com/confluence/ without the virtual directory, then requests to http://www.example.com/confluence will fail.
- Finally, navigate to your host context again and do a restart. Confluence should now be accessible via http://localhost/confluence
Known Issues
64 bit IIS
If you are running a 64 bit OS, please use a 64 bit version of the Tomcat IIS connector.
Customer submitted solution:
If you must use a 32 bit IIS connector, you can do so by clicking Application Pools > Advanced Settings > Allow 32bit applications
.
Double Escaped Character
IIS 7 blocks double escaped character sequences by default. This will cause problems with Confluence pages with spaces. To fix this, please see http://support.microsoft.com/kb/942076.
Troubleshooting
The information in the Windows System Event Log can be useful for troubleshooting, followed by the c:\ajp_iis\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:\ajp_iis
directory - Your
conf/server.xml
file
RELATED TOPICS
- JIRA's documentation on Configuring IIS with Tomcat, including how to integrate both Confluence and JIRA in the same IIS server. The Troubleshooting section there is relevant to Confluence as well as JIRA.
- Connecting Confluence with IIS 5.1 or 6
- Supported Platforms
Take me back to Setting up Confluence with IIS
Attachments:





