X-Git-Url: http://git.freeside.biz/gitweb/?p=freeside.git;a=blobdiff_plain;f=httemplate%2Fdocs%2Finstall.html;h=ed306f2d38b09ac5e83d33f5e803ad4c904970f8;hp=e6f4edbbcebff488e59e721b00b53135ca93075a;hb=d384acea721092aebd4ffd972a2c3a80208e80ae;hpb=eb0d04842631ae16247c6246cc6a1d8896169ff9 diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index e6f4edbbc..ed306f2d3 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -3,21 +3,22 @@
--default-table-type=BDB
or --default-table-type=InnoDB
mysqld command-line option or by setting default-table-type=BDB
or default-table-type=InnoDB
in the my.cnf option file.
-$ su postgres +$ su postgres (pgsql on some distributions) $ 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-
$ su freeside $ createdb freeside-
$ make perl-modules @@ -114,7 +114,10 @@ $ su
- Run make aspdocs -
- Copy aspdocs/ to your web server's document space. +
- 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/ @@ -126,34 +129,41 @@ 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:
+PerlModule Apache::ASP <Directory /usr/local/apache/htdocs/freeside-asp> -<Files ~ (\.cgi)> -AddHandler perl-script .cgi +<Files ~ (\.cgi|\.html)> +SetHandler perl-script PerlHandler Apache::ASP </Files> <Perl> $MLDBM::RemoveTaint = 1; </Perl> PerlSetVar Global /usr/local/etc/freeside/asp-global/ -PerlSetVar Debug 2 +PerlSetVar Debug 2 +PerlSetVar RequestBinaryRead Off </Directory>-
(using other auth types, add each user to your Apache authentication and then run: freeside-adduser username -- (use version 1.0x - Freeside is not yet compatible with version 1.1x)
- 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 +
- 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:
+PerlModule HTML::Mason <Directory /usr/local/apache/htdocs/freeside-mason> -<Files ~ (\.cgi)> -AddHandler perl-script .cgi +<Files ~ (\.cgi|.html)> +SetHandler perl-script PerlHandler HTML::Mason </Files> <Perl> -require "/usr/local/apache/conf/handler.pl"; +require "/usr/local/etc/freeside/handler.pl"; </Perl> </Directory>@@ -164,7 +174,6 @@ require "/usr/local/apache/conf/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):
<Directory /usr/local/apache/htdocs/freeside-asp> -PerlSetVar Global /usr/local/etc/freeside/asp-global/ AuthName Freeside AuthType Basic AuthUserFile /usr/local/etc/freeside/htpasswd @@ -181,7 +190,7 @@ $ freeside-adduser -c -h /usr/local/ $ freeside-adduser -h /usr/local/etc/freeside/htpasswd usernameAs the freeside UNIX user, run freeside--setup username (in the untar'ed freeside directory) to create the database tables, passing the username of a Freeside user you created above: + 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 @@ -190,7 +199,7 @@ $ freeside-setup usernameAs 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: $ su freeside -$ cd /path/to/freeside-1.4.0/ +$ cd /path/to/freeside/ $ bin/populate-msgcat usernamefreeside-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)