#LORIS CentOS 6.x Notes

This document contains supplemental details on how to perform a basic CentOS 6.x install of LORIS.
Note that the main README in LORIS assumes that LORIS is being run on Ubuntu.
As of Loris 17.0, the install script and web-based install steps as described in the main (Ubuntu) readme are applicable to CentOS installs. 

This Readme assumes you already understand basic UNIX, MySQL and Apache setup and
settings. If you're not already comfortable troubleshooting sysadmin issues,
you should not follow this guide.

For further details on the install process, please see the LORIS GitHub Wiki CentOS Install page.  

# System Requirements

Default dependencies installed by CentOS 6.x may not meet the version requirements LORIS deployment or development.
* MySQL 5.7 is supported for LORIS 18.*
* PHP 7 is supported for LORIS 18.* - upgrade your PHP manually

The yum packages to be installed vary from any Ubuntu packages referenced in the LORIS README.

The following should be installed with yum:
 * Apache2
 * PHP
 * MySQL
 * PHP Composer

**Apache2:**
```
sudo yum install httpd 
sudo service httpd start
```
**PHP:**
```
sudo yum install php php-pdo php-mysql 
```

*NOTE:* As of Loris 17.0 php7 is required (but not yet officially supported by CentOS). To upgrade php follow the following instructions:
``` 
# update php5 -> php7
curl 'https://setup.ius.io/' -o setup-ius.sh
sudo bash setup-ius.sh

# update php7 specific packages
sudo yum remove php-cli mod_php php-common
sudo yum install php70u-json php70-xml mod_php70u php70u-cli php70u-mysqlnd php70u-mbstring
``` 
**MySQL:**

*Note:* Loris developers (those NOT working with a .zip release codebase) should skip steps relating to hosting mysql locally. Contact your sysadmins for database credentials directly.
``` 
sudo yum install mysql mysql-server
```
The above command will download MariaDB by default in CentOS7 [(see paragraph2)](https://www.digitalocean.com/community/tutorials/how-to-install-mysql-on-centos-7).

Check what version you have installed by running:
```
mysql -v
```
If you have MySQL:
```
sudo service mysqld start
sudo service mysqld status
```
If you have MariaDB:
```
sudo service mariadb start
sudo service mariadb status
```
The two versions should act nearly identically in all other respects. 

To finalise the MySQL/MariaDB installation: 
```
mysql_secure_installation
```
(follow instructions to create a password the root user):

**PHP Composer:**
```
sudo curl -sS https://getcomposer.org/installer | php
sudo mv composer.phar /usr/local/bin/composer
```
# LORIS code base

Download the latest release from the [releases page](https://github.com/aces/Loris/releases) to the home directory (~/), unzip it, and copy the contents to your project directory, `/var/www/loris` (we recommend naming your project directory `loris`, although you can use a different naming convention if you prefer). 
```
wget https://github.com/aces/Loris/archive/v$VERSION.zip
unzip Loris-%VERSION%.zip
cp -r Loris-%VERSION%/* /var/www/loris
```

Alternatively the latest development branch can be obtained by forking the [LORIS repository] (http://github.com/aces/Loris) for development purposes. We do not support unstable dev branches. 

# Setup:

**Composer:**

Composer will download all of LORIS's library requirements, assuming an active internet connection.
This must be done from the LORIS project directory `/var/www/loris`. There may be additional packages
to install at this setp for composer to exist successfully, be sure to install the php 7 compatible 
versions of these packages, if necessary. 

```bash
# It may be necessary to create the project/libraries/ directory before running composer install 
composer install --no-dev
```

**Apache2:**

A sample apache configuration file is in `docs/config/apache2-site`. 
The install script will ask if you want to automatically create/install apache config files.
To perform this step manually, copy the sample file to the apache configuration directory (`/etc/httpd/conf.d/`), and add the `.conf` file extension:

```bash
cp docs/config/apache-site /etc/httpd/conf.d/apache-site.conf
```

Ensure the following: 

 * Paths and settings in `/etc/heepd/conf.d/apache-site.conf` are populated appropriately for your server, (replacing placeholders such as `%LORISROOT% --> /var/www/loris`, `%PROJECTNAME% --> loris`, `%LOGDIRECTORY% --> /var/log/httpd/loris-error.log`. 
 * DocumentRoot is pointing to `/var/www/loris/htdocs`.
 * The `smarty/templates_c/` directory under the LORIS root is writable by Apache.
 (This can be done by running: `chmod 775 /var/www/loris/smarty/templates_c)

`
Finally, restart apache:
```
sudo service httpd restart
sudo service httpd status
```
# Install LORIS

For the purpose of following LORIS conventions and easy understanding of all LORIS documentation, we recommend the following account names: 

* lorisadmin : Linux user with sudo permission who will setup and manage Loris
* lorisuser : MySQL user with limited (insert, delete, update, select...) permissions on the Loris database, for database transactions requested by the Loris front end
* admin : default username for Loris front-end admin account (browser login)

**Run the loris install script:**
```
cd /var/www/loris/tools
./install.sh
```
**Configure your databse:*
point your URL to: `http://%IPADDRESS%/installdb.php`

(%IPADDRESS% will likely be the IP address of the VM you are ssh'ed into)

The web page will prompt you for the following information: 

 * `Server Hostname`: localhost if your database if hosted on your VM or the IP address of your database server

 * `Admin Username`: should be "root" 

 * `Admin Password`: whatever password you set when running the `mysql_secure_installation` step

 * `Database Name`: set to "LORIS" by default, can be customised

Click submit, and follow the instructions to enter the username and password of your backend user, and front end admin user. 

You may have to manually paste the xml output to `/var/www/loris/project/config.xml`

Your Loris instance should now be accessible by pointing your url to `http://%IPADDRESS%`

Further configuration can be done using the LORIS configuration module.

If there are any errors or you get a blank page, you'll have to troubleshoot
based on the errors in your apache error log (by default
 `/var/log/httpd/lorris-error.log`)