User Tools

Site Tools


nupusi:olatedownload:setup

Olate Download Setup

Installing or upgrading Olate Download is easy. Follow the instructions in this section to get started.

Requirements

Olate Download has been tested on multiple platforms and OSs, however, there are few requirements:

Minimum Requirements

  • PHP 4.3.x and above
  • MySQL 3.23.x and above
  • PHP 5.0.x and above (for increased speed and performance afforded by ehancements in PHP5)
  • MySQL 4.1.0 and above

Note: In order to use the search functionality, MySQL 4.0.2 is the minimum requirement. The MySQL version will be detected during installation and the search feature enabled if 4.0.2+ is found.

Installation

If your server satisfies the minimum requirements, you can proceed with the installation of Olate Download 3. The setup system has been designed to aid you through every step of the install process and will make sure everything is done correctly.

1. Downloading the latest release

The latest release can always be found on the Olate website at http://www.olate.co.uk/od/download.php.

2. Uploading/Extracting

Once you have downloaded the package, extract it using your preferred too (e.g. WinZip).

You will see three directories:

  • /docs
  • /upload
  • /tools

You should upload the /upload directory (including all sub directories and files) to your web hosting account maintaining the original directory structure. You may rename /upload to whatever you like.

3. Action Selection

Using your browser, load the page where you uploaded the /upload directory. For example, if you uploaded to /home/example/public_html/upload and your domain name is example.com, then you should browse to http://www.example.com/upload. You will automatically be directed to the setup system. You should then select New Installation.

4. Server Requirements

You will next be told whether your server can support Olate Download 3. Any errors will be displayed and you will told what the problem is. If everything is ok, click Continue.

Note: In order to use the search functionality, MySQL 4.0.2 is the minimum requirement. The MySQL version will be detected during installation and the search feature enabled if 4.0.2+ is found. Even if MySQL is detected at this stage, you must double check with your host that you are using MySQL 4.0.2+ as the version will not be detected until later. You can use the script tools/fulltext.php located in the /tools directory of the download package to enable the search functionality at a later date.

5. Database Settings

Before continuing past this page, you must create a database and user to install the database tables into. This will not be done for you. If you are unsure, you should contact your web host. Once you have the information, enter it into the boxes. The table prefix will be added to the front of each table name. The default should be fine for most users. Clicking Continue will take you to the next page.

6. General Settings

If there were any problems with the database setup, you will be notified. Otherwise, you can proceed to enter in the default General Settings you require.

Site Name

The text entered in the site name box is used as the title for most pages. It does not appear on the actual site but is shown in the browser title bar, at the very top of the window.

Base URL

The base url is the location where a browser would access to view the Olate Download site. Although the copy of Olate Download may be installed in the /home/olate/public_html/upload directory of the server and your domain name is example.com it would be accessible to the internet through the domain http://www.example.com/upload - this is the base URL. If the Base URL is not set correctly internal links within the site will not work; as they will be pointing to the wrong location. Normally, it will be autodetected during this step and must have a trailing slash.

Admin E-Mail

The administrative e-mail receives all mail generated by the report problem section. When a user finds a problem with a file they have the option to click on the report problem. They can then fill in the details of the problem, which is mailed to this admin address.

Admin Username/Password

This is the default username and password you will use to login to the admin control panel.

7. Remove Installer Files

In order to make your installation secure, you must delete the setup/ directory and chmod includes/config.php to 755. This will prevent your site being overwritten by a new installation.

Note chmod is a Linux/Unix command. For Windows users, you should remove write access to the file.

If you are not using MySQL 4.0.2+, you will be notified at this point that the search functionality has been disabled.

You can now continue to login to your fresh installation of Olate Download 3!

Upgrading

If your server satisfies the minimum requirements, you can proceed with upgrading to the latest version. The setup system has been designed to aid you through every step of the upgrade process and will make sure everything is done correctly. This process is very similar to the installation procedure.

Note: Before continuing with the upgrade process, you should make sure that you have a backup of your database in case anything goes wrong.

1. Downloading the latest release

The latest release can always be found on the Olate website at http://www.olate.co.uk/od/download.php.

2. Uploading/Extracting

Once you have downloaded the package, extract it using your preferred too (e.g. WinZip).

You will see three directories:

  • /docs
  • /upload
  • /tools

Note: If you are upgrading from a previous v3.x version then you must keep your current upload/includes/config.php file when uploading the new files. Do not overwrite this file. You should also ensure that any files that have been uploaded by your users in the uploads/ directory are backed up.

You should upload the /upload directory (including all sub directories and files) to your web hosting account maintaining the original directory structure and overwriting all current files except for upload/includes/config.php. You may rename /upload to whatever you like.

3. Action Selection

Using your browser, load the page where you uploaded the /upload directory. For example, if you uploaded to /home/example/public_html/upload and your domain name is example.com, then you should browse to http://www.example.com/upload. You will automatically be directed to the setup system.

If you wish to upgrade from version Olate Download 2.2, click Begin Upgrade in the Upgrade from version 2.2 section.

If you are upgrading from an existing Olate Download 3 installation, click the Begin Upgrade button under the Upgrade from version 3.x section that describes which version you are upgrading from. After clicking, the upgrade will be performed immediately. Once completed, skip to the last step.

4. Server Requirements

Only proceed from here if you are upgrading from v2.2. For v3.x upgrades, skip to the last step.

You will next be told whether your server can support Olate Download 3. Any errors will be displayed and you will told what the problem is. If everything is ok, click Continue.

Note: In order to use the search functionality, MySQL 4.0.2 is the minimum requirement. The MySQL version will be detected during installation and the search feature enabled if 4.0.2+ is found. Even if MySQL is detected at this stage, you must double check with your host that you are using MySQL 4.0.2+ as the version will not be detected until later. You can use the script tools/fulltext.php located in the /tools directory of the download package to enable the search functionality at a later date.

5. Database Settings

Before continuing past this page, you must create a database and user to install the database tables into. This will not be done for you. If you are unsure, you should contact your web host. Once you have the information, enter it into the boxes. The table prefix will be added to the front of each table name. The default should be fine for most users. Clicking Continue will take you to the next page.

6. General Settings

If there were any problems with the database setup, you will be notified. Otherwise, you can proceed to enter in the default General Settings you require.

Site Name

The text entered in the site name box is used as the title for most pages. It does not appear on the actual site but is shown in the browser title bar, at the very top of the window.

Base URL

The base url is the location where a browser would access to view the Olate Download site. Although the copy of Olate Download may be installed in the /home/olate/public_html/upload directory of the server and your domain name is example.com it would be accessible to the internet through the domain http://www.example.com/upload - this is the base URL. If the Base URL is not set correctly internal links within the site will not work; as they will be pointing to the wrong location. Normally, it will be autodetected during this step and must have a trailing slash.

Admin E-Mail

The administrative e-mail receives all mail generated by the report problem section. When a user finds a problem with a file they have the option to click on the report problem. They can then fill in the details of the problem, which is mailed to this admin address.

Admin Username/Password

This is the default username and password you will use to login to the admin control panel.

7. Remove Installer Files

In order to make your installation secure, you must delete the setup/ directory and chmod includes/config.php to 755. This will prevent your site being overwritten by a new installation.

Note: chmod is a Linux/Unix command. For Windows users, you should remove write access to the file.

If you are not using MySQL 4.0.2+, you will be notified at this point that the search functionality has been disabled.

You can now continue to login to your upgraded version of Olate Download 3!

Installing the WYSIWYG editor

Olate Download is released two distributions - one containing FCKeditor set up and ready to use with Olate Download, and the other without FCKeditor, for people who aren't wanting to use it.

  • If you downloaded the distribution that didn't contain FCKeditor, but now want to use it there are two ways you can install it:
  1. Download the appropriate distribution from the Olate Download downloads page.
  2. Extract the files to a folder on your hard drive, but don't overwrite your existing Olate Download files.
  3. Using your favourite FTP client, upload the folder FCKeditor (in the upload/ directory) to your webspace, into the directory that the rest of the Olate Download files reside. Pleas check that the FCKeditor folder is indeed called FCKeditor as on linux-based hosting folder names are case sensitive, meaning that a folder called fckeditor doesn't contain the same files as a folder called FCKeditor.
  4. Once this has completed, load the Admin Control Panel and go to the General Settings page. Check the box labelled Use WYSIWYG Editor and click the button labelled Update.

Note: If you see this message, you haven't followed the instructions properly: “You cannot use the WYSIWYG editor as the files do for it not exist. Please consult the documentation for more information.”

  • If you don't want to use the bundled version of FCKeditor, choosing instead to install it youself, please follow the guidelines above for naming folders. Instructions for manual installation are beyond the scope of this document.
nupusi/olatedownload/setup.txt · Last modified: 2008/12/06 13:56 (external edit)