X-Git-Url: http://git.freeside.biz/gitweb/?a=blobdiff_plain;f=htdocs%2Fdocs%2Finstall.html;h=d94ffe7fa81194d5e54181c605398ebf0deca915;hb=069f8453eb624a0d4a77734aca8bc9367dbb60e6;hp=c4784ebf6b565ac0f05a9e1a11dee879e6f2df18;hpb=96df1d26951db4d9650da92e06e6ab79bacc5ba5;p=freeside.git
diff --git a/htdocs/docs/install.html b/htdocs/docs/install.html
index c4784ebf6..d94ffe7fa 100644
--- a/htdocs/docs/install.html
+++ b/htdocs/docs/install.html
@@ -6,51 +6,79 @@
Before installing, you need:
- A web server, such as Apache-SSL or Apache
-
- SSH
-
- agrep from the Glimpse distribution, if you want fuzzy searching capability
-
- Perl (at least 5.004_04)
-
- A database engine supported by Perl's DBI, such as MySQL or PostgreSQL
-
- Perl modules
+
- SSH
+
- 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.
+
- Perl modules (CPAN will query, download and build perl modules automatically)
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)
+
- 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
+
+ - 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 -
- - 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 UNINST=1
- 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. Your system should support secure setuid scripts or Perl's emulation, see perlsec: Security Bugs for information and workarounds.
+
- 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.
+
+ - Use Perl's setuid emulation: see the Security Bugs section of the perlsec manpage.
cd /usr/local/apache/htdocs/freeside
chown -R freeside .
chmod 4755 browse/*.cgi edit/*.cgi edit/process/*.cgi misc/*.cgi misc/process/*.cgi search/*.cgi view/*.cgi
- - Create the base Freeside directory `/var/spool/freeside', and the subdirectories `conf', `counters', and `export'.
mkdir /var/spool/freeside
-mkdir /var/spool/freeside/conf
-mkdir /var/spool/freeside/counters
-mkdir /var/spool/freeside/export
-chown -R freeside /var/spool/freeside
- - Create the necessary configuration files.
-
- Run bin/fs-setup to create the database tables.
+
- Use Apache's suEXEC.
+
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. 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 (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.