[412a5e]: website / xapUpg100.html History

Download this file

xapUpg100.html    70 lines (55 with data), 2.5 kB 

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">



<html>

  <head>

    <title>Upgrading to xapian 1.0.x</title>



    <meta name="generator" content="HTML Tidy, see www.w3.org">

    <meta name="Author" content="Jean-Francois Dockes">

    <meta name="Description" content=

    "Upgrading a recoll installation from xapian 0.9 to 1.0">

    <meta name="Keywords" content="recoll, xapian, upgrade">

    <meta http-equiv="Content-language" content="en">

    <meta http-equiv="content-type" content="text/html; charset=iso-8859-1">

    <meta name="robots" content="All,Index,Follow">



    <link type="text/css" rel="stylesheet" href="styles/style.css">

  </head>



  <body>

    

    <div class="rightlinks">

      <ul>

	<li><a href="index.html">Home</a></li>

	<li><a href="download.html">Downloads</a></li>

      </ul>

    </div>

    

    <div class="content">



      <h1>Upgrading to Xapian 1.0</h1>

      

      <p>Xapian has supported two main index formats for quite some

	time: the older <em>Quartz</em> format, and the

	newer <em>Flint</em></p>



      <p>Up to Xapian release 1.0, <em>Quartz</em> was the

	default. This is also quite probably what your Recoll index

	used, except if you had explicitely required a <em>Flint</em>

	index by setting the <tt>XAPIAN_PREFER_FLINT</tt> environment

	variable.</p> 



      <p>When upgrading an existing Recoll installation to Recoll 1.9,

	which is normally built with Xapian 1.0 (0.9 is still

	supported), or after rebuilding Recoll 1.8.2 with Xapian 1.0,

	you probably want to convert your index format

	to <em>Flint</em>, which is faster and more efficient (if you

	were using the default <em>Quartz</em>, you can also elect to

	just do nothing, the older <em>Quartz</em> format is still

	supported).</p>



      <p>The index format upgrade will not happen automatically, and

	you will need to destroy the old index explicitely, then

	restart the indexer (this will cause a full indexing pass, of

	course, which may take some time, so you may prefer to let it

	work overnight).</p>

      

      <p>To destroy the old index, you just need to erase the xapiandb

	directory: typically: rm -rf ~/.recoll/xapiandb, except if you

	specified a special storage place with the <tt>dbdir</tt>

	configuration variable.</p>



      <p>If you were using <em>Flint</em> with Xapian 0.9,

	you <em>must</em> destroy the old index,

	because <em>Flint</em> had an incompatible format change

	between 0.9 and 1.0</p>



    </div>

  </body>

</html>