X-Git-Url: http://git.freeside.biz/gitweb/?p=freeside.git;a=blobdiff_plain;f=httemplate%2Fdocs%2Finstall.html;h=2ad75b15e8ebea97cc3ea3d0f55bf7f9a3f64659;hp=8d5785f501aac89491037508fd67313d0a3fb8ae;hb=8fc4118f1f055195d280b3250b39a3b5fcdf13dc;hpb=381ea36d912fe0aec54918c03f3a88eacab64460
diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html
index 8d5785f50..2ad75b15e 100644
--- a/httemplate/docs/install.html
+++ b/httemplate/docs/install.html
@@ -5,14 +5,18 @@
Installation
Before installing, you need:
Install the Freeside distribution:
@@ -55,18 +63,23 @@ 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'
$ mysql -u root -p
mysql> GRANT SELECT,INSERT,UPDATE,DELETE,INDEX,ALTER,CREATE,DROP on freeside.* TO freeside@localhost IDENTIFIED BY 'set_a_freeside_database_password';
- Unpack the tarball: gunzip -c fs-x.y.z.tar.gz | tar xvf -
+
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:
@@ -88,7 +101,7 @@ $ su
$ su
# make create-config
- You should run a separate iteration of Apache[-SSL] with mod_perl enabled as the freeside user.
+ Run a separate iteration of Apache[-SSL] with mod_perl enabled as the freeside user.
@@ -98,11 +111,18 @@ $ 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.
+
- Create a Global directory, such as /usr/local/etc/freeside/asp-global/:
+
+mkdir /usr/local/etc/freeside/asp-global/
+chown freeside /usr/local/etc/freeside/asp-global/
+
+ - 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
@@ -110,25 +130,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>
@@ -150,10 +170,10 @@ require valid-user
- First user:
$ su
-$ freeside-adduser -c -h /usr/local/etc/freeside/htpasswd username
+$ freeside-adduser -c -h /usr/local/etc/freeside/htpasswd username
- Additional users:
$ su
-$ freeside-adduser -h /usr/local/etc/freeside/htpasswd username
+$ freeside-adduser -h /usr/local/etc/freeside/htpasswd username
(using other auth types, add each user to your Apache authentication and then run: freeside-adduser 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:
|