Confluence Post-Upgrade Checks
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.
Before You Begin
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 Upgrade Troubleshooting 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.
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 the different Internet browsers that you have in use in your environment. In addition, confirm that the layout appears as expected and that the menus are clickable and functioning.
2. Search
Try searching for content, for example pages, attachments or user names. Check that the expected results are returned.
3. Permissions
Confirm that you can visit a page that has view 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 The Atlassian Marketplace or check for compatibility in the Universal Plugin Manager.