Installing Upgrading

Before You Start...

Before proceeding with installation, please make sure your system meets the Minimum Requirements.

Installation Procedure

  1. Download the ZOE.tar.gz file, available from http://zoe.nu/itstories/story.php?data=stories&num=24&sec=3
  2. Unarchive the file, this should produce a "ZOE" directory with the app inside.
  3. Mac OS X: For Mail integration set the package flag on the ZOEMail.mailbundle folder.

Upgrade Procedure

For regular upgrade (i.e. between backward compatible release, e.g. most of them), you simply need to :
  1. Copy the new binaries over your old installation.
That's all.

Special Case: Upgrading from 0.4.5 to a later version

The internal message format in version 0.4.6 and above is not backwards compatible with previous versions. This means that the messages must be re-processed. To do this, you have two options:
  1. manual copy of the messages followed by a rebuild.
  2. running two instances of the app and transferring the messages through the built-in POP server.

Copy Messages and Rebuild

The 'SZ' directory under '%ZOE%/Library/' is where all your messages are stored.
  1. unpack the latest version of Zoe into a different directory than your current Zoe installation.
  2. Run the new version and create a new account. Let it fetch one or two messages to create the proper structures for your messages.
  3. Shutdown the app
  4. There should be a new 'SZ' directory under your new installation. You will need to copy all the messages from the old 'SZ' to the new 'SZ' directory. Messages are stored in a timeline structure under the 'Mails' directory. Copy all the years directories (i.e. '2002', '2003', etc) under 'SZ/Mails/<long hex name>/' to the new location under 'SZ/Mails/<long hex name>/'. Only copy the year directories, not the directory with the long hexadecimal name.
  5. If you want Zoe to keep track of what it has already downloaded, copy 'SZ/Storages/<long hex name>/alt.dev.szmail.SZServiceAgent/' to the new location.
  6. Once everything is copied over, run a rebuild.

    java -jar Zoe.jar rebuild
see Starting And Stopping for information about launching ZOE