mnoGoSearch 3.2.39 reference manual: Full-featured search engine software
Prev | Chapter 2. Installation | Next

# Installing mnoGoSearch

1. Unpack the distribution and change dir into the top-level directory of the unpacked distribution.

   `tar -zxf mnogosearch-x.x.x.tar.gz`

2. To simplify the configuration process we included a configuration script with the package - `install.pl`. Run `install.pl` and select mnoGoSearch configuration options in a question-and-answer manner. After you specify all the configuration options, 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. After configuration is finished, build and install the package as described in section 3.

   In case you would like to configure mnoGoSearch manually without using the configuration script, do the following:

   If you would like to configure the package with SQL database support:

   `sh$ ./configure --with-mysql`

   or

   `sh$ ./configure --with-pgsql`

   or with another depending on what database you prefer,

   or with multiple databases:

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

   By default, mnoGoSearch is installed in /usr/local/mnogosearch in the following subdirectories:

   Directory | Contents
   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`
   doc | various documentation

   If you have no permission to write to that directory or just want to install mnoGoSearch to another location, please use configure with --prefix option, e.g.

   `./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 the OpenSSL library is installed in a non-standard location:

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

   > Note: Please note that OpenSSL library installed on your system is required for HTTPS support.

   You can see all available options with ./configure --help

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

   `sh$ CFLAGS="-O7 -mpentium"`

   command prior to running configure.

   To compile mnoGoSearch on FreeBSD with Solid in old aout format use

   `sh$ CFLAGS="-aout"`

   prior to running configure.

   To enable DMALLOC memory debugger support use --enable-dmalloc.

   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 --with-extra-charsets command line argument.

   To build mnoGoSearch with support for all additional charsets, use:

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

   To build mnoGoSearch with only one specified charset support use:

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

   To build mnoGoSearch with several specified charsets support, use a comma separated list of the charsets you want:

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

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

3. Build and install the package.

   `sh$ make`

   `sh$ make install`

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

4. Create the mnogosearchdatabase.

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

   MySQL:

   `sh$ mysqladmin create mnogosearch`

   PostgreSQL:

   `sh$ createdb mnogosearch`

   See database specific information if you use another database.

5. Create indexer.conf and set DBAddr

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

   Copy indexer.conf-dist into indexer.conf: cp indexer.conf-dist indexer.conf

   Open indexer.conf in your favorite editor, and edit DBAddr to set the parameters of the database you're going to use.

6. Create tables

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

   Run :

   `sh$ ./indexer -Ecreate`

7. Installing search scripts

   Copy `search.cgi` to your web-server cgi-bin directory or make an Apache alias to mnoGoSearch's bin directory.

Prev | Home | Next
Tools required for installation | Up | Possible installation problems