From a496b337f8a6946cd100e4daea9f2692536ea9ce Mon Sep 17 00:00:00 2001 From: ivan Date: Sun, 7 Nov 2004 22:58:21 +0000 Subject: [PATCH] update install documentation for 1.5 HTML::Mason or Apache::ASP install --- ANNOUNCE.1.5.0 | 13 +++++++------ httemplate/docs/install.html | 45 +++++++++++++------------------------------- 2 files changed, 20 insertions(+), 38 deletions(-) diff --git a/ANNOUNCE.1.5.0 b/ANNOUNCE.1.5.0 index 46204b8bf..59f1db1f0 100644 --- a/ANNOUNCE.1.5.0 +++ b/ANNOUNCE.1.5.0 @@ -9,15 +9,16 @@ - reseller interface 1.5.0pre6: -- cust_pay_refund and credit card/ACH refunds w/supported processor -- proper payment receipts (not invoice copies) -- expanded reseller interface - RADIUS session viewing +- Major updates for reseller interface +- Credit card and ACH refunds (w/supported processor module) +- Proper email payment receipts (not invoice copies) - modular price plans, rewrote package add/edit page -- fixed up tax report - should be correct for all edge cases with named taxes, +- fixed up tax report - should be correct for edge cases with named taxes, tax classes, etc. -- some documentation updates +- Documentation updates 1.5.0pre7: +- fix bug that could cause mis-billing on upgrades! (new installs ok) +- update install documentation for 1.5 HTML::Mason or Apache::ASP install - historical late notice viewing in web interface - 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
  • 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, add something like the following to your Apache httpd.conf file, adjusting for your actual paths: +
      +
    • Configure Apache:
       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>
       
      -
    • 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: +
      +
    • Configure Apache:
       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";
       
      • Restrict access to this web interface - see the Apache documentation on user authentication. For example, to configure user authentication with mod_auth (flat files), add something like the following to your Apache httpd.conf file, adjusting for your actual paths:
        -<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 @@ $ freeside-adduser -c -h /usr/local/
         
        $ su
         $ freeside-adduser -h /usr/local/etc/freeside/htpasswd username
      - (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
      -- 
      2.11.0