X-Git-Url: http://git.freeside.biz/gitweb/?p=freeside.git;a=blobdiff_plain;f=httemplate%2Fdocs%2Finstall.html;h=b739af02c5021813325287cf5c5ac8fda271d761;hp=6861a173eb713d50b66bf84d51edfeb4d24b7d48;hb=d7a1a7154a401edfbc4844721c08cb6f483d59b7;hpb=68a1b014aea963c2c94316fa34ec9a5dd135d102 diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index 6861a173e..b739af02c 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -9,7 +9,14 @@ Before installing, you need:
  • mod_perl
  • SSH (OpenSSH is recommended. SSH Communications Security commercial SSH version 3 has been reported incompatible with Freeside.)
  • Perl Don't enable experimental features like threads or the PerlIO abstraction layer. -
  • A transactional database engine supported by Perl's DBI. PostgreSQL is recommended. MySQL's default MyISAM and ISAM table types are not supported. If you really want to use MySQL, you need to use one of the new transaction-safe table types such as BDB, and set it as the default table type using the --default-table-type=BDB mysqld command-line option or by setting default-table-type=DBD in the my.cnf option file. +
  • A transactional database engine supported by Perl's DBI. +
  • Perl modules (CPAN will query, download and build perl modules automatically) Install the Freeside distribution: @@ -46,20 +57,47 @@ Install the Freeside distribution:
  • Add the user `freeside' to your system.
  • Allow the freeside user full access to the freeside database. -
  • Add the freeside database to your database engine. (with MySQL) (with PostgreSQL)
  • Unpack the tarball: 
    gunzip -c fs-x.y.z.tar.gz | tar xvf -
    -
  • Build and install the Perl libraries: +
  • Edit the top-level Makefile: + +
  • Add the freeside database to your database engine: 
    -$ cd FS/
-$ perl Makefile.PL
-$ make
 $ su
-# make install UNINST=1
    +# make create-database + (or manually, with Postgres:) + 
    +$ su freeside
+$ createdb freeside
    + (with MySQL:) + 
    +$ mysqladmin -u freeside -p create freeside
    +
  • Build and install the Perl modules: + 
    +$ make perl-modules
+$ su
+# make install-perl-modules
    +
  • Create the necessary configuration files:
    +$ su
+# make create-config
+
  • You should run a separate iteration of Apache[-SSL] with mod_perl enabled as the freeside user. @@ -71,10 +109,13 @@ $ su
  • Run make aspdocs
  • Copy aspdocs/ to your web server's document space.
  • Create a Global directory, such as /usr/local/etc/freeside/asp-global/ -
  • Copy htetc/global.asa to the Global directory. +
  • 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>
+<Directory /usr/local/apache/htdocs/freeside-asp>
 <Files ~ (\.cgi)>
 AddHandler perl-script .cgi
 PerlHandler Apache::ASP
@@ -82,25 +123,25 @@ PerlHandler Apache::ASP
 <Perl>
 $MLDBM::RemoveTaint = 1;
 </Perl>
-PerlSetVar Global /usr/local/etc/freeside/asp-global/
+PerlSetVar Global /usr/local/etc/freeside/asp-global/
+PerlSetVar Debug 2
 </Directory>
      • -
    • NOTE: Mason support is still a bit buggy in the 1.4.0 prereleases. This will be fixed before 1.4.0. You have been warned.
    • 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: 
      -<Directory /usr/local/apache/htdocs/freeside-mason>
+<Directory /usr/local/apache/htdocs/freeside-mason>
 <Files ~ (\.cgi)>
 AddHandler perl-script .cgi
 PerlHandler HTML::Mason
 </Files>
 <Perl>
-require "/usr/local/apache/conf/handler.pl";
+require "/usr/local/apache/conf/handler.pl";
 </Perl>
 </Directory>
      @@ -108,13 +149,32 @@ require "/usr/local/apache/conf/handler.pl";