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
• 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
  • General advice for upgrading pre-2.5 releases to the latest release
  • Upgrading from Plone 1.0 to 2.0
  • Upgrading from Plone 2.0 to 2.1
  • Upgrading from Plone 2.1 to 2.5
  • Upgrading Plone 2.5 to 3.0
  • Upgrading from 3.x to 3.2
  • Upgrading from 3.2 to 3.3.x
• 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