X-Git-Url: http://git.freeside.biz/gitweb/?p=freeside.git;a=blobdiff_plain;f=httemplate%2Fdocs%2Finstall.html;h=2ad75b15e8ebea97cc3ea3d0f55bf7f9a3f64659;hp=749c4c77b807e7c47181000fefe70f1af47fbf2b;hb=8fc4118f1f055195d280b3250b39a3b5fcdf13dc;hpb=1340e8879e31d3fcbe09b73477f3aac3dbf65113
diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html
index 749c4c77b..2ad75b15e 100644
--- a/httemplate/docs/install.html
+++ b/httemplate/docs/install.html
@@ -5,14 +5,18 @@
Installation
Before installing, you need:
- - A web server, such as Apache-SSL or Apache
-
- mod_perl
-
- SSH (OpenSSH is recommended. SSH Communications Security commercial SSH version 3 has been reported incompatible with Freeside.)
- 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.
- Perl modules (CPAN will query, download and build perl modules automatically)
@@ -20,6 +24,7 @@ Before installing, you need:
- Term-Query (make test broken; install manually)
- MIME-Base64
- Digest-MD5
+
- MD5
- URI
- HTML-Tagset
- HTML-Parser
@@ -32,12 +37,10 @@ Before installing, you need:
- MailTools
- TimeDate
- DateManip
-
- Time-Duration
- File-CounterFile
- FreezeThaw
- String-Approx
- Text-Template
-
- Archive-Tar
- DBI
- DBD for your database engine (DBD::Pg for PostgreSQL, DBD::mysql for MySQL)
- DBIx-DataSource
@@ -48,6 +51,8 @@ Before installing, you need:
- Apache::ASP or HTML::Mason
- Tie-IxHash
- Time-Duration
+
- HTML-Widgets-SelectLayers
+
- Storable
Install the Freeside distribution:
@@ -58,14 +63,19 @@ Install the Freeside distribution:
with PostgreSQL:
$ su postgres
-$ createuser -P freeside
+$ 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
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';
- Unpack the tarball: gunzip -c fs-x.y.z.tar.gz | tar xvf -
+
Edit the top-level Makefile:
- Set DATASOURCE to your DBI data source, for example, DBI:Pg:host=localhost;dbname=freeside for PostgresSQL or DBI:mysql:freeside for MySQL. See the DBI manpage and the manpage for your DBD for the exact syntax of a DBI data source.
@@ -91,7 +101,7 @@ $ su
$ su
# make create-config
-
- You should run a separate iteration of Apache[-SSL] with mod_perl enabled as the freeside user.
+
- Run a separate iteration of Apache[-SSL] with mod_perl enabled as the freeside user.
@@ -101,11 +111,18 @@ $ su
- 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.
+
- 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>
+<Directory /usr/local/apache/htdocs/freeside-asp>
<Files ~ (\.cgi)>
AddHandler perl-script .cgi
PerlHandler Apache::ASP
@@ -113,7 +130,7 @@ PerlHandler Apache::ASP
<Perl>
$MLDBM::RemoveTaint = 1;
</Perl>
-PerlSetVar Global /usr/local/etc/freeside/asp-global/
+PerlSetVar Global /usr/local/etc/freeside/asp-global/
PerlSetVar Debug 2
</Directory>
@@ -125,13 +142,13 @@ PerlSetVar Debug 2
- 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>
+<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";
+require "/usr/local/apache/conf/handler.pl";
</Perl>
</Directory>
|