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.