X-Git-Url: http://git.freeside.biz/gitweb/?p=freeside.git;a=blobdiff_plain;f=htdocs%2Fdocs%2Finstall.html;h=300104b2d02086f427d3694e75ecef16e05010b3;hp=6cf9677fd77a7cc31cbcc3b1fe92d2ffa4db2a68;hb=4c7f7284e84faca5404f609c8af0a50197edff96;hpb=5c519554565e024b5bf32a7ff6e78b0d468c6fa1
diff --git a/htdocs/docs/install.html b/htdocs/docs/install.html
index 6cf9677fd..300104b2d 100644
--- a/htdocs/docs/install.html
+++ b/htdocs/docs/install.html
@@ -6,15 +6,21 @@
Before installing, you need:
- A web server, such as Apache-SSL or Apache
-
- SSH
-
- Perl (at least 5.004_04)
-
- A database engine supported by Perl's DBI, such as MySQL or PostgreSQL
-
- Perl modules
+
- 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 (verstion 6.5 or higher) (see the PostgreSQL notes)
+
- Perl modules (CPAN will query, download and build perl modules automatically)
@@ -31,11 +38,22 @@ 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 -
- - Copy or link fs-x.y.z/site_perl to FS in your site_perl directory. (try `
perl -V
' if unsure) mkdir /usr/local/lib/site_perl/FS
-cp fs-x.y.z/site_perl/* /usr/local/lib/site_perl/FS
or ln -s /full/path/to/fs-x.y.z/site_perl /usr/local/lib/site_perl/FS
+ - Build and install the Perl libraries:
+
+$ cd FS/
+$ perl Makefile.PL
+$ make
+$ 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)
@@ -50,14 +68,14 @@ chmod 4755 browse/*.cgi edit/*.cgi edit/process/*.cgi misc/*.cgi misc/process/*.
cd /usr/local/apache/htdocs/freeside
chown -R freeside .
chmod 755 browse/*.cgi edit/*.cgi edit/process/*.cgi misc/*.cgi misc/process/*.cgi search/*.cgi view/*.cgi
- - Use mod_perl. You should run a separate iteration of Apache[-SSL] as the freeside user. (Warning: The redirect method of CGI.pm 2.36 [as distributed with Perl 5.004_04] is broken under mod_perl. Downlaod the current version from CPAN.)
+
- Use mod_perl. You should run a separate iteration of Apache[-SSL] as the freeside user. (Warning: The redirect method of CGI.pm 2.36 [as distributed with Perl 5.004_04] is broken under mod_perl. Downlaod the current version from CPAN. Apache 1.3.6 is also highly recommended because of signal handling problems in earlier versions.)
cd /usr/local/apache/htdocs/freeside
chown -R root .
chmod 755 browse/*.cgi edit/*.cgi edit/process/*.cgi misc/*.cgi misc/process/*.cgi search/*.cgi view/*.cgi
- Create the necessary configuration files.
- Create the `/usr/local/etc/freeside/counters.datasrc', and
- `/usr/local/etc/freeside/export.datasrc' directories for each datasrc.
+ `/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.