MonarcAppFO/INSTALL/INSTALL.rhel7.9.md

6.7 KiB

Installation on RHEL 7.9

RHEL Installation and preparation

Install RHEL 7.9

Register RHEL

[root@monarc ~]# subscription-manager register --username <un> --password <pw> --auto-attach

Update Yum

[root@monarc ~]# yum update

Install the epel repo - extra packages for enterprise Linux 7

[root@monarc ~]# yum install https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm

Install Remis Rpm Repo for RH7

[root@monarc ~]# yum install https://rpms.remirepo.net/enterprise/remi-release-7.rpm

Install PHP 7.4, required modules & dependencies from Remi's repository (PHP8 or PHP8.1 can be used from Monarc v2.15.6):

[root@monarc ~]# yum install php74.x86_64 php74-php.x86_64 \
php74-php-gd.x86_64 php74-php-mysqlnd.x86_64 \
php74-php-mbstring.x86_64 php74-php-pear.noarch \
php74-php-pecl-apcu.x86_64 php74-php-xml.x86_64 php74-php-intl.x86_64 \
php74-php-pecl-imagick.x86_64 php74-php-pecl-zip.x86_64 \
php74-php-bcmath php74-php-mbstring.x86_64 php74-php-cli

Update Git 1.8-2.3

[root@monarc fo]# yum remove git
[root@monarc fo]# yum -y install https://packages.endpoint.com/rhel/7/os/x86_64/endpoint-repo-1.9-1.x86_64.rpm
[root@monarc fo]# yum install git

Update OpenSSH

[root@monarc fo]# wget https://kojipkgs.fedoraproject.org/vol/fedora_koji_archive02/packages/openssh/7.6p1/7.fc28/x86_64/openssh-7.6p1-7.fc28.x86_64.rpm
[root@monarc fo]# yum localinstall openssh-7.6p1-7.fc28.x86_64.rpm

MariaDB

Update MariaDB to V10

https://mariadb.com/docs/deploy/upgrade-community-server-cs105-rhel7/

[root@monarc ~]# subscription-manager repos --enable=rhel-7-server-optional-rpms
[root@monarc ~]# yum install php-mbstring php-intl

Secure the MariaDB installation

[root@monarc ~]# systemctl start mariabdb
[root@monarc ~]# mysql_secure_installation

MariaDB configuration

Add the following line to server.cnf (/etc/my.cnf.d/server.cnf) otherwise you may get an error when initializing the database

[mariadb]

max_allowed_packet=8M
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;

Restart Apache

[root@monarc ~]# systemctl restart httpd

MONARC installation and configuration

Install MONARC

[root@monarc ~]# mkdir -p /var/www/html/monarc/fo
[root@monarc ~]# yum install git
[root@monarc ~]# git clone https://github.com/monarc-project/MonarcAppFO.git /var/www/html/monarc/fo
[root@monarc ~]# cd /var/www/html/monarc/fo
[root@monarc fo]# mkdir -p data/cache
[root@monarc fo]# mkdir -p data/LazyServices/Proxy
[root@monarc fo]# mkdir -p data/DoctrineORMModule/Proxy
[root@monarc fo]# mkdir -p data/import/files
[root@monarc fo]# chmod -R g+w data
[root@monarc fo]# yum remove php-5.4.16 php-cli-5.4.16 php-common-5.4.16

Install composer

[root@monarc fo]# curl https://getcomposer.org/installer --output composer-setup.php
[root@monarc fo]# php composer-setup.php --install-dir=/usr/bin/ --filename composer
[root@monarc fo]# rm composer-setup.php
[root@monarc fo]# yum install php74-php-cli

Configure path (can be adjusted depending on the php version)

[root@monarc fo]# export PATH=$PATH:/opt/remi/php74/root/usr/bin:/opt/remi/php74/root/usr/sbin
[root@monarc fo]# ln -s /usr/bin/php74 /usr/bin/php

Apply PHP configuration settings in your php.ini

https://github.com/monarc-project/MonarcAppFO/blob/master/vagrant/bootstrap.sh#L22-L26

Update (The option --ignore-platform-req=php is used in case of php8.1)

[root@monarc fo]# composer self-update
[root@monarc fo]# composer install -o --ignore-platform-req=php

Prepare Backend

[root@monarc fo]# mkdir -p module/Monarc
[root@monarc Monarc]# cd module/Monarc
[root@monarc Monarc]# ln -s ./../../vendor/monarc/core Core
[root@monarc Monarc]# ln -s ./../../vendor/monarc/frontoffice FrontOffice
[root@monarc Monarc]# cd ../..

Prepare Front-end

[root@monarc fo]# mkdir node_modules
[root@monarc fo]# cd node_modules
[root@monarc node_modules]# git clone https://github.com/monarc-project/ng-client.git ng_client
[root@monarc node_modules]# git clone https://github.com/monarc-project/ng-anr.git ng_anr

Install database

mysql -u root --p monarc_common < db-bootstrap/monarc_structure.sql
mysql -u root -p monarc_common < db-bootstrap/monarc_data.sql

Create a database user for MONARC (in the interpreter)

create user 'monarc'@'localhost' identified by 'password';
grant create, delete, insert, select, update, drop, alter on monarc_common.* to 'monarc'@'localhost';
grant create, delete, insert, select, update, drop, alter on monarc_cli.* to 'monarc'@'localhost';

Set up database connection

[root@monarc fo]# cd /var/www/html/monarc/fo/config/autoload/
[root@monarc autoload]# cp local.php.dist local.php
[root@monarc autoload]# vi local.php

Update database credentials

Reference: https://github.com/nodesource/distributions

Install correct version of NodeJS and Grunt

[root@monarc fo]# yum remove -y nodejs npm
[root@monarc fo]# curl -fsSL https://rpm.nodesource.com/setup_16.x | bash -
[root@monarc fo]# yum install -y nodejs
[root@monarc fo]# npm install -g grunt grunt-cli

Set git branch

For the commnad below, the {LATEST-RELEASE-TAG} parameter can be found here (for example: v2.12.5-p4): https://github.com/monarc-project/MonarcAppFO/releases

[root@monarc fo]# git branch --set-upstream-to=origin/master {LATEST-RELEASE-TAG}

Reconfigure SSH

/etc/ssh_config:

StrictHostKeyChecking no

Trigger the update script

[root@monarc fo]# ./scripts/update-all.sh

Set permissions on MONARC website folder

[root@monarc fo]# cd /var/www/html/
[root@monarc html]# chown -R apache:apache monarc

Restart the services

[root@monarc fo]# cd /etc/httpd/conf.d/
[root@monarc conf.d]# vi monarc.conf
[root@monarc conf.d]# systemctl stop firewalld
[root@monarc conf.d]# systemctl restart httpd.service

monarc.conf can be found here

Create MONARC Admin User

[root@monarc fo]# php ./vendor/robmorgan/phinx/bin/phinx seed:run -c ./module/Monarc/FrontOffice/migrations/phinx.php