Confluence 6.12 Upgrade Notes

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

Upgrade notes

Confluence 6 is a major upgrade

If you're upgrading from Confluence 5.x, be sure to read these upgrade notes thoroughly, take a full backup, and test your upgrade in a non-production environment before upgrading your production site.

Additional memory requirements for Data Center nodes

If you choose to allow Confluence to manage Synchrony for you, you'll need to allow an additional 2GB RAM for the Synchrony process, on every Confluence node. 

If you're upgrading from Confluence 6.9 or earlier, don't forget you'll also need to allow an additional 2GB for the external process pool, which handled document conversion and PDF exports. 

You can read more about the memory requirements in our Data Center Technical Overview

Changes to PDF export in Data Center

As mentioned in the release notes, PDF export is now handled by the external process pool in Data Center. You may find that spaces that previously exported slowly, but successfully, may fail now that we have implemented a timeout. Particularly if the spaces include pages with a large number of web images (that are not attached to a page). 

If you do experience timeouts, you can either increase the time limits using system properties, or choose not to handle PDF exports in external process pool. See  PDF export in Confluence Data Center for more details. 

Changes to editor icons

Icons in the editor got a smart new look in this release, and a few table icons have changed significantly. Here's a 'before and after' to help you out. 

Add and delete rows

Cut, copy, and paste a row

Add and remove columns

Cut, copy, and paste a column

Merge and split cells

Header row, header column, or numbered column

Delete the table

We've also improved many of the icons in the Insert menu, including adding a new item for inserting a date lozenge. 

Add-ons are now known as Apps

We've renamed "add-ons" to "apps" throughout Confluence, to match the terminology used on the Atlassian Marketplace. 

To view and modify system and Marketplace apps go to  > Manage apps

Supported platforms changes

  • Advance notice: end of support for PostgreSQL 9.3 
    Confluence 6.13.x will be the last release to support PostgreSQL 9.3. 

Update configuration files after upgrading

The contents of configuration files such as server.xml, web.xmlsetenv.batsetenv.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.

Check for Atlassian Companion MSI updates

The Atlassian Companion app manages the download and re-upload of files edited in Confluence. If you distribute the Companion app using the Microsoft Installer (MSI), the app won't automatically get the latest security updates and bug fixes. Check the Atlassian Companion app release notes to make sure you're running the latest version.

Upgrading from Confluence 5.x?

Collaborative editing is made possible by the magic of Synchrony. When you install Confluence Server, Synchrony will be configured to run as a separate process on your server.

If you're upgrading from Confluence 5.x, there are a few requirements you need to be aware of:

Collaborative editing requirements...
  • Memory and CPU: You may need to give your server more resources than for previous Confluence releases. When you install Confluence, Synchrony (which is required for collaborative editing), will be configured to run as a separate process on your server. The default maximum heap size for Synchrony is 1 GB (on top of Confluence's requirements). 
  • WebSockets: Collaborative editing works best with WebSockets. Your firewall / proxy should allow WebSocket connections. 
  • SSL termination: SSL should be terminated at your load balancer, proxy server, or gateway as Synchrony does not support direct HTTPS connections. 
  • Database drivers: You must use a supported database driver. Collaborative editing will fail with an error if you're using an unsupported or custom JDBC driver (or driverClassName in the case of a JNDI datasource connection). See Database JDBC Drivers for the list of drivers we support.
  • Database connection pool: your database must allow enough connections to support both Confluence and Synchrony (which defaults to a maximum pool size of 15). 

Infrastructure changes 

For developers

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

End of support announcements

No announcements. 

Known issues

Upgrade procedure

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

If you're already running a version of Confluence, please follow these instructions to upgrade to the latest version:

  1. Go to > Support Tools > Health Check to check your license validity, application server, database setup and more.
  2. Before you upgrade, we strongly recommend that you back up your installation directory, home directory and database.
  3. If your version of Confluence is earlier than 6.5, read the release notes and upgrade guides for all releases between your version and the latest version.
  4. Download the latest version of Confluence.
  5. 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 Community.
  • 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 can't solve it, please create a support ticket and one of our support engineers will help you.

Last modified on Dec 16, 2019

Was this helpful?

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