/[collab-maint]/deb-maint/pinot/trunk/FAQ
ViewVC logotype

Contents of /deb-maint/pinot/trunk/FAQ

Parent Directory Parent Directory | Revision Log Revision Log


Revision 12334 - (show annotations) (download)
Mon Feb 2 16:36:15 2009 UTC (4 years, 4 months ago) by hanska-guest
File size: 4527 byte(s)
New upstream release
1 * The index is huuuuge ! How can I make it smaller ?
2 The format of Xapian indexes is optimized for writing. Once all documents
3 have been indexed, compacting the index may reduce its size quite
4 significantly. If you have Xapian >= 1.0.6, xapian-compact will let you do
5 that. Stop the daemon and run the following commands :
6 $ mv ~/.pinot/daemon ~/.pinot/backup-daemon
7 $ xapian-compact ~/.pinot/backup-daemon ~/.pinot/daemon
8 This may take a little while. Once xapian-compact has completed, restart
9 the daemon with :
10 $ pinot-dbus-daemon -i
11 The -i parameter instructs the daemon to ignore the index version number,
12 which may not have been set in the compacted index.
13 You may also want to disable support for spelling. See the README for more
14 details.
15
16 * Pinot doesn't use my favourite browser XYZ to open HTML documents
17 Even if you have set XYZ as your favourite Web browser in your desktop
18 environment, it may not be setup as the default application for HTML files.
19 In Gnome for instance, one has to select XYZ as default for all HTML files
20 using Nautilus (Properties dialog, Open With tab). This applies to
21 applications for any other file type.
22
23 * At startup, when listing an index or indexing documents, Pinot complains
24 of an "index error"
25 This is likely because a previous instance didn't exit properly and one
26 (or more) index is still locked. Quit Pinot and look for a "db_lock",
27 "flicklock" or "flintlock" file (depending on what version of Xapian the
28 index was created with/is currently installed) in the directory that Pinot
29 complains about. If it's there, check that no other process is using this
30 file, delete it and restart Pinot.
31
32 * When compiling from source, you may run into linking problems related to
33 libstdc++.la. Try patching xapian-config as explained in the post at
34 http://lists.tartarus.org/pipermail/xapian-devel/2006-January/000293.html
35
36 * If you experience segfaults at startup and you are on Fedora, chances are
37 it's because of libxml++/libsigc++. See this Bugzilla entry :
38 https://bugzilla.redhat.com/bugzilla/show_bug.cgi?id=178592
39 The latest version seems to fix this issue.
40
41 * If the daemon crashes seemingly randomly while indexing, it may be because
42 SQLite wasn't built thread-safe. I have witnessed this mostly on dual CPU
43 machines, but others are not immune. Try rebuilding SQLite by passing
44 "--enable-threadsafe --enable-threads-override-locks" to configure.
45
46 * If you have built Pinot from source, make sure you have done a "make install".
47 Pinot will fail to start if it can't find stuff it needs, its icon for
48 instance.
49
50 * If "make install" fails with an error about Categories in pinot.desktop
51 and you have desktop-file-utils 0.11, either downgrade to 0.10 or upgrade
52 to 0.12 if possible, or edit the top-level Makefile and replace the line
53 @desktop-file-install --vendor="" --dir=$(DESTDIR)$(datadir)/applications pinot.desktop
54 with
55 $(INSTALL_DATA) pinot.desktop $(DESTDIR)$(datadir)/applications/pinot.desktop
56 and run "make install" again.
57
58 * In stored queries, the directory filter doesn't work as expected if the
59 directory name starts with a non alpha-numeric character. This has been
60 fixed in Xapian 0.9.8.
61
62 * On FreeBSD, threading issues may cause the daemon to crash unexpectedly.
63 A fix is to add the following lines to /etc/libmap.conf (which may not exist) :
64 [/usr/local/bin/pinot-dbus-daemon]
65 libpthread.so.2 libc_r.so.6
66 libpthread.so libc_r.so
67
68 [/usr/local/bin/pinot]
69 libpthread.so.2 libc_r.so.6
70 libpthread.so libc_r.so
71
72 * If you are using KDE 3.* and pinot-dbus-daemon does not autostart, symlink
73 the file /etc/xdg/autostart/pinot-dbus-daemon.desktop to either
74 $(kde-config --prefix)/share/autostart (for all users) or ~/.kde/Autostart
75 (current user only).
76
77 * Flushing is not directly configurable in Pinot, but some control is
78 possible with the environment variable XAPIAN_FLUSH_THRESHOLD. It can be
79 set to the number of documents after which changes should be flushed to the
80 index. The default value is 10000.
81 The daemon explicitely flushes the index once it has crawled one of the
82 directories configured in Preferences, Indexing. if this directory has more
83 documents than XAPIAN_FLUSH_THRESHOLD, changes will be buffered in RAM until
84 the directory is fully crawled.
85

  ViewVC Help
Powered by ViewVC 1.1.5