Confluence 4.1 : Confluence 4.1 Upgrade Notes

Below are some important notes on upgrading to Confluence 4.1. For details of the new features and improvements in this release, please read the Confluence 4.1 Release Notes.

On this page:

Upgrade Notes

Confluence Clustered reactivated

Please be aware that Confluence Clustered is now available again, following a brief hiatus after the release of Confluence 4.0.

Personal labels removed

The ability to create Personal labels is being removed in 4.1. Existing labels can still be accessed via the User Profile > Favourites page, or if you go directly to the URL, in the following format:

 

CONFLUENCE-URL/users/viewmylabels.action

Where CONFLUENCE-URL is the URL for your Confluence instance.

For a more complete example, like this: https://confluence.atlassian.com/users/viewmylabels.action

Legacy Crowd SSO Authenticator removed

For customers with Crowd SSO authentication who ever used Confluence 3.4.9 or earlier: Customers who were using the com.atlassian.crowd.integration.seraph.v22.CrowdAuthenticator in their seraph-config.xml must replace this with com.atlassian.confluence.user.ConfluenceCrowdSSOAuthenticator. This has been the default Crowd SSO authenticator since Confluence 3.5, so users who installed from scratch with Confluence 3.5 or higher are not affected.

Upgrade Procedure

Upgrade a test environment first

As always, please test your upgrades in your test environment before rolling into production.

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

  1. Before you upgrade, we strongly recommend that you back up your Confluence Home Directory and database. See the documentation on backing up your Confluence site. If you are using an external database, perform a database backup.
  2. If your version of Confluence is earlier than 3.5.x, then you should  upgrade to Confluence 3.5.x before upgrading to Confluence 4.0. There are several reasons for this:
    • There were major changes to user management and LDAP in Confluence 3.5.
    • From version 3.5, you'll be able to use our new automated Installer / Upgrader to move to 4.0. The Confluence 4.0 Installer does not support upgrading from earlier versions of Confluence than 3.5.x.
    • We recommend that any issues arising from the upgrade to version 3.5.x be fixed separately to those that may arise from upgrading to version 4.0. Please contact Atlassian Support for assistance.
    • Please read the Upgrade Notes Overview  and the Upgrade Notes for each version of Confluence listed on that page. (There are hyperlinks to each one.)
    If you are upgrading from 2.1 or earlier, please read the 2.2 Release Notes.
    If you are upgrading from 2.2 or earlier, you will need to upgrade to Confluence 2.7.x first, confirm the upgrade was successful, then upgrade from version 2.7.x to version 3.5.x, before upgrading to the latest version. For more details, please refer to CONF-11767.
  3. Download the latest version of Confluence.
  4. Follow the instructions in the Upgrade Guide.

Checking for Other 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. Please check the known issues for the relevant release on this page of the Knowledge Base and follow the instructions to solve the problem.

  • 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 cannot solve it, please create a support ticket and one of our support engineers will help you.
RELATED TOPICS

Confluence 4.1 Release Notes