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)