<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <HTML ><HEAD ><TITLE >Installing mnoGoSearch </TITLE ><META NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK REL="HOME" TITLE="mnoGoSearch 3.3.9 reference manual" HREF="index.html"><LINK REL="UP" TITLE="Installing mnoGoSearch " HREF="msearch-install.html"><LINK REL="PREVIOUS" TITLE="Tools required for installation" HREF="msearch-toolsreq.html"><LINK REL="NEXT" TITLE="Running search.cgi from inetd / xinetd " HREF="msearch-inetd.html"><LINK REL="STYLESHEET" TYPE="text/css" HREF="mnogo.css"><META NAME="Description" CONTENT="mnoGoSearch - Full Featured Web site Open Source Search Engine Software over the Internet and Intranet Web Sites Based on SQL Database. It is a Free search software covered by GNU license."><META NAME="Keywords" CONTENT="shareware, freeware, download, internet, unix, utilities, search engine, text retrieval, knowledge retrieval, text search, information retrieval, database search, mining, intranet, webserver, index, spider, filesearch, meta, free, open source, full-text, udmsearch, website, find, opensource, search, searching, software, udmsearch, engine, indexing, system, web, ftp, http, cgi, php, SQL, MySQL, database, php3, FreeBSD, Linux, Unix, mnoGoSearch, MacOS X, Mac OS X, Windows, 2000, NT, 95, 98, GNU, GPL, url, grabbing"></HEAD ><BODY CLASS="sect1" BGCOLOR="#EEEEEE" TEXT="#000000" LINK="#000080" VLINK="#800080" ALINK="#FF0000" ><!--#include virtual="body-before.html"--><DIV CLASS="NAVHEADER" ><TABLE SUMMARY="Header navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TH COLSPAN="3" ALIGN="center" ><SPAN CLASS="application" >mnoGoSearch</SPAN > 3.3.9 reference manual: Full-featured search engine software</TH ></TR ><TR ><TD WIDTH="10%" ALIGN="left" VALIGN="bottom" ><A HREF="msearch-toolsreq.html" ACCESSKEY="P" >Prev</A ></TD ><TD WIDTH="80%" ALIGN="center" VALIGN="bottom" >Chapter 2. Installing <SPAN CLASS="application" >mnoGoSearch</SPAN > <A NAME="AEN519" ></A ></TD ><TD WIDTH="10%" ALIGN="right" VALIGN="bottom" ><A HREF="msearch-inetd.html" ACCESSKEY="N" >Next</A ></TD ></TR ></TABLE ><HR ALIGN="LEFT" WIDTH="100%"></DIV ><DIV CLASS="sect1" ><H1 CLASS="sect1" ><A NAME="installing" >Installing <SPAN CLASS="application" >mnoGoSearch</SPAN > <A NAME="AEN690" ></A ></A ></H1 ><P ></P ><OL TYPE="1" ><LI ><P >Unpack the source distribution and change directory to the unpacked sources. For example: </P ><P > <KBD CLASS="userinput" >tar -zxf mnogosearch-3.3.8.tar.gz</KBD > </P ><P > <KBD CLASS="userinput" >cd mnogosearch-3.3.8</KBD > </P ></LI ><LI ><P >Configure the package</P ><DIV CLASS="note" ><BLOCKQUOTE CLASS="note" ><P ><B >Note: </B >To simplify the configuration process, <SPAN CLASS="application" >mnoGoSearch</SPAN > source distribution includes an optional configuration script <TT CLASS="filename" >install.pl</TT >. You can run <TT CLASS="filename" >install.pl</TT > and select <SPAN CLASS="application" >mnoGoSearch</SPAN > configuration options in the <SPAN CLASS="emphasis" ><I CLASS="emphasis" >question-and-answer</I ></SPAN > manner. After you answer all the questions, the script will run <TT CLASS="literal" >./configure</TT > with the options you chose. It will also create the <TT CLASS="filename" >install.options</TT > file containing your configuration preferences that you can use to run the script later, bypassing questions. </P ><P >If you decided to use <SPAN CLASS="application" >install.pl</SPAN >, go to the section <TT CLASS="literal" >3</TT > after configuration is finished. </P ></BLOCKQUOTE ></DIV ><P >In case you prefer to configure <SPAN CLASS="application" >mnoGoSearch</SPAN > in the traditional way (without using <SPAN CLASS="application" >install.pl</SPAN >), do the following: </P ><P > <KBD CLASS="userinput" >sh$ ./configure --with-mysql</KBD > </P ><P >or </P ><P > <KBD CLASS="userinput" >sh$ ./configure --with-pgsql</KBD > </P ><P >or with another database on your choice, </P ><P >or with multiple databases: </P ><P > <KBD CLASS="userinput" >sh$ ./configure --with-mysql --with-pgsql --with-freetds</KBD > </P ><P >By default, <SPAN CLASS="application" >mnoGoSearch</SPAN > is installed into the <TT CLASS="filename" >/usr/local/mnogosearch</TT > directory with the following subdirectories: </P ><DIV CLASS="informaltable" ><P ></P ><A NAME="AEN729" ></A ><TABLE BORDER="1" CLASS="CALSTABLE" ><COL><COL><TBODY ><TR ><TD >Directory</TD ><TD >Contents</TD ></TR ><TR ><TD >bin</TD ><TD > <TT CLASS="filename" >mconv</TT >, <TT CLASS="filename" >mguesser</TT >, <TT CLASS="filename" >search.cgi</TT >, <TT CLASS="filename" >udm-config</TT > </TD ></TR ><TR ><TD >lib</TD ><TD > <TT CLASS="filename" >libmnogocharset.a(so)</TT >, <TT CLASS="filename" >libmnogosearch.a(so)</TT > </TD ></TR ><TR ><TD >sbin</TD ><TD > <TT CLASS="filename" >indexer</TT >, </TD ></TR ><TR ><TD >etc</TD ><TD > <TT CLASS="filename" >indexer.conf-dist</TT >, <TT CLASS="filename" >search.htm-dist</TT >, <TT CLASS="filename" >langmap.conf-dist</TT >, <TT CLASS="filename" >stopwords.conf-dist</TT > </TD ></TR ><TR ><TD >man</TD ><TD > <TT CLASS="filename" >indexer.1, indexer.conf.5</TT > </TD ></TR ><TR ><TD >doc</TD ><TD >various documentation</TD ></TR ></TBODY ></TABLE ><P ></P ></DIV ><P >If you have no permission to write to that directory or just want to install <SPAN CLASS="application" >mnoGoSearch</SPAN > to another location, you can use configure with the <CODE CLASS="option" >--prefix</CODE > option, for example: </P ><P > <KBD CLASS="userinput" >./configure --prefix=/user/home/mnogo --with-mysql</KBD > </P ><P >To install <SPAN CLASS="application" >mnoGoSearch</SPAN > with <ACRONYM CLASS="acronym" >HTTPS</ACRONYM > support use <SPAN CLASS="application" >configure</SPAN > with the following option: </P ><P > <KBD CLASS="userinput" >./configure --with-openssl</KBD > </P ><P >or in case when the <SPAN CLASS="application" >OpenSSL</SPAN > library is installed in a non-standard location: </P ><P > <KBD CLASS="userinput" >./configure --with-openssl=/path/to/library</KBD > </P ><DIV CLASS="note" ><BLOCKQUOTE CLASS="note" ><P ><B >Note: </B >The <SPAN CLASS="application" >OpenSSL</SPAN > library is required to build <SPAN CLASS="application" >mnoGoSearch</SPAN > with <ACRONYM CLASS="acronym" >HTTPS</ACRONYM > support. </P ></BLOCKQUOTE ></DIV ><P >You can see all available options by typing <KBD CLASS="userinput" >./configure --help</KBD > </P ><P >If you want to add some specific flags to the <SPAN CLASS="application" >C compiler</SPAN > (for example, <TT CLASS="literal" >'-O7 -mpentium'</TT > to build a highly optimized binary for <SPAN CLASS="trademark" >Pentium</SPAN >™ processors if you use <SPAN CLASS="application" >egcs</SPAN > or <SPAN CLASS="application" >pgcc</SPAN >), you can do so using </P ><P > <KBD CLASS="userinput" >sh$ CFLAGS="-O7 -mpentium" ./configure </KBD > </P ><P > <A NAME="AEN796" ></A > To enable the <A HREF="http://sourceforge.net/projects/dmalloc/" TARGET="_top" >DMALLOC memory debugger</A > support for debugging purposes, use the <CODE CLASS="option" >--with-dmalloc</CODE >. Don't forget to set a proper value to the <CODE CLASS="envar" >DMALLOC_OPTION</CODE > environment variable before debugging <SPAN CLASS="application" >indexer</SPAN > or <SPAN CLASS="application" >search.cgi</SPAN > (see the <SPAN CLASS="application" >dmalloc</SPAN > manual for details). </P ><P >The <TT CLASS="literal" >euc-kr</TT >, <TT CLASS="literal" >big5</TT >, <TT CLASS="literal" >gb2312</TT > and <TT CLASS="literal" >shift-jis</TT > character sets are not supported by default. To build <SPAN CLASS="application" >mnoGoSearch</SPAN > with support for these charsets, use <SPAN CLASS="application" >configure</SPAN > with the <CODE CLASS="option" >--with-extra-charsets</CODE > option. </P ><P >To build <SPAN CLASS="application" >mnoGoSearch</SPAN > with support for all additional character sets, use: </P ><P > <KBD CLASS="userinput" >./configure --with-extra-charsets=all</KBD > </P ><P >To build <SPAN CLASS="application" >mnoGoSearch</SPAN > with a single additional character set use: </P ><P > <KBD CLASS="userinput" >./configure --with-extra-charsets=shift-jis</KBD > </P ><P >To build <SPAN CLASS="application" >mnoGoSearch</SPAN > with multiple additional character sets, use a comma separated list of the character sets you want: </P ><P > <KBD CLASS="userinput" >./configure --with-extra-charset=big5,gb2312</KBD > </P ><P >If you run into problems with <SPAN CLASS="application" >configure</SPAN >, please see <A HREF="msearch-installproblem.html" >the Section called <I >Possible installation problems <A NAME="AEN952" ></A ></I ></A >. </P ></LI ><LI ><P >Building and installing the package. </P ><P > <KBD CLASS="userinput" >sh$ make</KBD > </P ><P > <KBD CLASS="userinput" >sh$ make install</KBD > </P ><P >If you run into problems at this step, please see <A HREF="msearch-installproblem.html" >the Section called <I >Possible installation problems <A NAME="AEN952" ></A ></I ></A >. </P ></LI ><LI ><P >Create a new database <SPAN CLASS="application" >mnoGoSearch</SPAN > will use to store data in. For example, <TT CLASS="literal" >mnogosearch</TT >. </P ><P >You can use an existing database. In this case, skip this step. </P ><P >For <SPAN CLASS="application" >MySQL</SPAN >: </P ><P > <KBD CLASS="userinput" >sh$ mysqladmin create mnogosearch</KBD > </P ><P >For <SPAN CLASS="application" >PostgreSQL</SPAN >: </P ><P > <KBD CLASS="userinput" >sh$ createdb mnogosearch</KBD > </P ><P >See the database specific documentation for the other database software. </P ></LI ><LI ><P >Create the file <TT CLASS="filename" >indexer.conf</TT > and set the <B CLASS="command" ><A HREF="msearch-cmdref-dbaddr.html" >DBAddr</A ></B > command. </P ><P >Change directory to <TT CLASS="filename" >/usr/local/mnogosearch/etc/</TT >. </P ><P >Copy <TT CLASS="filename" >indexer.conf-dist</TT > into <TT CLASS="filename" >indexer.conf</TT >: </P ><P > <KBD CLASS="userinput" >cp indexer.conf-dist indexer.conf</KBD > </P ><P >Open <TT CLASS="filename" >indexer.conf</TT > in your favorite text editor and edit the <B CLASS="command" ><A HREF="msearch-cmdref-dbaddr.html" >DBAddr</A ></B > command to set the proper database connection string. </P ></LI ><LI ><P >Create <TT CLASS="filename" >search.htm</TT > and set <B CLASS="command" ><A HREF="msearch-cmdref-dbaddr.html" >DBAddr</A ></B > </P ><P >Change dir to <TT CLASS="literal" >/etc</TT > directory of your <SPAN CLASS="application" >mnoGoSearch</SPAN > installation, typically <TT CLASS="literal" >/usr/local/mnogosearch/etc/</TT >. </P ><P >Copy <TT CLASS="filename" >search.htm-dist</TT > into <TT CLASS="filename" >search.htm</TT >: </P ><P > <KBD CLASS="userinput" >cp search.htm-dist search.htm</KBD > </P ><P >Open <TT CLASS="filename" >search.htm</TT > in your favorite editor, and edit the <B CLASS="command" ><A HREF="msearch-cmdref-dbaddr.html" >DBAddr</A ></B > to set the database connection strings, similarly to what you've done at the previous step. </P ></LI ><LI ><P >Create tables </P ><P >Change dir to the <TT CLASS="filename" >/sbin</TT > directory of the installation, typically <TT CLASS="literal" >/usr/local/mnogosearch/sbin</TT >, and create the database structure: </P ><P > <KBD CLASS="userinput" >sh$ ./indexer -Ecreate</KBD > </P ></LI ><LI ><P >Installing search scripts </P ><P >Copy <SPAN CLASS="application" >search.cgi</SPAN > to your Web server <TT CLASS="filename" >cgi-bin</TT > directory or add an <SPAN CLASS="application" >Apache</SPAN > alias to <SPAN CLASS="application" >mnoGoSearch</SPAN > bin directory. </P ></LI ></OL ></DIV ><DIV CLASS="NAVFOOTER" ><HR ALIGN="LEFT" WIDTH="100%"><TABLE SUMMARY="Footer navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" ><A HREF="msearch-toolsreq.html" ACCESSKEY="P" >Prev</A ></TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="index.html" ACCESSKEY="H" >Home</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" ><A HREF="msearch-inetd.html" ACCESSKEY="N" >Next</A ></TD ></TR ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" >Tools required for installation</TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="msearch-install.html" ACCESSKEY="U" >Up</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" >Running <SPAN CLASS="application" >search.cgi</SPAN > from <SPAN CLASS="application" >inetd</SPAN > / <SPAN CLASS="application" >xinetd</SPAN ></TD ></TR ></TABLE ></DIV ><!--#include virtual="body-after.html"--></BODY ></HTML >