X-Git-Url: http://git.freeside.biz/gitweb/?a=blobdiff_plain;ds=sidebyside;f=htdocs%2Fdocs%2Finstall.html;h=61eec08d8146fb00c60c1505bab828b83cd3d68b;hb=15f65a0c56cbce6951d9cb4f71119725a2009f79;hp=f38b89e3bd3fbe563ae35b206b3e5682a0d0adc5;hpb=5c797603d68f5a240a49e0082508a96fc2a1cd8e;p=freeside.git
diff --git a/htdocs/docs/install.html b/htdocs/docs/install.html
index f38b89e3b..61eec08d8 100644
--- a/htdocs/docs/install.html
+++ b/htdocs/docs/install.html
@@ -6,20 +6,21 @@
Before installing, you need:
- A web server, such as Apache-SSL or Apache
-
- SSH
+
- SSH
- Perl (at least 5.004_05 for the 5.004 series or 5.005_03 for the 5.005 series. Don't enable experimental features like threads or the PerlIO abstraction layer.)
-
- A database engine supported by Perl's DBI, such as MySQL or PostgreSQL (see the PostgreSQL notes)
-
- Perl modules
+
- 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.
+
- Perl modules (CPAN will query, download and build perl modules automatically)
@@ -36,8 +38,14 @@ Before installing, you need:
Install the Freeside distribution:
- Add the user `freeside' to your system.
-
- Add the freeside database to your database engine. (with MySQL) (with PostgreSQL)
-
- Allow the freeside user full access to the freeside database. (with MySQL) (with PostgreSQL)
+
- Add the freeside database to your database engine. (with MySQL) (with PostgreSQL)
+
- Allow the freeside user full access to the freeside database.
+
+ - 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
+
- Unpack the tarball:
gunzip -c fs-x.y.z.tar.gz | tar xvf -
- Build and install the Perl libraries:
@@ -48,7 +56,7 @@ $ su
# make install
- Copy or link fs-x.y.z/htdocs to your web server's document space.
mkdir /usr/local/apache/htdocs/freeside
cp -r fs-x.y.z/htdocs/* /usr/local/apache/htdocs/freeside
or ln -s /full/path/to/fs-x.y.z/htdocs /usr/local/apache/htdocs/freeside
- - Restrict access to this web interface. (with Apache)
+
- Restrict access to this web interface. (with Apache)
- Enable CGI execution for files with the `.cgi' extension. (with Apache)
- Set ownership and permissions for the web interface. The web interface needs to run as the freeside user - there are several ways to do this.
@@ -69,5 +77,6 @@ chmod 755 browse/*.cgi edit/*.cgi edit/process/*.cgi misc/*.cgi misc/process/*.c
- 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.
+
- Now proceed to the initial administration of your installation.