Confluence 7.18 Upgrade Notes

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

On this page:

Upgrade notes 

Upgrading to 7.18.1

Due to changes required for  CONFSERVER-78179 - Getting issue details... STATUS in Confluence 7.18.1, you won't be able to perform a rolling upgrade to this version. Downtime will be required. 

You must wait for node 1 to start completely after upgrading before you attempt to start the next node, or Confluence will fail to start with an 'Unexpected bytes from remote node' error. If this happens, restart your first node. 

It is always good practice to wait for a node to start up completely before starting the next node. 

New content API

We have added a new REST API endpoint, rest/content/scan. The new endpoint provides better performance than rest/content, and adds a cursor parameter which can be used for pagination. It can only be used to browse pages (not blogs), and doesn't support offset , title , or creationdate parameters.

See how you can use the API to browse Confluence content


Supported platform changes

End of support for PostgreSQL 10

As previously announced, PostgreSQL 10 is no longer supported.

End of support announcements

Advance Notice: End of support for Oracle 12c

Confluence 7.19.x will be the last release to support Oracle 12c.

Advance Notice: End of support for UTF8 encoding for MySQL

We will end support for UTF8 encoding for MySQL databases in Confluence 8.0. If you run Confluence with a MySQL database, you should use UTF8MB4 encoding.

Advance Notice: End of support for Java 8

We will end support for running Confluence with Java 8 in Confluence 8.0.

Advance Notice: Removal of Usage stats 

We will remove the Usage Stats feature in Confluence 8.0. 

For more information on these notices, see End of Support Announcements for Confluence

Infrastructure changes 

Head to Preparing for Confluence 7.18 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 / setenv.sh, and confluenceinit.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.

Last modified on Mar 31, 2023

Was this helpful?

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