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:

Setting up Confluence with IIS 7

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.

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 Nov 05, 2009 23:34