Differences

This shows you the differences between two versions of the page.

Link to this comparison view

wiki:installation_guide [2008/07/01 10:30] (current)
sdemi created
Line 1: Line 1:
 +====== 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)