Test Vanilla Installation

summary: Instructions for creating a fresh install, and pointers to help troubleshoot the basic functionality of Zoe.

Motivation

If Zoe is not working properly on you system and you are unable to correctly diagnose the problem, try creating a fresh install to check the basics.

1) Start Fresh

  1. Download the latest incarnation of the app and unarchive it in its own directory. Don't worry about your old repository for the moment.
  2. Start the app in debug mode from the command line so you can see what's going on:\
java -jar Zoe.jar debug
  1. Setup one account from where you can retrieve some messages. Keep it small and simple. Make sure there is indeed some messages in that account.

2) Check for Debug Info

Once the app is starting to retrieve messages you should see some logs along those lines:
08/22 23:06:56 (Debug) SZServiceAgent.processFolder: Processing: INBOX

Which indicates that a folder is getting processed.

Then, for each message in that folder you should see something like:
08/22 23:07:00 (Debug) SZServiceAgent.processFolder: 1

Which indicates that a message was retrieved and is getting enqueued for processing.

Then you should see the mail processor kick in for each message:
08/22 23:07:12 (Debug) SZMailProcessor.runImplementation: 1

And finally some indices should get flushed:
08/22 23:07:12 (Debug) SZIndex.flush: <alt.dev.szobject.SZIndex:alt.dev.szmail.SZEnvelope.index>

At that point your email is ready for consumption.

3) Check the UI

In the UI, your mail will appear under the date it was posted or under a list under that date if it was categorized as belonging to a mailing list.
If for some reason you cannot locate it, make a search to find it. If you can find it, click on the date it's associated with.

If all Else Fails

If you cannot find anything whatsoever, something must have gone badly awry and that should show up in the logs.

reference: [Zoe-general]