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

• 1. 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.
  2. In case you would like to configure mnoGoSearch manually without using the configuration script, do the following:
  3. If you would like to configure the package with SQL database support:
  4. sh$ ./configure --with-mysql
  5. or
  6. sh$ ./configure --with-pgsql
  7. or with another depending on what database you prefer,
  8. or with multiple databases:
  9. sh$ ./configure --with-mysql --with-pgsql --with-freetds
  10. By default, mnoGoSearch is installed in /usr/local/mnogosearch in the following subdirectories:
  11.  

  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

• 1. 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.
  2. ./configure --prefix=/user/home/mnogo --with-mysql
  3. To install mnoGoSearch with HTTPS support use configure with the following option:
  4. ./configure --with-openssl
  5. or in case the OpenSSL library is installed in a non-standard location:
  6. ./configure --with-openssl=/path/to/library
  7. 1. Note: Please note that OpenSSL library installed on your system is required for HTTPS support.
  8. You can see all available options with ./configure --help
  9. 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
  10. sh$ CFLAGS="-O7 -mpentium"
  11. command prior to running configure.
  12. To compile mnoGoSearch on FreeBSD with Solid in old aout format use
  13. sh$ CFLAGS="-aout"
  14. prior to running configure.
  15. To enable DMALLOC memory debugger support use --with-dmalloc. Don't forget to set environment variable DMALLOC_OPTION before debugging indexer or search.cgi (see dmalloc manual for details).
  16. 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.
  17. To build mnoGoSearch with support for all additional charsets, use:
  18. ./configure --with-extra-charsets=all
  19. To build mnoGoSearch with only one specified charset support use:
  20. ./configure --with-extra-charsets=shift-jis
  21. To build mnoGoSearch with several specified charsets support, use a comma separated list of the charsets you want:
  22. ./configure --with-extra-charset=big5,gb2312
  23. If you run into problems with configure, please see the Section called Possible installation problems .

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

  25. Create a database mnoGoSearch will store data in. For example, mnogosearch.

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

      MySQL:

      sh$ mysqladmin create mnogosearch

      PostgreSQL:

      sh$ createdb mnogosearch

      See database specific information if you use another database.

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

  27. Create search.htm and set DBAddr

      Change dir to /etc directory of 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 DBAddr to set the database parameters similary to what you've done at the previous step.

  28. Create tables

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

      Run :

      sh$ ./indexer -Ecreate

  29. Installing search scripts

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