diff options
Diffstat (limited to 'httemplate/docs/install.html')
| -rw-r--r-- | httemplate/docs/install.html | 45 |
1 files changed, 13 insertions, 32 deletions
diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index d4507a2a5..c95b41f5d 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -107,32 +107,20 @@ $ su # make create-config </pre> <li>Run a <b>separate</b> iteration of Apache[-SSL] with mod_perl enabled <b>as the freeside user</b>. + <li>Edit the <tt>Makefile</tt> and set <tt>TEMPLATE</tt> to <tt>asp</tt> or <tt>mason</tt>. Also set <tt>FREESIDE_DOCUMENT_ROOT</tt>. + <li>Run <tt> make install-docs</tt>. </ul> <table> <tr> <th>Apache::ASP</th><th>Mason</th> </tr> <tr> - <td><ul> - <li>Run <tt>make aspdocs</tt> - <li>Copy <tt>aspdocs/</tt> to your web server's document space: -<font size="-1"><pre> -cp aspdocs /usr/local/apache/htdocs/freeside-asp -</pre></font> - <li>Create a <a href="http://www.apache-asp.org/config.html#Global">Global</a> directory, such as <tt>/usr/local/etc/freeside/asp-global/</tt>: -<font size="-1"><pre> -mkdir /usr/local/etc/freeside/asp-global/ -chown freeside /usr/local/etc/freeside/asp-global/ -</pre></font> - <li>Copy <tt>htetc/global.asa</tt> to the Global directory: -<font size="-1"><pre> -cp htetc/global.asa /usr/local/etc/freeside/asp-global/global.asa -</pre></font> - <li>Configure Apache for the Global directory and to execute .cgi files using Apache::ASP. For example, add something like the following to your Apache httpd.conf file, adjusting for your actual paths: + <td valign="top"><ul> + <li>Configure Apache: <font size="-1"><pre> PerlModule Apache::ASP # your freeside document root -<Directory /usr/local/apache/htdocs/freeside-asp> +<Directory /var/www/freeside> <Files ~ (\.cgi|\.html)> AddHandler perl-script .cgi .html PerlHandler Apache::ASP @@ -144,24 +132,16 @@ PerlSetVar Global /usr/local/etc/freeside/asp-global/ PerlSetVar Debug 2 PerlSetVar RequestBinaryRead Off # your freeside document root -PerlSetVar IncludesDir /usr/local/apache/htdocs/freeside-asp +PerlSetVar IncludesDir /var/www/freeside </Directory> </pre></font> </ul></td> - <td><ul> - <li>Run <tt>make masondocs</tt> - <li>Copy <tt>masondocs/</tt> to your web server's document space. (For example: <tt>/usr/local/apache/htdocs/freeside-mason</tt>) - <li>Copy <tt>htetc/handler.pl</tt> to <tt>/usr/local/etc/freeside</tt> - <li>Edit <tt>handler.pl</tt> and: - <ul> - <li> set an appropriate <tt>comp_root</tt>, such as <tt>/usr/local/apache/htdocs/freeside-mason</tt> - <li> set an appropriate <tt>data_dir</tt>, such as <tt>/usr/local/etc/freeside/masondata</tt> - </ul> - - <li>Configure Apache to use the <tt>handler.pl</tt> file and to execute .cgi files using HTML::Mason. For example, add something like the following to your Apache httpd.conf file, adjusting for your actual paths: + <td valign="top"><ul> + <li>Configure Apache: <font size="-1"><pre> PerlModule HTML::Mason -<Directory /usr/local/apache/htdocs/freeside-mason> +# your freeside docuemnt root +<Directory /var/www/freeside> <Files ~ (\.cgi|\.html)> AddHandler perl-script .cgi .html PerlHandler HTML::Mason @@ -177,7 +157,8 @@ require "/usr/local/etc/freeside/handler.pl"; <ul> <li>Restrict access to this web interface - see the <a href="http://httpd.apache.org/docs/misc/FAQ.html#user-authentication">Apache documentation on user authentication</a>. For example, to configure user authentication with <a href="http://httpd.apache.org/docs/mod/mod_auth.html">mod_auth</a> (flat files), add something like the following to your Apache httpd.conf file, adjusting for your actual paths: <pre> -<Directory /usr/local/apache/htdocs/freeside-asp> +#your freeside document root +<Directory /var/www/freeside> AuthName Freeside AuthType Basic AuthUserFile /usr/local/etc/freeside/htpasswd @@ -193,7 +174,7 @@ $ <a href="man/bin/freeside-adduser.html">freeside-adduser</a> -c -h /usr/local/ <pre>$ su $ <a href="man/bin/freeside-adduser.html">freeside-adduser</a> -h /usr/local/etc/freeside/htpasswd <i>username</i></pre></font> </ul> - <i>(using other auth types, add each user to your <a href="http://httpd.apache.org/docs/misc/FAQ.html#user-authentication">Apache authentication</a> and then run: <tt>freeside-adduser <b>username</b></tt></i> + <i>(using other auth types, add each user to your <a href="http://httpd.apache.org/docs/misc/FAQ.html#user-authentication">Apache authentication</a> and then run: <tt>freeside-adduser <b>username</b></tt>)</i> <li>As the freeside UNIX user, run <tt>freeside-setup <b>username</b></tt> to create the database tables, passing the username of a Freeside user you created above: <pre> $ su freeside |