X-Git-Url: http://git.freeside.biz/gitweb/?a=blobdiff_plain;f=httemplate%2Fdocs%2Finstall.html;h=0bf2c1616e40bd5e3cdb5392f6a3bfdc43ccd3f3;hb=03dcc6e0f48fae0b892dbd36229884e684b94049;hp=f62ac4cf9f86fa1e988dfb93edc25767b6587d46;hpb=8c8e1e437e684c54dfbd846fb0997b30f4993131;p=freeside.git
diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html
index f62ac4cf9..0bf2c1616 100644
--- a/httemplate/docs/install.html
+++ b/httemplate/docs/install.html
@@ -7,9 +7,13 @@ Before installing, you need:
- A web server, such as Apache-SSL or Apache
- mod_perl
-
- SSH
+
- SSH (OpenSSH is recommended. SSH Communications Security commercial SSH version 3 has been reported incompatible with Freeside.)
- Perl Don't enable experimental features like threads or the PerlIO abstraction layer.
-
- A transactional database engine supported by Perl's DBI. PostgreSQL is recommended. (see the PostgreSQL notes) MySQL's default MyISAM and ISAM table types are not supported. If you really want to use MySQL, you need to use one of the new transaction-safe table types such as BDB.
+
- A transactional database engine supported by Perl's DBI.
+
- Perl modules (CPAN will query, download and build perl modules automatically)
- Array-PrintCols
@@ -32,8 +36,10 @@ Before installing, you need:
- FreezeThaw
- String-Approx
- Text-Template
+
- Archive-Tar
- DBI
- DBD for your database engine
+
- DBIx-DataSource
- DBIx-DBSchema
- Net-SSH
- String-ShellQuote
@@ -46,20 +52,35 @@ Install the Freeside distribution:
- Add the user `freeside' to your system.
- Allow the freeside user full access to the freeside database.
- - with MySQL:
$ mysqladmin -u root password 'set_a_root_database_password'
+
- with PostgreSQL:
+
+$ su postgres
+$ createuser -P freeside
+ - 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';
- - with PostgreSQL
- - Add the freeside database to your database engine. (with MySQL) (with PostgreSQL)
- Unpack the tarball:
gunzip -c fs-x.y.z.tar.gz | tar xvf -
- - Build and install the Perl libraries:
+
- 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.
+
+ - Add the freeside database to your database engine:
+
+$ su
+# make create-database
+ - Build and install the Perl modules:
-$ cd FS/
-$ perl Makefile.PL
-$ make
+$ make perl-modules
$ su
-# make install UNINST=1
+# make install-perl-modules
+ - Create the necessary configuration files:
+$ su
+# make create-config
+
- You should run a separate iteration of Apache[-SSL] with mod_perl enabled as the freeside user.
@@ -87,6 +108,7 @@ PerlSetVar Global /usr/local/etc/freeside/asp-global/
+ - 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.
@@ -107,11 +129,32 @@ require "/usr/local/apache/conf/handler.pl";
|
-- Restrict access to this web interface. (with Apache)
-
- Create the necessary configuration files.
-
- Create the `/usr/local/etc/freeside/counters.datasrc', and
- `/usr/local/etc/freeside/export.datasrc' directories for each datasrc (owned by the freeside user).
-
- As the freeside user, run bin/fs-setup to create the database tables.
+
- 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
+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, not UNIX user accounts. For example, using mod_auth (flat files):
+
+ - First user:
+
$ su
+$ freeside-adduser -c -h /usr/local/etc/freeside/htpasswd username
+ - Additional users:
+
$ su
+$ 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:
+
+$ su freeside
+$ bin/fs-setup username
+
+ - freeside-queued was installed with the Perl modules. Start it now and ensure that is run upon system startup.
- Now proceed to the initial administration of your installation.