From 00c67881a02200afb8dac9cec8149bf5ec5077d4 Mon Sep 17 00:00:00 2001 From: Sebastian Spaeth Date: Fri, 6 Jan 2012 19:35:56 +0100 Subject: [PATCH] docs/MANUAL: How to upgrade to sqlite storage Add section to the manual describing how to upgrade to the new cache backend. Signed-off-by: Sebastian Spaeth --- docs/MANUAL.rst | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/docs/MANUAL.rst b/docs/MANUAL.rst index 49dedd6..da09141 100644 --- a/docs/MANUAL.rst +++ b/docs/MANUAL.rst @@ -305,6 +305,25 @@ achieve this. to hit the disk before continueing, you can set this to True. If you set it to False, you lose some of that safety, trading it for speed. + +Upgrading from plain text cache to SQLITE based cache +===================================================== + +OfflineImap uses a cache to store the last know status of mails (flags etc). Historically that has meant plain text files, but recently we introduced sqlite-based cache, which helps with performance and CPU usage on large folders. Here is how to upgrade existing plain text cache installations to sqlite based one: + + 1) Sync to make sure things are reasonably similar + 3) Change the account section to status_backend = sqlite + 4) A new sync will convert your plain text cache to an sqlite cache (but + leave the old plain text cache around for easy reverting) + This should be quick and not involve any mail up/downloading. + 5) See if it works :-) + 6a) If it does not work, go back to the old version or set + status_backend=plain + 6b) Or once you are sure it works, you can delete the + .offlineimap/Account-foo/LocalStatus folder (the new cache will be in + the LocalStatus-sqlite folder) + + Security and SSL ================