Confluence 8.5 Upgrade Notes
Here are some important notes on upgrading to Confluence 8.5. For details of the new features and improvements in this release, see the Confluence 8.5 Release Notes.
Upgrade notes
Confluence Server and Data Center 8.5 is a Long Term Support release
This means we'll provide bug fix releases until 8.5 reaches end of life, to address critical security, stability, data integrity, and performance issues.
Ready to upgrade? Check out the Confluence 8.5 Long Term Support Release Change Log for an overview of the changes to be aware from Confluence 7.19 to Confluence 8.5 before making the move.
Supported platform changes
There are no platform changes in this version. See complete list of supported platforms
End of support announcements
There are no advance announcements for end of support.
For more information on these notices, see End of Support Announcements for Confluence.
Infrastructure changes
Head to Preparing for Confluence 8.5 to find out more about changes under the hood.
Known issues
There is a known issue where Confluence 7.19.14 and Confluence 8.5.1 fail to start up and run correctly when running on old Linux distributions that don’t have GLIBC_2.14 installed. To resolve this issue, upgrade to a supported Linux OS that has GLIBC_2.14 or newer bundled. See CONFSERVER-91652 to learn more about this issue
- There is a known issue where the Task Report macro returns a timeout or error state when faster permissions is enabled. As a temporary fix, we will not use faster permissions on this macro in Confluence 7.19.2 and later. Track this issue at CONFSERVER-79865
- There are a number of known issues when upgrading Confluence on specific database versions. See Confluence 7.11 upgrade notes if you are upgrading from Confluence 7.10 or earlier.
- If you use Apache to limit who can access the admin console, you should update your configuration. See Using Apache to limit access to the Confluence administration interface for our suggested configuration.
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:
- Go to Administration
> General Configuration > Plan your upgrade and select the version you want to upgrade to. This will run the pre-upgrade checks. - Go to Administration > General Configuration > Troubleshooting and support tools to check your license validity, application server, database setup and more.
- 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.
- Back up your installation directory, home directory and database.
- Download the latest version of Confluence.
- 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 / setenv.sh and confluence-init.properties 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.