Back to mnoGoSearch site


mnoGoSearch 3.3.12 reference manual: Full-featured search engine software
PrevChapter 2. Installing mnoGoSearch Next

Installing mnoGoSearch

  1. Unpack the source distribution and change directory to the unpacked sources. For example:

    tar -zxf mnogosearch-3.3.8.tar.gz

    cd mnogosearch-3.3.8

  2. Configure the package

    Note: To simplify the configuration process, mnoGoSearch source distribution includes an optional configuration script install.pl. You can run install.pl and select mnoGoSearch configuration options in the question-and-answer manner. After you answer all the questions, the script will run ./configure with the options you chose. It will also create the install.options file containing your configuration preferences that you can use to run the script later, bypassing questions.

    If you decided to use install.pl, go to the section 3 after configuration is finished.

    In case you prefer to configure mnoGoSearch in the traditional way (without using install.pl), do the following:

    sh$ ./configure --with-mysql

    or

    sh$ ./configure --with-pgsql

    or with another database on your choice,

    or with multiple databases:

    sh$ ./configure --with-mysql --with-pgsql --with-freetds

    By default, mnoGoSearch is installed into the /usr/local/mnogosearch directory with the following subdirectories:

    DirectoryContents
    bin mconv, mguesser, search.cgi, udm-config
    lib libmnogocharset.a(so), libmnogosearch.a(so)
    sbin indexer,
    etc indexer.conf-dist, search.htm-dist, langmap.conf-dist, stopwords.conf-dist
    man indexer.1, indexer.conf.5
    docvarious documentation

    If you have no permission to write to that directory or just want to install mnoGoSearch to another location, you can use configure with the --prefix option, for example:

    ./configure --prefix=/user/home/mnogo --with-mysql

    To install mnoGoSearch with HTTPS support use configure with the following option:

    ./configure --with-openssl

    or in case when the OpenSSL library is installed in a non-standard location:

    ./configure --with-openssl=/path/to/library

    Note: The OpenSSL library is required to build mnoGoSearch with HTTPS support.

    You can see all available options by typing ./configure --help

    If you want to add some specific flags to the C compiler (for example, '-O7 -mpentium' to build a highly optimized binary for Pentium™ processors if you use egcs or pgcc), you can do so using

    sh$ CFLAGS="-O7 -mpentium" ./configure

    To enable the DMALLOC memory debugger support for debugging purposes, use the --with-dmalloc. Don't forget to set a proper value to the DMALLOC_OPTION environment variable before debugging indexer or search.cgi (see the dmalloc manual for details).

    The euc-kr, big5, gb2312 and shift-jis character sets are not supported by default. To build mnoGoSearch with support for these charsets, use configure with the --with-extra-charsets option.

    To build mnoGoSearch with support for all additional character sets, use:

    ./configure --with-extra-charsets=all

    To build mnoGoSearch with a single additional character set use:

    ./configure --with-extra-charsets=shift-jis

    To build mnoGoSearch with multiple additional character sets, use a comma separated list of the character sets you want:

    ./configure --with-extra-charset=big5,gb2312

    If you run into problems with configure, please see the Section called Possible installation problems .

  3. Building and installing the package.

    sh$ make

    sh$ make install

    If you run into problems at this step, please see the Section called Possible installation problems .

  4. Create a new database mnoGoSearch will use to store data in. For example, mnogosearch.

    You can use an existing database. In this case, skip this step.

    For MySQL:

    sh$ mysqladmin create mnogosearch

    For PostgreSQL:

    sh$ createdb mnogosearch

    See the database specific documentation for the other database software.

  5. Create the file indexer.conf and set the DBAddr command.

    Change directory to /usr/local/mnogosearch/etc/.

    Copy indexer.conf-dist into indexer.conf:

    cp indexer.conf-dist indexer.conf

    Open indexer.conf in your favorite text editor and edit the DBAddr command to set the proper database connection string.

  6. Create search.htm and set DBAddr

    Change dir to /etc directory of your mnoGoSearch installation, typically /usr/local/mnogosearch/etc/.

    Copy search.htm-dist into search.htm:

    cp search.htm-dist search.htm

    Open search.htm in your favorite editor, and edit the DBAddr to set the database connection strings, similarly to what you've done at the previous step.

  7. Create tables

    Change dir to the /sbin directory of the installation, typically /usr/local/mnogosearch/sbin, and create the database structure:

    sh$ ./indexer -Ecreate

  8. Installing search scripts

    Copy search.cgi to your Web server cgi-bin directory or add an Apache alias to mnoGoSearch bin directory.