File: FAQ

package info (click to toggle)
pinot 0.85-1
  • links: PTS, VCS
  • area: main
  • in suites: lenny
  • size: 5,524 kB
  • ctags: 3,868
  • sloc: cpp: 33,107; sh: 8,801; ansic: 3,049; makefile: 557; xml: 366; python: 250
file content (78 lines) | stat: -rw-r--r-- 4,109 bytes parent folder | download
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
70
71
72
73
74
75
76
77
78
  * The index is huuuuge ! How can I make it smaller ?
    The format of Xapian indexes is optimized for writing. Once all documents
    have been indexed, compacting the index may reduce its size quite
    significantly. If you have Xapian >= 1.0.6, xapian-compact will let you do
    that. Stop the daemon and run the following commands :
     $ mv ~/.pinot/daemon ~/.pinot/backup-daemon
     $ xapian-compact ~/.pinot/backup-daemon ~/.pinot/daemon
    This may take a little while. Once xapian-compact has completed, restart
    the daemon with :
     $ pinot-dbus-daemon -i
    The -i parameter instructs the daemon to ignore the index version number,
    which may not have been set in the compacted index.
    You may also want to disable support for spelling. See the README for more
    details.

  * At startup, when listing an index or indexing documents, Pinot complains
    of an "index error"
    This is likely because a previous instance didn't exit properly and one
    (or more) index is still locked. Quit Pinot and look for a "db_lock",
    "flicklock" or "flintlock" file (depending on what version of Xapian the
    index was created with/is currently installed) in the directory that Pinot
    complains about. If it's there, check that no other process is using this
    file, delete it and restart Pinot.

  * When compiling from source, you may run into linking problems related to
    libstdc++.la. Try patching xapian-config as explained in the post at
    http://lists.tartarus.org/pipermail/xapian-devel/2006-January/000293.html

  * If you experience segfaults at startup and you are on Fedora, chances are
    it's because of libxml++/libsigc++. See this Bugzilla entry :
    https://bugzilla.redhat.com/bugzilla/show_bug.cgi?id=178592
    The latest version seems to fix this issue.

  * If the daemon crashes seemingly randomly while indexing, it may be because
    SQLite wasn't built thread-safe. I have witnessed this mostly on dual CPU
    machines, but others are not immune. Try rebuilding SQLite by passing
    "--enable-threadsafe --enable-threads-override-locks" to configure.

  * If you have built Pinot from source, make sure you have done a "make install".
    Pinot will fail to start if it can't find stuff it needs, its icon for
    instance.

  * If "make install" fails with an error about Categories in pinot.desktop
    and you have desktop-file-utils 0.11, either downgrade to 0.10 or upgrade
    to 0.12 if possible, or edit the top-level Makefile and replace the line
     @desktop-file-install --vendor="" --dir=$(DESTDIR)$(datadir)/applications pinot.desktop
    with
     $(INSTALL_DATA) pinot.desktop $(DESTDIR)$(datadir)/applications/pinot.desktop
    and run "make install" again.

  * In stored queries, the directory filter doesn't work as expected if the
    directory name starts with a non alpha-numeric character. This has been
    fixed in Xapian 0.9.8.

  * On FreeBSD, threading issues may cause the daemon to crash unexpectedly.
    A fix is to add the following lines to /etc/libmap.conf (which may not exist) :
     [/usr/local/bin/pinot-dbus-daemon]
     libpthread.so.2         libc_r.so.6
     libpthread.so           libc_r.so

     [/usr/local/bin/pinot]
     libpthread.so.2         libc_r.so.6
     libpthread.so           libc_r.so

  * If you are using KDE 3.* and pinot-dbus-daemon does not autostart, symlink
    the file /etc/xdg/autostart/pinot-dbus-daemon.desktop to either
    $(kde-config --prefix)/share/autostart (for all users) or ~/.kde/Autostart
    (current user only).

  * Flushing is not directly configurable in Pinot, but some control is
    possible with the environment variable XAPIAN_FLUSH_THRESHOLD. It can be
    set to the number of documents after which changes should be flushed to the
    index. The default value is 10000.
    The daemon explicitely flushes the index once it has crawled one of the
    directories configured in Preferences, Indexing. if this directory has more
    documents than XAPIAN_FLUSH_THRESHOLD, changes will be buffered in RAM until
    the directory is fully crawled.