Documentation for Confluence 2.5.4 - 2.5.8.
Documentation for [Confluence Cloud] and the latest Confluence Server is available too. 
Confluence requires extra configuration to run in Resin 3.
As of Confluence 2.3 you can just need to update web.xml for Resin 3 with the shipped resin3 version of web.xml.
In older versions, follow the instructions below.
Whenever you use Confluence under Resin 3.0:
参考資料
Resin 2 Users
Confluence has always run without modification on Resin 2.1.11 and later. These instructions only apply to Resin 3.0
Resin and SOAP
If you want to use Confluence's SOAP interface under Resin, you will need to follow these instructions as well: Confluence and SOAP on Resin
Resin 3.0 does not correctly support the Servlet 2.3 specification. Confluence relies on this specification to function. The workaround is to modify Confluence's web.xml file so that it is conformant with the Servlet 2.4 specification. A big thankyou to Matthew Schmidt for supplying us with this workaround.
You can download one of the premodified web.xml files that are attached to this page. After downloading rename to web.xml and place in the $confluenceWebapp/WEB-INF/ directory, overwriting the existing web.xml in there. Don't forget to keep a backup!
Confluence Release |
ファイル |
|---|---|
2.1 |
|
2.1.2 |
|
2.1.4 |
|
2.2.1a |
|
2.2.4 |
Please only use the file with the exact version of Confluence you are using. An incorrect web.xml file can cause strange problems. You can follow the instructions below to patch any other version.
First, you will need to change the XML preamble for the web.xml file. Servlet 2.3 validates against a DTD, Servlet 2.4 validates against a schema. Also note that the <display-name> and <description> elements have reversed orders.
変更前:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN" "http://java.sun.com/dtd/web-app_2_3.dtd">
<web-app>
<display-name>Confluence</display-name>
<description>Confluence Web App</description>
変更後:
<?xml version="1.0" encoding="UTF-8"?>
<web-app id="ConfluenceWebApp" version="2.4" xmlns="http://java.sun.com/xml/ns/j2ee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">
<description>Confluence Web App</description>
<display-name>Confluence</display-name>
Move down web.xml until you find the definition of the login filter-mapping. You need to change the definitions of the login, security and sitemesh filters:
変更前:
<filter-mapping>
<filter-name>login</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
<filter-mapping>
<filter-name>security</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
<filter-mapping>
<filter-name>sitemesh</filter-name>
<url-pattern>*.action</url-pattern>
</filter-mapping>
<filter-mapping>
<filter-name>sitemesh</filter-name>
<url-pattern>*.vm</url-pattern>
</filter-mapping>
<filter-mapping>
<filter-name>sitemesh</filter-name>
<url-pattern>/display/*</url-pattern>
</filter-mapping>
変更後:
<filter-mapping>
<filter-name>login</filter-name>
<url-pattern>/*</url-pattern>
<dispatcher>REQUEST</dispatcher>
<dispatcher>FORWARD</dispatcher>
</filter-mapping>
<filter-mapping>
<filter-name>security</filter-name>
<url-pattern>/*</url-pattern>
<dispatcher>REQUEST</dispatcher>
<dispatcher>FORWARD</dispatcher>
</filter-mapping>
<filter-mapping>
<filter-name>sitemesh</filter-name>
<url-pattern>*.action</url-pattern>
<dispatcher>REQUEST</dispatcher>
<dispatcher>FORWARD</dispatcher>
</filter-mapping>
<filter-mapping>
<filter-name>sitemesh</filter-name>
<url-pattern>*.vm</url-pattern>
<dispatcher>REQUEST</dispatcher>
<dispatcher>FORWARD</dispatcher>
</filter-mapping>
<filter-mapping>
<filter-name>sitemesh</filter-name>
<url-pattern>/display/*</url-pattern>
<dispatcher>REQUEST</dispatcher>
<dispatcher>FORWARD</dispatcher>
</filter-mapping>
Confluence 2.0
In Confluence 2.0, you will need to add dispatcher tags to another of the sitemesh filter mappings:
<filter-mapping>
<filter-name>sitemesh</filter-name>
<url-pattern>/label/*</url-pattern>
<dispatcher>REQUEST</dispatcher>
<dispatcher>FORWARD</dispatcher>
</filter-mapping>
You will also need to find all the <display-name> servlet attributes and remove them as well. For example:
Before
<servlet>
<servlet-name>dwr-invoker</servlet-name>
<display-name>DWR Servlet</display-name>
<servlet-class>uk.ltd.getahead.dwr.DWRServlet</servlet-class>
After
<servlet>
<servlet-name>dwr-invoker</servlet-name>
<servlet-class>uk.ltd.getahead.dwr.DWRServlet</servlet-class>
This will need to be done for the dwr-invoker, labels-javascript, editpage-javascript, wysiwyg-javascript, labels and tinymce servlets.
Confluence 2.1
In addition to the Confluence 2.0 modifications you will also need to remove the Selenese servlet and mappings:
<servlet>
<servlet-name>SeleneseServletSpike</servlet-name>
<servlet-class>com.thoughtworks.selenium.outbedded.CommandBridge</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>SeleneseServletSpike</servlet-name>
<url-pattern>/selenium-driver/driver</url-pattern>
</servlet-mapping>
Otherwise you might get the following error when starting up resin:
com.caucho.config.LineConfigException: WEB-INF/web.xml:582: `com.thoughtworks.selenium.outbedded.CommandBridge' is not a known servlet. Servlets belong in the classpath, often in WEB-INF/classes.
Confluence 2.2
The removal of the <display-name/> element from the dwr-invoker, labels-javascript, editpage-javascript, wysiwyg-javascript, labels and tinymce servlets, as described in the Confluence 2.0 appendage, is no longer required.
Confluence should now run under Resin 3.0. Please report any other bugs as you find them.
Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 2.5 Australia License.