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 deprecated
The tab that displays personal labels in the user profile has been hidden in Confluence 4.1. We are planning to remove personal labels altogether from Confluence in a future release. The functionality for creating personal labels is still in Confluence, but we recommend that you stop using them. People can still see their existing personal labels by visiting the following URL:
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.
(i) These are probably rolled into 4.1:
* The *WebDAV Attachment Storage Location* has been removed,
* *Show Link Icons* general configuration setting has been removed,
* The *Enable Confluence Open Search* option,
* The *External User Management* Security Configuration setting has been removed,
* The JIRA Portlet Macro has been disabled or removed.
|
Reduced functionality for JIRA Portlets macro
Upgrade notes updated in March 2012: In Confluence 4.1, it is no longer possible to add a JIRA Portlet macro via the Confluence macro browser. It is still possible to add the macro using wiki markup or by copying an existing JIRA Portlet macro. The macro still displays information correctly.
Upgrade Procedure
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:
- 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.
- 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.1. 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.1. The Confluence 4.1 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.1. 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.
If your site contains links to a file system (for example [\\\C:\Foo\Bar\foobarpreso.ppt] these may break when upgrading to Confluence 4.1.x. We recommend that you upgrade directly to Confluence 5.0.3. Refer to 
for more details. - Download the latest version of Confluence.
- Follow the instructions in the Upgrade Guide.
Checking for Other Known Issues and Troubleshooting the Confluence Upgrade
- 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