Install Script

HOME > SETUP > INSTALL SCRIPT

---

This page provides more information on the Loris install script and installation process.

---

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

---

Notes on Operating systems and Dependencies

Ubuntu

• The main Loris Readme will cover most Ubuntu installations.
• 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 5.6 is the recommended version for Loris 16.0, and MySQL 5.6 is the maximum supported version.

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 is designed to be run on Ubuntu (12.04 or 14.04) or CentOS systems.

Before continuing further --
Please ensure you have already completed the preceding steps 1 and 2 in the Readme.

The install script will ask for the following input and will offer the following choices:

1. Your project directory name.
   (Will be used to modify the paths for Imaging data in the generated config.xml file for LORIS, and may also be used to automatically create/install apache config files.)

This should be the directory name created in Step 1 of the main Readme, e.g. "loris" from /var/www/loris

2. MySQL Database name. If an empty database has not already been created for your project, choose a simple name such as "LORIS" or "Abc_Def"

3. Hostname for the machine running MySQL server where the database is or will be located.

4. A new MySQL username that the LORIS system will use to connect to this server and database to perform frontend-backend transactions.
   This script will ask to create this user. Recommended: "lorisuser"

5. Host address of this machine - from which LORIS system will be connecting (Where Apache is installed)

6. A new password for the "lorisuser" MySQL username

7. Another new password for the 'admin' frontend Loris user account. This 'admin' account will be the superuser Loris' web-accessible platform.

8. Credentials of an existing MySQL account with root or superuser privileges, capable of creating the database, or installing the schema, or creating users on the given database. This will only be used to create the database, install the schema, and/or create and grant privileges to the "lorisuser" MySQL user.

If you have mysql root access, provide that root account credential. If you have another account that can create databases, create/drop tables.

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

• Smarty 3 : For Ubuntu the recommended smarty3 package can be 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
• Verify your Loris Configuration settings in the database -- see Troubleshooting Configuration notes

NEXT: (2) Project Customization