X-Git-Url: https://git.cworth.org/git?p=obsolete%2Fnotmuch-wiki;a=blobdiff_plain;f=performance.mdwn;h=4adb946bf77086aa263b560b3b023829af76823c;hp=e686cabd1a55fe6b3cdd451b8001ee73e831f320;hb=HEAD;hpb=00e5d4b6f8f9357e1d0da2c5eb7b4b9ec043ec3b diff --git a/performance.mdwn b/performance.mdwn index e686cab..4adb946 100644 --- a/performance.mdwn +++ b/performance.mdwn @@ -1,5 +1,7 @@ # Optimize notmuch's performance +[[!toc levels=2]] + ## Xapian 1.2.x database format: chert vs. flint Xapian 1.2 (in contrast to 1.0.x) uses a new database format called @@ -18,20 +20,20 @@ database format, but also used in case of `chert`. ### Migrate from flint to chert -1. make sure you are using xapian 1.2.x (depends on your distribution) +Make sure you are using xapian 1.2.x (depends on your distribution) -XXX: add examples +XXX: add examples for different distributions -2. Backup your notmuch tags: +Backup your notmuch tags: $ cd - $ notmuch dump notmuch-dump-b4chert + $ notmuch dump --output=notmuch-dump-b4chert -3. Move away your old database: +Move away your old database: $ mv $(notmuch config get database.path)/.notmuch/ notmuch-db-b4chert -4. Find and import your messages, a new and fresh database will be +Find and import your messages, a new and fresh database will be created: $ XAPIAN_PREFER_CHERT=1 notmuch new @@ -44,23 +46,21 @@ somebody more knowledgeable. After the initial import it is definitely not necessary to define `XAPIAN_PREFER_CHERT` for subsequent calls of `notmuch new`. -5. Restore your tags: +Restore your tags: - $ notmuch restore notmuch-dump-b4chert + $ notmuch restore --input=notmuch-dump-b4chert -6. Check whether you are on chert now: +Check whether you are on chert now: $ ls $(notmuch config get database.path)/.notmuch/xapian/iam* iamchert If it says `iamflint`, most likely you are still using xapian 1.0.x. -7. Clean-up - -If you are sure everything is fine, you can delete the old things. The -dump of your tags you might want to keep anyway as a backup - on the -other hand you should have some mechanism in place to make regular -backups of your notmuch database: +Clean-up: if you are sure everything is fine, you can delete the old +things. The dump of your tags you might want to keep anyway as a +backup - on the other hand you should have some mechanism in place to +make regular backups of your notmuch database: $ rm notmuch-dump-b4chert $ rm -R notmuch-db-b4chert @@ -80,7 +80,7 @@ This needs xapian 1.2 Backup your database: $ cd - $ notmuch dump notmuch-dump-b4compact + $ notmuch dump --output=notmuch-dump-b4compact Compact it: @@ -100,4 +100,3 @@ Remove old and renamed compacted, if compacting went well: * [Sebastian Spaeth](http://notmuchmail.org/pipermail/notmuch/2011/004048.html) * [Pieter Praet](http://notmuchmail.org/pipermail/notmuch/2011/004175.html) -