X-Git-Url: http://git.freeside.biz/gitweb/?a=blobdiff_plain;f=httemplate%2Fdocs%2Finstall.html;h=1edd4b16c8baf73962133b857d729f17281e480e;hb=65f2a86b2c239782f209b481744915f858530598;hp=f2db59f88668f06f6a8dd10c74c60d3ab2ff6363;hpb=edda09a317f5dfef05fb8906f28531ec6f4b0927;p=freeside.git
diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html
index f2db59f88..1edd4b16c 100644
--- a/httemplate/docs/install.html
+++ b/httemplate/docs/install.html
@@ -11,7 +11,7 @@ Before installing, you need:
Perl Don't enable experimental features like threads or the PerlIO abstraction layer.
A transactional database engine supported by Perl's DBI.
Perl modules (CPAN will query, download and build perl modules automatically)
@@ -36,14 +36,17 @@ Before installing, you need:
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
+ Time-Duration
Install the Freeside distribution:
@@ -53,7 +56,7 @@ Install the Freeside distribution:
- with PostgreSQL:
-$ su freeside
+$ su postgres
$ createuser -P freeside
- with MySQL:
@@ -65,13 +68,20 @@ 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:
$ su
# make create-database
- - Build and install the Perl libraries:
+ (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
@@ -103,11 +113,11 @@ PerlHandler Apache::ASP
$MLDBM::RemoveTaint = 1;
</Perl>
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.
@@ -138,16 +148,16 @@ AuthUserFile /usr/local/etc/freeside/htpasswd
require valid-user
</Directory>
-
- Create one or more Freeside users (your internal sales/tech folks, not customer accounts). These users are setup using using Apache authentication; they're not UNIX user accounts. For example, using mod_auth (flat files):
+
- Create one or more Freeside users (your internal sales/tech folks, not customer accounts). These users are setup using using Apache authentication, not UNIX user accounts. For example, using mod_auth (flat files):
- First user:
$ su
-$ freeside-adduser -h /usr/local/etc/freeside/htpasswd -c /usr/local/etc/freeside/secrets username
+$ freeside-adduser -c -h /usr/local/etc/freeside/htpasswd username
- Additional users:
$ su
-$ freeside-adduser -h /usr/local/etc/freeside/htpasswd /usr/local/etc/freeside/secrets username
+$ freeside-adduser -h /usr/local/etc/freeside/htpasswd username
- (using other auth types, add each user to your Apache authentication yand then run: freeside-adduser /usr/local/etc/freeside/secrets 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:
$ su freeside
|