Install Script

HOME > SETUP > INSTALL SCRIPT

As of Loris 17.0.3 this page is archived.

Please see Installing LORIS wiki page for up-to-date installation steps.

If you're looking for LORIS 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)

CentOS

• There aren't exact 17.0 instructions for CentOS but most of the next section will work with CentOS. The information here may help with your install process until instructions are written.

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