mnoGoSearch 3.3.9 reference manual: Full-featured search engine software
Prev | Chapter 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:

   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, 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.

Prev | Home | Next
Tools required for installation | Up | Running search.cgi from inetd / xinetd