MonarcAppFO/INSTALL/INSTALL.ubuntu1604.md

195 lines
4.8 KiB
Markdown
Raw Normal View History

2018-09-05 22:46:16 +02:00
Installation on Ubuntu 16.04
2017-06-21 22:54:16 +02:00
============================
2018-09-05 22:42:07 +02:00
# 1. Install LAMP & dependencies
2017-08-07 10:25:18 +02:00
2018-09-05 22:42:07 +02:00
## Install the dependencies
2017-06-21 22:54:16 +02:00
$ sudo apt-get install vim zip unzip git gettext curl net-tools gsfonts curl
2017-06-21 22:54:16 +02:00
2018-09-05 22:42:07 +02:00
Some might already be installed.
## Install MariaDB
2017-06-21 22:54:16 +02:00
$ sudo apt-get install mariadb-client mariadb-server
2017-06-21 22:54:16 +02:00
2018-09-05 22:42:07 +02:00
# Secure the MariaDB installation
2017-06-21 22:54:16 +02:00
$ sudo mysql_secure_installation
2017-06-21 22:54:16 +02:00
2018-09-05 22:42:07 +02:00
Especially by setting a strong root password.
2017-06-21 22:54:16 +02:00
2018-09-05 22:42:07 +02:00
## Install Apache2
$ sudo apt-get install apache2 apache2-doc apache2-utils
2018-09-05 22:42:07 +02:00
## Enable modules, settings, and default of SSL in Apache
$ sudo a2dismod status
$ sudo a2enmod ssl
$ sudo a2enmod rewrite
$ sudo a2enmod headers
2018-09-05 22:42:07 +02:00
## Apache Virtual Host
2017-06-21 22:54:16 +02:00
<VirtualHost *:80>
2018-09-05 22:42:07 +02:00
ServerName monarc.localhost
DocumentRoot /var/lib/monarc/fo/public
<Directory /var/lib/monarc/fo/public>
2018-09-05 22:42:07 +02:00
DirectoryIndex index.php
AllowOverride All
Require all granted
</Directory>
<IfModule mod_headers.c>
Header always set X-Content-Type-Options nosniff
Header always set X-XSS-Protection "1; mode=block"
Header always set X-Robots-Tag none
Header always set X-Frame-Options SAMEORIGIN
</IfModule>
SetEnv APPLICATION_ENV "development"
2018-09-05 22:42:07 +02:00
</VirtualHost>
2017-06-21 22:54:16 +02:00
2018-09-05 22:42:07 +02:00
## Install PHP and dependencies
2017-06-21 22:54:16 +02:00
$ sudo apt-get install php apache2 libapache2-mod-php php-curl php-gd php-mcrypt php-mysql php-pear php-apcu php-xml php-mbstring php-intl php-imagick php-zip
2017-06-21 22:54:16 +02:00
2018-09-05 22:42:07 +02:00
## Apply all changes
2017-06-21 22:54:16 +02:00
$ sudo systemctl restart apache2.service
2017-06-21 22:54:16 +02:00
2018-09-05 22:42:07 +02:00
# 2. Installation of MONARC
2017-06-21 22:54:16 +02:00
2018-09-05 22:42:07 +02:00
## MONARC code
2018-09-05 22:42:07 +02:00
Clone the repository and invoke `composer` using the shipped `composer.phar`:
$ cd /var/lib/monarc/
$ git clone https://github.com/monarc-project/MonarcAppFO.git fo
$ cd fo/
$ chown -R www-data data
$ chmod -R g+w data
$ php composer.phar self-update
$ php composer.phar install -o
2018-09-05 22:42:07 +02:00
The `self-update` directive is to ensure you have an up-to-date `composer.phar`
available.
2018-09-05 22:42:07 +02:00
### Backend
2017-06-21 22:54:16 +02:00
2018-09-05 22:42:07 +02:00
The backend is not directly modules of the project but libraries.
2017-06-21 22:54:16 +02:00
You must create modules with symbolic links to libraries.
2018-09-05 22:42:07 +02:00
Create two symbolic links:
2017-06-21 22:54:16 +02:00
$ mkdir module
$ cd module/
$ ln -s ./../vendor/monarc/core MonarcCore
$ ln -s ./../vendor/monarc/frontoffice MonarcFO
2017-06-21 22:54:16 +02:00
There are 2 parts:
2018-09-05 22:42:07 +02:00
* MonarcFO is only for front office;
* MonarcCore is common to the front office and to the back office.
2017-06-21 22:54:16 +02:00
2018-09-05 22:42:07 +02:00
### Frontend
2018-09-05 22:42:07 +02:00
The frontend is an AngularJS application.
2017-06-21 22:54:16 +02:00
$ mkdir node_modules
$ cd node_modules
$ git clone https://github.com/monarc-project/ng-client.git ng_client
$ git clone https://github.com/monarc-project/ng-anr.git ng_anr
2017-06-21 22:54:16 +02:00
There are 2 parts:
2018-09-05 22:42:07 +02:00
2017-06-21 22:54:16 +02:00
* one only for front office: ng_client;
* one common for front office and back office: ng_anr.
2018-09-05 22:42:07 +02:00
## Databases
2017-06-21 22:54:16 +02:00
2018-09-05 22:42:07 +02:00
### Change SQL Mode in my.cnf
2017-06-21 22:54:16 +02:00
2018-09-05 22:42:07 +02:00
[mysqld]
sql-mode = MYSQL40
2017-06-21 22:54:16 +02:00
### Create 2 databases
2017-06-21 22:54:16 +02:00
CREATE DATABASE monarc_cli DEFAULT CHARACTER SET utf8 DEFAULT COLLATE utf8_general_ci;
CREATE DATABASE monarc_common DEFAULT CHARACTER SET utf8 DEFAULT COLLATE utf8_general_ci;
2017-06-21 22:54:16 +02:00
2018-09-05 22:42:07 +02:00
* monarc_common contains models and data created by CASES;
* monarc_cli contains all client risk analyses. Each analysis is based on CASES
model of monarc_common.
2017-06-21 22:54:16 +02:00
### Initializes the database
2018-09-05 22:42:07 +02:00
$ mysql -u user monarc_common < db-bootstrap/monarc_structure.sql
$ mysql -u user monarc_common < db-bootstrap/monarc_data.sql
2017-06-21 22:54:16 +02:00
2018-09-05 22:42:07 +02:00
### Database connection
Create the configuration file:
2018-09-05 22:42:07 +02:00
$ sudo cp ./config/autoload/local.php.dist ./config/autoload/local.php
2017-06-21 22:54:16 +02:00
2018-09-05 22:42:07 +02:00
And configure the database connection:
2017-06-21 22:54:16 +02:00
return array(
'doctrine' => array(
'connection' => array(
'orm_default' => array(
'params' => array(
'host' => 'host',
'user' => 'user',
'password' => 'password',
'dbname' => 'monarc_common',
),
),
'orm_cli' => array(
'params' => array(
'host' => 'host',
'user' => 'user',
'password' => 'password',
'dbname' => 'monarc_cli',
),
),
),
),
);
2018-09-05 22:42:07 +02:00
# Update MONARC
2017-06-21 22:54:16 +02:00
2018-09-05 22:42:07 +02:00
## Install Grunt
2017-06-21 22:54:16 +02:00
$ sudo apt-get install nodejs
$ sudo apt-get install npm
$ sudo npm install -g grunt-cli
$ sudo ln -s /usr/bin/nodejs /usr/bin/node
2017-06-21 22:54:16 +02:00
2018-09-05 22:46:16 +02:00
Update MONARC:
$ ./scripts/update-all.sh
2018-09-05 22:42:07 +02:00
This script will retrieve the updates from the last stable release of MONARC,
execute the database migration scripts and compile the translations.
2018-09-05 22:42:07 +02:00
# Create initial user
2017-06-21 22:54:16 +02:00
$ php ./vendor/robmorgan/phinx/bin/phinx seed:run -c ./module/MonarcFO/migrations/phinx.php
2017-08-17 15:05:12 +02:00
The username is *admin@admin.test* and the password is *admin*.