From 51984ac3d3da3006809c6866fdecd4ad83610731 Mon Sep 17 00:00:00 2001 From: ivan Date: Mon, 30 Jul 2001 07:36:04 +0000 Subject: templates!!! --- httemplate/docs/install.html | 121 +++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 121 insertions(+) create mode 100644 httemplate/docs/install.html (limited to 'httemplate/docs/install.html') diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html new file mode 100644 index 000000000..d61dc9dfa --- /dev/null +++ b/httemplate/docs/install.html @@ -0,0 +1,121 @@ + + Installation + + +

Installation

+Before installing, you need: +

A web server, such as Apache-SSL or Apache +
mod_perl +
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) +
- Array-PrintCols +
- Term-Query (make test broken; install manually) +
- MIME-Base64 +
- Digest-MD5 +
- URI +
- HTML-Tagset +
- HTML-Parser +
- libnet +
- Locale-Codes +
- Net-Whois +
- libwww-perl +
- Business-CreditCard +
- Data-ShowTable +
- MailTools +
- TimeDate +
- DateManip +
- File-CounterFile +
- FreezeThaw +
- String-Approx +
- Text-Template +
- DBI +
- DBD for your database engine +
- DBIx-DBSchema +
- Net-SSH +
- String-ShellQuote +
- Net-SCP +
- Apache::ASP or HTML::Mason +
+

+Install the Freeside distribution: +

Add the user `freeside' to your system. +

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

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

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. The web interface needs to run as the freeside user - there are several ways to do this. +
You should run a separate iteration of Apache[-SSL] with mod_perl enabled as the freeside user. +

+ + + + + + + + +

Apache::ASP Mason

Apache::ASP	Mason
+ Run `make aspdocs` + Copy `aspdocs/` to your web server's document space. + Create a Global directory, such as `/usr/local/etc/freeside/asp-global/` + Copy `htetc/global.asa` to the Global directory. + Configure Apache for the Global directory and to execute .cgi files using Apache::ASP. For example: + +<Directory /usr/local/apache/htdocs/freeside-asp> +<Files ~ (\.cgi)> +AddHandler perl-script .cgi +PerlHandler Apache::ASP +</Files> +<Perl> +$MLDBM::RemoveTaint = 1; +</Perl> +PerlSetVar Global /usr/local/etc/freeside/asp-global/ +</Directory> + +	+ Run `make masondocs` + Copy `masondocs/` to your web server's document space. + Copy `htetc/handler.pl` to your web server's configuration directory. + Edit `handler.pl` and set an appropriate `data_dir`, such as `/usr/local/etc/freeside/mason-data` + Configure Apache to use the `handler.pl` file and to execute .cgi files using HTML::Mason. For example: + +<Directory /usr/local/apache/htdocs/freeside-mason> +<Files ~ (\.cgi)> +AddHandler perl-script .cgi +PerlHandler HTML::Mason +</Files> +<Perl> +require "/usr/local/apache/conf/handler.pl"; +</Perl> +</Directory> + +

Run make aspdocs +
Copy aspdocs/ to your web server's document space. +
Create a Global directory, such as /usr/local/etc/freeside/asp-global/ +
Copy htetc/global.asa to the Global directory. +

Configure Apache for the Global directory and to execute .cgi files using Apache::ASP. For example: +

+<Directory /usr/local/apache/htdocs/freeside-asp>
+<Files ~ (\.cgi)>
+AddHandler perl-script .cgi
+PerlHandler Apache::ASP
+</Files>
+<Perl>
+$MLDBM::RemoveTaint = 1;
+</Perl>
+PerlSetVar Global /usr/local/etc/freeside/asp-global/
+</Directory>
+

Run make masondocs +
Copy masondocs/ to your web server's document space. +
Copy htetc/handler.pl to your web server's configuration directory. +
Edit handler.pl and set an appropriate data_dir, such as /usr/local/etc/freeside/mason-data +

Configure Apache to use the handler.pl file and to execute .cgi files using HTML::Mason. For example: +

+<Directory /usr/local/apache/htdocs/freeside-mason>
+<Files ~ (\.cgi)>
+AddHandler perl-script .cgi
+PerlHandler HTML::Mason
+</Files>
+<Perl>
+require "/usr/local/apache/conf/handler.pl";
+</Perl>
+</Directory>
+

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

+ -- cgit v1.2.1