README.TXT

File contents

USING THE UPDATERS
---------------------

1. Install the NEW version of the software you want to update. This is VERY IMPORTANT as it's
   the assumption that has been made when writing all the updaters that use this product.

      For example, if you are upgrading from Zope 2.3.0 to 2.3.2 and want to update all your
      catalogs, install Zope 2.3.2 before running the updaters.

2. Find the appropriate updater files and put them in the Extensions folder of the Zope Instance 
   you're updating. By the time you read this, you should know what files you will need.

      For example, if you are upgrading from CST 0.7 to CST 0.8, you would need to use the following:

      - CST080_idmgrs.py
      - CST080_datamgrs.py 

3. Turn the file into an external method.

      The module name should be the name of the file (minus .py) from step 1.
      The method name should be 'updateall'
      The id of the external method can be anything you want, 'updateall' is often a good choice.

      It's best to add this external method in the root of the ZODB.

4. Run the external method in the root of that ZODB. This will update all the objects of the necessary 
   type(s) in the ZODB.

      eg: http://localhost:8080/updateall