view release on metacpan or  search on metacpan

INSTALL.html  view on Meta::CPAN

Browsing to the Web server's address should display
the Apache default home page.
<p>
The section, <a href="#apache20config">Apache 2.0 Configuration</a>,
describes configuring the Web server for OnSearch.

<a name="apacheconfig">
<h4>Configuring Apache</h4>

<strong>Note:</strong> In all versions of Apache, it may be
necessary to add a unique user and group ID for the Web
server, in order index from within OnSearch. You will also need to
<tt>adduser</tt> and <tt>addgroup</tt> (or <tt>useradd</tt>
and <tt>groupadd</tt>) the Web server's unique user and group.

<a name="apache13config">
<h5>Apache 1.3</h4>

Configuring Apache requires several steps:
<ol>
<li>Determine that the Web server has loaded the necessary modules.
<li>Enable the handlers for CGI scripts and server side
includes.
<li>Add the permissions that OnSearch needs.
<li>Create the password and group files.
<li>Restart the Server.
</ol>

<a name="loadmodules">
<h5>Load Modules</h5>

If you installed Apache with the configuration described in 
<a href="#apacheinstall">Apache Installation</a>, you will
need to load modules by using <tt>LoadModule</tt> statements
in <tt>httpd.conf,</tt> as described below.

However, if the Web server does not have Dynamic Shared
Object support enabled, you can determine which modules are
already loaded with the following shell command.

<blockquote><pre>
# /usr/local/apache/bin/httpd -l
Compiled-in modules:
  http_core.c
  mod_env.c
  mod_log_config.c
  mod_mime.c
  mod_negotiation.c
  mod_status.c
  mod_include.c
  mod_autoindex.c
  mod_dir.c
  mod_cgi.c
  mod_asis.c
  mod_imap.c
  mod_actions.c
  mod_userdir.c
  mod_alias.c
  mod_access.c
  mod_auth.c
  mod_setenvif.c
suexec: disabled; invalid wrapper /usr/local/apache/bin/suexec
</pre></blockquote>

The modules that OnSearch needs are: <tt>mod_cgi,</tt>
<tt>mod_include,</tt> and <tt>mod_auth.</tt> If any of these
are not compiled into the Web server, you'll need to load
them dynamically by adding the following lines to
<tt>httpd.conf</tt> if they are not already present.

<blockquote><pre>
LoadModule auth_module /usr/local/apache/libexec/mod_auth.so
LoadModule cgi_module /usr/local/apache/libexec/mod_cgi.so
LoadModule includes_module /usr/local/apache/libexec/mod_include.so
</pre></blockquote>

The file paths in the examples are those of a standard
Apache directory layout used in <a
href="#apacheinstall">Apache Installation</a>.  You may need
to adjust the paths depending on the Web server's
configuration.
<p>
If any of these modules are missing, consult
<tt>INSTALL</tt> in the Apache source code archive.

<a name="enablehandlers">
<h5>Enable Handlers</h5>

To enable the handlers for CGI scripts and server side
includes, uncomment the relevant lines in
<tt>httpd.conf.</tt>
<p>
Change the lines:
<blockquote><pre>
    #AddHandler cgi-script .cgi
    .
    .
    .
    #AddType text/html .shtml
    #AddHandler server-parsed .shtml
</pre></blockquote>
So that they look like the following:
<blockquote><pre>
    AddHandler cgi-script .cgi
    .
    .
    .
    AddType text/html .shtml
    AddHandler server-parsed .shtml
</pre></blockquote>

<a name="addpermissions">
<h5>Add Permissions</h5>
The easiest way to add permissions for OnSearch is to add the
following sections to <tt>httpd.conf.</tt>
<blockquote><pre>
&lt;Directory /usr/local/apache/htdocs/onsearch&gt;
    Options ExecCGI Includes
    AddHandler cgi-script .cgi
    AddType text/html .shtml
    AddHandler server-parsed .shtml