X-Git-Url: http://git.freeside.biz/gitweb/?a=blobdiff_plain;f=httemplate%2Fdocs%2Finstall.html;h=d4507a2a5dae86dac886dd5b37a21678f2b4d898;hb=4a881cc149f6892da35f85b767a1e806f237a05f;hp=54614ccb322e54eceb8262895bb1021b5e83584b;hpb=c0567c688084e89fcd11bf82348b6c418f1254ac;p=freeside.git
diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html
index 54614ccb3..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
+
- 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,42 @@ 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>
- Run make masondocs
- 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 (use htetc/handler.pl-1.0x for Mason versions before 1.10).
+
- 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:
+
- 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>
@@ -169,7 +175,7 @@ require "/usr/local/etc/freeside/handler.pl";
|