Installing the Confluence EAR-WAR edition

Step 1 - Download and extract WAR

1. Download the Confluence WAR zip file
2. Extract the downloaded zip file:
   • Windows users must avoid Win XP's built-in unzip as it doesn't extract all the files. Use a 3rd party zip extractor like WinZip.
   • Solaris users will need to use GNU tar to handle the long filenames.
   • Tomcat users must not unzip their Confluence install to inside the Tomcat webapps folder as this may cause Confluence to be deployed more than once.
3. It will unzip your Confluence install directory, which should contain the version number e.g. confluence-2.2.9 or confluence-2.5.0. This directory will be later referred to as the Confluence install directory. Inside is a confluence subdirectory, referred to later as the Confluence WAR directory. Record the absolute path to the Confluence WAR directory.

Step 2 - Check for patches

Review the Release Notes for your Confluence version and apply any patches listed

Step 3 - Check for application server issues 

• Page:
  Known Issues for Apache Tomcat
• Page:
  Known Issues for Apache Tomcat
• Page:
  Known Issues for Apache Tomcat

Step 3 - Configure confluence-init.properties

1. Inside the Confluence install directory, edit ...confluence/WEB-INF/classes/confluence-init.properties in a text editor
2. Set the confluence.home property to a directory of your choosing. This is the directory that will contain all of Confluence's configuration, backup and attachment files.

Step 4 - Edit Tomcat context descriptors

If you using Tomcat 5.0.x or Tomcat 5.5.x:

1. Create a file called confluence.xml in your Tomcat installation's conf/Catalina/localhost directory (if you have set up a different hostname for your tomcat instance, please specify that instead of localhost)
2. Open confluence.xml and add these lines:

   <Context path="/confluence" docBase="c:/applications/confluence-2.1.3/confluence" debug="0" reloadable="false">
   <Logger className="org.apache.catalina.logger.FileLogger"
   prefix="atlassian-confluence." suffix=".log" timestamp="true"/>
   </Context>
   

   
   
3. For docBase specify the value you noted down earlier.

If you are using Tomcat 4.x

1. Open conf/server.xml in a text editor
2. Add the following:

   <Context path="/confluence" docBase="c:/applications/confluence-2.1.3/confluence" debug="0" reloadable="false">
   <Logger className="org.apache.catalina.logger.FileLogger"
   prefix="atlassian-confluence." suffix=".log" timestamp="true"/>
   </Context>
   

   
   
3. For docBase specify the value you noted down earlier.

Step 5 - Configure Your Application server

Review any documentation associated with your webserver here. If your application server requires deploying Confluence as a EAR/WAR, follow these instructions to build the WAR file:

Step 6 - Restart Server

1. Shut down, and then restart Tomcat
2. Confluence should now be accessible on http://host:port/confluence