Installation

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

Before installing, you need: Install the Freeside distribution:
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, add something like the following to your Apache httpd.conf file, adjusting for your actual paths:
    PerlModule Apache::ASP
    # your freeside document root
    <Directory /usr/local/apache/htdocs/freeside-asp>
    <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 RequestBinaryRead Off
    # your freeside document root
    PerlSetVar IncludesDir /usr/local/apache/htdocs/freeside-asp
    </Directory>
    
  • Run make masondocs
  • Copy masondocs/ to your web server's document space. (For example: /usr/local/apache/htdocs/freeside-mason)
  • Copy htetc/handler.pl to /usr/local/etc/freeside
  • Edit handler.pl and:
    • set an appropriate comp_root, such as /usr/local/apache/htdocs/freeside-mason
    • set an appropriate data_dir, such as /usr/local/etc/freeside/masondata
  • Configure Apache to use the handler.pl 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:
    PerlModule HTML::Mason
    <Directory /usr/local/apache/htdocs/freeside-mason>
    <Files ~ (\.cgi|\.html)>
    AddHandler perl-script .cgi .html
    PerlHandler HTML::Mason
    </Files>
    <Perl>
    require "/usr/local/etc/freeside/handler.pl";
    </Perl>
    </Directory>