Install Script

HOME > SETUP > INSTALL SCRIPT

Information here is for 17.0 If you're looking for 16.X instructions, click here.

---

1. Notes on Operating systems and Dependencies
2. Running the Install Script and Web-based Database Installer
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)

Running the Install Script and Web-based Database Installer

The Install script and web-based database 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