From 160be29a0dc62e79a4fb95d2ab8c0c7e5996760e Mon Sep 17 00:00:00 2001 From: cvs2git Date: Mon, 12 Aug 2002 06:17:10 +0000 Subject: This commit was manufactured by cvs2svn to create branch 'BESTPRACTICAL'. --- httemplate/docs/install.html | 198 ------------------------------------------- 1 file changed, 198 deletions(-) delete mode 100644 httemplate/docs/install.html (limited to 'httemplate/docs/install.html') diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html deleted file mode 100644 index 75f039dd1..000000000 --- a/httemplate/docs/install.html +++ /dev/null @@ -1,198 +0,0 @@ - - Installation - - -

Installation

-Before installing, you need: -

Perl Don't enable experimental features like threads or the PerlIO abstraction layer. -
Apache (mod_ssl or Apache-SSL highly recommended) -
mod_perl (if compiling your own mod_perl, make sure you set the EVERYTHING=1 compile-time option) -
SSH (OpenSSH is recommended. SSH Communications Security commercial SSH version 3 has been reported incompatible with Freeside.) -
rsync -
A transactional database engine supported by Perl's DBI. -
- PostgreSQL (v7 or higher) is recommended. -
- MySQL versions before 4.1 do not support standard SQL subqueries and are NOT SUPPORTED. If you are a developer who wishes to contribute MySQL 3.x/4.0 support, see ticket #438 in the bug-tracking system and ask on the -devel mailing list. - -
-
Perl modules (CPAN will query, download and build perl modules automatically) -
- MIME-Base64 -
- Digest-MD5 - -
- URI -
- HTML-Tagset -
- HTML-Parser -
- libnet -
- Locale-Codes -
- Net-Whois -
- libwww-perl -
- Business-CreditCard - -
- MailTools -
- TimeDate -
- DateManip -
- File-CounterFile -
- FreezeThaw -
- String-Approx -
- Text-Template -
- DBI -
- DBD for your database engine (DBD::Pg for PostgreSQL) -
- DBIx-DataSource -
- DBIx-DBSchema -
- Net-SSH -
- String-ShellQuote -
- Net-SCP -
- Apache::ASP or HTML::Mason (use version 1.0x - Freeside is not yet compatible with version 1.1x) -
- Tie-IxHash -
- Time-Duration -
- HTML-Widgets-SelectLayers -
- Storable - -
- Apache::DBI (optional but recommended for better webinterface performance) -
-

-Install the Freeside distribution: -

Add the user and group `freeside' to your system. -

Allow the freeside user full access to the freeside database. -

with PostgreSQL: -

-$ su postgres
-$ createuser -P freeside
-Enter password for user "freeside": 
-Enter it again: 
-Shall the new user be allowed to create databases? (y/n) y
-Shall the new user be allowed to create more new users? (y/n) n
-CREATE USER

- -

Edit the top-level Makefile: -
- Set DATASOURCE to your DBI data source, for example, DBI:Pg:host=localhost;dbname=freeside for PostgresSQL. See the DBI manpage and the manpage for your DBD for the exact syntax of your DBI data source. -
- Set DB_PASSWORD to the freeside database user's password. -
-
Add the freeside database to your database engine: -
```
-$ su
-# make create-database
```
- (or manually, with Postgres:) -
```
-$ su freeside
-$ createdb freeside
```
- -

Build and install the Perl modules: -

-$ make perl-modules
-$ su
-# make install-perl-modules

Create the necessary configuration files:
```
-$ su
-# make create-config
-
```
-
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/`: - -mkdir /usr/local/etc/freeside/asp-global/ -chown freeside /usr/local/etc/freeside/asp-global/ - - Copy `htetc/global.asa` to the Global directory: - -cp htetc/global.asa /usr/local/etc/freeside/asp-global/global.asa - - 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/ -PerlSetVar Debug 2 -</Directory> - -	- (use version 1.0x - Freeside is not yet compatible with version 1.1x) - 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/: -

-mkdir /usr/local/etc/freeside/asp-global/
-chown freeside /usr/local/etc/freeside/asp-global/
-

Copy htetc/global.asa to the Global directory: -

-cp htetc/global.asa /usr/local/etc/freeside/asp-global/global.asa
-

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/
-PerlSetVar Debug 2
-</Directory>
-

(use version 1.0x - Freeside is not yet compatible with version 1.1x) -
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>
-

Restrict access to this web interface - see the Apache documentation on user authentication. For example, to configure user authentication with mod_auth (flat files): -

-<Directory /usr/local/apache/htdocs/freeside-asp>
-PerlSetVar Global /usr/local/etc/freeside/asp-global/
-AuthName Freeside
-AuthType Basic
-AuthUserFile /usr/local/etc/freeside/htpasswd
-require valid-user
-</Directory>
-

Create one or more Freeside users (your internal sales/tech folks, not customer accounts). These users are setup using using Apache authentication, not UNIX user accounts. For example, using mod_auth (flat files): -
- First user:
  -
```
$ su
-$ freeside-adduser -c -h /usr/local/etc/freeside/htpasswd username
```
  -
- Additional users:
  -
```
$ su
-$ freeside-adduser -h /usr/local/etc/freeside/htpasswd username
```
  -
- (using other auth types, add each user to your Apache authentication and then run: freeside-adduser username -
As the freeside UNIX user, run bin/fs-setup username (in the untar'ed freeside directory) to create the database tables, passing the username of a Freeside user you created above: -
```
-$ su freeside
-$ cd /path/to/freeside-1.4.0/
-$ bin/fs-setup username
-
```
-
As the freeside UNIX user, run bin/populate-msgcat username (in the untar'ed freeside directory) to populate the message catalog, passing the username of a Freeside user you created above: -
```
-$ su freeside
-$ cd /path/to/freeside-1.4.0/
-$ bin/populate-msgcat username
-
```
-
freeside-queued was installed with the Perl modules. Start it now and ensure that is run upon system startup (Do this manually, or edit the top-level Makefile, replacing INIT_FILE with the appropriate location on your systemand QUEUED_USER with the username of a Freeside user you created above, and run make install-init) -
Now proceed to the initial administration of your installation. -

- -- cgit v1.2.1