X-Git-Url: http://git.freeside.biz/gitweb/?a=blobdiff_plain;f=httemplate%2Fdocs%2Finstall.html;h=c95b41f5d6323af3c06c2e5009e9a4ec1193e734;hb=b8cfd0780aa40bb07f3215bf9cb58011f5e32a35;hp=3d19e4d35611e6699ffb195584983762887b3009;hpb=25fdab941288302f1aa8063d4e237f62876c59b8;p=freeside.git diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index 3d19e4d35..c95b41f5d 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -3,21 +3,22 @@

Installation

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

Before installing, you need: @@ -71,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: @@ -92,10 +94,9 @@ $ su 
     $ su freeside
 $ createdb freeside
    -
  • Build and install the Perl modules: 
     $ make perl-modules
@@ -106,54 +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. -
    • Create a Global directory, such as /usr/local/etc/freeside/asp-global/: +
      +
    • Configure Apache: 
      -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: -
      -<Directory /usr/local/apache/htdocs/freeside-asp>
-<Files ~ (\.cgi)>
-AddHandler perl-script .cgi
+PerlModule Apache::ASP
+# 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: 
      -<Directory /usr/local/apache/htdocs/freeside-mason>
-<Files ~ (\.cgi)>
-AddHandler perl-script .cgi
+PerlModule HTML::Mason
+# 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>
      @@ -161,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