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:

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