This page last changed on Jan 04, 2011 by smaddox.

This article provides a list of items for Confluence Administrators to check after a Confluence upgrade to ensure that it has completed successfully. This list is not exhaustive, but it does cover common upgrade mistakes.

On this page:

Before You Begin

 

If you are upgrading to Confluence 2.10 or later, after you have completed an upgrade you should see the following message in the atlassian-confluence.log file:

2010-03-08 08:03:58,899 INFO [main] [atlassian.confluence.upgrade.AbstractUpgradeManager] upgradeFinished Upgrade completed successfully

If you do not see the line in your log similar to the one above, this means that your upgrade has not completed successfully. Please check our Troubleshooting Upgrades documentation to check for a suitable recommendation or fix. If there are no errors logged or if none of the errors are referenced in the the Troubleshooting Upgrades documentation, please contact Atlassian Support using the Support Utilities in your administration console.

Upgrade Checklist

 

Below is a recommended list of items to check after completing an upgrade.

1. Layout and Menu

Visit the Confluence dashboard and check that it is accessible and displays as expected. Test using the different internet browsers used by your users. In addition, confirm that the layout appears as expected and that the menus are clickable and functioning.

2. Search

Try searching for content, e.g. pages, attachments, user names, and check that the expected results are returned.

3. Permissions

Confirm that you can visit a page that has viewing restrictions, but you have permission to view. Confirm that you can edit a page that has edit restrictions but you have permission to edit. Make sure that the permissions of child pages are functioning as well. Involve as many space administrators as possible to confirm they are working. Confirm that anonymous or forbidden users cannot access or modify restricted pages.

4. Attachments

Confirm that attachments are accessible and searchable.

5. Plugins

Outdated third-party plugins can cause upgrade failure. Quite often, they will just be incompatible and simply do not work anymore. If you discover that your plugin is no longer working, please check for the latest version for your plugin in the Atlassian Plugin Exchange.

Universal Plugin Manager
If using Confluence 3.1 or later, you can use the Universal Plugin Manager to allow you check for plugin compatibility easily.
RELATED TOPICS

Troubleshooting Upgrades
Upgrading Confluence

Document generated by Confluence on Mar 16, 2011 18:38