X-Git-Url: http://git.freeside.biz/gitweb/?a=blobdiff_plain;ds=sidebyside;f=httemplate%2Fdocs%2Finstall.html;h=4870c7db79748bcd792a66397e8453bf41326bd3;hb=17ddcceb66e4c5c45abe890403d2ca98b128d375;hp=b739af02c5021813325287cf5c5ac8fda271d761;hpb=d7a1a7154a401edfbc4844721c08cb6f483d59b7;p=freeside.git
diff --git a/httemplate/docs/install.html b/httemplate/docs/install.html
index b739af02c..4870c7db7 100644
--- a/httemplate/docs/install.html
+++ b/httemplate/docs/install.html
@@ -5,15 +5,16 @@
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.
- PostgreSQL (v7 or higher) is recommended.
- MySQL does not work at this time.
- The following information is provided for developers who wish to contribute MySQL support: See tickets #300 and #334 in the bug-tracking system.
+ The following information is provided for developers who wish to contribute MySQL support: See ticket #300 in the bug-tracking system.
MySQL's default MyISAM and ISAM table types are not supported. If you really want to use MySQL, you need to use one of the new transaction-safe table types such as BDB, and set it as the default table type using the
--default-table-type=BDB
mysqld command-line option or by setting default-table-type=BDB
in the my.cnf option file.
@@ -23,6 +24,7 @@ Before installing, you need:
- Term-Query (make test broken; install manually)
- MIME-Base64
- Digest-MD5
+
- MD5
- URI
- HTML-Tagset
- HTML-Parser
@@ -39,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
@@ -50,6 +51,8 @@ Before installing, you need:
- Apache::ASP or HTML::Mason
- Tie-IxHash
- Time-Duration
+
- HTML-Widgets-SelectLayers
+
- Storable
Install the Freeside distribution:
@@ -72,7 +75,7 @@ $ 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.
@@ -98,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.
@@ -108,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
@@ -174,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.
|