Getting started
From KatWiki
Here are the necessary steps to perform before starting to use Kat.
| Table of contents |
Install an inotify enabled kernel
(Based on http://www.beaglewiki.org/Inotify_Kernel)
Inotify is a file notification system for the Linux kernel. As of 2.6.13-rc3, it is included in the stable Linux kernel series. You can learn more about inotify here: http://www.kernel.org/pub/linux/kernel/people/rml/inotify/.
The Kat deamon does not require inotify, but it is strongly recommended as it will greatly improve your Kat search experience. Without it, Kat will not automatically detect all changes to your home directory and index the data in a timely fashion.
1. Inotify and Kat Versions
Kat is under heavy development and Inotify only recently was merged into Linus's kernel, so only versions of Inotify >=0.24 will work with all versions of Kat. Because Inotify is in Linus' kernel, the interface will be stable as of the release of the 2.6.13 kernel. All future versions of Kat above 0.6 will use this interface. Here are the versions supported:
- Kat 0.5.x: no inotify support
- Kat 0.6.0-0.6.1: inotify 0.21-0.23
- Kat 0.6.2: inotify 0.21-0.23
- Kat 0.6.3: only inotify 0.24 and above
2. Prepared Inotify Kernels
If your distribution is not listed, you will probably have to patch and build a kernel yourself.
SUSE
SUSE 9.3
Inotify-enabled kernel RPMs for SUSE 9.3: are available here: http://primates.ximian.com/~rml/kernel-rml/suse-93-i586
You can install the RPMs alongside your existing kernel RPMs. For example:
rpm -ivh kernel-default-2.6.11.4-747.inotify.0.i586.rpm
SUSE 10.0
SUSE LINUX 10.0 and openSUSE have a inotify enabled kernel.
Fedora Core
Fedora Core 2 and 3
Kernel packages which include inotify and other desktop enhancements are available for Fedora Core 2 and 3 here: (http://apt.bea.ki.se/kernel-desktop/). Fedora Core 3 kernel RPMs can also be downloaded from here (http://www.bagu.org/inotify/).
Thanks go to Ben Konrath for building and hosting these RPMs. They can be installed just like any other rpm:
rpm -ivh kernel-*.i686.rpm
There is also a yum repository for these packages. Add the following lines to your /etc/yum.conf:
[inotify] name=inotify baseurl=http://www.bagu.org/inotify enabled=0 gpgcheck=0
Now install the rpm with something like:
yum --enablerepo=inotify install kernel-2.6.11-1.14.inotify.0.22_FC3.i686
Fedora Core 4
An updated Fedora Core 4 system has already a inotfied kernel. It was released at the end of September 2005.
Rawhide / Fedora Devel
Inotify is in the current Fedora development kernel:
http://download.fedora.redhat.com/pub/fedora/linux/core/development/
Gentoo
Gentoo's and vanilla kernel sources >= 2.6.13 now include the inotify patch. These can be installed via:
emerge >=gentoo-sources-2.6.13 or emerge >=vanilla-sources-2.6.13
And during kernel-configuration enable Inotify file change notification support (INOTIFY) under either
Device Drivers / Character Devices or File Systems, or set CONFIG_INOTIFY=y in .config
Important: if you use kat 0.6.3 or 0.6.4 with sqlite 3.2.6, this may cause the kde-daemon to crash. kat 0.6.3 or 0.6.4 can be used with sqlite-3.2.1-r3.
Mandriva
The Mandriva 2006 kernels already have inotify enabled by default.
3. Build from Sources
Inotify is now merged into the upstream Linux kernel. You no longer need explicit inotify patches, although they are available under http://www.kernel.org/pub/linux/kernel/people/rml/inotify
Make sure you enable (set to 'y') the option "Inotify file change notification support (INOTIFY)" under Device Drivers / Character Devices. This is the CONFIG_INOTIFY option.
It can also be found in File Systems if you use make menuconfig. Also ensure extended attributes are enabled for your chosen filesystem(s). e.g. EXT2_FS_XATTR, EXT3_FS_XATTR, REISERFS_FS_XATTR and so on.
The build your kernel:
$ make $ make modules_install $ make install
Installing Kat
Suse
Fetch kat for SUSE 9.3 from ftp://ftp.suse.com/pub/suse/i386/supplementary/KDE/update_for_9.3/applications/ and do
rpm -Uhv kat kat-0.6.2-3.i586.rpm
Fetch kat for SUSE 10.0 from http://ftp.opensuse.org/pub/opensuse/distribution/SL-10.0-OSS/inst-source/suse/i586/kat-0.6.2-4.i586.rpm
Debian and Ubuntu
apt-get update && apt-get install kat
NOTE: At the moment, kat is not packaged in the Debian Repos, you may try Compiling SVN or check for a .deb package here [1] (http://sourceforge.net/project/showfiles.php?group_id=131039)
At the time of this writing, only 6.3 has a Debian package available for download, to install it, download it and run the following command from the directory it was downloaded into.
sudo dpkg -i ./kat_0.6.3-1_i386.deb
Assuming you can track down all the necessary dependencies, that should work alright in Debian Testing, as of February 19th (the time of this writing) this will not work.
Gentoo
1. Setup your PORTAGE_OVERLAY (see http://gentoo-wiki.com/HOWTO_Installing_3rd_Party_Ebuilds)
mkdir /usr/local/portage or mkdir /any/other/directory
2. Edit the PORTDIR_OVERLAY variable in /etc/make.conf to /usr/local/portage
PORTDIR_OVERLAY="/usr/local/portage" or PORTDIR_OVERLAY="/any/other/directory"
3. Copy the correct kat-gentoo ebuilds from http://sf.net/project/showfiles.php?group_id=131039 to /usr/local/portage
cp kat-gentoo-XXX.tar.gz /usr/local/portage && cd /usr/local/portage && tar xvfz kat-gentoo-XXX.tar.gz
4. Emerge kat with the right USE-flags set for the extra external plugin helpers (ext-XXX) and put them in to /etc/portage/package.use:
emerge -pv kat && USE="ext-doc xattr" emerge -av kat
Fedora
Get the precompiled binaries from the SourceForge Site (http://sourceforge.net/project/showfiles.php?group_id=131039). There are two files (kat-<version>-FC4.i386.rpm and kat-lib-<version>-FC4.i386.rpm), download both of them and install them with
rpm -Uvh *.rpm
If you get several dependancy errors - such as libkdecore.so and the like - then install the kdelibs-3*.rpm packages from your install CD/DVD. Though this probably means you're running the Fedora default of Gnome so may struggle to use this product.
Mandriva
Kat is distributed (and enabled) by default on Mandriva distributions newer than (and including) 2006 Official (http://qa.mandriva.com/twiki/bin/view/Main/MandrivaLinux2006ReleaseNotes#Desktop_search_KAT_).
From SVN (almost all distributions)
see Compiling SVN
Install some helper applications
Kat requires Antiword and Hevea as helper applications which are not included in SUSE LINUX 9.3. You can find them packaged in RPM format at http://www.remset.net/Members/Markus/download/kat/.
untex can be downloaded from here and compiles easily by calling make and make install ftp://ftp.thp.uni-duisburg.de/pub/source/untex-1.3.tar.gz
unrtf can be downloaded from here and compiles easily by calling make and make install http://ftp.gnu.org/gnu/unrtf/0.19.7/unrtf-0.19.7.tar.gz
