Upgrading Tallyman

To upgrade Tallyman from a previous version, you'll first need to
upgrade the libraries and support files.  Then you can run the appropriate
script(s) in tools/upgrade to make the changes to the tables of any installed
stores.


Upgrading the libraries
-----------------------

  via CVS:
  --------

If you used cvs to check out Tallyman from the tallyman-stable branch,
upgrading is as simple as this:

cd /usr/local/tallyman   # or wherever your Tallyman files are kept
export CVSROOT=:pserver:anon_cvs@akopia.com:/anon_cvs/repository
cvs login
[Password:] anon_cvs
cvs update -dP -r tallyman-stable .

Any changes you've made to files will be preserved and seamlessly
upgraded as long as they don't conflict with the updated bits of code.
Watch for any such files; CVS will warn you about them when you
update, and you'll need to manually resolve the conflict.


  from a .patch file:
  -------------------

To patch your copy of tallyman, first acquire the patches to apply to your
existing version.  tallyman-2.0b5.patch.gz patches the previous version
(2.0a3) to version 2.0b5;  tallyman-2.0.6.patch.gz patches from 2.0b5 to
2.0.6.  You get the idea.

        wget ftp://ftp.akopia.com/pub/tallyman-2.0.6.patch.gz
        wget ftp://ftp.akopia.com/pub/tallyman-2.0.7.patch.gz
        etc.

Cd to your tallyman directory and apply the patch:

        cd /usr/local/tallyman
        zcat /tmp/tallyman-2.0.6.patch.gz | patch -Zp1
        zcat /tmp/tallyman-2.0.7.patch.gz | patch -Zp1
        etc.



Running the upgrade script
--------------------------

The script to upgrade your live tables can be found in tools/upgrade/.
Try running it with the '--help' option to see available options.  Or
run it with no options and it'll interactively prompt you about each
store that it finds.  To upgrade across multiple revisions, run each
script in between.  For example, to upgrade from 2.0b5 to 2.0.7:

First run up2.0b5-2.0.6.pl
Then run up2.0.6-2.0.7.pl

The scripts will make sure it's safe to upgrade before doing anything,
so running them more than once won't break anything.

