Updated about 9 years ago by Jessie Lee

ResourceSpace Installation¶

Initial setup¶

The following packages are needed for installation: apache2 mysql-server php5 php5-dev php5-gd php5-mysql imagemagick ghostscript antiword xpdf libav-tools postfix libimage-exiftool-perl cron wget
ResourceSpace can be either installed via SVN or via tar.gz. I did it via the point release tar.gz file
unpack in /var/www/resourcespace and chown -R www-data:www-data /var/www/resourcespace
if file storage will be in /var/www/resourcespace create filestore directory if it will be elsewhere create a symlink to the filestore directory

Database (mysql)¶

log into mysql as root user
create database resourcespace;

create user resourcespace

CREATE USER 'username'@'localhost' IDENTIFIED BY 'password';
CREATE DATABASE IF NOT EXISTS resourcespace;
GRANT ALL PRIVILEGES ON resourcespace.* TO 'username'@'localhost' IDENTIFIED BY 'password';

Apache config¶

No site.conf file is included so we will have to make our own.

<IfModule mod_ssl.c>
<VirtualHost *:443>
        ServerName cloud.example.org

        ServerAdmin webmaster@localhost
        DocumentRoot /var/www/resourcespace
        <Directory /var/www/resourcespace>
                AllowOverride All
                Options Indexes FollowSymLinks MultiViews
                Order allow,deny
                allow from all
        </Directory>
    <Directory /var/www/resourcespace/filestore>
    Options -Indexes
    AllowOverride All
    Order allow,deny
    allow from all
    </Directory>

        ErrorLog ${APACHE_LOG_DIR}/resourcespace.error.log
        CustomLog ${APACHE_LOG_DIR}/resourcespace.access.log combined

SSLCertificateFile /path/to/cert.pem
SSLCertificateKeyFile /path/to/key.key
Include /etc/letsencrypt/options-ssl-apache.conf
Header always add Strict-Transport-Security "max-age=15768000" 
</VirtualHost>

We should also create .htaccess file in the filestore directory as an added measure

<ifModule mod_authz_core.c>
Require all denied
</ifModule>

# line below if for Apache 2.2
<ifModule !mod_authz_core.c>
deny from all
Satisfy All
</ifModule>

# section for Apache 2.2 and 2.4
IndexIgnore *

PhP requirements¶

to fufill php requirements it is best to use .htaccess files
you may have to edit the global php.ini file in /etc/php5/apache2/php.ini

create this .htaccess file in /var/www/resourcespace/

<IfModule mod_php5.c>
  php_value SecFilterEngine off
  php_value SecFilterScanPOST off
  php_value memory_limit 512M
  php_value post_max_size 100M
  php_value upload_max_filesize 100M
  php_value short_open_tag off
  </IfModule>

First Run Wizard¶

Now we should be able to open up the url for resourcespace and point resourcespace to the database and user we set
set an admin user and password
go to admin ---> System installation check to make sure everything is set.

Cron¶

a cron job is required to run background work.
#crontab -u www-data -e
add wget -q -r http://localhost/pages/tools/cron_copy_hitcount.php to run daily
1 0 * * * wget -q -r http://localhost/pages/tools/cron_copy_hitcount.php >/dev/null 2>&1

SMTP¶

smtp server must be set in the config.php which is located in /var/www/resourcespacedirectory/include/config.php

$email_from = '';
$email_notify = '';
$use_smtp=true;
$smtp_secure='tls';
$smtp_host='';
$smtp_port=587;
$smtp_auth=true;
$smtp_username='';
$smtp_password='';
$use_phpmailer=true;

SSL setup¶

run let's encrypt and follow setup
edit /var/www/resourcespace/include/config.php $baseurl variable from http://site.com to https://site.com