-
Notifications
You must be signed in to change notification settings - Fork 173
Install Script
HOME > SETUP > INSTALL SCRIPT
This page provides more information on the Loris install script and installation process.
For Loris 17.0 a new web-based install script has been added. Please see the Readme for more details.
The following notes reflect the Loris 16.0 release (spring 2016)
- The install script should install Composer and dependencies including smarty3. There is no need to install these dependencies before running the install script.
- Note that PHP 7 and MySQL 5.7 are recommended for LORIS 17.0 (Fall 2016); for Loris 16.* (Spring 2016) PHP 5.6 and MySQL 5.6 are the highest supported versions.
For CentOS 6 systems a separate CentOS Readme is available.
- Mac is not actively supported as of release 15.10
For Mac OSX installations, a Mac Readme was developed for release 15.04. It has not been updated for subsequent releases, e.g. for newer dependencies such as Composer. Users attempting Mac install may also find Apache setup changes for El Capitan.
The Install script and web-based installer is designed to be run on Ubuntu (14+) or CentOS systems.
The new instructions may be found here
If re-running the Install script, remove (rename) the config.xml file stored in the project/ directory. If this file exists, the install script will abort.
For Ubuntu installations, if any difficulties are encountered in the install script, Composer can be manually installed thus: To manually install Composer
curl -sS https://getcomposer.org/installer | php;
sudo mv composer.phar /usr/local/bin/composer
composer install
Running composer install may fail if you do not have a project/libraries directory created:
cd /var/www/loris/
mkdir -p project/libraries
composer install # try again
NOTE: Smarty 3 is installed by Composer. For Ubuntu the recommended smarty3 package can be manually installed using:
> apt-get install smarty3
Once your install script has finished running, if your Loris does not load:
-
Check your apache logs. e.g. Ubuntu: /var/log/apache2/$project-error.log and $project-access.log
-
If you see a PHP Fatal error about DateTime -- set your timezone in your php.ini file. The error usually looks like this:
PHP Fatal error: Uncaught exception 'Exception' with message 'DateTime::__construct() ...
- Verify your Loris Configuration settings in the database -- see Troubleshooting Configuration notes