H-Sphere MnoGoSearch

MnoGoSearch is a web search engine that searches your site by keywords. It can run on both intranet and Internet pages. MnoGoSearch is installed into H-Sphere from a single package hsphere-mnogosearch-<version>-<build>, where <version> is MnoGoSearch version, and <build> is this package's build number. Please refer to H-Sphere MnoGoSearch Updates for the latest version of hsphere-mnogosearch package.

Questions considered:

• What's new in hsphere-mnogosearch package in H-Sphere 2.5
• MnoGoSearch configuration scripts
• MnoGoSearch frontend

What's new in hsphere-mnogosearch package in H-Sphere 2.5

hsphere-mnogosearch-x.x.x package underwent significant changes in H-Sphere 2.5:

• Changed the structure of tables and database. Now the indexer creates the tables in database.
• Removed Perl frontend. Instead mnogosearch-php-frontend-3.2.11 is included.
• Added ability to create several entry points on one server.
• Old mnogosearch databases are not supported anymore.

All MnoGoSearch files are installed in /hsphere/shared/mnogosearch, except for mnogosearch-init and mnogosearch-set scripts, that are placed to /hsphere/shared/scripts.

For the proper work of MnoGoSearch, you will also need the file ~httpd/conf/mnogosearch.conf that assigns domains but is not included in the package hsphere-mnogosearch-x.x.x

MnoGoSearch configuration scripts

• mnogosearch-init script is used to enable/disable MnoGoSearch.

  Usage:

  mnogosearch-init [ -f homedir ] [ -u login ] [ -g group ] [ -d domain ] [ -l dblogin ] [ -p dbpasswd ] [ -t dbhost ] [ -n dbname ] [ -a user_action ]

  Where:

  • homedir - user home directory
  • login - user name
  • group - the group to which the user belongs
  • domain - domain name
  • dblogin - MnoGoSearch database login
  • dbpasswd - MnoGoSearch database password
  • dbhost - MnoGoSearch database host
  • dbname - MnoGoSearch database name
  • user_action - 'set' parameter adds MnoGoSearch, 'drop' removes

  When MnoGoSearch is being enabled, this script:

  • creates for the domain folder /user_homedir/mnogosearch/domain_name where it places the files indexer.conf and search.htm. A user can configure these files to customize indexer and frontend.
  • in the folder /user_homedir/domain_name, creates the folder fe_mnogosearch where it places PHP-frontend. Now, the MnoGoSearch can be found at http://domain_name/fe_mnogosearch/search.php
  • creates the table structures by running:
    /hsphere/shared/mnogosearch/sbin/indexer -Ecreate user_homedir/mnogosearch/domain_name/indexer.conf
  • performs indexing.

  When MnoGoSearch is being disabled, the mnogosearch-init script removes all the custom settings.

• mnogosearch-set script is used to add/remove startup links from the server.

  Usage:

  mnogosearch-set [ -a | -r ] [ -d domain ] [ -u URL ]

  Where:

  • -a - adds startup URL
  • -r - removes existing entering URL
  • domain - domain for which these changes are done
  • URL - URL which is to be added or removed

  This script is executed when the startup link in the field "Add new MnoGoSearch URL" is submitted. It adds/removes the startup URLs into/from the file user_homedir/mnogosearch/domain_name/indexer.conf

MnoGoSearch frontend

Starting with H-Sphere 2.5, MnoGoSearch frontend written in Perl is replaced with PHP-based frontend.

To use MnoGoSearch with PHP frontend, PHP must include mnogosearch-php-extension. See H-Sphere PHP documentation.