X-Git-Url: http://git.freeside.biz/gitweb/?a=blobdiff_plain;f=httemplate%2Fdocs%2Finstall.html;h=51dce4da57555ccb5d6644032ad32a4ee6d77ab3;hb=4063ea45f3ab0a9cb2582834e55ac3afc71425f9;hp=26fa34dd1bc8fed5ce2e5eb9182a63a40ce1e09e;hpb=eb7c552dd8290d6b33a4e026c5dc21ebf01105cf;p=freeside.git diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html index 26fa34dd1..51dce4da5 100644 --- a/httemplate/docs/install.html +++ b/httemplate/docs/install.html @@ -10,20 +10,20 @@ Before installing, you need:
-$ 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- (with MySQL:) +
$ make perl-modules @@ -110,7 +115,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/ @@ -122,6 +130,7 @@ 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 @@ -136,12 +145,14 @@ PerlSetVar Debug 2+
(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
- 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 @@ -159,7 +170,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 @@ -176,17 +186,19 @@ $ freeside-adduser -c -h /usr/local/ $ freeside-adduser -h /usr/local/etc/freeside/htpasswd username- As the freeside UNIX user, run bin/fs-setup username 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 -$ bin/fs-setup username +$ freeside-setup username-- As the freeside UNIX user, run bin/populate-msgcat username to populate the message catalog, passing the username of a Freeside user you created above: + 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:
$ su freeside +$ cd /path/to/freeside/ $ bin/populate-msgcat 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 system, and run make install-init. +
- 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.