Confluence 3.0.1 is a recommended upgrade which fixes some security flaws as well as other bugs. You'll find details of the fixes in the release notes.

On this page:

Upgrade Notes

Confluence 3.0.1 is the first Confluence version to be released in two editions 'standard' and 'clustered'.

Also, from September 2009:

• Standard editions will be released for each previous major version of Confluence back to 2.6. These will be:
  
  
  • Available as Confluence versions 2.10.4, 2.9.3, 2.8.3, 2.7.4 and 2.6.3.
  • Available to customers with non-clustered Confluence licenses.
    
    
• The remaining previous versions of Confluence currently available from our download page (from 2.6 to 3.0 inclusively), will be re-released as clustered editions and will only be available to customers with Confluence clustered licenses.
  
  
• The installation files for all versions of Confluence prior to 2.6 (which are no longer supported) will be removed from the Atlassian web site and will no longer be available for download and installation.

Confluence Caching Layer Changes

Due to the caching layer changes in the 'standard editions' of Confluence, you will need to reapply any cache customisations made to your cache sizes and/or cache configuration file, if all three of the following points are applicable:

• You have implemented cache customisations to your Confluence installation's cache sizes (either via the Administration Console or cache configuration file).
  
  
• You have an existing installation of Confluence 3.0 or earlier (excluding the 'standard edition' versions) and will be upgrading to Confluence 3.0.1 or later (or one of the earlier standard editions).
  
  
• Your Confluence installation is using a non-clustered Confluence license.

If you customised your Confluence instance's cache settings via the Administration Console, please refer to the Reapplying Cache Size Modifications via the Administration Console section below.

If you customised your Confluence instance's cache settings by modifying the cache configuration file, please refer to the Reapplying Cache Configuration File Modifications section below.

Reapplying Cache Size Modifications via the Administration Console

To reapply your cache size modifications via the administration console:

1. Before you upgrade, use the procedure described on the Cache Statistics page to open the 'Cache Statistics' section of the Administration Console in the 'Advanced' view.
   
   
2. Print out this view or save a copy of the web page for later reference. (This contains your existing individual cache settings.)
   
   
3. After upgrading Confluence, view the 'Cache Statistics' section of your upgraded Confluence installation in the 'Advanced' view.
   
   
4. Use the same procedure describe on the Cache Statistics page to re-adjust the size of each cache based on the previous settings that you had printed out (or saved).

Reapplying Cache Configuration File Modifications

Upgrade Procedure

If you are already running a version of Confluence, please follow these instructions to upgrade to the latest version:

1. Before you upgrade, we strongly recommend that you back up your confluence.home directory and database.
   
   
2. If your version of Confluence is earlier than 3.0.1, read the release notes and upgrade guides for all releases between your version and the latest version. In particular:
   • Please read the 3.0.1 release notes.
   • If you are upgrading from 2.1 or earlier, please also read the 2.2 release notes.
     
     
3. Download the latest version of Confluence.
   
   
4. Follow the instructions in the Upgrade Guide.