X-Git-Url: http://git.freeside.biz/gitweb/?a=blobdiff_plain;f=httemplate%2Fdocs%2Finstall.html;h=4870c7db79748bcd792a66397e8453bf41326bd3;hb=1290c097176adcd62d48b1250233d53adb4b50a5;hp=35caa0023ef8fc8f9bbc2505b6c70242906e0869;hpb=30f31aae2dee3bdbec04f107e9d8cbb96442852e;p=freeside.git
diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html
index 35caa0023..4870c7db7 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
@@ -36,7 +41,6 @@ Before installing, you need:
- FreezeThaw
- String-Approx
- Text-Template
-
- Archive-Tar
- DBI
- DBD for your database engine (DBD::Pg for PostgreSQL, DBD::mysql for MySQL)
- DBIx-DataSource
@@ -47,6 +51,8 @@ Before installing, you need:
- Apache::ASP or HTML::Mason
- Tie-IxHash
- Time-Duration
+
- HTML-Widgets-SelectLayers
+
- Storable
Install the Freeside distribution:
@@ -57,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.
@@ -90,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.
@@ -100,7 +111,11 @@ $ 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/
+
- 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
@@ -166,6 +181,11 @@ $ freeside-adduser -h /usr/local/etc
$ su freeside
$ bin/fs-setup username
+ - As the freeside UNIX user, run bin/populate-msgcat username to populate the message catalog, passing the username of a Freeside user you created above:
+
+$ su freeside
+$ bin/populate-msgcat username
+
- freeside-queued was installed with the Perl modules. Start it now and ensure that is run upon system startup.
- Now proceed to the initial administration of your installation.
|