[Evolution-hackers] force migration FAQ (was: Re: [Evolution] Evolution 2.0.0)

[guenther <guenther rudersport de>]

CC'ing e-h, as this may bite hackers as well as brave, interested users.
Please do not cross-post, if you do have any further questions.


> In accordance with our Grand Plan (TM), the Evolution Team is pleased to
> announce Evolution 2.0.0 has been released to coincide with GNOME 2.8
[...]

> Upgrade Notes:
> Evolution 2.0 is the stable version of the 1.5.x development series.  It
> will upgrade your existing 1.4 install if you were not using 1.5
> previously,  but will not delete it until told to.

Probably the most common reason to need the following instructions:
Running 1.5.x previously for testing only and still using 1.4.x for
daily work.

The risks and joy of testing unstable versions... ;-)


> Common Questions:
[...]

> Q) Where does Evolution store my data now?
> A) It is now stored in ~/.evolution
> 
> Q) Why is my question not answered here?
> A) We didn't know it was a significant issue for you, let us know at
> evolution ximian com 


Another FAQ, which I answer daily on IRC:


Q: "How can I force migration of 1.4.x data?"

FWIW: This option has been removed from the stable release, cause it was
meant for excessive beta testing only. Anyway, there is a way to force
migration.

Note: You will do anything mentioned below ON YOUR OWN RISK. Create a
backup in case anything goes wrong -- backup your old ~/evolution
directory as well as the new 1.5/2.0 ~/.evolution directory.

Make sure the old 1.4 directory still exists and holds all the *latest*
data.


Now here is how to manually force migration again:

* Shutdown any running evolution processes.

  $ evolution-2.0 --force-shutdown

* Edit the GConf keys /apps/evolution/version and last_version to read
  "1.4.0". You can use gconf-editor or the command line interface:

  $ gconftool-2 --set /apps/evolution/version --type string "1.4.0"
  $ gconftool-2 --set /apps/evolution/last_version --type string "1.4.0"

* Remove (do you have a backup?) or rename (as shown) the new hidden
  ~/.evolution directory:

  $ mv ~/.evolution ~/old-evolution-2.0.0

* Then run Evolution 2.0.0 and it should migrate your 1.4.x data again.
  Lean back and have a good cup of coffee, beer, whatever... :-)

  Reset both GConf keys to "2.0.0", if not already done. AFAIK
  last_version will not be reset.


HTH

...guenther


-- 
char *t="\10pse\0r\0dtu\0  ghno\x4e\xc8\x79\xf4\xab\x51\x8a\x10\xf4\xf4\xc4";
main(){ char h,m=h=*t++,*x=t+2*h,c,i,l=*x,s=0; for (i=0;i<l;i++){ i%8? c<<=1:
(c=*++x); c&128 && (s+=h); if (!(h>>=1)||!t[s+h]){ putchar(t[s]);h=m;s=0; }}}