| 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 |
|