Installation overview

ResourceSpace is a standard PHP/MySQL application and the process should be familiar if you've installed other PHP/MySQL applications before.

Most issues encountered relate to the default php.ini settings. As you may be handling large resource files the default values for memory, upload size and timing often need to be increased.

  • Unzip the web file to an appropriate folder off your web root. The application is capable of running both in the web root folder or several levels deep within an existing folder structure. SVN checkout is preferable to the zip file if you're familiar with SVN (whether you are a developer or not), as it permits simple upgrades of the software.
  • Create an empty database (ResourceSpace will automatically create database tables etc.)
  • Configure PHP (see Configuring Your PHP.ini).
  • The 'filestore' and 'include' folders must be writable by the web server (either 'chmod 777 filestore' then 'chmod -R 777 include' or chown/chgrp the folders to your web server's user/group).
  • The system should now be up and running at the configured URL and the setup process will commence. You will be asked for database connection details and you will need to provide an administrator username and password.
  • Try 'Admin -> System -> Installation Check' to make sure everything is configured correctly.

Important: When the system is in full use (i.e. when you go live) the file 'cron_copy_hitcount.php' should be set to execute once each night so the relevance matching works correctly. You can do this using a cron job which runs 'wget' and fetches the file's URL. This script copies the resource usage information collected during the day from the temporary columns into the live columns, and doesn't happen in real time because the resource/keyword usage counts are used to order resources when searching (this is how the relevance matching works), and if the counters updated instantly the resources would appear to jump around in your result set as you accessed them, as your own activity would be immediately affecting the search order.

A lot of the configuration (fields, user groups, etc.) can be configured within the Admin -> Setup.

The GD library (which is a minimum requirement) will provide automatic thumbnail for JPEG, GIF and PNG files. To add many more image and video file formats you can install ImageMagick and FFmpeg and set the paths to the binaries in config.php.

If using Apache it is important to make sure that the Indexes option is not set. If this is set the 'filestore' folder will be publicly available as the scrambled resource paths will be clearly visible.

Spotted a mistake? It would be a big help if you could edit this article. Thanks!