X-Git-Url: http://git.freeside.biz/gitweb/?a=blobdiff_plain;f=httemplate%2Fdocs%2Finstall.html;h=c95b41f5d6323af3c06c2e5009e9a4ec1193e734;hb=a496b337f8a6946cd100e4daea9f2692536ea9ce;hp=df353eb9dff7f113f38cde4de273f40615e5a585;hpb=2a7c870a444759b248b273483bf50a433ed8c490;p=freeside.git diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index df353eb9d..c95b41f5d 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -48,7 +48,7 @@ Before installing, you need:
  • Net-SSH
  • String-ShellQuote
  • Net-SCP -
  • Apache::ASP or HTML::Mason +
  • HTML::Mason (recommended, enables full functionality) or Apache::ASP (deprecated, integrated RT ticketing will not be available)
  • Tie-IxHash
  • Time-Duration
  • HTML-Widgets-SelectLayers @@ -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