X-Git-Url: http://git.freeside.biz/gitweb/?a=blobdiff_plain;f=httemplate%2Fdocs%2Finstall.html;h=c95b41f5d6323af3c06c2e5009e9a4ec1193e734;hb=a496b337f8a6946cd100e4daea9f2692536ea9ce;hp=51dce4da57555ccb5d6644032ad32a4ee6d77ab3;hpb=66729728e57c13e44eaac51dc8deaf37e47b7530;p=freeside.git diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index 51dce4da5..c95b41f5d 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -3,9 +3,10 @@

Installation

+Note: Install Freeside on a firewalled, private server, not a public (web, RADIUS, etc.) server.

Before installing, you need: @@ -72,17 +74,16 @@ Enter it again: Shall the new user be allowed to create databases? (y/n) y Shall the new user be allowed to create more new users? (y/n) n CREATE USER -
  • Edit the top-level Makefile:
  • Add the freeside database to your database engine: @@ -93,10 +94,9 @@ $ su 
     $ su freeside
 $ createdb freeside
    -
  • Build and install the Perl modules: 
     $ make perl-modules
@@ -107,59 +107,47 @@ $ su
 # make create-config
  • Run a separate iteration of Apache[-SSL] with mod_perl enabled as the freeside user. +
  • Edit the Makefile and set TEMPLATE to asp or mason. Also set FREESIDE_DOCUMENT_ROOT. +
  • Run make install-docs. - -
    Apache::ASPMason
      -
    • Run make aspdocs -
    • Copy aspdocs/ to your web server's document space: -
      -cp aspdocs /usr/local/apache/htdocs/freeside-asp
-
       -
    • Create a Global directory, such as /usr/local/etc/freeside/asp-global/: -
      -mkdir /usr/local/etc/freeside/asp-global/
-chown freeside /usr/local/etc/freeside/asp-global/
-
       -
    • Copy htetc/global.asa to the Global directory: -
      -cp htetc/global.asa /usr/local/etc/freeside/asp-global/global.asa
-
       -
    • Configure Apache for the Global directory and to execute .cgi files using Apache::ASP. For example: +
      +
    • Configure Apache: 
       PerlModule Apache::ASP
-<Directory /usr/local/apache/htdocs/freeside-asp>
-<Files ~ (\.cgi)>
-AddHandler perl-script .cgi
+# your freeside document root
+<Directory /var/www/freeside>
+<Files ~ (\.cgi|\.html)>
+AddHandler perl-script .cgi .html
 PerlHandler Apache::ASP
 </Files>
 <Perl>
 $MLDBM::RemoveTaint = 1;
 </Perl>
 PerlSetVar Global /usr/local/etc/freeside/asp-global/
-PerlSetVar Debug 2
+PerlSetVar Debug 2
+PerlSetVar RequestBinaryRead Off
+# your freeside document root
+PerlSetVar IncludesDir /var/www/freeside
 </Directory>
      -
    • (use version 1.0x - Freeside is not yet compatible with version 1.1x) -
    • Run make masondocs -
    • Copy masondocs/ to your web server's document space. -
    • Copy htetc/handler.pl to your web server's configuration directory. -
    • Edit handler.pl and set an appropriate data_dir, such as /usr/local/etc/freeside/mason-data -
    • Configure Apache to use the handler.pl file and to execute .cgi files using HTML::Mason. For example: +
      +
    • Configure Apache: 
       PerlModule HTML::Mason
-<Directory /usr/local/apache/htdocs/freeside-mason>
-<Files ~ (\.cgi)>
-AddHandler perl-script .cgi
+# your freeside docuemnt root
+<Directory /var/www/freeside>
+<Files ~ (\.cgi|\.html)>
+AddHandler perl-script .cgi .html
 PerlHandler HTML::Mason
 </Files>
 <Perl>
-require "/usr/local/apache/conf/handler.pl";
+require "/usr/local/etc/freeside/handler.pl";
 </Perl>
 </Directory>
      @@ -167,9 +155,10 @@ require "/usr/local/apache/conf/handler.pl";
    - (using other auth types, add each user to your Apache authentication and then run: freeside-adduser username + (using other auth types, add each user to your Apache authentication and then run: freeside-adduser username)
  • As the freeside UNIX user, run freeside-setup username to create the database tables, passing the username of a Freeside user you created above: 
     $ su freeside