Websphere 6 Install Walkthrough

This page describes installing Confluence on a plain Websphere 6.0 installation.

Installation 

You need to start with a confluence.war file which has had the WEB-INF/classes/confluence-init.properties file modified to set confluence.home. 

Log on to the administration console, i.e. http://localhost:9060/ibm/console/secure/logon.do

Choose the 'Install New Application' link.

Specify a path to the confluence.war file on the local file system, and choose the context root which you want to deploy confluence at (this is the context you'll access Confluence on, i.e: http://yourserver/context_root). Click Next. (You just accept the default from here on)

On the 'Choose to generate default bindings and mappings' page, just click Next.

On the 'Application Security Warnings' page, just click Continue.

On 'Step 1', just click Next.

On 'Step 2' and 'Step 3', just click Next. On 'Step 4' click finish.

The installation will be performed. Click 'Save to Master Configuration', then click the Save button.

At this point you can make adjustments to the exploded version of Confluence which Websphere has put in  <WAS Install Dir>\AppServer\profiles\default\installedApps\<node id>\confluence_war.ear\confluence.war. You can edit confluence-init.properties or add JDBC drivers to WEB-INF/lib -- just remember that you'll need to do this again if you reinstall the application.

When that completes you'll be returned to the console. Click 'Enterprise Applications', check the 'confluence_war' checkbox and click the Start button.

Go to http://localhost:9080/confluence. You should get the setup page.

 You don't need to use 'parent last' classloading, the default 'parent_first' works, with the changes in the position of jar files mentioned below.

Known Problems

RSS Generation Fails 

The error:

com.atlassian.core.exception.InfrastructureException: java.lang.NoClassDefFoundError: com/sun/syndication/io/WireFeedOutput
 at com.atlassian.xwork.interceptors.XWorkTransactionInterceptor.intercept(XWorkTransactionInterceptor.java(Compiled Code))

caused by: java.lang.NoClassDefFoundError: com/sun/syndication/io/WireFeedOutput
 at com.atlassian.xwork.results.RssResult.doExecute(RssResult.java:41)

To correct this, copy the files 'jdom-1.0.jar' and 'dom4j-1.4-full.jar' from Confluence's WEB-INF/lib directory into your <appServerRoot>/lib directory (that is, the lib subdirectory of the directory named AppServer in the default Websphere install)

URLs with International Characters Don't Work

For example, a personal space for the user häns generates a URL which Websphere doesn't correctly interpret. We don't have a solution for this at the moment.

Error registering bean with name 'fileSystemAttachmentDataDao'

If you get that error message, it is because the path to a class file is longer than Windows can handle. You need to rename your war file to a shorter name.