On this page:

Installation Instructions

See the Installing Confluence EAR-WAR on Websphere page for step-by-step instructions.

Version Requirements

Visit the List Of Supported Application Servers.

Classloader settings

Confluence 2.10.x (all versions)

Confluence 2.10 uses the new Plugins 2 framework. The default classloader settings for WebSphere interferes with Plugins 2 dependencies.

The solution is to ensure your WebSphere application is configured with the following settings:

  1. Application classloader policy to SINGLE
  2. Application classloader mode to child-first

Please refer to Running on WebSphere 6.1 for more details.

Additional note for Confluence 2.10.1, 2.10.2, and 2.10.3

There is a known issue involving a jar file with 2.10.1, 2.10.2, and 2.10.3 that requires an additional step. Download the package-scanner-0.7.jar file, delete the package-scanner-0.7.2.jar from the WEB-INF/lib directory, and place the 0.7 version in its place.

Then set the 'Application Server' classloader to allow access to internal server classes, and a Classloader policy of 'Multiple'

Issue for the fix is CONF-15040

Configuring Encoding

I am having trouble with the £ and € characters

Confluence allows you to specify which character encoding should be used for its requests. To use the £ and € characters, you will need to use the "UTF-8" option. However, in some cases, WebSphere will encode the characters using ISO-8859-1 before they get to Confluence. If you have set the Confluence character encoding to "UTF-8" and are having problems, have a look at http://www-306.ibm.com/software/globalization/j2ee/encoding.jsp for an explaination of WebSphere and Character encoding. In particular, the -Dclient.encoding.override=UTF-8 system property allows you to override WebSpheres defaults.

Known Issues

Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 2.5 Australia License.