Confluence 8.2 Upgrade Notes

Here are some important notes on upgrading to Confluence 8.2. For details of the new features and improvements in this release, see the Confluence 8.2 Release Notes.

Upgrade notes

Migration of attachment data

If you're upgrading from Confluence 8.0 or earlier, we'll migrate your attachment data to a new, robust folder structure on start up of Confluence. This change improves page move performance and stops images from breaking or “going missing” during failed page moves. It's also expected to restore any attachments that were previously "lost" or broken during failed page moves.

Confluence will operate normally while this migration task runs in the background. If you intend on migrating your attachments to S3 object storage, you must wait for this migration task to finish first.

Before you upgrade, review your backup solution as this change can lead to additional storage consumption. For example, if your backup tool reads the migrated attachments in the new v4 folder structure as new data, you will end up with duplicates.

Learn about the migration task and the new folder structure at Hierarchical File System Attachment Storage

Changes to blog display

To personalize the blogging experience, Confluence blogs will now reflect the user’s time zone instead of the browser or system default time zone. This change impacts the blog breadcrumbs, page tree and any newly created blog URLs:

  • Blog breadcrumbs will feature the year, month, and day of page creation based on the user's time zone.
  • Blogs will be grouped in the correct month and year in the page tree (sidebar) based on the user's time zone.
  • Newly-created blog posts will have stable URLs like /pages/viewpage.action?pageId=953065, instead of time-based URLs like display/SPACEKEY/2023/02/28

Users should check and set their time zones to take advantage of this change.

This change has been backported to Confluence 8.1.3+, and Confluence 7.19.7+.

Supported platform changes

No supported platform changes at this time.

End of support announcements

There are no advance announcements for end of support.

Infrastructure changes 

Head to Preparing for Confluence 8.2 to find out more about changes under the hood. 

Known issues

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

Upgrade procedure

Always test the upgrade in a test environment before upgrading in production.

To upgrade Confluence to the latest version:

  1. Go to Administration  > General Configuration > Plan your upgrade and select the version you want to upgrade to. This will run the pre-upgrade checks.
  2. Go to Administration  > General Configuration > Troubleshooting and support tools to check your license validity, application server, database setup, and more.
  3. If your version of Confluence is more than one version behind, read the release notes and upgrade guides  for all releases between your version and the latest version.
  4. Back up your installation directory, home directory, and database.
  5. Download the latest version of Confluence.
  6. Follow the instructions in the Upgrade Guide.

Update configuration files after upgrading

The contents of configuration files such as server.xml, web.xml , setenv.bat /, and change from time to time. 

When upgrading, we recommend manually reapplying any additions to these files (such as proxy configuration, datasource, JVM parameters) rather than simply overwriting the file with the file from your previous installation; otherwise you will miss out on any improvements we have made.

Last modified on Aug 11, 2023

Was this helpful?

Provide feedback about this article
Powered by Confluence and Scroll Viewport.