Installation Guide

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)