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)

---

1. Notes on Operating systems and Dependencies
2. Running the Install Script
3. Troubleshooting

---

Notes on Operating systems and Dependencies

Ubuntu

• 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.

CentOS

For CentOS 6 systems a separate CentOS Readme is available.

Mac OSX

• 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.

Running the Install Script

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

Troubleshooting

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

NEXT: (2) Project Customization