This page last changed on Dec 16, 2009 by ggaskell.

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:

  1. Open IIS 7 Manager
  2. Navigate to your host. In the picture below, your host would be the one highlighted in blue just below "Start Page".



  3. Double click on the ISAPI and CGI Restrictions icon
  4. On the right hand panel, click on Add.... Click here for picture
  5. Point the path to your isapi_redirect.dll file and give it a description eg. tomcat. Give it an execute permission by clicking on the Allow extension path to execute tick box.
  6. Now, click on the Default Website and double click ISAPI Filter.
  7. On the right hand panel, click on Add... and point to your isapi_redirect.dll file, give the filter a name (eg. tomcat)
  8. Navigate to your Default Website again.
  9. Right click on Default Website to create a virtual directory and name it jakarta, point this to your c:\ajp_iis directory.
  10. Click on the newly created virtual directory jakarta and double click Handler Mappings.
  11. Click on Edit Feature Permissions and tick the execute permission.



  12. Add another virtual directory and name it confluence. Point the physical path to c:\confluence.
  13. Set a context path in Confluence's xml configuration. For example, if you are using Confluence Standalone 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.

  14. 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:

  1. A zip of your logs directory
  2. A zip of your c:\ajp_iis directory
  3. Your conf/server.xml file
RELATED TOPICS

Take me back to Setting up Confluence with IIS


Document generated by Confluence on Sep 19, 2011 02:51