Installation on Ubuntu 18.04 ============================ This guide is also working with Ubuntu 20.04 LTS. # 1. Install LAMP & dependencies ## 1.1. Install system dependencies $ sudo apt-get install zip unzip git gettext curl gsfonts Some might already be installed. ## 1.2. Install MariaDB $ sudo apt-get install mariadb-client mariadb-server ### Secure the MariaDB installation $ sudo mysql_secure_installation Especially by setting a strong root password. ## 1.3. Install Apache2 $ sudo apt-get install apache2 ### Enable modules, settings, and default of SSL in Apache $ sudo a2dismod status $ sudo a2enmod ssl $ sudo a2enmod rewrite $ sudo a2enmod headers ### Apache Virtual Host ServerAdmin admin@localhost.lu ServerName monarc.local DocumentRoot /var/lib/monarc/fo/public DirectoryIndex index.php AllowOverride All Require all granted 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 SetEnv APP_ENV "development" ## 1.4. Install PHP and dependencies $ sudo apt-get install php apache2 libapache2-mod-php php-curl php-gd php-mysql php-pear php-apcu php-xml php-mbstring php-intl php-imagick php-zip php-bcmath $ curl https://getcomposer.org/installer --output composer-setup.php $ sudo php composer-setup.php --install-dir=/usr/bin/ --filename composer $ rm composer-setup.php ## 1.5 Apply all changes $ sudo systemctl restart apache2.service # 2. Installation of MONARC ## 2.1. MONARC source code $ mkdir -p /var/lib/monarc/fo $ git clone https://github.com/monarc-project/MonarcAppFO.git /var/lib/monarc/fo $ cd /var/lib/monarc/fo $ mkdir -p data/cache $ mkdir -p data/LazyServices/Proxy $ chmod -R g+w data $ composer install -o ### Back-end The back-end is using [Laminas](https://getlaminas.org). Create two symbolic links: $ mkdir -p module/Monarc $ cd module/Monarc $ ln -s ./../../vendor/monarc/core Core $ ln -s ./../../vendor/monarc/frontoffice FrontOffice $ cd ../.. There are 2 parts: * Monarc\FrontOffice is only for MONARC; * Monarc\Core is common to MONARC and to the back office of MONARC. ### Front-end The frontend is an AngularJS application. $ 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 There are 2 parts: * one only for MONARC: ng_client; * one common for MONARC and the back office of MONARC: ng_anr. ## 2.2. Databases ### Create a MariaDB user for MONARC With the root MariaDB user create a new user for MONARC: MariaDB [(none)]> CREATE USER 'monarc'@'%' IDENTIFIED BY 'password'; MariaDB [(none)]> GRANT ALL PRIVILEGES ON * . * TO 'monarc'@'%'; MariaDB [(none)]> FLUSH PRIVILEGES; ### Create 2 databases In your MariaDB interpreter: MariaDB [(none)]> CREATE DATABASE monarc_cli DEFAULT CHARACTER SET utf8 DEFAULT COLLATE utf8_general_ci; MariaDB [(none)]> CREATE DATABASE monarc_common DEFAULT CHARACTER SET utf8 DEFAULT COLLATE utf8_general_ci; * 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. ### Initializes the database $ mysql -u monarc -ppassword monarc_common < db-bootstrap/monarc_structure.sql $ mysql -u monarc -ppassword monarc_common < db-bootstrap/monarc_data.sql ### Database connection Create the configuration file: $ sudo cp ./config/autoload/local.php.dist ./config/autoload/local.php And configure the database connection: return [ 'doctrine' => [ 'connection' => [ 'orm_default' => [ 'params' => [ 'host' => 'localhost', 'user' => 'monarc', 'password' => 'password', 'dbname' => 'monarc_common', ], ], 'orm_cli' => [ 'params' => [ 'host' => 'localhost', 'user' => 'monarc', 'password' => 'password', 'dbname' => 'monarc_cli', ], ], ], ], ]; # 3. Update MONARC Install Grunt: $ curl -sL https://deb.nodesource.com/setup_15.x | sudo bash - $ sudo apt-get install nodejs $ npm install -g grunt-cli then update MONARC: $ ./scripts/update-all.sh -c # 4. Create initial user $ php ./vendor/robmorgan/phinx/bin/phinx seed:run -c ./module/Monarc/FrontOffice/migrations/phinx.php The username is *admin@admin.localhost* and the password is *admin*. # 5. Statistics for Global Dashboard If you would like to use the global dashboard stats feature, you need to configure a Stats Service instance on your server. The architecture, installation instructions and GitHub project can be found here: - https://monarc-stats-service.readthedocs.io/en/latest/architecture.html - https://monarc-stats-service.readthedocs.io/en/latest/installation.html - https://github.com/monarc-project/stats-service The communication of access to the StatsService is performed on each instance of FrontOffice (clients). This includes the following lines change in your local.php file: ```diff 'monarc' => [ 'ttl' => 60, 'cliModel' => 'generic', ], - 'mospApiUrl' => 'https://objects.monarc.lu/api/v1/' + 'mospApiUrl' => 'https://objects.monarc.lu/api/v1/', + + 'statsApi' => [ + 'baseUrl' => 'http://127.0.0.1:5005', + 'apiKey' => '', + ], ]; ```