Plone Upgrade Guide

Description

Instructions and tips for upgrading to a newer Plone version.

This guide particularly focuses on Unix-like environments, though the stack discussion may be useful to everyone.

• Introduction
  • What does it mean to upgrade Plone?
  • A note about version numbering and terminology
• Preparations
  • Gather information
  • Back up your Plone site
  • Setup a test environment to rehearse the upgrade
• Upgrading Plone 4 within 4.x.x series dot minor releases
• Upgrade add-on products
• Troubleshooting
  • Check the log files
  • Test without customizations
  • Test without products
  • Test with a fresh Plone instance
  • Make the problem reproducible
  • Ask for help on a mailing list
  • Report a bug
• Version-specific migration procedures and tips
  • Upgrading Plone 4.2 to 4.3
  • Upgrading Plone 4.1 to 4.2
  • Upgrading from 4.0 to 4.1
  • Upgrading Plone 3.x to 4.0
• Upgrading Non-Buildout-based Plone Instances
  • Before you start upgrading anything, make sure you have a backup.
• General advice on updating from a non-buildout to buildout-based installation
  • A word on warnings