INSTALL.txt

INSTALLATION INSTRUCTIONS:
Please be sure that your system meets the minimum requirements outlined at the end of this document.

The following steps provide instructions for installing IsoveraDL on a Unix or Windows machine.

1. Download IsoveraDL.tar.gz (Unix) or IsoveraDL.zip (Windows).

2. Move the file into your public web directory, e.g., /var/www/html (Unix) or C:\Apache Group\Apache\htdocs\ (Windows)

2. Unpack the zipped file using command:
	gunzip < IsoveraDL.tar.gz | tar xvf - (on Unix machines)

	or use Winzip (on Windows machines)

This will create a folder called "IsoveraDL" inside of your public web directory.  All of the IsoveraDL files are stored in this location.

3. Using phpMyAdmin or otherwise, create a new database with an appropriate name, e.g., "isoveraDL" 

4. Use the database.sql file from this folder to create the IsoveraDL database.

5. Create a user to access the database, e.g., "IsoveraDL", and give them all permissions.  From the mysql prompt, this may be done with the following command:
	GRANT ALL on isoveraDL.* TO IsoveraDL@localhost IDENTIFIED BY 'password';

6. Using your preferred text editor open the "app/config/database.php" (Unix) "app\config\database.php" (Windows) file for editing.

7. Scroll down to the part where it says "class DATABASE_CONFIG" and edit the array for var $default as follows:
	 var $default = array( 	'driver'    => 'mysql',
                         	'connect'  => 'mysql_connect',
                         	'host'     => 'localhost',
                         	'login'    => 'IsoveraDL',
                         	'password' => 'password',
                         	'database' => 'isoveraDL',
                         	'prefix'    => '');

Note that "host", "login", "password" and "database" may differ according to the settings of your database server.

8. If you are using Unix, make sure that /IsoveraDL/app/tmp is writable by the user that your web server runs as.

9. Remove database.sql from the "IsoveraDL" directory

10. Change the permissions on the folders /IsoveraDL/app/webroot/files and /IsoveraDL/app/webroot/files/temp so that the Apache user can write to these directories.  World-writable permissions will suffice, however, for tighter security, you may prefer to make the permissions more granular.

11. Change the following line in /IsoveraDL/app/config/directories.php to reflect your base web address:

	define("DIR_WEB_ROOT", "http://www.yourserver.com/IsoveraDL");

The above entry corresponds to an installation of IsoveraDL in /var/www/html on http://www.yourserver.com.  This definition should be in line 17 of directories.php.

12. IsoveraDL expects to run with mod_rewrite enabled. If you don't want to use mod_rewrite or cannot use it for some reason, then perform the following steps:
	a. Remove the mod_rewrite directives from the following .htaccess files:
		/IsoveraDL/.htaccess
		/IsoveraDL/app/.htaccess
		/IsoveraDL/app/webroot/.htaccess
		Be sure to keep the other directives, if any, in the files. 
		
	b. Edit /IsoveraDL/app/config/core.php to uncomment line 42:
		Line 42: define ('BASE_URL', env('SCRIPT_NAME'));

13. Go to http://www.yourserver.com/IsoveraDL/ to see your working installation of IsoveraDL.  Instructions on using IsoveraDL are in README.txt.

REQUIREMENTS:

- MySQL 4 and above (tested on MySQL 4.1)
- PHP 4 (tested on PHP 4.4)
- Apache 1.3 and above (tested on Apache 2)
	Be sure that you have the mod_rewrite module of Apache loaded
- Windows or Unix operating system (developed on Red Hat Linux Enterprise Server 4)