Confluence 3.2 Upgrade Notes
Below are some important notes on upgrading to Confluence 3.2. For details of the new features and improvements in this release, please read the Confluence 3.2 release notes.
On this page:
Upgrade Notes
Clickr Theme and Left Navigation Theme are now Deprecated
Confluence 3.2 introduces two new themes, the Documentation theme and the Easy Reader theme. At the same time, we are announcing the deprecation of the following two themes:
Deprecated Theme | Description | Suggested Replacement |
|---|---|---|
Clickr theme | This theme was inspired by the Flickr user interface, with Confluence content centred on the page. Please note that some features of Confluence 3.x are not fully supported by this theme. | Easy Reader theme |
This theme provides a navigation bar on the left hand side of the screen. Please note that some features of Confluence 3.x are not fully supported by this theme. | Documentation theme |
We recommend that you move to a different theme as soon as possible. In the table above, we have suggested new themes that will give you similar and better-supported functionality.
Advance Notice --- Clickr Theme and Left Navigation Theme will not be bundled with Confluence 3.3
Please note, the Clickr Theme and Left Navigation Theme will not be bundled with Confluence 3.3. We will not support these themes from Confluence 3.3 onwards.
End of Support for JBoss, Firefox 2 and Safari 2
As previously announced, we are no longer providing support for:
- JBoss (all versions) from this release onwards.
- Firefox 2 and Safari 2 from this release onwards.
Please see End of Support Announcements for Confluence for further details.
Advance Notice of End of Support for Oracle Weblogic, IBM Websphere, Caucho Resin, DB2 8.2, Java Platform 5 (JDK/JRE 1.5) and Internet Explorer 6
As previously announced, we are planning on ending support for:
- Oracle Weblogic, IBM Websphere and Caucho Resin in Confluence 3.3.
- DB2 version 8.2 in Confluence 3.3. DB2 9.7 will still be supported.
- Java Platform 5 (JDK/JRE 1.5) in Confluence 3.3.
- Internet Explorer 6 in Confluence 3.3 or 13 July 2010, whichever is sooner.
Please see End of Support Announcements for Confluence for further details.
Link Browser will Remove Tooltips
In Confluence 3.2 and later, the link browser no longer offers the option to include a tooltip for your link. If you have existing links with tooltips, the tooltip will disappear if you edit the link with the link browser. The tooltip will remain if you edit the link using wiki markup. See issue CONF-18668.
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 3.1.x, then please read the Upgrade Notes Overviewand the Upgrade Notes for each version of Confluence listed on that page. (There are hyperlinks to each one.) Also:
- 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.
Troubleshooting the Upgrade
This section lists some specific issues that may occur during or as a result of the upgrade process, and guidelines on fixing the problem if it does happen to you.
- Left-hand navigation bar in Documentation theme is empty. If your existing Confluence installation already has the Documentation theme plugin installed, you may find that after upgrading to Confluence 3.2 the left-hand navigation bar is empty in the spaces that use the theme. The fix is to enable all modules of the Documentation theme plugin. See the knowledge base article.
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.
- 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 cannot solve it, please create a support ticket and one of our support engineers will help you.
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.