Sphinx-Search Engine mit MySQL unter Ubuntu

Sphinx ist ein extrem interessanter Ansatz für alle, denen die Volltextsuche von MySQL zu eingeschränkt ist. Hier erkläre ich, wie man Sphinx unter Ubuntu zum Laufen bekommt.

Edit: weitere/neuere Infos

Quellcode herunterladen, kompilieren und installieren

(Anmerkung: Die Versionsnummer können sich in der Zwischenzeit natürlich geändert haben – diese also beachten)

Zuerst brauchen wir den Quellcode, da dieser leider (noch?) nicht als Ubuntu-Paket verfügbar ist:

cd /usr/src
sudo wget www.sphinxsearch.com/downloads/sphinx-0.9.7-rc2.tar.gz
sudo tar xzf sphinx-0.9.7-rc2.tar.gz


Um das Ganze zu kompilieren, brauchen wir GNU make und gcc. Beide sind über ein Sammelpaket herunterladbar. Außerdem bemötigen wir für die SQL-Unterstützung das dev-Paket des MySQL-Clients:

sudo apt-get install build-essential libmysqlclient15-dev


Nun sollte die Installation recht einfach funktionieren:

cd /usr/src/sphinx-0.9.7-rc2
./configure
make
make install

Die Dateien wurden nach /usr/local/ geschrieben. Um Sphinx nun effektiv zu nutzen muss man folgende Schritte unternehmen.

Sphinx unter Ubuntu konfigurieren

Zuerst einmal muss man die Konfigdatei anpassen – hier kann ich wenig helfen, aber die Vorlage ist recht verständlich und man kommt mit ein wenig Experimentieren schnell zurecht. Man sollte die Vorlage kopieren und diese anpassen:

sudo cp /usr/local/etc/sphinx.conf.dist /usr/local/etc/sphinx.conf
sudo gedit /usr/local/etc/sphinx.conf


Um Sphinx als Dienst laufen zu lassen, kann man eine init-Datei herunterladen, die ich vorbereitet habe und dise ins init.d-Verzeichnis legen:

wget www.auxnet.de/fileadmin/data/blog/searchd.gz
gunzip searchd.gz
sudo chown root.root searchd
sudo chmod 755 searchd
sudo mv searchd /etc/init.d/


Den Dienst kann man nun mit Hilfe von folgendem Kommando starten:

sudo /etc/init.d/searchd start


Vor dem Start habe ich eine Reindizierung eingebaut, damit der Dienst auch startet, falls keine Index-Dateien vorliegen. Dieses Verhalten kann man natürlich anpassen (im Skript).

Will man, dass Sphinx standardmäßig beim Systemstart startet, kann man das mit Hilfe der Runlevels einfach machen:


sudo update-rc.d searchd start 92 2 3 4 5 . stop 08 S 1 6 .


(S92 habe ich genommen, so dass der Dienst direkt nach Apache startet…)

MySQL Storage Engine nutzen (optional)

Man kann Sphinx auch als Storage Engine für MySQL nutzen. Dies ist dann interessant, wenn man z.B. mit JOINS die gefundenen Daten mit den Texten verknüpfen will, o.ä. Wer Sphinx extern (z.B. über die PHP-API) nutzt, benötigt diesen Schritt nicht extra.

Um das Ganze zum Laufen zu bringen, braucht man den Quellcode von MySQL und ein wenig Geduld…

Zuerst brauchen wir die Voraussetzungen zum Kompilieren von MySQL – nicht gerade wenig:

sudo apt-get install libtool debhelper libncurses5-dev libwrap0-dev \
zlib1g-dev libreadline-dev chrpath automake1.8 automake1.9 \
doxygen dpatch procps file perl psmisc po-debconf tetex-bin \
tetex-base tetex-extra gs gawk bison


(Bison ist hier wichtig, da Sphinx das zum Kompilieren benötigt, sonst bricht die Installation mit einem Fehler ab!)

Nun holen wir uns die Sources des mysql-servers (Sources müssen natürlich in /etc/apt/sources.list eingetragen sein):

sudo apt-get source mysql-server


Ok, diese müssen wir nun patchen:

cd mysql-dfsg-5.0-5.0.24a
sudo patch -p1 < ../sphinx-0.9.7-rc2/mysqlse/sphinx.5.0.22.diff


Der Patch sollte glatt laufen, bis auf eine Stelle - diese müssen wir per Hand nachtragen:

sudo gedit sql/set_var.cc
Hier nach “csv” suchen und nach dieser Zeile folgende einfügen:
{"have_sphinx", (char*) &have_sphinx_db, SHOW_HAVE},

Nun den Storage Engine Quellcode kopieren:

sudo cp -ar ../sphinx-0.9.7-rc2/mysqlse sql/sphinx


Jetzt haben wir’s fast – nur noch dpkg sagen, dass wir den Storage Engine mitkompilieren wollen:

sudo gedit nano debian/rules
Hier nach “with-innodb” suchen und nach dieser Zeile folgende einfügen:
--with-sphinx-storage-engine \

Jetzt ist alles bereit… gestartet wird die Installation mit:

sudo dpkg-buildpackage


Ok, jetzt sollte alles fehlerfrei durchlaufen – das Kompilieren dauert auch auf einem modernen Dual-Core-Rechner eine Weile. Man kann also einen schnellen Kaffee trinken gehen :-)

Wenn alles glatt gelaufen ist dann zurück in’s /etc/src-Verzeichnis und das Paket installieren:

cd ..
sudo dpkg -i mysql-server-5.0_5.0.24a-9_i386.deb


Falls man MySQL noch nicht installiert hat, muss man evt. noch andere Pakete mitinstallieren, die ebenfalls im /usr/src-Verzeichnis zu finden sind…

Ob alles geklappt hat, sieht man, wenn man sich mit mysql einloggt und folgenden Befehl ausführt:
SHOW ENGINES;

Es müsste dann eine Zeile mit SPHINX und Support YES kommen.

Viel Spaß damit!