Confluence 5.4 Upgrade Notes

Below are some important notes on upgrading to Confluence 5.4. For details of the new features and improvements in this release, please read the Confluence 5.4 Release Notes.

On this page:

Upgrade notes

Changes to thumbnail directory storage

Thumbnail directory storage layout has changed to allow many more thumbnails to be stored without running into the max-files-per-directory limit (see  CONF-20464 - Use similar directory hierarchy for thumbnails as for attachments Resolved ).  Following the upgrade to 5.4, new thumbnails will be generated as required by the application, and placed in the new directory structure. Pre-existing thumbnails from before the upgrade will be ignored, and not cleaned up. If disk space is a concern, then delete the CONF_HOME/thumbnails directory prior to the upgrade.

Changes to the page byline

We have made some changes to the Confluence byline and breadcrumb areas:

  • The Attachments and Page Restrictions icons are now located next to the page breadcrumbs. 
  • The View Change and Show Comment links have been removed - click the edited date on the byline to see the most recent change to the page, and any change comment that has been entered. 

JIRA and JIRA Agile versions required for new integration features

Some of the new features in this release require a specific version of JIRA or JIRA Agile:

Note: The JIRA Links button only appears in the default theme. It is not visible in the Documentation theme in Confluence. 

Some translations not available in 5.4

Translations for some new features and dialogs are not available in this release. We hope to make these translations available shortly after this release. 

Plugin compatibility notes

Gliffy 5.4.3 or earlier is not compatible with Confluence 5.4. Upgrade Gliffy to 5.4.4 or later. 

Changes to supported platforms

In this release we have added support for PostgreSQL 9.3.

End of support announcements

Advance notice: End of support for Internet Explorer 8  

To allow us to dedicate resources to providing the best experience on modern browsers, Confluence 5.5 (including minor releases) will be the last release that supports Internet Explorer 8 (IE8).

See End of Support Announcements for Confluence for more information.

Advance notice: End of support for PostgreSQL 8.3

This release (Confluence 5.4) will be the last release that supports PostgreSQL 8.3. See End of Support Announcements for Confluence for more information.

Upgrade procedure

Note: Upgrade to a test environment first. Test your upgrades in your test environment before rolling them into production.

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 and other important directories and database. See the documentation on backing up your Confluence site. If you are using an external database, perform a database backup.
  2. If your version of Confluence is earlier than 5.1, read the  release notes and upgrade guides for all releases between your version and the latest version.
  3. Download the latest version of Confluence.
  4. Follow the instructions in the Upgrade Guide.

Checking for known issues and troubleshooting the Confluence upgrade

After you have completed the steps required to upgrade your Confluence installation, check all the items on the Confluence post-upgrade checklist to ensure that everything works as expected. If something is not working correctly, please check for known Confluence issues and try troubleshooting your upgrade as described below:

  • Check for known issues. Sometimes we find out about a problem with the latest version of Confluence after we have released the software. In such cases we publish information about the known issues in the Confluence Knowledge Base.
  • Check for answers from the community. Other users may have encountered the same issue. You can check for answers from the community at Atlassian Answers.
  • Did you encounter a problem during the Confluence upgrade? Please refer to the guide to troubleshooting upgrades in the Confluence Knowledge Base.

  • If you encounter a problem during the upgrade and cannot solve it, please create a support ticket and one of our support engineers will help you.

Was this helpful?

Thanks for your feedback!

Why was this unhelpful?

Have a question about this article?

See questions about this article

Powered by Confluence and Scroll Viewport