OpenDb Installation Instructions
--------------------------------

1) Requirements

To install the Open Lending Database Project on your site. You will need the 
following:
- WebServer (Apache, IIS,...)  Apache linux/Windows & IIS 5 on Windows 
								both tested to varying degrees.

- PHP 4.0b3 (strip_tags with allowable_tags parameter and '===' comparison), 
  4.1.x, 4.2.x, 4.3.x. (Developed with 4.0.4p1) 

  	* track_vars must be enabled.
	
	* register_globals can be enabled/disabled.
	
- MySQL Database (Tested with 3.23.36). OpenDb should work on earlier 
  versions, but no testing has been done below 3.23.36.  
  
  If you are running a MySQL version prior to 3.23.2 you will need to set 
  the include/config.php $CONFIG_VARS['listings.count_distinct_support']=FALSE; 
  due to  OpenDb's use of the COUNT(DISTINCT ...) syntax which does not exist 
  in this (and earlier) versions.

- Sendmail or some other email configured for use with PHP, so that the
  PHP email functions can be used.  If you cannot do this be sure to set
  the include/config.php $CONFIG_VARS['email.use_php_mail'] variable to FALSE.

2) Installation

2.1) MySQL User and Database

You will need to create a user and database in MySQL.  

A simple SQL script is included with the distribution, and can be executed 
as the MySQL 'root' user with the following command from the OpenDb root 
installation directory:
	mysql -u root -p mysql < docs/create_user_and_db.sql

You can also use phpMyAdmin or something similiar.
	
2.2) OpenDb Configuration

Edit the include/config.php file so that it suits your needs, especially
in relation to the MySQL database and user/password you configured in
the previous step.

// The MySQL database and its host (If database is on same machine as 
// webserver, then localhost is probably what you want)
$CONFIG_VARS['db_server.host'] = "localhost";
$CONFIG_VARS['db_server.dbname'] = "opendb";

// The username and passwd of the MySQL user you created.
$CONFIG_VARS['db_server.username'] = "lender";
$CONFIG_VARS['db_server.passwd'] = "test";

2.3) Patch facility

Start the patch.php facility, and perform the Upgrade option you 
require.  You may be upgrading from DVDDBP, performing
a New Install, or upgrading from a previous version of OpenDb.

2.4) Post Installation (For DVDDBP Upgrade or New Install)

You should now open the OpenDb main index.php page and login 
as the default OpenDb user:
	userid: test
	passwd: test

Create a new Admininstrator user and delete the "test" user. 
	
You may also like to protect the log/ directory from direct access
from the Browser so users cannot access the log entries unless they
are administrators.  Refer to docs/logfile.txt for more information.

2.5) Post Installation Continued

You should set the include/config.php $CONFIG_VARS['patch.enable'] = FALSE
to disable the patch facility.

3)	Upgrade

For upgrading from OpenDb versions 0.54 -> 0.60, execute
the 0.54 patch.  Ensure you run each and every step in the 
order specified.

For versions of OpenDb prior to 0.54, run the appropriate patch
to upgrade to 0.54, and then run the 0.54 -> 0.61pX patch.

For ugrading from DVDDBP execute the DVDDBP upgrade patch.

For a New installation, execute the New Install patch.	

4) FAQ

4.1) What if I only want a few of the types installed, how can I get
	 rid of the others?

	Answer:
		Once you have completed the 'New Installation' or DVDDBP upgrade,
		log in as an Admininstrator user.  Start the 'System Admin Tools' from 
		the menu, and choose the 'Types' tool.  Delete all the types
		you do not want.

4) GD Library issues
	
	Refer to section 4 of the docs/notes/statistics.txt document for
	more information.