UPGRADING FROM 1.6 or 1.7 to 1.8

Note. Make a backup of you Data.fs before upgrading.

Note. Don't upgrade inplace, but reinstall Zope and Easy Publisher.

Note. Easy Publisher 1.8 is only distributed as a patch to an existing Zope installation. Easy Publisher 1.8 is designed for Zope 2.5.1 and Zope 2.6.1.

Installing and Upgrade

• Download and Install Zope (2.5.1 and 2.6.1 for full support)
• Install PIL (see INSTALL_PIL.txt)
  • To enable the EasyRoot object

  Upgrading a single object

  Most classes in Easy Publisher supports the upgradehook interface: upgradehook is a ttw-callable method (Protected by Easy Upgrade Manage) that upgrades the object to the current version.

  You call it by adding upgradehook at the view URL to the object:

  http://server_and_port/MyObject/upgradehook

  Upgrading a site structure

  By calling the manage_upgrade you can upgrade a whole structure of object, as it walks the hierarcy and call upgrade scripts on each object (for instance the upgradehook) (optional)

  After all objects has been upgraded, manage_upgrade walks through the hierarcy a second time and re-index all object. (optional)

  manage_upgrade creates a log of the upgrade. Here any problems will be indicated.

  http://server_and_port/manage_upgrade

  Upgrading Indexes

  The indexes in 1.6 (Zope 2.3.3) are different from the indexes in 1.7 and later (Zope 2.5.1) and Vocabularies as well. The manage_upgrade feature now upgrade your indexes and vocabulaties as well as checkes if any new index or columns are missing in the Catalogs. It also warns for deprecated indexes and columns.

  Tips.

  Tip 1: Due to the way Catalogs are acquired from object bellow the parent of the Catalog the parent it self can get lost in the index process (not added to the catalog).

  The parent is still catalogaware (if it's a Easy Publisher object) so you can easily go in under Properties and press Save Changes and it will be added to the Catalogs.

  If the root object is missing, navigation will look strange.