X-Git-Url: http://git.freeside.biz/gitweb/?a=blobdiff_plain;f=httemplate%2Fdocs%2Finstall.html;h=78172e8e47bd52accab486a6a011b89b80c05f24;hb=c509ea790c3d0631a0e1f79527ec937e419e380e;hp=4a89ab3baa1e4d7fd0289fcbb9319568bab1c603;hpb=34647c32b50ce3b8ee1b6d3d7aef4ba9d0297bdb;p=freeside.git diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index 4a89ab3ba..78172e8e4 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -14,58 +14,66 @@ Before installing, you need:
  • Optional, enables typeset invoices: teTeX and Ghostscript (included with most distributions).
  • A transactional database engine supported by Perl's DBI. + Note: the above only applies to the database used by the Freeside software itself. Freeside can integrate with RADIUS and other servers running MySQL or any other DBI-supported database.
  • Perl modules (CPAN will query, download and build perl modules automatically) Install the Freeside distribution: @@ -116,35 +124,7 @@ $ su
  • 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
      -
    • Configure Apache: -
      -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 RequestBinaryRead Off
      -# your freeside document root
      -PerlSetVar IncludesDir /var/www/freeside
      -</Directory>
      -
      -
      -
    • Configure Apache: +
    • Configure Apache:
       PerlModule HTML::Mason
       # your freeside docuemnt root
      @@ -158,10 +138,6 @@ require "/usr/local/etc/freeside/handler.pl";
       </Perl>
       </Directory>
       
      -
    - (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
    -$ freeside-setup username
    -
    - Alternately, use the -s option to enable shipping addresses: freeside-setup -s username -
  • As the freeside UNIX user, run bin/populate-msgcat username (in the untar'ed freeside directory) to populate the message catalog, passing the username of a Freeside user you created above: +
  • Create the Freeside system users: +
    $ su
    +# freeside-adduser fs_queue
    +# freeside-adduser fs_selfservice
    +
  • As the freeside UNIX user, run freeside-setup -d domain.name username to create the database tables and initial data, passing the username of a Freeside user you created above:
     $ su freeside
    -$ cd /path/to/freeside/
    -$ bin/populate-msgcat username
    +$ freeside-setup -d example.com username
     
  • freeside-queued was installed with the Perl modules. Start it now and ensure that is run upon system startup (Do this manually, or edit the top-level Makefile, replacing INIT_FILE with the appropriate location on your systemand QUEUED_USER with the username of a Freeside user you created above, and run make install-init)
  • Now proceed to the initial administration of your installation.