X-Git-Url: http://git.freeside.biz/gitweb/?a=blobdiff_plain;f=httemplate%2Fdocs%2Finstall.html;h=d4507a2a5dae86dac886dd5b37a21678f2b4d898;hb=157e8bdba110b7aac022bd2c2f7b377d3c5b2f85;hp=ed419a1ca31ba8cdbe2a4ee8e2e894b44955f82f;hpb=60527016538d1794227983d99ce3b77c8fcd7426;p=freeside.git
diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html
index ed419a1ca..d4507a2a5 100644
--- a/httemplate/docs/install.html
+++ b/httemplate/docs/install.html
@@ -3,9 +3,10 @@
Installation
+Note: Install Freeside on a firewalled, private server, not a public (web, RADIUS, etc.) server.
Before installing, you need:
- Perl modules (CPAN will query, download and build perl modules automatically)
+ Perl modules (CPAN will query, download and build perl modules automatically)
@@ -29,7 +30,7 @@ Before installing, you need:
- HTML-Parser
- libnet
- Locale-Codes
-
- Net-Whois
+
- Net-Whois-Raw
- libwww-perl
- Business-CreditCard
@@ -47,7 +48,7 @@ Before installing, you need:
- Net-SSH
- String-ShellQuote
- Net-SCP
-
- Apache::ASP or HTML::Mason (use version 1.0x - Freeside is not yet compatible with version 1.1x)
+
- HTML::Mason (recommended, enables full functionality) or Apache::ASP (deprecated, integrated RT ticketing will not be available)
- Tie-IxHash
- Time-Duration
- HTML-Widgets-SelectLayers
@@ -55,6 +56,7 @@ Before installing, you need:
- NetAddr-IP
- Chart
+
- Crypt::PasswdMD5
- Apache::DBI (optional but recommended for better webinterface performance)
@@ -126,38 +128,46 @@ chown freeside /usr/local/etc/freeside/asp-global/
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:
+ Configure Apache for the Global directory and to execute .cgi files using Apache::ASP. For example, add something like the following to your Apache httpd.conf file, adjusting for your actual paths:
PerlModule Apache::ASP
+# your freeside document root
<Directory /usr/local/apache/htdocs/freeside-asp>
-<Files ~ (\.cgi)>
-AddHandler perl-script .cgi
+<Files ~ (\.cgi|\.html)>
+AddHandler perl-script .cgi .html
PerlHandler Apache::ASP
</Files>
<Perl>
$MLDBM::RemoveTaint = 1;
</Perl>
PerlSetVar Global /usr/local/etc/freeside/asp-global/
-PerlSetVar Debug 2
+PerlSetVar Debug 2
+PerlSetVar RequestBinaryRead Off
+# your freeside document root
+PerlSetVar IncludesDir /usr/local/apache/htdocs/freeside-asp
</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:
+
- Copy masondocs/ to your web server's document space. (For example: /usr/local/apache/htdocs/freeside-mason)
+
- Copy htetc/handler.pl to /usr/local/etc/freeside
+
- Edit handler.pl and:
+
+ - set an appropriate comp_root, such as /usr/local/apache/htdocs/freeside-mason
+
- set an appropriate data_dir, such as /usr/local/etc/freeside/masondata
+
+
+ - Configure Apache to use the handler.pl file and to execute .cgi files using HTML::Mason. For example, add something like the following to your Apache httpd.conf file, adjusting for your actual paths:
PerlModule HTML::Mason
<Directory /usr/local/apache/htdocs/freeside-mason>
-<Files ~ (\.cgi)>
-AddHandler perl-script .cgi
+<Files ~ (\.cgi|\.html)>
+AddHandler perl-script .cgi .html
PerlHandler HTML::Mason
</Files>
<Perl>
-require "/usr/local/apache/conf/handler.pl";
+require "/usr/local/etc/freeside/handler.pl";
</Perl>
</Directory>
@@ -165,7 +175,7 @@ require "/usr/local/apache/conf/handler.pl";
|