- 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
or 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
or 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.