X-Git-Url: http://git.freeside.biz/gitweb/?a=blobdiff_plain;f=httemplate%2Fdocs%2Finstall.html;h=0f3796c6ce22960da2eca165f9af1189231cb6e8;hb=7e3eb82f87c371785544b706b7347c7edde2b593;hp=20bb168dfff633c55793ed7d84a8ff0b217b1231;hpb=6991d4986df7fb3a6c7c49b5ae1b3713e87a16c4;p=freeside.git diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index 20bb168df..0f3796c6c 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -32,21 +32,21 @@ Before installing, you need:
  • MailTools
  • TimeDate
  • DateManip -
  • Time-Duration
  • File-CounterFile
  • FreezeThaw
  • String-Approx
  • Text-Template
  • Archive-Tar
  • DBI -
  • DBD for your database engine +
  • DBD for your database engine (DBD::Pg for PostgreSQL, DBD::mysql for MySQL)
  • DBIx-DataSource
  • DBIx-DBSchema
  • Net-SSH
  • String-ShellQuote
  • Net-SCP
  • Apache::ASP or HTML::Mason -
  • Tie-IxHash +
  • Tie-IxHash +
  • Time-Duration Install the Freeside distribution: @@ -57,7 +57,12 @@ Install the Freeside distribution:
  • with PostgreSQL:
     $ su postgres
    -$ createuser -P freeside
    +$ createuser -P freeside +Enter password for user "freeside": +Enter it again: +Shall the new user be allowed to create databases? (y/n) y +Shall the new user be allowed to create more new users? (y/n) n +CREATE USER
  • with MySQL:
     $ mysqladmin -u root password 'set_a_root_database_password'
    @@ -68,7 +73,7 @@ mysql> GRANT SELECT,INSERT,UPDATE,DELETE,INDEX,ALTER,CREATE,DROP on freeside.* T
       
  • Edit the top-level Makefile:
    • Set DATASOURCE to your DBI data source, for example, DBI:Pg:host=localhost;dbname=freeside for PostgresSQL or DBI:mysql:freeside for MySQL. See the DBI manpage and the manpage for your DBD for the exact syntax of a DBI data source. -
    • Set DB_ADMIN_PASSWORD to the freeside database user's password. +
    • Set DB_PASSWORD to the freeside database user's password.
  • Add the freeside database to your database engine:
    @@ -101,10 +106,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
    @@ -112,26 +120,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>