This page last changed on Mar 21, 2007 by ernest@atlassian.com.
This page describes how to install Confluence stand-alone with IIS using the Apache jk connector.
Install IIS
Follow these instructions for installing IIS
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.
Install Confluence Standalone
Do a normal Confluence install, after which you should be able to use confluence normally through the URL http://localhost:8080
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" />
Then start Confluence, in the logs/catalina.YYYY-MM-DD.log file you should see:
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 config=null
These instructions are based on the Tomcat Connector, IIS Configuration documentation.
- Download the isapi_redirect.dll from here: http://www.apache.org/dist/tomcat/tomcat-connectors/jk/binaries/win32/jk-1.2.21/isapi_redirect.dll and put it 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.
- 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
- Enable the plugin within IIS
1 |
Using the IIS management console (Internet Services Manager 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 registry. Its physical path should be the directory where you placed isapi_redirect.dll (in the example it is c:\iis_ajp). When creating this new virtual directory, give it execute access. |
2 |
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 |
3 |
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. acces 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
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.
|