*** Installing Product Review Module ***

Greetings sysadmin!

Here are the instructions for deploying the module -- nothing majorly complex, but a number of steps nonetheless.  The following assumes you're operating on a unix system with a recent version of PHP and PEAR installed, that you've un-tarred the distribution bundle and moved into the reviews directory.


*** Database ***


1 - Create a database, e.g. to create "mydbname":

$ mysqladmin -u root -p create mydbname


2 - Provide full access to the db to a user, say "myuser" using the fun and easy setperms script:

$ mysql_setpermission -u root


3 - Create tables and import startup data using:

$ mysql -u myuser -p < resources/conf/dbcreate.sql


4 - Access the database to set valid configuration values. 
You need to ensure the following values are set correctly in the prime_config table. Check the current values before overwriting to have an idea of what's expected

Minimally:
	
	id	name			function
	1  server_fqdn  	Fully qualified domain name of webserver
	2  server_document_root Full path to document
	11 base_install_dir	Base filesystem install dir
	22 server_admin_root	Server path to admin document root 
	
	
*** Config Files ***


5 - Edit conf/pathconf.php and set PSYPRIME_BASEDIR

6 - Edit conf/primeconfig.ini and set:
	
	database = mysql://myuser:mypassword@localhost/mydbname
	
and change the /full/path/ lines to reflect the actual install directories.

7 - Change the names of the resources/conf/DBObj/ files.  For the DataObject magic to work, these files must be named using the database name.  In our example:

$ mv resources/conf/DBObj/lexiconn.ini  resources/conf/DBObj/mydbname.ini
$ mv resources/conf/DBObj/lexiconn.links.ini resources/conf/DBObj/mydbname.links.ini 


*** Web server ***

8 - Template cache settings.

The webserver needs permission to write to a few directories, all within the templates/ subdir.  Set the ownership to that of the webserver, or simply:

$ chmod 777 resources/templates/templates_c
$ chmod 777 resources/templates/cache


NOTE: Make sure server_document_root and server_admin_root point to the right spot (e.g. /reviews/ and /reviews/admin/)


If you decide to move things around, you'll normally only need to change the server_document_root/conf/pathconf.php requires to have everything running smoothly.