Confluence 7.11 Upgrade Notes

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

On this page:

Upgrade notes 

Changes to the Page Index macro 

The Page Index macro can be quite memory hungry in large spaces. To prevent it causing out of memory errors in your site, the macro won't list any pages if there are more than 1000 in the space. This limit can be increased or decreased using the page.index.macro.max.pages system property. 

Access logs enabled by default

Access logging is now enabled by default from Confluence 7.11.  You can find the access logs in the <install-directory>/logs directory. The logs use the Tomcat Access Log Valve, and are retained for 30 days. To increase this, change the maxDays attribute in the <install-directory>/conf/server.xml file. 

You may need to allow some additional disk space to cater for the additional log files, particularly if you've got a big, busy site, and want to retain logs for more than 30 days. 

If you've previously enabled access logging using Tomcat valve, you'll find that our recommended log pattern has changed. Consider using our new format, which is easier to read and contains more information. 

pattern="%t %{X-AUSERNAME}o %I %h %r %s %Dms %b %{Referer}i %{User-Agent}i"

Changes to the application log files

Currently, most log entries are written to the application log file (atlassian-confluence.log), which can be difficult to parse, and can rotate too quickly when you're attempting to troubleshoot a problem. To help with this, some entries will now be written to the following separate log files, in the same directory. 

  • atlassian-confluence-index.log contains events related to the search index.
  • atlassian-confluence-outgoing-mail.log contains events related to outgoing mail, such as notifications.
  • atlassian-confluence-security.log contains events related to your users and user directories.

This should make troubleshooting problems significantly easier. If you send your logs to a third party tool for easier access and analysis, you may need to update your config to include these new files. 

You can check the exact classes or packages that are logged to each file in the log4j.properties file under LOGGING LOCATION AND APPENDER

You can also set these packages to additionally send log entries to the atlassian-confluence.log.

Changes to the allowlist

When you create an application link, the URL is automatically added to the Confluence allowlist. From Confluence 7.11, outbound requests from these URLs require users to be authenticated, unless you specifically allow anonymous users .

In addition, you can also set the default allowlist behaviour for all application links. Choose to allow all users (including anonymous), only authenticated users, or deny all outbound requests for all users. When a new application link is created, the URL will be added to the allowlist with your preferred setting already configured. 

If you experience any issues with features that rely on application links, such as gadgets, you can choose to allow anonymous requests for that application link. This is less secure, but may be a useful workaround until you can make any required changes to your linked application for authenticated requests. If you are in this situation, consider using an exact URL or wildcard rule to limit access to only the required path or resources. 

If you subscribe a third-party gadget, that doesn't require an application link, you will now need to add the gadget URL to the allowlist. 

Review data retention and rate limiting settings for analytics

If you have Confluence Data Center, we recommend you review the default analytics data retention settings to make sure they're appropriate for your site. Analytics data is stored in the database, and will grow as people use your site. To prevent database tables growing too large (which can increase your backup time, or result in reports taking a long time to load) we have put in place some limits, which you can change to suit the size and usage levels of your site.

  • Analytics data is retained in the database for 12 months, up to a maximum of 20 million records. Confluence will regularly delete any records that exceed this limit, starting with the oldest records. Records are deleted in batches of 10,000 so the total number of records retained may be less than the limit you set.
  • A maximum of 3 reports can be generated simultaneously. This means if four people attempt to load an analytics report at exactly the same time, the fourth will get a message to try again in a minute. As soon as a report loads, the next one can be generated. 
  • Generating a report will time out after 1000 seconds. 

Go to   > General Configuration > Confluence Analytics > Configuration to review, and change these limits if necessary.

Translations for Analytics

In Confluence 7.11, analytics screens will only be available in English. Translations in all our bundled languages will be available in Confluence 7.12.  Apologies for the delay.  

GoodSoftware Analytics for Confluence app

If you previously used the Good Software Analytics for Confluence app, that was acquired by Atlassian, and have a Confluence Data Center license, when you upgrade to Confluence 7.11, the app will be replaced by the bundled version.

We have changed the way you grant global permissions to view analytics to make it handle a large number of groups. If you have limited analytics to specific groups, you'll need to make a note of the groups before upgrading, as you'll need to manually re-select these groups in the permissions screen after upgrading. 

Show me how to do this...
  1. Before upgrading Confluence, go to  > General Configuration > Analytics for Confluence > Permissions
  2. Make a note of the groups that are selected.
  3. After upgrading Confluence, go to  > General Configuration > Confluence Analytics > Permissions
  4. Search for a group then select Add.
  5. Repeat this process for every group that should have access to analytics.

If you have a Confluence Server license, when you upgrade to Confluence 7.11, you'll be able to continue to access analytics until your Analytics for Confluence app license expires. After that time, if you want to continue to access analytics you'll need to migrate to Data Center. 

Upgrade will fail with Oracle 12c R1

This release contains changes that will cause your upgrade to fail with the following error when running on Oracle 12c Release 1. 

Configuring database failed
StatementCallback; bad SQL grammar [ALTER TABLE DENORMALISED_SPACE_CHANGE_LOG MODIFY (ID DEFAULT DENORMALISED_SPACE_CHANGE_LOG_SEQ.NEXTVAL)]; nested exception is java.sql.SQLSyntaxErrorException: ORA-00972: identifier is too long
Setting up database instance failed. You can either try it again or or go back to the database selection page

We ended support for Oracle 12c R1 in Confluence 7.4, so make sure you're running a supported version of Oracle before upgrading to Confluence 7.11. 

Upgrade will fail on some Microsoft SQL Server 2016 versions

This release contains changes that will cause your upgrade to fail with the following error when running on Microsoft SQL Server 2016 and earlier unsupported versions. 

Upgrade failed, application will not start: Upgrade task com.atlassian.confluence.upgrade.upgradetask.DenormalisedSpacePermissionsUpgradeTask@867e592
failed during the SCHEMA_UPGRADE phase due to: 
StatementCallback; bad SQL grammar [CREATE OR ALTER FUNCTION
dbo.space_function_for_denormalised_permissions()

This is due to the syntax only being supported in Microsoft SQL Server 2016 Service Pack 1 or later. If you're still running Microsoft SQL Server 2016, make sure you have Service Pack 1 or later before attempting to upgrade to Confluence 7.11. 

Upgrade may fail on MySQL 8

This release contains changes that may cause your upgrade to fail with the following error when running on MySQL 8. 

ERROR [Catalina-utility-1] [atlassian.confluence.plugin.PluginFrameworkContextListener] launchUpgrades Upgrade failed, application will not start: Upgrade task com.atlassian.confluence.upgrade.upgradetask.DenormalisedSpacePermissionsUpgradeTask@c8e620 failed during the SCHEMA_UPGRADE phase
...
You do not have the SUPER privilege and binary logging is enabled (you *might* want to use the less safe log_bin_trust_function_creators variable)

To resolve this problem, you will need to specify the following parameter in the [mysqld] section of your my.cnf  file.

log-bin-trust-function-creators = 1

See Install/Upgrade Confluence 7.11+ fails with error - You do not have the SUPER privilege and binary logging is enabled for more information. 

Page history is not renumbered when versions are deleted

There's a known issue in Confluence 7.11.0 and 7.11.1 where page history versions are not renumbered when a version is deleted. This change is related to an upcoming piece of work, and may cause problems if you have created your own scripts to interact with page history. See CONFSERVER-61228 - Getting issue details... STATUS for more information.

End of support announcements

Advance Notice: End of support for Microsoft Edge Legacy

In January 2020 Microsoft released a new Microsoft Edge browser based on Chromium. As Microsoft have announced plans to end support for Microsoft Edge Legacy, we have also decided to end support for Microsoft Edge Legacy.

Confluence 7.12.x will be the last release to support Microsoft Edge Legacy. 

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

Infrastructure changes 

Head to Preparing for Confluence 7.11 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  > General Configuration > Plan your upgrade and select the version you want to upgrade to. This will run the pre-upgrade checks.
  2. Go to  > 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 Jul 26, 2021

Was this helpful?

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