From: ivan Date: Fri, 18 Sep 1998 02:07:23 +0000 (+0000) Subject: Initial revision X-Git-Tag: freeside_1_2_0~261 X-Git-Url: http://git.freeside.biz/gitweb/?p=freeside.git;a=commitdiff_plain;h=361f95491952b2d968152ca50a94c7eec56610b1 Initial revision --- diff --git a/htdocs/docs/install.html b/htdocs/docs/install.html new file mode 100644 index 000000000..c4784ebf6 --- /dev/null +++ b/htdocs/docs/install.html @@ -0,0 +1,56 @@ + + Installation + + +

Installation

+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 +
- MIME-Base64 +
- Data-Dumper +
- MD5 +
- libnet +
- libwww-perl +
- CGI-modules (NOT CGI.pm) with this patch applied +
- Business-CreditCard +
- Data-ShowTable +
- MailTools +
- TimeDate +
- DateManip +
- File-CounterFile +
- FreezeThaw +
- DBI +
- DBD for your database engine +
+

+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) +
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

ln -s /full/path/to/fs-x.y.z/site_perl /usr/local/lib/site_perl/FS

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

ln -s /full/path/to/fs-x.y.z/htdocs /usr/local/apache/htdocs/freeside

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. +
```
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. +