官术网_书友最值得收藏!

Time for action - installation on Linux

  1. Download the latest stable version of the sphinx source from http://sphinxsearch.com/downloads.html.
  2. Extract it anywhere on your file system and go inside the extracted sphinx directory:
    $ tar -xzvf sphinx-0.9.9.tar.gz $ cd sphinx-0.9.9
  3. Run the configure utility:
    $ ./configure --prefix=/usr/local/sphinx
  4. Build from the source:
    $ make

    Note

    It will take a while after you run the make command as it builds the binaries from the source code.

  5. Install the application (run as root):
    $ make install

What just happened?

We downloaded the latest release of Sphinx and extracted it using the tar command. We then ran the configure command which gets the details of our machine and also checks for all dependencies. If any of the dependency is missing, it will throw an error. We will take a look at possible dependency issues in a while.

Once we are done with configure, the make command will build (compile) the source code. After that, make install will actually install the binaries to respective location as specified in --prefix option to the configure.

Options to the configure command

There are many options that can be passed to the configure command but we will take a look at a few important ones:

  • --prefix=/path: This option specifies the path to install the sphinx binaries. In this book it is assumed that sphinx was configured with --prefix=/usr/local/sphinx so it is recommended that you configure your path with the same prefix.
  • --with-mysql=/path: Sphinx needs to know where to find MySQL's include and library files. It auto-detects this most of the time but if for any reason it fails, you can supply the path here.
  • --with-pgsql=/path: Same as -with-mysql but for PostgreSQL.

Most of the common errors you would find while configuring sphinx are related to missing MySQL include files.

Options to the configure command

This can be caused either because Sphinx's auto detection for MySQL include path failed, or MySQL's devel package has not been installed on your machine. If MySQL's devel package is not installed, you can install it using the Software Package Manager (apt or yum) of your operating system. In case of Ubuntu, the package is called libmysqlclient16-dev.

Note

If you intend to use Sphinx without MySQL then you can use the configure option --without-mysql.

You need to follow pretty much the same steps if PostgreSQL include files are missing. In this book we will be primarily using MySQL for all examples.

Known issues during installation

Listed next are a few errors or issues that may arise during Sphinx's installation make can sometimes fail with the following error:

/bin/sh: g++: command not found make[1]: *** [libsphinx_a-sphinx.o] Error 127

This may be because of a missing gcc-c++ package. Try installing it.

At times you might get compile-time errors like:

sphinx.cpp:67: error: invalid application of `sizeof' to incomplete type `Private::SizeError<false>'

To fix the above error try editing sphinx.h and replace off_t with DWORD in a typedef for SphOffset_t.

#define STDOUT_FILENO fileno(stdout) #else typedef DWORD SphOffset_t; #endif

One drawback of doing this would be that you won't be able to use full-text indexes larger than 2 GB.

Sphinx on Windows

Installing on a Windows system is easier than on a Linux system as you can use the pre-compiled binaries.

主站蜘蛛池模板: 遂昌县| 额济纳旗| 二连浩特市| 塔城市| 夏河县| 苍梧县| 宝山区| 从江县| 玛曲县| 平乡县| 芜湖市| 内乡县| 千阳县| 泰和县| 西吉县| 阳原县| 曲阜市| 玉树县| 亳州市| 洪湖市| 江山市| 且末县| 昌吉市| 青河县| 麻江县| 淮滨县| 安达市| 淮安市| 孙吴县| 广河县| 剑川县| 曲阜市| 临城县| 德令哈市| 屏山县| 玉环县| 六安市| 河东区| 云浮市| 包头市| 青川县|