Installing Confluence EAR-WAR on Websphere

This documentation provides a guide to install Confluence on Websphere 6.1 with basic settings and an external database.

On this page:

After installing Websphere, follow the instructions below.

Step 1. Configuring the Confluence War File

1. Download the Confluence EAR/WAR zip file. (You need to click the 'Show all' link to see the EAR/WAR zip file.)
2. Check your unzip program before extracting the downloaded zip file. Some archive-extract programs cause errors when unzipping the Confluence zip file:
   • Windows users must avoid the Windows built-in unzip utility, as it doesn't extract all the files. Use a third-party unzip program like 7Zip or Winzip.
   • Solaris users will need to use GNU tar to handle the long file names.
3. Extract the downloaded zip file.
4. You have now unzipped your Confluence installation directory, which should contain the version number e.g. confluence-2.10.0 or confluence-2.10.2. This directory will be later referred to as the Confluence installation directory. Inside is a confluence subdirectory, referred to later as the (Exploded) Confluence WAR directory. Record the absolute path to the Confluence WAR directory.
5. Modify its confluence-init.properties and set Confluence Home.
   1. Inside the Confluence installation directory, edit ...confluence/WEB-INF/classes/confluence-init.properties in a text editor.
   2. Now define your Confluence Home directory, by setting the confluence.home property to a directory of your choosing.
      We suggest using different paths for your installation and home directories. This will facilitate upgrades. This is the directory that will contain all of Confluence's configuration, backup and attachment files.
      Tip: Another term for 'Home directory' would be 'data directory'.
6. For Confluence versions 2.10.1, 2.10.2 and 2.10.3, delete the package-scanner-0.7.2.jar from the WEB-INF/lib directory, and place package-scanner-0.7.jar in its place. See Known Issues for Websphere.
7. Add your database driver jar file to the WEB-INF/lib directory. If your driver already exists in the main classpath and is used for other applications, you can skip this step. Check the Database Installation Instructions. If you're not already committed, we recommend Postgres.

   The built-in evaluation database may not work on a Websphere deployment.

8. Build the war file.
   Windows

   1. Open the command line prompt
   2. Navigate to the Confluence installation directory
   3. コマンド build war を実行します。
   Linux

   1. Open a terminal window
   2. Navigate to the Confluence installation directory
   3. Add executable mode to build.sh — chmod +x build.sh
   4. build.sh を実行します。
   5. The WAR file is now located in the dist subfolder in your Confluence installation directory

Step 2. Install Confluence in Websphere

1. Start Websphere Admin Server.
2. Access Websphere Admin console: https://localhost:9043/ibm/console
3. On the left hand panel, click Servers > Application Servers.
4. Select your server.  
5. Choose Allow for Access to internal server classes.
6. Choose Multiple for Classloader Policy.
7. On the left hand panel, click Applications > Enterprise Applications.
8. Import your war. Note your context path and choose all the defaults.
9. Once the war file is imported, select it, then choose Class loading and update detection.
10. Select Classes loaded with application class loader first and Single class loader for application.
11. Restart Websphere to make sure that all settings are picked up.

Step 3. Starting Confluence

1. Start your Websphere Server.
2. Go to Applications > Enterprise Applications and locate your installed Confluence.
3. Tick the box next to the Confluence war file and click Start.
4. Access Confluence at http://localhost:9080/contextPath (chosen above)

To access Confluence go to http://localhost:9080/contextPath

Step 4. Modifying Files in an Exploded War

It's a bit inconvenient to modify files - add patches or configure velocity or xml files - if you have to rebuild and redeploy the war file. Websphere requires deploying Confluence as a built .war archive originally. After that, however, you can drop files in the exploded war directory and restart the server to pick up changes (just the application isn't enough, given classloading issues). For the case of Velocity (vm or vmd) files or jsp files, you don't even need to reload the application - just refresh your page!

A typical exploded war directory might be found in a path similar to:

/usr/lib/IBM/WebSphere/AppServer/profiles/AppSrv03/installedApps/serverName-laptopNode01Cell/confluence-2_10_2_war.ear/confluence-2.10.2.war/

Keep in mind that this isn't a technique for deploying war files, but rather for modifications after deploy.

関連トピック

Known Issues for Websphere
Websphere JVM Tuning