Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Info
titleAlways Upgrade QA First

It is recommended that you maintain separate QA (test) and Production instances. Upgrade your QA tier and confirm things are working as expected before upgrading Production.

Warning
titleUpgrading Multiple Versions

It is not always possible to upgrade multiple versions in one step. When this is not the case, if you attempt to skip a critical release you will see this message when trying to update the database schema:

Cannot automatically upgrade past version x.y.z. Please upgrade to that version first.

You must download and upgrade successfully to the specified version. This is the list of versions that block upgrading:

If you are currently runningYou must upgrade to this releaseBefore being able to upgrade to this release
v0.9.3 or earlierv0.9.4v1.0.0
v0.9.4v1.0.0Any later release

Backup Your Database

While upgrading is usually a fairly straightforward process, from time to time fairly significant database changes are made. Efforts are made to make these changes transparent, but as a precaution you should create a backup of your database prior to upgrading in case you need to revert the upgrade.

...

No Format
$ cd app
$ su -c "./Console/cake upgradeVersion" ${APACHE_USER}
[...]
Current version: 0.9.4
Target version: 1.0.0
[...]
Database schema update successful
Info
titleUpgrading Multiple Versions

It is not always possible to upgrade multiple versions in one step. For example, if you are currently running 0.9.3 you cannot directly upgrade to 1.0.0. If you try, you will see the error message

Cannot automatically upgrade past version 0.9.4. Please upgrade to that version first.

You must download and upgrade successfully to version 0.9.4, and then you may download and upgrade from 0.9.4 to 1.0.0.
Info
titleUpdating May Throw Error

When upgrading the database schema, you may see "Possibly failed to update database schema" instead. In all likelihood, the database schema successfully updated. (CO-165)

...