Confluence 3.0 Upgrade Notes
Below are some essential notes on upgrading to Confluence 3.0. For details of the new features and improvements in this release, please read the Confluence 3.0 Release Notes.
On this page:
Upgrade Notes
Anonymous Access to User Profiles
Confluence 3.0 introduces a new Anonymous Access Global Permission, View User Profiles, which prevents individuals who have not logged in to Confluence from viewing other users profiles. This permission, which is accessible from the Administration Console was introduced to protect the identity and security of Confluence user accounts and details associated with the Confluence 3.0 Community-based features.
In all new installations of Confluence 3.0, this permission is disabled for Anonymous users by default, such that an individual will not be able to view another user's profile details until they have logged in to Confluence.
Plugins
If you are having trouble with any screens in Confluence 3.0, which could be related to potentially incompatible or unsupported third-party plugins, try using the plugin safe mode to disable all unsupported plugins.
The Usage Tracking Plugin is disabled by default
Due to performance issues in high load environments, the Confluence Usage Tracking Plugin is disabled by default in Confluence 3.0. While upgrading to Confluence 3, the plugin will be turned off even if it was active before. We do still deliver the plugin as part of Confluence (and have even improved its performance since 2.10), so if you don't have a high load environment and are happy with the performance of the plugin, you can easily reactivate this plugin through the Administration Console.
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:
- Before you upgrade, we strongly recommend that you back up your Confluence Home and other important directories 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 2.10.x, read the release notes and upgrade guidesfor all releases between your version and the latest version. In particular:
- Please read the 2.10 upgrade notes.
- 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 again from version 2.7.x to the latest. For more details, please refer to CONF-11767.
- Download the latest version of Confluence.
- Follow the instructions in the Upgrade Guide.
- If you encounter a problem during the upgrade, please create a support ticket and one of our support engineers will assist you through the process.
Useful Plugins
Before installing an add-on (also called a plugin) into your Confluence site, please check the add-on's information page to see whether it is supported by Atlassian, by another vendor, or not at all. See our guidelines on add-on support.
- Unable to render {include} The included page could not be found.