Confluence 7.8 Upgrade Notes

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

On this page:

Upgrade notes 

Cannot upgrade to 7.8.0 directly if you use the H2 database

In this release we've upgraded the embedded H2 database, which is often used when evaluating Confluence. This is a significant upgrade which contains some breaking changes. 

If you attempt to upgrade a Confluence site running on the embedded H2 database, the upgrade will fail and your site will not be accessible until you roll back the upgrade. We recommend you check your database before upgrading, as rolling back can take considerable effort.  

Check whether you are using H2

To check whether you're using the embedded database go to Administration  > General Configuration > Troubleshooting and support tools and make sure the database health checks are passing.  If you are using the H2 database, the Embedded database check will fail. 

Alternatively you can go to Administration  > General Configuration > System Information and check the Database name row. 

Migrate your data to a supported database

If you are using H2 in production, you will need to migrate to a supported external database before upgrading to Confluence 7.8. 

See Migrating to Another Database for a step by step guide. 

Word and Excel conversion now handled by the external process pool


In Confluence Data Center, many memory and CPU intensive tasks are handled by the external process pool

From Confluence 7.8, the HTML conversion that's required to display a Word or Excel file using the Office Word and Office Excel macros (provided by the Office Connector) will be handled by the external process pool. 

End of support announcements

No end of support announcements at this time. 

Infrastructure changes 

Head to Preparing for Confluence 7.8 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 May 3, 2022

Was this helpful?

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